Ir para o conteúdo

Roteiro: Trocar a própria senha e conferir dados da conta

Perfil necessário: admin | viewer (qualquer usuário autenticado) Menus usados: Conta (menu do usuário, canto superior direito) Risco: baixo (afeta apenas o próprio usuário; errar a senha atual apenas falha a operação) Rollback: repetir a troca de senha, voltando para a senha anterior (a senha atual passa a ser a última definida)

Pré-requisitos

  • [ ] Estar logado (rota /account disponível para admin e viewer)
  • [ ] Saber a senha atual
  • [ ] Nova senha com no mínimo 8 caracteres

Passo a passo

1. Abrir Minha Conta

Caminho: Avatar do usuário (canto superior direito) → Minha Conta

Ou direto pela URL /account.

Página Minha Conta com o botão Salvar nova senha destacado

Resultado esperado: dois cards — Perfil (dados da conta) e Alterar senha.

2. Conferir os dados do perfil

O card Perfil é somente leitura (não há edição de dados na UI — renomear o usuário ou alterar nome de exibição/perfil é feito por um admin em Usuários):

Dado Origem Exemplo
Usuário login da conta admin
Nome de exibição campo display_name do cadastro Administrador
Perfil tag colorida: vermelho admin, azul viewer admin

3. Trocar a senha

Preencha:

Campo Obrig. Formato/exemplo Efeito
Senha atual Sim senha em uso hoje Validada pelo backend; erro 400 "Senha atual incorreta" se errada
Nova senha Sim mínimo 8 caracteres Componente mostra medidor de força (feedback ativado); olho alterna visibilidade
Confirmar nova senha Sim igual à nova senha Comparação feita na UI antes de enviar

Clique: [Salvar nova senha]

Resultado esperado: toast "Senha alterada com sucesso" e campos limpos. A troca fica registrada no log de auditoria (change_password).

Clique alternativo: [Limpar] — esvazia os três campos sem enviar nada.

4. Sessões abertas

A UI não desloga as outras sessões após a troca: JWTs já emitidos continuam válidos até expirar. Se a senha foi trocada por suspeita de comprometimento, faça logout manual nas máquinas afetadas e considere revogar PATs do usuário (ver roteiro admin-pat.md).

Validação

  • [ ] Visual: toast de sucesso e campos limpos
  • [ ] Funcional: logout → login com a nova senha funciona; com a antiga falha
  • [ ] Funcional: curl -X PUT http://127.0.0.1:8080/api/auth/me/password -H "Authorization: Bearer <JWT>" -H "Content-Type: application/json" -d '{"current_password":"...","new_password":"..."}' responde "Senha alterada com sucesso"
  • [ ] Auditoria: evento change_password no log de auditoria do admin

Erros comuns

Sintoma Causa provável Correção
Toast "Preencha todos os campos" algum campo vazio completar os três campos
Toast "A nova senha deve ter no mínimo 8 caracteres" senha curta usar senha ≥ 8 caracteres
Toast "A confirmação de senha não confere" confirmação difere da nova senha redigitar a confirmação
Toast "Falha ao alterar senha" + backend 400 senha atual incorreta conferir a senha atual (caps lock, gerenciador desatualizado)

Tabela de referência rápida

Tarefa Onde
Ver dados da conta Minha Conta → card Perfil (somente leitura)
Trocar senha Minha Conta → Alterar senha → Salvar nova senha
Trocar senha de outro usuário Usuários → Editar usuário → Nova senha (opcional)