Documentação

Português

English
Español

Português

English
Español

Appearance

Lista de usuários ​

Pré-requisitos de acesso

  • Permissão (módulo): viewUsers
  • Licença/Feature: Nenhuma
  • Contêiner do menu: GERAL → grupo Usuários

O que é / quando usar ​

Tela de entrada para toda a operação de atendimento e compliance sobre a base de clientes. Lista paginada de todos os usuários cadastrados na plataforma (PF e PJ), com busca, filtros por tipo, por status do cadastro e por status da conta digital, exportação para CSV e o atalho para os Detalhes do usuário (onde ficam as ações administrativas individuais). É o ponto de partida para localizar um cliente antes de qualquer operação manual.

Pré-condições ​

  • Permissão: viewUsers cadastrado para a role do operador. Lembrar que a permissão é dupla — o enum estático E_PERMISSION_MODULES.viewUsers valida a rota no API-Gateway (CPM-UserController) e o módulo dinâmico viewUsers precisa estar associado à role no banco para a UI liberar o item de menu.
  • Licença/Feature: nenhuma. A tela aparece para qualquer tenant.
  • Dependências de outras telas: nenhuma. Esta é a tela-raiz do grupo Usuários.

Passo a passo ​

  1. Acesse o menu Usuários → Informações (/users/informations).
  2. Use o campo de busca para filtrar por nome ou e-mail (a busca dispara ~1s após parar de digitar, ou imediatamente ao pressionar Enter).
  3. Refine com os filtros Status do usuário e Status da conta digital.
  4. Clique no ícone de visualizar (olho) na linha do usuário para abrir os Detalhes.
  5. Opcional: clique em Exportar para baixar a base filtrada em CSV.

Filtros e colunas ​

Filtro / ColunaO que mostraOrigem do dado
Busca (nome ou e-mail)Filtra a listagem por trecho do nome ou e-mailnameOrEmail enviado em getUsers (CPM-UserController)
Filtro de TipoALL / sem tipo / Agentes / ParceirosFlags profile.is_agent / profile.is_partner
Status do usuárioALL, sem status, APPROVED, PENDING, REJECTED, BLOCKEDuser.status no CPM. APPROVED é a pré-condição para operações financeiras em nome do usuário
Status da conta digitalALL, APPROVED, DISAPPROVED, PROCESSING, SUSPENDED, NONEbankingAccount.fintechStatus (lido do BLS, não direto do provider)
Coluna E-mailE-mail de login do usuárioCPM
Coluna Nome completoPrimeiro + último nome (capitalizado)CPM
Coluna TipoAgente / Parceiro / Ambos / Sem tipoprofile
Coluna Status do usuárioStatus do cadastrouser.status
Coluna Conta digitalStatus do onboarding bancáriobankingAccount.fintechStatus
Ação (olho)Abre /users/informations/details?userEmail=...navegação interna

Ações e modais ​

  • Exportar (CSV): abre o modal de exportação (ExportUsersModalComponent), onde se escolhem os campos a exportar. O backend gera o arquivo via exportUserData respeitando os filtros ativos (busca, tipo, status, conta digital); o token fiduciário principal é passado para conversão de saldos. O download é entregue como URL temporária.
  • Dashboard: atalho para /users/dashboard (painel analítico de usuários).
  • Criar conta: abre o link público de signup do Midas-Web em nova aba (não cria conta pelo BackOffice).
  • Editar e-mail (na própria linha, quando disponível): abre UpdateUserEmailComponent. A troca de e-mail é uma ação sensível — só execute após validar a identidade do solicitante (ver Detalhes do usuário).

Regras de negócio / cuidados ​

Atenção

  • O status do usuário (APPROVED/PENDING/REJECTED/BLOCKED) é distinto do status da conta digital. Um usuário pode estar APPROVED na plataforma e ainda sem conta digital (NONE).
  • O status da conta digital é lido do BLS (BankManagement), não consultado direto no provider bancário. Contas que existam só no provider, sem registro no BLS, não aparecem aqui — exigem backfill (ver Auditoria → Falhas na criação de Banco Digital).
  • A paginação e os filtros são preservados ao entrar e voltar de um detalhe (a última linha acessada pisca ao retornar).
  • Valores financeiros: quando a exportação inclui saldos, eles são convertidos com base no token fiduciário principal; tratados internamente como BigNumber — confira casas decimais ao analisar o CSV.
  • Status APPROVED: lembre-se de que operações em nome do usuário (crédito/débito, alocação manual) só são permitidas quando o usuário-alvo está APPROVED — filtre por esse status antes de operar.

Telas relacionadas ​