Dashboard OTC
Pré-requisitos de acesso
- Permissão (módulo):
viewOtc - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Jornais de transações → Dashboard OTC (
/otc-dashboard)
O que é / quando usar
Visão executiva e agregada do desk de OTC: gráficos de spread (receita), volume cobrado do cliente (BRL) e entregues × falhas ao longo do tempo, mais os cards de resumo do período. É a tela para acompanhar a saúde do balcão (tendência de receita, volume e taxa de sucesso) sem entrar ordem a ordem. Para investigar uma ordem específica, use o Journal OTC.
Compartilha a mesma fonte de dados do Journal OTC (o serviço de OTC do PaymentManagementService), apenas em formato de série temporal (timeSeries) e resumo (summary).
Pré-condições
- Permissão:
viewOtc(permissão dupla — enum CPM + módulo dinâmico no DB). - Licença/Feature: nenhuma.
- Dependências de outras telas: Nenhuma. Os agregados são calculados no backend a partir das ordens de OTC.
Passo a passo
- Acesse Jornais de transações → Dashboard OTC.
- A tela abre com a janela padrão dos últimos 30 dias.
- Ajuste o período (de/até) e a granularidade com os botões Dia / Semana / Mês (
bucket). - Os gráficos e cards recarregam ao mudar a granularidade.
Filtros e elementos
| Filtro / Elemento | O que mostra / faz | Origem do dado |
|---|---|---|
| De / Até | Janela de datas (padrão: últimos 30 dias). | from / to. |
Granularidade (bucket) | Agrupa por day, week ou month. | setBucket() → timeSeries(from, to, bucket). |
| Cards de resumo | Totais do período (ordens, USDT, BRL cliente, spread, contagens de desfecho). | summary(from, to). |
| Gráfico de Spread (BRL) | Linha da receita da casa por período. | totalSpread da série. |
| Gráfico de Volume (BRL cliente) | Barras do volume cobrado dos clientes. | totalBrlClient da série. |
| Gráfico de Status (empilhado) | Entregues (verde) × Falhas (vermelho) por período. | deliveredCount / failedCount. |
Ações e modais
Esta tela é somente leitura — não há ações administrativas. Toda mutação de ordem é feita no Journal OTC.
Regras de negócio / cuidados
Atenção
- O Spread plotado é a receita da casa (delta preço-cliente × preço-provedor), agregada no período. É o mesmo conceito de spread do Journal OTC, apenas consolidado.
- A granularidade muda só a agregação dos mesmos dados; trocar de Dia para Mês não altera os totais do período, apenas o agrupamento das barras/pontos.
- A janela padrão é de 30 dias — para análises de tendência mais longas, ajuste De/Até antes de tirar conclusões.
- Valores financeiros: spread e volume vêm como strings de alta precisão e são convertidos para número apenas para plotagem. Para conferência contábil precisa, use a exportação CSV do Journal OTC.