Módulos do Sistema
Usuários e Acesso
Usuários, cargos, permissões e visibilidade da interface.
Usuários e acesso conectam três partes:
| Parte | Responsabilidade |
|---|---|
| Autenticação | Login, refresh token, logout, senha e usuário atual. |
| Usuários | Cadastro, edição, restauração, exclusão e vínculos de cargo. |
| Cargos e permissões | Controle granular de acesso no backend e visibilidade no frontend. |
Tela de usuários
Objetivos da tela:
- pesquisar por nome ou e-mail;
- agrupar por cargo prioritário;
- mostrar badges dos cargos do usuário;
- criar, editar e excluir usuário;
- evitar que agrupamentos confundam usuários com múltiplos cargos.
Prioridade de agrupamento:
- Administrador
- Diretoria
- Recursos Humanos
- Usuário
Níveis de acesso
A tela deve focar em Cargos:
- criar cargo;
- editar nome e descrição do cargo;
- atribuir permissões existentes ao cargo;
- remover cargo quando permitido pela regra de negócio.
Permissões do sistema são contrato técnico com o backend. A interface não deve incentivar criação, edição ou exclusão livre de permissões, porque isso pode quebrar autorização.
Endpoints principais
| Recurso | Base | Uso |
|---|---|---|
| Auth | /gnoqcore/v1/auth | login, refresh, logout, me, troca de senha |
| Usuários | /gnoqcore/v1/user | CRUD e senha |
| Cargos | /gnoqcore/v1/role | CRUD de cargos |
| Permissões | /gnoqcore/v1/permission | referência técnica de permissões |
| Permissões do cargo | /gnoqcore/v1/role/{roleId}/permissions | vincular/desvincular permissões |
| Cargos do usuário | /gnoqcore/v1/user/{userId}/roles | vincular/desvincular cargos |
Referências detalhadas: Backend / Usuários e Autenticação e Backend / Permissões.