Início (Home)
Pré-requisitos de acesso
- Permissão (módulo): Nenhuma específica — basta estar autenticado no BackOffice.
- Licença/Feature: Nenhuma.
- Contêiner do menu: GERAL → grupo Início
O que é / quando usar
É a tela de entrada do BackOffice, exibida logo após o login. Serve como ponto de partida do operador: mostra uma saudação com o nome do usuário e a data, um atalho para as ações recentes (telas visitadas), e um painel de notas (lembretes pessoais por data) à direita. É também o lugar onde o sistema avisa, de forma proativa, sobre alertas antifraude recentes quando o operador tem perfil de pagamentos.
Pré-condições
- Permissão: Nenhuma — a Home é acessível a qualquer operador logado. As ações listadas em "Ações recentes" e o aviso de alertas, porém, dependem das permissões individuais (ver "Regras de negócio"). Lembre-se de que a permissão no BackOffice é dupla — enum CPM no backend + módulo dinâmico no DB.
- Licença/Feature: Nenhuma.
- Dependências de outras telas: Nenhuma.
Passo a passo
- Faça login no BackOffice — você cai automaticamente em
/home. - Confira a saudação e a data corrente no topo.
- Use Ações recentes para voltar rapidamente a telas que você visitou (Usuários, Pagamentos, Saques, Compras, Tokens).
- No painel Notas, navegue entre meses com as setas, crie lembretes com Adicionar nota e edite/exclua os existentes.
Campos
A Home não tem formulário de criação principal. Os campos relevantes são os do modal de Nota:
| Campo | O que é | Obrigatório? | Efeito no sistema/backend |
|---|---|---|---|
| Data/Hora | Data e hora a que o lembrete se refere | Sim | Define dateTime da nota; a nota é agrupada e exibida no dia correspondente do calendário. Notas no mesmo dia são empilhadas (hasSameDay). |
| Descrição | Texto livre do lembrete | Sim | Grava o conteúdo exibido no card da nota (description). |
| Local | Texto opcional de localização/contexto | Não | Exibido abaixo da descrição quando preenchido (local). |
| Ocultar horário | Esconde a hora no card | Não | Quando ativo, o card não mostra a hora (hideTime). |
As notas são pessoais do operador (vinculadas ao usuário logado), persistidas via
NotesServices. Não são compartilhadas com outros operadores nem influenciam regras de negócio — são apenas lembretes.
Ações e modais
- Adicionar nota: abre o diálogo de nota em branco; ao salvar, chama
addNotee exibe snackbar de sucesso/erro. - Editar nota (ícone lápis): reabre o diálogo preenchido; salva via
updateNote. - Excluir nota (ícone cancelar): abre um bottom sheet de confirmação ("Confirmar exclusão"); ao confirmar, chama
removeNote. - Ações recentes → seta: navega para a tela correspondente (atalho de produtividade).
- Perfil do usuário (topo): permite Trocar senha e Sair.
- Modal de alertas recentes (automático): se o operador tiver o módulo
managePaymentse houver algum alerta antifraude criado nas últimas ~24h, a Home abre sozinha um modal avisando. Ao confirmar, leva para/audit-alerts; ao dispensar, fecha. Se o operador não temmanagePaymentsou não há alerta recente, nada acontece.
Regras de negócio / cuidados
Atenção
- Ações recentes é filtrada por relevância: só aparecem rotas que estão na lista de sugestões conhecidas (Home, Usuários, Pagamentos, Saques, Compras, Tokens). Outras telas visitadas não entram nessa lista.
- O aviso de alertas antifraude é silencioso em falha: se a consulta de permissões ou de alertas falhar, a Home não quebra e simplesmente não mostra o aviso. Não confie nele como única fonte de monitoramento — use a tela de Alertas de Auditoria (
/audit-alerts) diretamente. - Notas não têm efeito operacional. Não use uma nota como aprovação ou registro oficial; ela não é auditável como ação administrativa.