Configurações - Checklist de Configuração

O que é

O Checklist de Configuração é a página central de acompanhamento do quanto o sistema já está pronto para operar. Ele varre automaticamente os dados da sua empresa (cadastro da empresa, identidade visual, pagamentos, transportes, excursões, site, domínio, notificações, integrações, usuários e módulos contratados) e mostra, item a item, o que já está configurado e o que ainda precisa de ajuste.

A página é normalmente o primeiro destino de quem acabou de assinar o Viagilize e também serve como referência diária para gerentes que querem garantir que nenhum ponto crítico ficou para trás - especialmente os marcados como Essencial, que travam o funcionamento básico de vendas online. Quando o módulo de análise por IA está disponível, o checklist gera ainda uma Análise Inteligente com nota de 0 a 100, resumo executivo e recomendações classificadas como Crítico, Recomendado ou Oportunidade.

Como usar

1. Vá em Configurações > Checklist no menu lateral (ou acesse diretamente /admin/configuracoes/checklist).
2. Confira o card Progresso Geral no topo: ele mostra quantos itens estão concluídos em relação ao total, o percentual geral e uma sub-barra com o progresso específico dos itens Essenciais.
3. Se o card Análise Inteligente aparecer, clique em Iniciar Análise para receber uma nota e recomendações personalizadas geradas por IA. A análise mostra um efeito de varredura item a item e termina com a lista de recomendações já priorizadas por tipo (Crítico, Recomendado, Oportunidade).
4. Use a barra de filtros Todos, Pendentes, Concluídos e Ignorados logo acima das seções para focar no que interessa no momento.
5. Em cada seção (clique no cabeçalho para expandir/recolher), trabalhe os itens da lista:
   • Configurar - leva à página que resolve o item.
   • Ignorar por enquanto - esconde o item e o tira do cálculo de progresso. Útil para itens que não se aplicam ao seu negócio.
   • Revisar configuração - aparece em itens já marcados como Configurado e permite voltar à tela de origem para ajustar.
6. Para revisitar um item antes escondido, troque o filtro para Ignorados e use Restaurar ao lado do item - ele volta à lista ativa.
7. Repita o ciclo até o card de progresso atingir 100% e a mensagem Tudo configurado! aparecer no final da página.

Seções avaliadas

O checklist agrupa os itens nas seguintes seções, na ordem em que aparecem:

• Dados da Empresa - nome fantasia, CNPJ, endereço, telefone/WhatsApp, email de contato, horário de atendimento e redes sociais.
• Identidade Visual - logo principal, logo modo escuro, cores primária/secundária e banner da home.
• Pagamentos - meio de pagamento ativo, PIX, modo produção (não sandbox), venda online ativa e regras de reserva.
• Estrutura Operacional - transporte cadastrado, veículo cadastrado e guia cadastrado.
• Excursões - primeira excursão criada, embarques, preços, publicação, imagem de capa e descrição.
• Site e Conteúdo - template do site, páginas, FAQs, depoimentos, política de privacidade, termos de uso e política de cancelamento.
• Domínio - subdomínio funcionando, domínio customizado e SSL.
• Notificações e Integrações - email transacional, WhatsApp, email de confirmação de reserva, NPS, Google Analytics e Facebook Pixel.
• Segurança e Acesso - papéis customizados e usuários cadastrados além do proprietário.
• Módulos Contratados - itens específicos dos módulos ativos na sua empresa (Ingressos, CRM, Contratos Digitais, Hospedagem, Financeiro etc.). empresas sem módulos não veem essa seção.

Prioridades dos itens

Cada item recebe uma etiqueta colorida que indica o peso para o sistema:

• Essencial (vermelho) - obrigatório para o funcionamento básico de vendas e operação. Conta para a sub-barra de essenciais.
• Recomendado (amarelo) - melhora bastante a experiência e a conversão.
• Opcional (cinza) - extras que podem ficar para depois.

Casos especiais

Item não se aplica ao meu negócio

Itens como Veículo cadastrado não fazem sentido para quem vende só pacotes sem transporte próprio. Use Ignorar por enquanto no item específico: ele sai do cálculo de progresso e some das seções até você restaurar. Para recuperar, troque o filtro para Ignorados e clique em Restaurar.

Análise Inteligente indisponível

Quando o serviço de IA não está habilitado para você, o card Análise Inteligente simplesmente não aparece - o checklist segue funcionando normalmente com a análise determinística baseada nos dados.

Resultado em cache

Quando já existe uma análise de IA recente em cache, a página exibe o card no estado "Carregando última análise..." e busca o resultado salvo automaticamente, sem rodar uma análise nova. Para forçar uma nova rodada, clique em Reanalisar no rodapé do card.

Conclusão do checklist

Quando o progresso geral chega a 100%, aparece no fim da página o banner verde Tudo configurado! Seu sistema está totalmente configurado e pronto para uso. Isso é apenas um indicativo: itens opcionais ignorados também contam para esse 100%.

Erros comuns e como resolver

• "A análise por IA demorou mais que o esperado. Tente novamente em alguns segundos." - Causa: timeout na chamada ao serviço de IA. Solução: aguarde alguns segundos e clique em Tentar novamente no card de erro ou em Reanalisar se o resultado anterior aparecer.
• "Não foi possível gerar a análise agora. Tente novamente mais tarde." - Causa: falha genérica no serviço de IA (limite, indisponibilidade). Solução: espere alguns minutos e tente outra vez. Enquanto isso, use a lista normal de itens - ela continua funcionando sem a IA.
• "Erro ao ignorar item." / "Erro ao restaurar item." - Causa: falha de rede ou sessão expirada. Solução: recarregue a página, faça login novamente se necessário e repita a ação.

Onde encontrar

• URL: /admin/configuracoes/checklist
• Caminho no menu: Configurações > Checklist
• Permissão necessária: ver as configurações
• Módulo necessário: nenhum (a Análise Inteligente exige o serviço de IA habilitado para você)

Veja também

• Dados da Empresa
• Conhecendo o Painel Administrativo
• Configurar Pagamentos
• Logo e Identidade Visual