Skip to content

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: viewUsers na 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

  1. Acesse o menu Dashboard → Usuários.
  2. Aguarde o carregamento dos cartões e gráficos.
  3. (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 / FiltroO que mostraOrigem do dado
Quantidade de usuáriosTotal de cadastrosusers.length
Quantidade de empresasContas com account_type == '1' (PJ)filtro
Número de pessoasContas com account_type == '0' (PF)filtro
Brasileiros / EstrangeirosSem passaporte = brasileiro; com passaporte = estrangeiropresença do campo passport
Com conta digitalUsuários com bankingAccountfiltro
Tipo de conta (pizza)PJ × PFtotais
Nacionalidades (pizza)Brasileira × Estrangeiratotais
Cadastros mensais (barras)Total por mês de cadastroagrupamento por mês do campo when
Data inicial / Data finalIntervalo para a consulta de cadastros por períodoenviadas 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 passport preenchido, 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.

Telas relacionadas