Index de Usuários
Gestão de usuários e permissões. Tabela, Lista enriquecida (avatar, perfil e status) e Preview. Acesso exclusivo para Administradores.
O ponto de partida: a tela real de Usuários (Tabela) — Header, Subheader (Convidar usuário), Sidebar (cargo, perfil e acesso — sem switcher) e a tabela com avatar, perfil, último acesso e status. A Lista enriquecida e o Preview estão em Contextos.
Boas Práticas
O índice de Usuários segue o chassi de Estrutura de Index. É uma tela administrativa — esta página cobre só o que é próprio da entidade.
Especificação
Lista enriquecida é o modo padrão — linha mais alta com avatar 40×40 e iniciais como fallback. People-centric: a identidade visual (avatar + e-mail) importa mais que densidade de colunas. Tabela e Preview também estão disponíveis pelo alternador de view.
Colunas
Na Lista (padrão), estes campos formam a linha enriquecida; na Tabela, viram colunas. O conjunto padrão é people-centric (avatar + identidade); outras ficam ocultas em "Editar colunas".
| Coluna | Tipo | Observação | Visibilidade |
|---|---|---|---|
| Avatar | 40×40 | Iniciais como fallback, cor de fundo por hash do nome. | Padrão |
| Nome + E-mail | Link + muted | Nome linka para o perfil; e-mail secundário, não editável. | Padrão |
| Perfil | Badge semântico | Papel de acesso (ver perfis abaixo). | Padrão |
| Departamento | Texto | «—» se não atribuído. | Padrão |
| Status | Badge semântico | Estado da conta (ver abaixo). | Padrão |
| Último acesso | Data relativa | Relativo ≤30d; «Nunca» para Pendente. | Padrão |
| Cargo | Texto | Função do usuário (distinta do perfil de acesso). | Opcional |
| Data de criação | Data | Antiguidade da conta. | Opcional |
| Empresa (multi-org) | Texto | A qual organização o usuário pertence. | Opcional |
| Telefone | Texto | Contato direto, quando informado. | Opcional |
Perfis
| Perfil | Acesso |
|---|---|
| Administrador | Acesso total + gestão de usuários |
| Gestor | Aprovação + relatórios + equipe |
| Comprador | Criação de docs sem aprovação |
| Aprovador | Aprovação sem criação |
| Visualizador | Somente leitura |
Status de conta
| Status | Significado |
|---|---|
| Ativo | Login habilitado |
| Inativo | Dados preservados, sem acesso |
| Pendente | Convite enviado, não aceito |
| Bloqueado | Requer ação de admin |
Filtros
Filtrar usuários acontece em camadas que se somam — da busca livre ao recorte estruturado — e todas refletem na lista na hora. A mecânica dos critérios (chips, operadores, salvar) vive no padrão Filtrar; aqui está o que cada superfície da tela resolve.
Busca
Campo no subheader. Casa nome ou e-mail; é o gatilho do Command Palette.
Command Palette (Filter Search)
Overlay que a busca abre: busca direta por usuário, aplicar um filtro salvo ou montar um critério (Critério → Operador → Valor). Mecânica em Filtrar.
Critérios (Filter Bar)
Filtros estruturados acima da lista: Perfil, Status, Cargo… Os três primeiros visíveis; o resto em “Mais filtros”.
Recortes da sidebar
Cargo, Perfil e Último acesso aplicam um recorte pronto num clique — sem montar critério.
Filtros salvos
Combinações de critérios salvas e reaplicáveis; ficam em Favoritos, na sidebar.
Critérios da Filter Bar
Os critérios estruturados que recortam a lista. Status já entra pré-aplicado em "Ativo + Pendente" — o foco de quem administra acessos.
| Filtro | Controle | Quando ajuda |
|---|---|---|
| Perfil | Multi-select | Recorta por papel: Administrador, Gestor, Comprador ou Visualizador. |
| Status | Multi-select | Situação da conta; já vem pré-aplicado em “Ativo + Pendente”. |
| Cargo | Typeahead | Função do usuário na organização. |
| Último acesso | Intervalo de datas | Encontra contas ociosas ou recém-ativas. |
| Data de criação | Intervalo de datas | Janela em que o usuário foi convidado. |
As ações da index estão detalhadas na aba Ações.
Contextos
Três campos: E-mail (único, não editável depois), Perfil e Departamento. O e-mail é o identificador permanente da conta.
Os filtros ficam na própria sidebar (à esquerda), não em drawer. Perfil usa radio (seleção única); Status usa checkbox (pré: Ativo + Pendente); Departamento usa typeahead colapsável.
Ao marcar usuários, a filter bar exibe a badge “N selecionados” (toggle): desabilita os filtros aplicados e expõe Salvar lista e Limpar seleção. O subheader não muda e nenhuma CTA nova aparece.
Ações
Como os padrões de Ações do usuário se aplicam ao índice de Usuários (tela administrativa). O universal está na Geral; aqui, o que é próprio da entidade.
Ações por linha (menu de mais ações)
Menu ⋮ no fim da linha: Ver, Editar, Alterar perfil e Ativar/Desativar. A destrutiva Bloquear (exclusiva do Administrador) fica isolada após um divisor.
Desfazer (ações reversíveis)
Ativar/desativar e alterar perfil executam na hora, com toast "Desfazer" (5s). Só Bloquear exige modal de confirmação.
Feedback
O retorno é proporcional ao impacto. O catálogo completo está na Geral; abaixo, as particularidades de Usuários.
| Cenário | Mecanismo de feedback |
|---|---|
Usuário cadastrado | Toast de confirmação; o novo usuário aparece com status Pendente até o primeiro acesso. |
Ativar / Desativar / Alterar perfil | Toast com Desfazer (5s) — ações reversíveis, sem modal. |
Bloquear (admin) | Modal de confirmação obrigatório — irreversível e exclusivo do Administrador. |
Editar e-mail | Bloqueado: o e-mail é o identificador único da conta e não pode ser alterado pelo painel. |