Visão geral

A funcionalidade de Definição de Conta Padrão permite que o usuário escolha qual conta (carteira/beneficiário) será automaticamente carregada ao acessar o sistema.

Essa configuração:

• É persistida no backend
• Define a experiência de login
• Impacta diretamente o contexto de dados e permissões

Objetivo Funcional

Permitir que o usuário:

• Defina uma conta padrão no primeiro acesso
• Altere a conta padrão posteriormente
• Tenha uma experiência consistente entre sessões e dispositivos

1. Fluxo de Primeiro Login

1.1 Cenários possíveis

Usuário com 1 conta

• Conta é selecionada automaticamente
• Não exibe modal
• Usuário é redirecionado diretamente para a Dashboard

Usuário com múltiplas contas 

Sistema executa:

GET /api/beneficiario/conta-padrao

> Caso exista conta padrão:

• Conta é carregada automaticamente
• X-Account-Id é definido
• Usuário é redirecionado para a Dashboard

> Caso NÃO exista conta padrão:

• Modal obrigatório é exibido

1.2 Comportamento visual

• Modal centralizado com título:
  “Seleção obrigatória da conta”
• Lista de contas disponíveis
• Exibição no formato: nrConta-nrDv (ex: 652992-5)
• Botões de Selecionar e Cancelar

1.3 Regras do Modal

• Modal é obrigatório
• Não pode ser fechado, clicando fora ou pressionando ESC.

1.4 Ações do usuário

Ao selecionar uma conta e confirmar:

1. Dispara: PATCH /api/beneficiario/conta-padrao
2. Atualiza: sessionStorage → X-Account-Id
3. Executa: window.location.reload()
4. Após reload:

• Interceptor injeta X-Account-Id
• Menu é recarregado (GET /menu)
• Dados são carregados no contexto da conta
• Usuário é redirecionada para o dashboard do sistema.

Ao cancelar/fechar sem selecionar a conta padrão, o sistema executa logout automático.