Pagamentos manuais (Dashboard)
Pré-requisitos de acesso
- Permissão (módulo):
viewPayments - Licença/Feature: Nenhuma.
- Contêiner do menu: GERAL → grupo Dashboard
O que é / quando usar
Painel analítico (somente leitura) do fluxo de pagamentos/depósitos manuais — aqueles em que o cliente paga por PIX ou TED para comprar Tokens ou NFTs. Use para acompanhar volume e ticket de depósitos manuais e a divisão entre meios de pagamento e tipos de ativo adquirido.
Pré-condições
- Permissão:
viewPaymentscadastrado para a role do operador (permissão dupla — enum CPM no backend + módulo dinâmico no DB). - Licença/Feature: Nenhuma.
- Dependências de outras telas: Os dados vêm dos pagamentos processados; o painel reflete o que já existe no histórico de depósitos.
Passo a passo
- Acesse o menu Dashboard → Pagamentos manuais.
- Aguarde o carregamento (o painel busca o resumo via
DepositsService.getDepositsDashboard). - Leia os cartões-resumo e os gráficos abaixo.
Filtros e colunas
Esta é uma tela de visualização — não há filtros nem campos editáveis. Os indicadores são:
| Indicador / Gráfico | O que mostra | Origem do dado |
|---|---|---|
| Quantidade de pagamentos | Total de depósitos manuais no período | summary do endpoint de dashboard de depósitos (FMS-PaymentController) |
| Quantidade de compra de Tokens / NFTs | Quantos depósitos resultaram em compra de Token vs NFT | totalTokenBuy / totalNFTBuy |
| Total em Tokens / NFTs | Valor agregado por tipo de ativo | summary |
| Total de pagamentos | Valor total depositado | summary |
| Tipo de pagamento (pizza) | Proporção PIX × TED | totalPix / totalTED |
| Tokens vs NFT (pizza) | Proporção de compras Token × NFT | totalTokenBuy / totalNFTBuy |
| Histórico de pagamentos (barras) | Total por mês, ordenado cronologicamente | paymentHistory, agrupado por mês de criação |
Regras de negócio / cuidados
Atenção
- Quando há um único mês de histórico, o painel injeta um ponto de valor zero no mês anterior só para o gráfico ter linha de base — é um artifício de exibição, não um pagamento real.
- Erro ≠ zero: se a consulta falhar, o painel mostra página de erro. Isso indica indisponibilidade do serviço, não ausência de pagamentos.
- Valores financeiros: os totais são derivados de valores monetários (
BigNumberno backend); o painel os converte para gráfico. Use como visão analítica, não como fechamento contábil.