Dashboard - KPIs e Métricas

O que é

A seção KPIs Principais fica no topo do Dashboard e reúne os números mais importantes da agência em cards coloridos. Cada card mostra um valor consolidado para o período selecionado na barra de filtro logo acima (padrão: Este Mês) e, quando aplicável, uma variação percentual comparada ao período anterior de mesma duração.

Você costuma chegar aqui ao abrir o admin pela manhã para conferir como o mês está fechando, depois de uma campanha para medir efeito sobre receita e reservas, ou ao trocar o período (por exemplo, Hoje ou Últimos 7 dias) para acompanhar tendências curtas.

Como usar

1. Acesse Dashboard no menu lateral (item fixo no topo). A URL canônica é /admin/dashboard.
2. Na barra branca de filtro logo abaixo do título, escolha o período clicando em um dos chips: Hoje, Ontem, 7 dias, 15 dias, 30 dias, Este Mês, Mês Passado ou Este Ano. O chip ativo fica destacado em azul.
3. Para um intervalo livre, preencha os campos de e até no canto direito da barra e clique em Filtrar.
4. Leia os cards principais (linha colorida no topo da seção KPIs):
   • Receita do Mês (verde) - soma de pagamentos confirmados e não estornados no período, ignorando passageiros cancelados. O rótulo muda conforme o período (Receita Hoje, Receita do Mês, Receita do Período, etc.).
   • Receita Hoje (turquesa) - receita confirmada apenas no dia atual, sempre fixa em "hoje" mesmo que o período selecionado seja outro.
   • Reservas do Mês (azul) - quantidade de passageiros criados no período com status confirmado ou pendente.
   • Novos Clientes (violeta) - clientes cadastrados no período.
   • Taxa de Ocupação (âmbar) - média ponderada de vagas ocupadas sobre vagas totais das excursões publicadas com data de início futura.
   • A Receber (laranja) - soma do valor pendente de todos os financeiros de passageiros ativos em excursões publicadas ou confirmadas.
5. Leia os cards secundários (linha menor branca, abaixo dos principais):
   • Confirmados - passageiros com status confirmado no período.
   • Cancelamentos - passageiros cancelados, comparando com o período anterior.
   • Ticket Médio - média do valor cobrado por reserva no período (apenas passageiros com valor maior que zero).
   • Vendas Site - reservas originadas pelo checkout público (cadastrado_via começa com checkout_).
   • Vendas Admin - reservas lançadas pela equipe no admin (cadastrado_via começa com admin_).
   • Viagens Ativas - excursões publicadas com data de início futura.
6. Quando o card exibir um selo no canto superior direito (ex.: +18% ou -7%), trata-se da variação contra o período anterior de mesma duração (se selecionou 30 dias, compara contra os 30 dias anteriores). Verde indica alta, vermelho indica queda.

Casos especiais

empresa em modo exclusivo de Experiências

Para empresas com Modo Exclusivo de Passeios/Experiências ativado, o card Taxa de Ocupação não é exibido e o card Reservas do Mês passa a se chamar Pedidos do Mês, refletindo a operação centrada em vendas de passeios em vez de excursões.

Cards de variação aparecem sem selo

Quando o período anterior teve valor zero (por exemplo, agência nova ou primeiro mês de uso), o selo de variação não aparece. Isso evita exibir percentuais distorcidos em comparações sem base.

Card "A Receber" desconsidera arquivadas

O valor de A Receber considera apenas saldos pendentes de passageiros ativos (não cancelados, não transferidos) em excursões com status publicada ou confirmada. Reservas em excursões arquivadas, canceladas ou rascunho não entram, mesmo que tenham parcelas em aberto.

Sem permissão financeira

Os cards de KPIs aparecem apenas para usuários com a permissão de ver o financeiro (Proprietário e Gerente já têm por padrão). Sem essa permissão, a seção inteira é ocultada e o Dashboard pula direto para os blocos seguintes (Alertas, Próximas Excursões, etc.). A barra de filtro de período também só aparece para quem tem ver o financeiro.

Personalizar quais seções aparecem

Use o botão Personalizar no canto superior direito do cabeçalho do Dashboard para ocultar ou reordenar a seção de KPIs. A configuração é salva por usuário.

Erros comuns e como resolver

• Receita do Mês não bate com o relatório financeiro. - Causa: o KPI considera apenas pagamentos confirmado, não estornados, e cujo passageiro NÃO esteja cancelado; pagamentos apenas registrados (sem confirmação) ficam de fora. Solução: confirme os pagamentos pendentes em Reservas > Pagamentos Aguardando ou compare com o relatório financeiro filtrado pelos mesmos critérios.
• Variação percentual surpreendente (ex.: +900%). - Causa: o período anterior teve valor muito baixo, distorcendo o cálculo. Solução: troque o filtro para um período maior (30 dias ou Este Ano) para suavizar o efeito de base baixa.
• Taxa de Ocupação fica em 0%. - Causa: nenhuma excursão publicada com data de início futura, ou todas as publicadas têm vagas_total = 0. Solução: publique novas excursões em Viagens > Excursões ou confira o lote de assentos/transportes das ativas.
• Receita Hoje continua mostrando o mesmo valor depois de confirmar um pagamento. - Causa: a resposta do widget tem cache de 30 segundos. Solução: aguarde alguns segundos e recarregue a página com F5.
• Card "Vendas Site" zerado mesmo com vendas no site. - Causa: o filtro usa o campo cadastrado_via começando com checkout_; reservas antigas anteriores à instrumentação podem não ter o valor preenchido. Solução: confira o período selecionado e considere ajustar para um intervalo posterior à entrada em produção do checkout.

Onde encontrar

• URL: /admin/dashboard
• Caminho no menu: Dashboard (item fixo, sempre visível no topo do sidebar)
• Permissão necessária: ver o painel para acessar a página e ver o financeiro para enxergar a seção de KPIs
• Módulo necessário: nenhum

Veja também

• Visão Geral do Dashboard - tour completo de todas as seções do Dashboard
• Gráficos e Análises - como ler o gráfico de Vendas dos Últimos 6 Meses e a distribuição por forma de pagamento