Usuários
Cadastro, edição, detalhes e exclusão de usuários por hospital.
1. Objetivo
Gerenciar os usuários do HaisFaturamento e o prestador ao qual cada um pertence.
2. Telas e estados
- Usuários/usuarios(abre em nova aba)
Lista de usuários.
- Cadastrar usuário/usuarios?estado=cadastro(abre em nova aba)
Modal de cadastro.
- Editar usuário/usuarios?estado=edicao(abre em nova aba)
Modal de edição.
- Detalhes do usuário/usuarios?estado=detalhes(abre em nova aba)
Modal de detalhes.
- Excluir usuário/usuarios?estado=exclusao(abre em nova aba)
Confirmação de exclusão.
3. Regras e comportamentos
Listagem
- Colunas: Nome, E-mail, CPF, Prestador, Ações, com paginação (20 itens por página por padrão; mudar filtros volta para a página 1).
- Busca por nome ou CPF, com ou sem pontuação, e filtro por Prestador.
- “Limpar filtros” disponível na barra e no estado vazio.
Cadastro e edição
- Nome completo (até 120 caracteres), E-mail e Prestador são obrigatórios.
- CPF é obrigatório e usa máscara; deve estar completo (“Informe o CPF.” / “Informe um CPF completo.”).
- No cadastro, um aviso informativo “Senha de primeiro acesso” informa que o usuário utilizará os números do CPF como senha no primeiro acesso.
- Não é permitido e-mail repetido.
- Na edição, CPF e Prestador não podem ser alterados.
- A exclusão exige confirmação.
4. Estados e validações
| Estado / situação | Onde ocorre | Comportamento esperado |
|---|---|---|
| Campo inválido | Onde ocorre
| Comportamento esperado “Informe um CPF completo.”, “Selecione um hospital.”, “Já existe um usuário com este e-mail.” |
| Vazio | Onde ocorre
| Comportamento esperado Mensagem para ajustar os filtros, com “Limpar filtros”. |
| Sucesso | Onde ocorre
| Comportamento esperado “Usuário cadastrado com sucesso.”, “Alterações salvas com sucesso.”, “Usuário {nome} excluído.” |
5. Responsividade
- MobileA tabela é substituída por uma lista de cartões com os mesmos campos; o menu lateral vira gaveta aberta pelo botão no topo.
- Cartão de usuárioAbaixo de telas largas, o e-mail ocupa até duas linhas, quebrando preferencialmente após "@" e "."; se ainda não couber, termina em reticências e o endereço completo fica nos detalhes.
6. Observações para desenvolvimento
Atenção — comportamento do protótipo
Os prestadores dos campos e filtros têm como origem o cadastro de Prestadores (Administração > Prestadores), a mesma fonte usada em Operadoras; cada usuário mantém seu próprio vínculo.
Usuários e prestadores são fictícios e as alterações não são salvas: ao recarregar a página, a lista volta ao estado inicial.
Os links com ?estado= em Telas e estados existem só para documentação e validação: abrem diretamente um modal ou estado que, no produto, é alcançado pelo fluxo normal.