Roteiro: Criar usuários admin/viewer no painel administrativo¶
Perfil necessário: admin Menus usados: Administração (menu do usuário, canto superior direito) Risco: médio (conta errada como admin concede controle total do softswitch; viewer apenas consulta) Rollback: editar o usuário e ajustar Perfil/Status, ou excluir o usuário pela ação da tabela
Pré-requisitos¶
- [ ] Login como usuário com perfil
admin(a rota/usersé exclusiva de admin) - [ ] Senha inicial de no mínimo 8 caracteres definida para o novo usuário
O que admin e viewer veem¶
As rotas com requiresAdmin são bloqueadas para viewer (redirecionamento para o Dashboard e item oculto na navegação):
| Seção | Página | Viewer vê? |
|---|---|---|
| Administração | Usuários (/users) |
Não |
| Sistema | SIP Profiles (/system/sip-profiles) |
Não |
| Sistema | Domínios SIP (/system/sip-domains) |
Não |
| Sistema | Backups (/system/backups) |
Não |
| Sistema | MCP (/system/mcp) |
Não |
| Roteamento | Avançado → Usuários SIP (/advanced/subscribers) |
Não |
Todo o restante (Operação, Comercial, Roteamento, Políticas, Infraestrutura, Rede/Firewall, Minha Conta) é visível para viewer em modo leitura: ações de escrita falham com 403 do backend.
Passo a passo¶
1. Abrir a página de usuários¶
Caminho: Avatar do usuário (canto superior direito) → Gerenciar Usuários
Ou direto pela URL /users.

Clique: [Novo usuário]
Resultado esperado: dialog Novo usuário abre.
2. Preencher o dialog Novo usuário¶

Preencha:
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Usuário * | Sim | noc01 (único; fica travado após criar) |
Login do painel e da API |
| Perfil | Sim | Administrador ou Visualizador (default: Administrador) |
Define requiresAdmin das rotas |
| Nome de exibição | Não | NOC Turno A |
Exibido nas listas e no avatar |
| Status | Sim | Ativo ou Inativo (default: Ativo) |
Inativo não consegue logar |
| Senha * | Sim (na criação) | mínimo 8 caracteres | Credencial de login |
Clique: [Criar] (rodapé do dialog)
Resultado esperado: toast "Usuário criado" e linha nova na tabela com Status Ativo.
3. Ajustar um usuário existente (opcional)¶
Na linha do usuário, Clique: [Editar usuário] (ícone de lápis em Ações).
O dialog muda para Editar usuário: Usuário fica travado; senha passa a ser opcional ("Nova senha (opcional)") e só troca se preenchida.
Resultado esperado: toast "Usuário atualizado".
Não é possível excluir o próprio usuário — a UI bloqueia com o aviso "Não é possível excluir o próprio usuário".
Validação¶
- [ ] Visual: linha nova na tabela com Perfil e Status corretos
- [ ] Funcional: logar com o novo usuário —
viewernão acessa/usersnem/system/mcp(cai no Dashboard);adminacessa tudo - [ ] Funcional:
curl -H "Authorization: Bearer <JWT>" http://127.0.0.1:8080/api/auth/medevolve o usuário criado
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Toast "Usuário e senha são obrigatórios" | criação sem usuário ou senha | preencher os dois campos marcados com * |
| Toast "Senha deve ter no mínimo 8 caracteres" | senha curta | usar senha ≥ 8 caracteres |
| Backend responde 409/400 ao criar | username já existe | escolher outro username |
| Viewer vê "Falha ao carregar usuários" | perfil sem permissão (/auth/users é admin-only) |
usar conta admin para gerenciar |
Tabela de referência rápida¶
| Tarefa | Onde |
|---|---|
| Criar usuário | Usuários → Novo usuário |
| Trocar perfil/senha/status | Usuários → ícone lápis na linha |
| Excluir usuário | Usuários → ícone lixeira na linha (confirmação obrigatória) |