Usuários e Perfis
Cadastre os operadores que acessam o sistema e atribua cargos para definir o que cada um pode fazer.
A tela de Usuários e Perfis lista quem tem acesso ao sistema. Cada usuário é identificado por e-mail e ganha permissões a partir de um cargo (ver Cargos).
Esta é uma tela de controle de acesso. Mudanças aqui têm efeito imediato — desativar um usuário ou trocar seu cargo bloqueia/altera o que ele consegue fazer na próxima requisição.
Onde encontrar
Menu lateral → Sistema → Usuários e Perfis. URL direta:
/management/users.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar a tela | access:read |
| Criar, editar, excluir | access:manage |
Sem access:manage, botões Novo usuário, Editar e Excluir ficam
ocultos. Ver detalhes continua disponível.
A tela em um relance
Usuários e Perfis
Operadores que acessam o sistema. Atribua cargos para definir permissões.
Estrutura:
- Cabeçalho com botões Cargos (atalho) e Novo usuário.
- Quatro cartões — total, ativos, inativos, cargos configurados.
- Filtros — busca livre + filtro por cargo + filtro por status.
- Tabela com avatar, e-mail, badge de cargo, badge de status e ações.
- Paginação — 10 usuários por página.
Os cartões
| Cartão | O que mostra |
|---|---|
| Total de usuários | Total cadastrado. À direita, quantos casam com o filtro atual. |
| Ativos | Usuários habilitados. Percentual sobre o total. |
| Inativos | Sem acesso ao sistema. Bom indicador de limpeza pendente. |
| Cargos configurados | Quantos cargos existem. Atalho mental para gerenciar permissões. |
Filtrar e buscar
- Busca livre — casa com nome, e-mail e nome do primeiro cargo do usuário.
- Cargo — filtre apenas quem tem um cargo específico.
- Status — Ativos, Inativos ou Todos.
Os três filtros se combinam (AND). Mudar qualquer filtro volta para a página 1.
Lendo uma linha
Os três ícones à direita, da esquerda para a direita: Ver detalhes, Editar, Excluir. Os dois últimos ficam desabilitados na sua própria linha.
Da esquerda para a direita:
- Avatar colorido — iniciais do nome. A cor é derivada do ID do usuário (mesma do diálogo de detalhes da Atividade Recente).
- Nome + e-mail — o seu próprio usuário aparece com o selo VOCÊ.
- Cargo — badge azul. Pode aparecer "—" se nenhum cargo foi atribuído.
- Status — verde Ativo ou vermelho Inativo.
- Ações — ver, editar, excluir. Na sua própria linha, editar e excluir ficam desabilitados.
Criar um novo usuário
Abrir o formulário
Clique em Novo usuário no canto superior direito.
Preencher os campos
Novo Usuário
| Campo | Obrigatório | Regra |
|---|---|---|
| Nome | Sim | Nome completo de exibição. |
| Sim | Formato de e-mail válido. Único no sistema. | |
| Telefone | Não | Texto livre — útil para contato fora do sistema. |
| Cargo | Recomendado | Sem cargo, o usuário entra mas não consegue fazer nada. |
| Senha | Sim | Mínimo 8 caracteres. |
No modo edição, o campo Senha vira Nova Senha e pode ficar em branco — assim a senha atual é mantida.
Salvar
Clique em Salvar. Notificação: "Usuário criado com sucesso". A linha aparece na tabela.
Editar um usuário
Localizar
Use a busca ou os filtros para achar o usuário. Clique no lápis.
Alterar e salvar
O mesmo formulário abre com os dados atuais. O título vira Editar Usuário. Trocar o cargo aqui substitui o atual — não acumula. Deixe a senha em branco para mantê-la.
Você não pode editar seu próprio usuário nem trocar seu cargo nessa tela — para evitar que você se trave fora do sistema. Peça a outro administrador.
Ver detalhes
Detalhes do usuário
O ícone de olho abre um painel só de leitura com nome, e-mail, telefone, cargo atual e status. O botão Editar leva direto ao formulário de edição.
Excluir um usuário
Abrir a confirmação
Clique no ícone de lixeira.
Excluir usuário
Tem certeza que deseja excluir “Bruno Lima”? O acesso é revogado imediatamente. Esta ação não pode ser desfeita.
Confirmar
Clique em Excluir. O acesso é revogado imediatamente — se o usuário estiver logado, próxima requisição cai para a tela de login.
Não há "soft delete" pela UI. Se quer apenas pausar o acesso, considere desativar em vez de excluir (deixa histórico de auditoria mais limpo).
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Erro ao salvar usuário" com e-mail duplicado | Outro usuário já usa esse e-mail | Use outro endereço, ou edite o existente |
| Botões de criar/editar/excluir ausentes | Falta access:manage | Solicite ajuste do seu cargo |
| Editar e excluir desabilitados na sua linha | Proteção contra auto-bloqueio | Peça a outro administrador |
| Usuário criado, mas não consegue fazer nada | Foi salvo sem cargo | Edite e atribua um cargo |
Próximos passos
Antes de cadastrar muitos usuários, defina os Cargos que sua operação precisa — assim você atribui o cargo correto já na criação.
Atividade Recente
Trilha de auditoria completa — quem fez o quê, quando e a partir de qual IP. Use para diagnosticar problemas, investigar incidentes ou conferir mudanças.
Cargos
Defina quais funcionalidades cada cargo pode acessar. Permissões são granulares — por área (Viagens, Veículos, Acesso, etc.) e por ação (ler, gerenciar, excluir).