Usuários - Visão Geral

O que é

O módulo de Usuários concentra todo o controle de acesso ao painel da sua empresa. É aqui que se cadastra cada pessoa que vai entrar no sistema com login e senha, define qual perfil de acesso ela recebe (Proprietário, Gerente, Atendente, Financeiro, Operacional, Vendedor CRM, Gerente CRM ou um perfil customizado) e se ela está ativa ou desativada.

O usuário normalmente chega aqui logo na implantação, para montar a equipe inicial, e depois sempre que entra ou sai alguém da operação. A página de entrada ("/admin/usuarios") mostra a lista completa com badges de perfil, status (Ativo/Inativo) e marcação especial "Você" no próprio usuário logado - a partir dela parte para criar, editar, ajustar perfis de acesso ou consultar auditoria.

Como usar

1. Vá em Sistema > Usuários no menu lateral. A lista paginada (20 por página) é aberta ordenada por nome.
2. Para encontrar alguém, use a barra de filtros logo abaixo do cabeçalho:
   • Buscar por nome ou e-mail - campo de texto à esquerda, faz busca parcial (ILIKE) por nome ou e-mail.
   • Status - seletor com Todos status, Ativos ou Inativos.
   • Perfil - seletor com todos os perfis (roles) cadastrados na sua empresa.
3. Para cadastrar alguém novo, clique em Novo Usuário (botão azul no canto superior direito do cabeçalho). Detalhado em "Usuários - Cadastrar Novo Usuário".
4. Em cada linha da lista, abra o dropdown de ações (ícone de três pontos à direita) para:
   • Editar - vai para a tela de edição do usuário.
   • Desativar ou Ativar - alterna o status sem permissão de excluir o registro (não aparece para o próprio usuário logado).
   • Excluir - abre modal de confirmação que exige digitar a palavra EXCLUIR para liberar o botão vermelho.
5. Para abrir os perfis de acesso e permissões, navegue até Sistema > Perfis de Acesso. Para ver o histórico de quem fez o quê, vá em Sistema > Auditoria. Para atualizar seus próprios dados, abra Meu Perfil no menu do avatar.

Casos especiais

Vendedor externo

Usuários cujos perfis são todos marcados como externos (sem acesso ao admin) aparecem na lista com avatar verde em vez de azul. Eles existem apenas para serem atribuídos como vendedores em links de venda, sem entrar no painel. O cadastro é simplificado e dispensa e-mail e senha.

Você não pode agir sobre si mesmo

Na linha do próprio usuário logado, a badge Você aparece ao lado do nome. As opções de Desativar/Ativar e Excluir ficam escondidas dessa linha - para alterar a própria conta, use Meu Perfil.

Lista vazia

Se não houver nenhum usuário cadastrado na sua empresa (situação inicial rara, já que o Proprietário entra como primeiro usuário), a lista exibe o estado vazio com o botão Cadastrar primeiro usuário apontando direto para o formulário de criação.

Campos customizados

Se você configurou campos customizados para a entidade "usuário", os valores aparecem em uma linha extra dentro do card, logo abaixo das informações de e-mail e data de cadastro.

Erros comuns e como resolver

• Dropdown de ações sem opções - Causa: o usuário logado não possui as permissões de editar os usuários nem excluir os usuários. Solução: peça ao Proprietário/Gerente para ajustar o perfil em Sistema > Perfis de Acesso.
• Botão Novo Usuário não aparece - Causa: falta a permissão de criar os usuários. Solução: revisar o perfil no módulo de Perfis de Acesso.
• "A palavra digitada não corresponde" (modal de exclusão) - Causa: foi digitado algo diferente de EXCLUIR (maiúsculas, sem acento). Solução: digitar exatamente EXCLUIR e confirmar.
• Filtro por perfil não traz ninguém - Causa: o perfil selecionado não está atribuído a nenhum usuário ativo na sua empresa. Solução: limpar o filtro com o botão de limpar da barra ou escolher outro perfil.

Onde encontrar

• URL: /admin/usuarios
• Caminho no menu: Sistema > Usuários
• Permissão necessária: ver os usuários (ações dependem de criar os usuários, editar os usuários, excluir os usuários)
• Módulo necessário: nenhum

Veja também

• Usuários - Cadastrar Novo Usuário
• Usuários - Editar, Desativar e Excluir
• Usuários - Perfis de Acesso e Permissões
• Usuários - Auditoria e Logs de Atividade
• Meu Perfil