Dashboard - Visão Geral

O que é

O Dashboard é a tela inicial do painel administrativo do Viagilize. Logo após o login, o usuário cai aqui e encontra uma visão consolidada do negócio: indicadores financeiros, alertas operacionais, gráficos de vendas, próximas excursões, atividade recente do sistema, atalhos rápidos e cards específicos dos módulos contratados (CRM, Gestão Financeira, Ingressos, Contratos Digitais e WhatsApp).

A tela é montada por seções independentes que carregam sob demanda quando entram no campo de visão. Cada usuário pode reordenar e ocultar essas seções, e quem tem acesso a dados financeiros também pode filtrar o período usado nos KPIs e gráficos. Em empresas no modo Jornadas, o Dashboard padrão é substituído pelo Dashboard de Jornadas; em empresas sem a permissão de ver o painel, uma versão simplificada é exibida.

Como usar

1. Faça login no admin - você cai direto em Dashboard (URL /admin/dashboard).
2. Use a barra de filtro de período logo abaixo do header para escolher o intervalo dos KPIs e gráficos. Os atalhos disponíveis são Hoje, Ontem, 7 dias, 15 dias, 30 dias, Este Mês, Mês Passado e Este Ano. Para um intervalo customizado, preencha os campos de data de / até e clique em Filtrar.
3. Role a página para carregar as seções; cada bloco mostra um esqueleto animado enquanto busca os dados.
4. Para reorganizar a tela, clique em Personalizar (canto superior direito). No modal que abrir:
   • Use as setas para cima/baixo de cada item para mudar a ordem.
   • Use o toggle azul à direita para mostrar ou ocultar a seção.
   • Clique em Restaurar Padrão se quiser voltar à configuração inicial.
   • Clique em Salvar para gravar a configuração no seu usuário.

Seções disponíveis no Dashboard padrão

• KPIs Principais - cards consolidados de receita, reservas, clientes, ocupação e a receber (requer permissão de ver o financeiro).
• Alertas - pendências que exigem ação (pagamentos, reservas, ocupação).
• CRM - pipeline de oportunidades (módulo crm).
• Gestão Financeira - receitas, despesas e contas (módulo gestao-financeira, permissão de ver o financeiro).
• Ingressos - vendas e agendamentos (módulo ingressos).
• Contratos Digitais - taxa de aceite e pendências (módulo contratos-digitais).
• WhatsApp - mensagens enviadas e taxa de entrega (módulo whatsapp-mensagens).
• Gráficos de Vendas - vendas mensais e formas de pagamento (requer ver o financeiro).
• Últimas Vendas e Clientes - listas curtas dos cinco itens mais recentes (requer ver as reservas).
• Analytics - Rankings - top excursões, vendedores e canais (requer ver o financeiro).
• Próximas Excursões - partidas mais próximas com ocupação (requer ver as viagens, oculto em modo exclusivo de experiências).
• Atividade Recente - últimas reservas e pagamentos (requer editar os dados da empresa em as configurações).
• Recursos do Sistema - status de uso dos limites do plano (requer ver as configurações).
• Ações Rápidas - atalhos para criar excursão, cliente, etc.

Casos especiais

empresa em modo Jornadas

Quando a sua empresa está com modo_operacao = jornadas, o acesso a /admin/dashboard redireciona automaticamente para o Dashboard de Jornadas (se o usuário tiver ver as jornadas). Caso contrário, é exibida a versão simplificada admin.dashboard-minimal.

Usuário sem permissão de ver o painel

Quem não tem a permissão de ver o painel é levado para o Dashboard mínimo, sem KPIs nem widgets analíticos. Ajuste as permissões em Configurações > Usuários para liberar a visão completa.

Modo exclusivo de experiências

Se você estiver com passeios_modo_exclusivo ativo, a seção Próximas Excursões é removida automaticamente da lista padrão e da configuração salva - o foco passa a ser os widgets de passeios/experiências.

Widget oculto por permissão ou módulo

Cada widget só renderiza se o usuário tiver a permissão exigida e você tiver o módulo correspondente ativo. Quando a permissão falha ou o serviço retorna erro, o widget responde sem conteúdo (HTTP 204) e some da tela em vez de mostrar dados parciais.

Cache dos widgets sob impersonação

Fora de impersonação, cada widget é cacheado por 30 segundos no navegador para acelerar refresh. Quando o Super Admin está impersonando, o cache é desligado (no-store) para refletir imediatamente trocas de usuário/modo de operação.

Erros comuns e como resolver

• "Não foi possível carregar este widget." - Mensagem cinza no lugar do card. Causa: falha de rede ao buscar o widget. Solução: recarregar a página (F5); se persistir, verificar logs do servidor.
• "Erro ao carregar widget." - Mensagem vermelha dentro do card. Causa: exceção no service que monta os dados (registro fica em Log::warning('[Dashboard widget] erro ao carregar dados')). Solução: reportar ao suporte com o slug do widget que falhou.
• Filtro de período não aparece - Causa: o usuário não tem permissão de ver o financeiro. Solução: solicitar a permissão ou usar o período padrão (este mês).
• Modal "Personalizar Dashboard" volta vazio depois de salvar - Causa: payload de seções com slug ou visible ausente é recusado pela validação do updateDashboardConfig. Solução: clicar em Restaurar Padrão e salvar novamente.

Onde encontrar

• URL: /admin/dashboard
• Caminho no menu: Dashboard (item fixo, sempre no topo do sidebar)
• Permissão necessária: ver o painel (sem ela, abre versão simplificada)
• Módulo necessário: nenhum para a tela; widgets específicos exigem seus próprios módulos (crm, gestao-financeira, ingressos, contratos-digitais, whatsapp-mensagens)

Veja também

• KPIs e Métricas do Dashboard - como cada indicador é calculado.
• Gráficos e Análises - leitura dos gráficos de vendas e formas de pagamento.
• Alertas e Notificações - significado e ação recomendada para cada alerta.
• Ações Rápidas e Atalhos - atalhos diretos para criar excursão, cliente e mais.