Primeiros Passos - Conhecendo o Painel Administrativo

O que é

O painel administrativo é a área onde você gerencia toda a operação da empresa de excursões: cadastros, vendas, reservas, financeiro, marketing e configurações. Ele abre em /admin/dashboard logo após o login e se mantém com a mesma estrutura visual em todas as telas internas: um menu lateral à esquerda, um cabeçalho superior fixo e a área de conteúdo no centro.

O usuário chega aqui no primeiro acesso (após criar a conta no Viagilize) e em todos os logins seguintes. Este artigo serve como tour guiado para quem está conhecendo a interface: o objetivo é mostrar onde fica cada coisa, o que cada elemento do cabeçalho faz e como o dashboard se organiza, sem ainda entrar na configuração propriamente dita.

Como usar

1. Faça login em "empresa".viagilize.com.br/admin com o e-mail e senha do cadastro. O sistema cai em Dashboard automaticamente.
2. Olhe para o menu lateral (coluna escura à esquerda no desktop). Ele agrupa o que você pode fazer em seções: Dashboard no topo, depois Viagens (Excursões), Reservas, Cotações, Empresa, e os blocos configuráveis Cadastros, Tarefas, Vitrine, Marketing, Módulos, Relatórios. As seções com submenu mostram uma seta para a direita; clique no nome da seção para expandir/recolher.
3. No topo do menu lateral, ao lado do logotipo, use o botão de recolher para alternar entre o modo expandido (com texto) e compacto (somente ícones). A preferência fica salva no navegador. Em telas pequenas o menu vira gaveta e abre pelo ícone hambúrguer no canto superior esquerdo.
4. Observe o cabeçalho branco no topo da área de conteúdo. Da esquerda para a direita você encontra: logotipo e nome da sua empresa; botão Portal Guia; botão Acessar Site (abre o site público em nova aba); botão Modo Claro/Modo Escuro (ícone de sol/lua); busca global (lupa, atalho F3 ou Ctrl+K); badge do chatbot; sino de notificações; e o menu do usuário com a inicial do nome.
5. Clique no avatar do usuário (canto direito). O dropdown mostra Meu Perfil, eventualmente Trocar Conta (no app mobile com várias contas) e Sair.
6. Use a busca global para encontrar páginas, excursões e clientes sem navegar pelo menu. Pressione F3 ou Ctrl+K, digite o que procura e selecione o resultado.
7. Na área de conteúdo do Dashboard, role para baixo. Os blocos (widgets) carregam um a um conforme entram na tela (lazy-load) - primeiro um esqueleto cinza, depois o conteúdo real.
8. Clique em Personalizar (canto superior direito da área de conteúdo, ícone de ajustes) para escolher quais blocos exibir e em qual ordem. Use as setas para mover, o interruptor para ligar/desligar e Salvar para confirmar. Restaurar Padrão volta ao layout original.
9. Quem tem permissão financeira vê a barra de filtro de período logo abaixo do título Dashboard. Use os chips prontos (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.

Casos especiais

Blocos do dashboard que podem aparecer

Os widgets do dashboard variam conforme permissão do usuário e módulos ativos no plano. Os principais são:

• KPIs Principais - indicadores de vendas e ocupação (requer ver o financeiro).
• Alertas - avisos operacionais que precisam de atenção.
• CRM - pipeline e leads (módulo crm).
• Gestão Financeira - saldo e movimentação (módulo gestao-financeira + ver o financeiro).
• Ingressos, Contratos Digitais, WhatsApp - resumos dos respectivos módulos quando ativos.
• Gráficos de Vendas - evolução mensal e por forma de pagamento.
• Últimas Vendas e Clientes - atividade recente (requer ver as reservas).
• Analytics - Rankings - destaques de vendas (requer ver o financeiro).
• Próximas Excursões - agenda da operação (requer ver as viagens; oculto em modo exclusivo de Experiências).
• Atividade Recente - log de mudanças (requer editar os dados da empresa em as configurações).
• Recursos do Sistema - uso de cota do plano.
• Ações Rápidas - atalhos para tarefas comuns.

Usuário sem permissão de ver o painel

Quem não tem essa permissão (por exemplo, um vendedor com perfil restrito) vê uma versão simplificada do dashboard: uma saudação "Olá, {primeiro nome}!", cards coloridos de atalho apenas para os módulos que o perfil pode acessar (Excursões, Reservas, Clientes, Guias, WhatsApp, Financeiro) e um aviso azul com o nome do papel de acesso. O menu lateral também é filtrado pelas permissões do papel, então os usuários só veem os itens aos quais têm acesso.

Sidebar recolhida com tooltips

No modo compacto (sidebar recolhida), passar o mouse sobre um ícone abre um tooltip flutuante com o nome do item e seu submenu, permitindo navegar sem expandir a coluna inteira. Útil para quem tem tela pequena ou prefere mais espaço para o conteúdo.

Temas do menu lateral

O sidebar tem múltiplos temas visuais (Grafite, Indigo Profundo, Slate, Esmeralda, Roxo, Azul Claro, Verde Claro, Branco), além de cor de destaque e densidade (compacto/normal). Tudo é configurado em Sistema > Menu pelo Proprietário/Gerente - não afeta dados, só a aparência.

empresa em modo Jornadas

Quando a sua empresa está com modo_operacao = 'jornadas', o /admin/dashboard redireciona para /admin/jornadas/dashboard automaticamente (se o usuário tiver ver as jornadas). Quem não tem essa permissão cai na versão simplificada.

Erros comuns e como resolver

• "Não foi possível carregar este widget." - Causa: erro ao buscar dados de um bloco (timeout, query pesada, módulo recém-desativado). Solução: recarregue a página; se persistir, verifique se o módulo continua ativo em Plano Atual.
• Painel aparece "vazio" com vários esqueletos cinzas - Causa: o lazy-load depende de JavaScript e do IntersectionObserver. Com JS bloqueado ou conexão muito lenta os blocos ficam em loading. Solução: confirme JS ativo e mantenha a aba visível enquanto rola a página.
• Não vejo um item esperado no menu lateral - Causa: o item pode estar oculto por permissão (o papel não tem acesso), por módulo não contratado, ou foi escondido em Sistema > Menu. Solução: cheque seu papel em Meu Perfil, peça revisão de permissões ao Proprietário ou verifique a configuração do menu.
• A busca global (F3/Ctrl+K) não acha o que procuro - Causa: o termo pode estar incompleto ou em outro idioma. Solução: digite por partes do nome (cliente por CPF, excursão por destino), tente sinônimos ou navegue pelo menu lateral.

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 os 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

• Bem-vindo ao Viagilize
• Configurar Dados da Empresa
• Logo e Identidade Visual
• Usuários e Permissões
• Criar sua Primeira Excursão