Dashboard - Gráficos e Análises

O que é

A seção Gráficos de Vendas ocupa a faixa central do Dashboard administrativo e reúne, lado a lado, dois painéis visuais: o gráfico Vendas dos Últimos 6 Meses (à esquerda, ocupando dois terços da largura) e o cartão Formas de Pagamento (à direita). Juntos, eles respondem duas perguntas que aparecem todo dia na operação: "estou vendendo mais ou menos do que nos meses anteriores?" e "por onde meus clientes estão pagando agora?".

O bloco é carregado de forma assíncrona (lazy-load) assim que entra no campo de visão, exige a permissão de ver o financeiro e usa Chart.js para renderizar o gráfico misto de barras e linha. Os dados do cartão Formas de Pagamento respeitam o filtro de período do cabeçalho; já o gráfico de 6 meses tem janela fixa (sempre os 6 meses anteriores ao mês corrente, inclusive).

Como usar

1. Acesse Dashboard no topo do menu lateral (URL /admin/dashboard).
2. Role até a seção Gráficos de Vendas, logo abaixo dos KPIs e antes de Próximas Excursões.
3. No painel Vendas dos Últimos 6 Meses, identifique cada série pela legenda no canto superior direito do gráfico:
   • Barras verdes (Receita) - eixo esquerdo, em reais; valores acima de mil aparecem abreviados (ex.: R$ 12k).
   • Linha azul (Reservas) - eixo direito, em quantidade; incremento mínimo de 1 unidade.
4. Passe o mouse sobre qualquer mês para abrir o tooltip com a receita formatada em reais e o número de reservas daquele mês.
5. No cartão Formas de Pagamento, leia cada linha como uma fatia do total: o bolinho colorido à esquerda identifica a forma, o valor à direita é o total recebido no período e a barra de progresso abaixo mostra o percentual sobre o total.
6. Para alterar o período do cartão Formas de Pagamento, use o filtro de período no cabeçalho do Dashboard (opções como Hoje, Este mês, Últimos 30 dias, Este trimestre e Customizado). O gráfico de 6 meses não é afetado pelo filtro.

Casos especiais

Cartão Formas de Pagamento sem dados

Se nenhum pagamento confirmado foi registrado no período selecionado, o cartão exibe um ícone de cartão de crédito cinza com a mensagem "Nenhum pagamento este mês". Amplie o período no filtro do cabeçalho (por exemplo, Últimos 90 dias) para confirmar se há pagamentos antigos ou se a forma de pagamento ainda não está em uso.

Gráfico de 6 meses sem barras

Quando você é novo e ainda não há receita nos meses anteriores, o gráfico aparece com o eixo desenhado mas sem barras visíveis. Não é erro: assim que a primeira receita confirmada entrar, ela aparece no mês corrente já no próximo carregamento da página.

Cores fixas das formas de pagamento

As cores do cartão Formas de Pagamento são fixas e não dependem do tema da empresa:

• PIX - verde
• Dinheiro - laranja
• Crédito - azul
• Débito - roxo
• Boleto - cinza
• Transferência - ciano
• Link - rosa

Formas de pagamento não previstas no mapa caem em cinza neutro com o nome capitalizado vindo do banco.

Seção oculta no painel

Se a seção Gráficos de Vendas não aparece, abra a engrenagem Configurar Dashboard no canto superior direito do painel e confirme que Gráficos de Vendas está marcada como visível. O bloco também é ocultado automaticamente para usuários sem a permissão de ver o financeiro.

Erros comuns e como resolver

• "Erro ao carregar widget." - Causa: falha temporária na consulta ao banco (timeout, conexão derrubada). Solução: recarregar a página (F5); se persistir, abrir um chamado em Suporte anotando o horário aproximado.
• Cartão Formas de Pagamento vazio mesmo com vendas no mês - Causa: as vendas foram lançadas como pendentes ou estão estornadas, e o cartão considera apenas pagamentos com status Confirmado e não estornados. Solução: ir em Reservas e confirmar manualmente os pagamentos pendentes.
• Gráfico de 6 meses fica em branco depois de trocar o tema (claro/escuro) - Causa: o Chart.js já foi inicializado com as cores do tema anterior. Solução: recarregar a página (F5) para reaplicar as cores corretas de grade e legenda.

Onde encontrar

• URL: /admin/dashboard
• Caminho no menu: Dashboard (primeiro item do menu lateral)
• Permissão necessária: ver o financeiro
• Módulo necessário: nenhum

Veja também

• Visão Geral do Dashboard
• KPIs e Métricas do Dashboard