Primeiros Passos - Bem-vindo ao Viagilize

O que é

O Dashboard é a tela inicial do painel administrativo do Viagilize. Toda vez que um usuário faz login no admin da sua empresa, ele cai aqui (/admin/dashboard) - é o ponto de partida do dia a dia e também o primeiro contato com o sistema logo após o cadastro da empresa.

A página se adapta a quem está olhando. Quem tem permissão completa de Dashboard vê widgets de KPIs, gráficos de vendas, próximas excursões, alertas e atalhos. Quem não tem essa permissão (por exemplo, um vendedor com perfil restrito) cai em uma versão simplificada com saudação, cards coloridos de atalhos para as áreas que ele pode acessar e a indicação do papel de acesso atual. Se você estiver em modo Jornadas, o dashboard oficial passa a ser o de Jornadas e o usuário é redirecionado para lá automaticamente.

Como usar

1. Faça login pela primeira vez no subdomínio da sua empresa (ex: "empresa".viagilize.com.br/admin).
2. Observe o cabeçalho da página: à esquerda fica o título Dashboard com a frase "Visão geral do seu negócio"; à direita, o botão Personalizar (ícone de ajustes) abre o modal de organização dos widgets.
3. Use a barra de filtro de período (logo abaixo do cabeçalho) para definir a janela de dados - clique em um chip pronto (Hoje, Ontem, 7 dias, 15 dias, 30 dias, Este Mês, Mês Passado, Este Ano) ou preencha as datas de / até e clique em Filtrar.
4. Role a página para baixo. Os blocos carregam um por um conforme entram na tela (lazy-load): primeiro um "esqueleto" cinza, depois o conteúdo real. Não é travamento - é o sistema buscando dados sob demanda.
5. Para esconder, mostrar ou reordenar blocos, clique em Personalizar, use as setinhas para mover, o interruptor azul para ligar/desligar cada seção e clique em Salvar. Se quiser voltar ao layout original, use Restaurar Padrão.
6. Para iniciar a configuração da empresa, abra o menu lateral à esquerda e siga os artigos da seção Primeiros Passos na ordem sugerida em Veja também.

Casos especiais

Usuário sem permissão de ver o painel

Quando um usuário (vendedor, atendente, perfil customizado) não tem a permissão de ver o painel, o sistema substitui automaticamente o painel completo pela versão enxuta. Ele vê:

• Saudação "Olá, {primeiro nome}!" e a mensagem "Bem-vindo ao painel. Use o menu lateral para navegar."
• Cards de atalho para Excursões, Reservas, Clientes, Guias, WhatsApp e Financeiro - só aparecem os módulos que o perfil pode acessar.
• Um aviso azul no rodapé com o nome do papel de acesso e a explicação de que os atalhos refletem suas permissões.

empresa em modo Jornadas

Se a sua empresa está configurado com modo_operacao = 'jornadas', o /admin/dashboard redireciona para /admin/jornadas/dashboard (quando o usuário tem ver as jornadas). Quem não tem essa permissão vê a versão simplificada (dashboard-minimal).

Widgets que somem do painel

Cada widget tem regras de exibição combinadas:

• Permissão: ver o financeiro, ver as reservas, ver o CRM, ver os ingressos, ver os contratos, ver o WhatsApp, editar os dados da empresa em as configurações, conforme o widget.
• Módulo: blocos como CRM, Gestão Financeira, Ingressos, Contratos Digitais e WhatsApp só aparecem se o módulo correspondente estiver ativo no plano da sua empresa.
• Modo exclusivo de Experiências: oculta o widget Próximas Excursões.

Se algum bloco que você espera ver não aparece, verifique permissão do papel, ativação do módulo e, por fim, o filtro do modal Personalizar Dashboard (a seção pode estar desligada).

Período padrão e filtro por URL

Sem filtro explícito, o período carregado é Este Mês (do primeiro dia do mês atual até agora). É possível compartilhar uma visão específica com a URL - por exemplo, /admin/dashboard?periodo=hoje ou /admin/dashboard?periodo=customizado&de=2026-01-01&ate=2026-01-31.

Erros comuns e como resolver

• "Não foi possível carregar este widget." - Causa: erro ao buscar os dados de um bloco específico (timeout, query pesada, módulo recém-desativado). Solução: recarregue a página; se persistir, verifique se o módulo do widget continua ativo em Plano Atual e tente novamente em alguns minutos.
• Painel aparece "vazio" com vários esqueletos cinzas - Causa: a página depende de lazy-load via JavaScript; com JS bloqueado ou conexão muito lenta os widgets ficam em estado de carregamento. Solução: confirme que o JavaScript do navegador está ativo e que a aba está visível (o IntersectionObserver só carrega o que entra no viewport).
• Faltam os blocos financeiros (KPIs, Gráficos, Rankings) - Causa: o usuário logado não tem permissão de ver o financeiro. Solução: peça ao Proprietário/Gerente para ajustar o papel em Sistema > Usuários ou conceder a permissão necessária.
• Após ativar um módulo, o widget novo não aparece - Causa: o usuário já tinha um layout personalizado salvo e o novo widget entra como visível, mas pode ficar no final da lista. Solução: abra Personalizar, role até o fim, garanta que o interruptor esteja ligado e use as setas para reordenar.

Onde encontrar

• URL: /admin/dashboard
• Caminho no menu: Dashboard (item fixo no topo do menu lateral)
• Permissão necessária: nenhuma para acessar a página; ver o painel para enxergar widgets completos
• Módulo necessário: nenhum (widgets específicos podem exigir módulos como crm, gestao-financeira, ingressos, contratos-digitais, whatsapp-mensagens)

Veja também

• Conhecendo o Painel Administrativo
• Configurar Dados da Empresa
• Logo e Identidade Visual
• Configurar Pagamentos
• Usuários e Permissões
• Criar sua Primeira Excursão
• Próximos Passos após Configurar