Usuários (Dashboard)
Pré-requisitos de acesso
- Permissão (módulo):
viewUsers - Licença/Feature: Nenhuma.
- Contêiner do menu: GERAL → grupo Dashboard
O que é / quando usar
Painel analítico (somente leitura) da base de usuários. Mostra o total de cadastros e a composição da base por tipo de conta (Pessoa Jurídica × Pessoa Física), nacionalidade (Brasileiros × Estrangeiros) e quantos têm conta digital (banking). Inclui também uma consulta de cadastros por período. Use para acompanhar crescimento da base e perfil dos clientes.
Pré-condições
- Permissão:
viewUsersna role (permissão dupla — enum CPM + módulo no DB). - Licença/Feature: Nenhuma.
- Dependências de outras telas: Carrega a lista de usuários (
AccountService.getUsers).
Passo a passo
- Acesse o menu Dashboard → Usuários.
- Aguarde o carregamento dos cartões e gráficos.
- (Opcional) Defina data inicial e data final e clique em Pesquisar para ver a quantidade de cadastros no período (total, brasileiros, estrangeiros).
Filtros e colunas
| Indicador / Gráfico / Filtro | O que mostra | Origem do dado |
|---|---|---|
| Quantidade de usuários | Total de cadastros | users.length |
| Quantidade de empresas | Contas com account_type == '1' (PJ) | filtro |
| Número de pessoas | Contas com account_type == '0' (PF) | filtro |
| Brasileiros / Estrangeiros | Sem passaporte = brasileiro; com passaporte = estrangeiro | presença do campo passport |
| Com conta digital | Usuários com bankingAccount | filtro |
| Tipo de conta (pizza) | PJ × PF | totais |
| Nacionalidades (pizza) | Brasileira × Estrangeira | totais |
| Cadastros mensais (barras) | Total por mês de cadastro | agrupamento por mês do campo when |
| Data inicial / Data final | Intervalo para a consulta de cadastros por período | enviadas ao getQtyUsersByPeriod (CPM-UserController); o botão Pesquisar fica desabilitado se a data inicial for maior que a final |
Regras de negócio / cuidados
Atenção
- Nacionalidade é inferida pelo passaporte: o painel considera "estrangeiro" todo usuário que tem
passportpreenchido, e "brasileiro" os demais. Não é um campo explícito de nacionalidade. - Validação do filtro de período: o botão Pesquisar é bloqueado quando a data inicial é posterior à final.
- Erro ≠ zero: página de erro indica falha na leitura da base de usuários, não base vazia.