Lista de Usuários

Módulo: Administração Caminho na aplicação: Menu > Administração > Usuários (/usuarios) Última atualização: 20/04/2026

Para que serve

Exibe todos os usuários cadastrados no tenant. Permite pesquisar, visualizar o status de cada usuário e remover registros. O acesso ao formulário de cadastro ou edição se dá a partir desta tela.

Quem pode usar

Usuários com permissão visualizar no módulo Usuários. A remoção exige permissão excluir.

Como usar (passo a passo)

1. Acesse Menu > Administração > Usuários.
2. A lista carrega automaticamente com até 50 registros por vez. Role a página para baixo para carregar mais.
3. Use o campo Buscar por nome ou email... para filtrar. O filtro é aplicado em tempo real conforme você digita.
4. Clique em Limpar para remover o filtro e recarregar a lista completa.
5. Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o cadastro do usuário em modo de edição.
6. Clique em Novo Usuário (botão superior direito) para cadastrar um novo usuário.
7. Para remover um usuário, clique no ícone de lixeira na linha correspondente e confirme a ação no popup.

Campos da tela

Campo	Obrigatório	O que preencher	Observações
Buscar por nome ou email...	Não	Texto livre	Filtra por nome ou e-mail do usuário

Colunas da tabela

Coluna	Descrição
ID	Identificador interno sequencial do usuário no tenant
Nome	Nome completo do usuário
Email	Endereço de e-mail (login)
Filiais	Filial(is) às quais o usuário tem acesso. Ao passar o mouse sobre "+N" exibe todas
Perfil	Perfil(s) de acesso atribuído(s) ao usuário por filial
Último Login	Data e hora do último acesso (formato DD/MM/AAAA HH:mm)
Status	Situação atual: Pendente, Ativo, Inativo ou Bloqueado

Validações e regras

• A lista usa paginação por scroll infinito: carrega 50 registros por vez e busca mais ao rolar até o final da página.
• O contador de registros ("X registros encontrados") é atualizado a cada busca.
• Perfis de sistema não são removíveis; usuários, sim — mas a remoção os desativa no backend (
• O botão de lixeira fica indisponível durante o carregamento para evitar cliques repetidos.

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Erro ao carregar usuarios"	Falha na comunicação com a API ao listar	Verifique a conexão e recarregue a página
"Erro ao remover usuario"	Falha na exclusão via API	Verifique se o usuário não está vinculado a registros que impeçam a remoção e tente novamente

Integrações e dependências

• Consome o serviço usuariosService.listar() com paginação e filtro de busca.
• A coluna Filiais e Perfil depende de dados retornados pelo relacionamento Usuario.filiais na resposta da API.
• Navegação para o formulário de edição: /usuarios/:id/editar.
• Navegação para criação: /usuarios/novo.

Dúvidas frequentes

A busca filtra em tempo real ou preciso pressionar Enter? Em tempo real — o filtro é reaplicado a cada caractere digitado.

Por que o status aparece como "Pendente"? O usuário foi cadastrado mas ainda não clicou no link de ativação enviado por e-mail.

Posso ver usuários de outras filiais nesta lista? A lista exibe todos os usuários do tenant. Cada usuário pode ter acesso a uma ou mais filiais, conforme configurado no Cadastro de Usuário.

Histórico de alterações

Data	Alteração
20/04/2026	Documento inicial criado.