Cadastro / Edição de Usuários (Admin)

1. O que é

A tela Usuários cadastrados (módulo Usuários no hub) permite incluir, editar, inativar, vincular perfil, redefinir acesso e importar planilha. Modais: Cadastro de Usuário e Edição de Usuário.

Há também bloco Importação para carga em lote.

2. Pré-requisitos

Acesso Admin a usuários.
Perfis cadastrados (Perfis).
Em SaaS, e-mail é o login; em ambiente não SaaS, há campo Login separado.
Licença válida.

3. Variantes / ações

Ação	Efeito
Voltar	Hub Configurações
Adicionar novo usuário	Modal de cadastro
Lápis	Modal de edição
Vincular (na grade de perfil do usuário)	Associa perfil
Importação	Upload de planilha no card Importação
Exclusão/inativação	Conforme botões da linha

Tipo de Usuário: Operacional, Prestador, Administrador (OPERACIONAL, PRESTADOR, ADMIN).

4. Onde configurar

Caminho: Admin → Configurações → Usuários.

4.1 Grade

Cabeçalho	Conteúdo
Cód.	Identificador
Nome	Nome
Email	E-mail
Tipo	Administrador / Prestador / (operacional)
Celular	Telefone
Último Acesso	Data/hora
Status	Ativo / Inativo

4.2 Modal cadastro / edição

Campo	Observação
Nome	Obrigatório
Login ou Email (será utilizado como login do usuário)	Conforme SaaS
Email	Em não SaaS (além do login)
Data Nascimento	Opcional
Celular	Máscara `(00) 00000-0000`
Tipo de Usuário	Operacional / Prestador / Administrador
Receber Notificação por Push ou SMS	Flag
Receber Notificação por Email	Flag
Ativo	Flag

Na edição, login/e-mail de login pode ser somente leitura. Só Administrador logado altera outro Administrador.

4.3 Importação

Use o card Importação com planilha no layout esperado pelo sistema (colunas alinhadas ao cadastro, incluindo tipo de usuário). Valide em homologação antes de produção.

5. Procedimentos relacionados

Necessidade	Doc
Criar/vincular módulos do perfil	kpainel-admin-Perfis.md
Meu Perfil (autoatendimento)	kpainel-admin-Perfil.md

6. Publicação / validação

Criar usuário ativo com tipo correto.
Vincular perfil com módulos.
Testar login Admin e preferências de notificação.

7. Checklist de sustentação

Sintoma	Verificar
Não loga	Ativo; login/e-mail; senha
Sem menus	Perfil e Vincular Módulo
Não vira ADMIN	Usuário logado precisa ser Administrador
Importação falha	Layout da planilha; tipos válidos

8. Fluxo resumido

Adicionar novo usuário → preencher → Salvar.
Vincular perfil.
Validar login e notificações.

9. Pontos de atenção

Mascarar PII em prints (e-mail, celular, nomes reais fora da allowlist).
Operacional no seletor pode ser normalizado internamente — valide o tipo após salvar.