Experiências - Dashboard

O que é

O Dashboard de Experiências é a tela inicial de acompanhamento do módulo de passeios. Diferente da listagem (/admin/passeios), que é focada no catálogo, esta página é focada em resultado: quanto entrou no mês, quantas reservas foram feitas, qual a ocupação das sessões, o que vai acontecer hoje e quais foram as últimas vendas registradas.

O usuário normalmente chega aqui ao abrir o sistema pela manhã para conferir a operação do dia, depois de cadastrar uma experiência para confirmar que as primeiras vendas estão entrando, ou quando recebe uma cobrança via WhatsApp/voucher e precisa entender o contexto antes de abrir a tela de vendas. Todos os números mostrados se referem ao mês corrente (do dia 1 ao último dia do mês atual), exceto a tabela de Últimas Vendas e o gráfico, que usam janelas próprias.

Como usar

1. Vá em Módulos > Passeios / Experiências no sidebar e abra a URL /admin/passeios/dashboard.
2. Leia os quatro cartões de KPI no topo da página:
   • Receita do Mês - soma de valor_total das vendas com status confirmado ou usado cuja sessão acontece no mês corrente.
   • Reservas no Mês - quantidade de vendas que não estão canceladas, considerando a data da sessão.
   • Ocupação Média - média percentual de vagas_ocupadas / vagas_total das sessões do mês com vagas configuradas.
   • Ticket Médio - receita do mês dividida pelo total de reservas do mês.
3. Logo abaixo, confira a tira de Vendas por Status (Reservados, Confirmados, Utilizados, Cancelados). Esses contadores são globais (não filtram por mês) e refletem todo o histórico da sua empresa.
4. Se houver sessões hoje, o bloco Sessões de Hoje lista cada uma com horário, nome da experiência, guia (se atribuído), resumo de vagas e o status colorido (Disponível, Lotado, Cancelado, etc.). O bloco fica oculto em dias sem sessões.
5. No grid de dois blocos:
   • Vendas dos Últimos 7 Dias - gráfico de barras teal com a receita de cada dia da última semana e a quantidade de vendas. Considera todas as vendas ativas (status diferente de cancelado), pela data de criação.
   • Experiências Mais Vendidas - top 5 do mês corrente por quantidade de vendas ativas, mostrando também a receita acumulada. Clique numa linha para abrir a experiência.
6. Na base da página, a tabela Últimas Vendas mostra as 10 vendas mais recentes (ordenadas por data de criação) com data, experiência, sessão (data + horário), beneficiário, quantidade, valor e status colorido.
7. Use Ver Vendas (canto superior direito) para abrir a lista completa com filtros, ou Nova Experiência para cadastrar um novo passeio.

Casos especiais

Dashboard vazio (empresa nova)

Antes da primeira venda, os KPIs aparecem zerados, o gráfico de 7 dias fica todo no chão, o bloco de Experiências Mais Vendidas mostra o estado vazio "Nenhuma venda registrada ainda." e a tabela Últimas Vendas mostra "Nenhuma venda registrada / As vendas de experiências aparecerão aqui.". A tira de status também aparece zerada. Não há erro nessa situação - basta criar uma experiência (botão Nova Experiência) e registrar vendas para os blocos populares.

Sessões de hoje sem guia atribuído

A linha do bloco Sessões de Hoje mostra "Guia: {nome}" somente quando a sessão tem um responsável definido. Sem guia, a linha exibe apenas o nome da experiência e o horário. Para atribuir guia, abra a sessão na página de sessões da experiência.

Receita do mês x receita do gráfico

O cartão Receita do Mês considera apenas vendas em status confirmado ou usado com sessão dentro do mês - ou seja, receita "realizada". Já o gráfico de Últimos 7 Dias soma o valor_total de todas as vendas ativas criadas no período (inclusive reservadas), pela data em que a venda entrou. Os dois blocos podem divergir e isso é esperado: um mede performance financeira do mês, o outro mede ritmo recente de entrada de pedidos.

Ocupação média igual a zero

Se nenhuma sessão do mês tiver vagas_total > 0, a Ocupação Média aparece como 0%. Isso acontece em catálogos novos ou quando todas as experiências do mês foram cadastradas com capacidade ilimitada (sem controle de vagas).

Erros comuns e como resolver

• Página não abre - "Você não tem permissão para acessar esta página." - Causa: usuário sem a permissão de ver as experiências. Solução: o Proprietário ou Gerente precisa habilitar a permissão no perfil do usuário em Configurações > Perfis e Permissões.
• Página redireciona ou mostra mensagem de módulo - Causa: o módulo Passeios e Experiências (passeios-experiencias) não está ativo para você. Solução: contratar o módulo em Configurações de Cobrança.
• Top Passeios mostra valores diferentes da Receita do Mês - Causa: o ranking considera vendas ativas (qualquer status diferente de cancelado), enquanto o KPI de Receita do Mês exige status confirmado ou usado. Solução: comportamento esperado - para conciliar, abra a lista de vendas e filtre por status.
• "Sessões de Hoje" não aparece - Causa: nenhum horário ativo gerou sessão para a data de hoje. Solução: abra a página de sessões da experiência e use Gerar sessões para criar as ocorrências futuras a partir dos horários cadastrados.

Onde encontrar

• URL: /admin/passeios/dashboard
• Caminho no menu: Módulos > Passeios / Experiências (item Dashboard dentro do submenu de passeios)
• Permissão necessária: ver as experiências
• Módulo necessário: Passeios e Experiências (passeios-experiencias)

Veja também

• Experiências - Visão Geral
• Vendas de Experiências
• Criar Experiência
• Configurações Experiências