Dashboard de Faturamento
O Dashboard de Faturamento centraliza os dados de vendas do tenant ativo em KPIs animados e gráficos interativos. Todos os números reagem imediatamente a qualquer alteração de filtro.
Filtros
O painel de filtros fica no topo da página e pode ser recolhido clicando na seta à direita do título "Filtros".
Período
Botões de atalho para os intervalos mais comuns:
| Botão | Intervalo |
|---|---|
| Hoje | Data atual (00:00 → 23:59) |
| Ontem | Dia anterior completo |
| 7 Dias | Semana corrente (segunda → hoje) |
| Este Mês | 1º ao último dia do mês atual |
| Mês Anterior | Mês anterior completo |
| Este Ano | 1º de janeiro → 31 de dezembro do ano atual |
| Ano Anterior | Ano calendário anterior completo |
| Todos | Sem restrição de data |
Para um intervalo livre, preencha os campos De e Até e clique em Aplicar. Ao digitar qualquer data nos campos, o sistema automaticamente muda o filtro ativo para "Personalizado".
Empresa e Cidade
Dois selects populados dinamicamente com as empresas e cidades presentes nos dados do tenant. Selecionar "Todas" (valor padrão) não aplica restrição.
Os filtros de Empresa e Cidade são cumulativos com o filtro de período.
Persistência: os filtros selecionados são salvos automaticamente no
localStoragedo navegador. Na próxima vez que o usuário abrir a página, os filtros são restaurados exatamente como estavam.
KPIs
Oito indicadores exibidos em dois grupos de quatro cards. Os valores são animados (contagem progressiva) ao carregar ou ao trocar de filtro.
Linha 1 — Visão geral
| Indicador | O que representa |
|---|---|
| Total de Registros | Quantidade de notas/registros no período filtrado |
| Fat. Bruto | Soma do faturamento antes de descontos |
| Fat. Líquido | Faturamento bruto menos descontos |
| Ticket Médio | Fat. líquido ÷ total de registros |
Linha 2 — Composição do faturamento
| Indicador | O que representa |
|---|---|
| Valor à Vista | Total pago à vista; exibe % sobre o fat. líquido |
| Valor a Prazo | Total parcelado/prazo; exibe % sobre o fat. líquido |
| Descontos | Total de descontos concedidos; exibe % sobre o fat. bruto |
| Empresas Únicas | Quantidade de empresas distintas; exibe média de registros/empresa |
Gráficos
Formas de Pagamento
Dois gráficos lado a lado com os mesmos dados, em visualizações complementares:
- Barras — comparação direta entre formas de pagamento por valor total.
- Pizza — proporção de cada forma sobre o total; cada fatia exibe nome e percentual.
Evolução Mensal de Faturamento
Gráfico de linhas com dois indicadores no mesmo eixo:
- Faturamento Bruto (linha verde)
- Faturamento Líquido (linha azul)
O período exibido segue o filtro ativo. Quando o filtro é "Todos", o sistema usa o ano corrente como referência para o eixo mensal.
Vista vs Prazo
Pizza com dois segmentos — À Vista (verde) e A Prazo (azul) — com percentual de cada um sobre o total líquido.
Top 5 Empresas
Gráfico de barras horizontais com as 5 empresas de maior faturamento no período filtrado. Os nomes das empresas aparecem no eixo X em diagonal.
O sistema busca os top 10 empresas e exibe apenas as 5 primeiras no gráfico.
Valor Líquido por Ano (drill-down)
Gráfico de barras com um ponto por ano. Ao clicar em uma barra, o gráfico detalha os meses daquele ano. Um botão "Voltar para Anos" retorna à visão anual.
O filtro de empresa e cidade se aplica também a este gráfico.
Atualização manual
O botão Atualizar (ícone de refresh) no cabeçalho da página e o botão Atualizar dentro do painel de filtros disparam nova busca com os filtros atuais. Erros de carregamento são exibidos como notificações (toast) no canto superior direito.
Estados de carregamento
Enquanto os dados são buscados, os cards exibem esqueletos (blocos cinzas animados) no lugar dos valores. Os gráficos exibem a mensagem "Nenhum dado disponível" quando não há registros para os filtros selecionados.