Saques (Dashboard)
Pré-requisitos de acesso
- Permissão (módulo):
viewWithdrawals - Licença/Feature: Nenhuma.
- Contêiner do menu: GERAL → grupo Dashboard
O que é / quando usar
Painel analítico (somente leitura) das solicitações de saque. Consolida quantidade e valor sacado, segmentados pelo destino do recurso: Banco Digital (transferência interna fiat), Conta Externa (saque fiat para banco externo) e Crypto (saque on-chain). Use para acompanhar a saída de recursos e o mix de canais de saque.
Pré-condições
- Permissão:
viewWithdrawalsna role (permissão dupla — enum CPM + módulo no DB). - Licença/Feature: Nenhuma.
- Dependências de outras telas: Reflete o histórico de solicitações de saque (
DepositsService.getAllWithdrawalRequest).
Passo a passo
- Acesse o menu Dashboard → Saques.
- Aguarde o carregamento.
- Leia os cartões por destino e os gráficos.
Filtros e colunas
Tela de visualização — sem campos editáveis. Indicadores:
| Indicador / Gráfico | O que mostra | Origem do dado |
|---|---|---|
| Quantidade de retirada | Total de solicitações de saque | withdrawalList.length |
| Total retirado (valor) | Soma de todos os amount | agregação em BigNumber |
| Banco Digital | Quantidade e total dos saques type == INTERNAL_FIAT | filtro por tipo |
| Conta Externa | Quantidade e total dos saques type == FIAT | filtro por tipo |
| Crypto | Quantidade e total dos saques type == BTC (saque on-chain) | filtro por tipo |
| Tipo de saque (pizza) | Distribuição entre os três destinos | totais por tipo |
| Histórico (barras) | Total por mês | agrupamento por mês do campo when |
Regras de negócio / cuidados
Atenção
- Os três destinos são definidos pelo
typeda solicitação:INTERNAL_FIAT= Banco Digital,FIAT= Conta Externa,BTC= Crypto/on-chain. Tipos fora desses três não aparecem em nenhum dos cartões segmentados (só no total geral). - Pré-condição de saque (regra de negócio do fluxo real): um saque só é processável se o usuário tiver, em moeda fiduciária, o valor necessário; o valor mínimo pode não existir ou variar conforme a configuração do tenant. Este painel apenas reflete os saques já solicitados — a operação e a aprovação ficam em Gerenciar saques.
- Erro ≠ zero: página de erro indica indisponibilidade do serviço de saques.
- Valores financeiros: os totais somam
amountcomBigNumberantes de plotar.