Commit cf9981

2026-06-17 13:57:41 Felipe Madril: item 11
/dev/null .. 11-usuarios-e-permissoes.md
@@ 0,0 1,60 @@
+ # 11 — Usuários e Permissões
+
+ O sistema controla o acesso por **usuário** e por **permissões**. Cada usuário enxerga e executa apenas o que lhe foi liberado.
+
+ > A gestão de usuários exige a permissão **"Editar dados da empresa e usuários"** (`my_data`).
+
+ ---
+
+ ## Listando usuários
+
+ Acesse o menu **Usuários** para ver a equipe cadastrada no estabelecimento.
+
+ ---
+
+ ## Cadastrando um usuário
+
+ 1. Clique em **Novo Usuário**.
+ 2. Preencha:
+ - **Nome**
+ - **Usuário (login)**
+ - **E-mail**
+ - **Senha**
+ 3. Defina o tipo e parâmetros:
+ - **Especialista/Técnico** — usuários técnicos vão direto para a lista de OS ao entrar.
+ - **Comissão** — percentual de comissão do usuário.
+ - **Valor/hora** — valor da hora de trabalho.
+ 4. Marque as **permissões** desejadas (veja abaixo).
+ 5. Salve.
+
+ ---
+
+ ## Editando usuários
+
+ Na edição é possível alterar dados, **redefinir a senha** (deixe em branco para manter a atual) e ativar/inativar o usuário pelo campo de **estado**.
+
+ ---
+
+ ## Permissões disponíveis
+
+ | Permissão | O que libera |
+ |---|---|
+ | **Acesso a relatórios** (`reports`) | Central de relatórios (estoque, usuários) |
+ | **Dados financeiros** (`financial`) | Valores financeiros da OS e relatório de fluxo de caixa |
+ | **Editar cadastro de clientes** (`edit_client`) | Edição de clientes |
+ | **Editar cadastro de peças** (`edit_part`) | Edição de peças |
+ | **Editar cadastro de marcas** (`edit_brand`) | Edição de marcas |
+ | **Editar cadastro de produtos** (`edit_product`) | Edição de produtos |
+ | **Editar cadastro de serviços** (`edit_service`) | Edição de serviços |
+ | **Editar marca, produto e número de série da OS** (`edit_serial`) | Alterar equipamento e nº de série de uma OS |
+ | **Editar dados da empresa e usuários** (`my_data`) | Configurações da empresa e gestão de usuários |
+
+ > Quando um usuário tenta acessar algo sem permissão, o sistema bloqueia com a mensagem *"Você não tem permissão para acessar este recurso."*
+
+ ---
+
+ ## Boas práticas
+
+ - Conceda apenas as permissões necessárias para cada função (princípio do **menor privilégio**).
+ - Reserve a permissão **"Editar dados da empresa e usuários"** para administradores.
+ - Inative (em vez de excluir) usuários que saírem da equipe, preservando o histórico das ordens.
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9