Usuários
O módulo de Usuários permite gerenciar contas de acesso do sistema, com controle de perfil, vínculo com funcionário, conta SMTP padrão e foto de perfil.
Visão Geral
A tela principal exibe a lista de contas cadastradas, com:
- ✅ Adicionar novos usuários
- ✅ Editar dados de usuários existentes
- ✅ Excluir usuário individual
- ✅ Excluir múltiplos usuários selecionados
- ✅ Pesquisar por texto livre
- ✅ Filtrar por Data de Criação e Status
- ✅ Ordenar por coluna
- ✅ Acessar ajuda do módulo pelo menu do cabeçalho
Acessando o Módulo
Para acessar o módulo de usuários:
- Faça login no sistema com uma conta que possua permissão de administrador
- No menu lateral, clique em Sistema › Usuários
- A listagem de usuários será exibida
Lista de Usuários
A grade apresenta as colunas:
| Campo | Descrição |
|---|---|
| ☐ | Seleção múltipla (inclui seleção em faixa) |
| ID | Identificador único do usuário |
| Nome | Nome completo do usuário |
| E-mail utilizado para login | |
| Status | Situação do usuário (Ativo quando deleted = false; Inativo quando deleted = true) |
| Ações | Editar e menu de ações da linha |
Ordenação
Clique no cabeçalho das colunas ordenáveis para alternar entre ordem crescente e decrescente.
Seleção em lote
- Selecionar individualmente: marque a caixa à esquerda de cada linha
- Selecionar todos: marque a caixa no cabeçalho da tabela
- Seleção por intervalo: segure Shift e clique para selecionar um intervalo
Quando há itens selecionados, é exibida uma barra inferior com o botão Excluir para remoção em lote.
Ações por linha
- Editar: abre o formulário de edição do usuário.
- Excluir: abre confirmação antes de remover o registro.
Pesquisa e Filtros
Use o campo Pesquisar... para buscar registros.
Filtros Avançados
| Filtro | Descrição |
|---|---|
| Data de Criação | Filtra por intervalo de data (createdAt) |
| Status | Ativo (deleted = false) ou Inativo (deleted = true) |
Ao aplicar busca/filtro, a listagem retorna para a primeira página automaticamente.
Cadastrando um Novo Usuário
Para cadastrar um novo usuário:
- Clique em Adicionar Usuário
- Preencha o formulário com os dados obrigatórios
- Clique em Salvar
Opções de Salvamento
| Opção | Descrição |
|---|---|
| Salvar | Salva e fecha o formulário |
| Salvar e Novo | Salva e mantém o modal aberto com formulário em branco |
| Menu (engrenagem) | Ações extras do registro atual (como duplicar, reiniciar e excluir, quando aplicável) |
Formulário de Usuário
O formulário permite configurar as principais informações e permissões do usuário.
O formulário abre em modal com barra lateral de seções:
- Usuario
- Foto de Perfil
Seção: Usuário
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | ✅ | Nome completo do usuário (máx. 100 caracteres) |
| ✅ | E-mail utilizado para login (formato válido) | |
| Senha | ✅ (novo) / ❌ (edição) | Deve ter no mínimo 6 caracteres. Em edição, se vazio, mantém a senha atual. |
| Confirmação de Senha | ✅ | Repita a senha para validação |
| Perfil | ✅ | Perfil de acesso (roleId) carregado da lista de perfis |
| Funcionário | Vincula o usuário a um funcionário existente (seletor modal) | |
| Conta SMTP padrão (para enviar e-mail) | Define a conta SMTP usada em envios externos. Se vazio, usa a conta padrão da empresa; sem padrão da empresa, usa SMTP do sistema. | |
| Data de Criação | - | Exibido somente em edição (somente leitura) |
| Última Atualização | - | Exibido somente em edição (somente leitura) |
Em edição, o campo Senha mostra a dica "Deixe em branco para manter a senha atual".
Seção: Foto de Perfil
- Faça upload de uma imagem para identificação visual do usuário no sistema.
- A imagem é salva automaticamente ao salvar o formulário.
- É exibida a foto atual do usuário (quando houver) para referência.
Confirmações e Atalhos
- Ao tentar fechar o formulário com Esc ou botão de fechar, o sistema pede confirmação para sair sem salvar.
- Exclusões (individual e em lote) sempre exigem confirmação.
- Nas caixas de confirmação, Enter confirma e Esc cancela.
Permissões e Perfis
O acesso ao módulo é protegido por permissão de sistema e os perfis determinam quais ações cada usuário pode executar.
No cabeçalho da página, o menu de opções (três pontos) disponibiliza atalho para Ajuda.
Para configurar perfis e permissões, consulte o módulo Perfis de Acesso.
Boas práticas
- Mantenha apenas as contas necessárias ativas.
- Utilize perfis separados para administradores, operação e consulta.
- Evite reutilizar contas entre pessoas.
- Atualize senhas periodicamente para segurança.
- Revise periodicamente a conta SMTP padrão associada aos usuários que enviam documentos por e-mail.