Pacote de Viagem - Roteiro dia-a-dia

O que é

O Roteiro é a aba onde a operadora monta o programa dia-a-dia do Pacote de Viagem - modo de excursão usado quando o cliente vai por conta própria, sem transporte fornecido pela empresa. Cada dia da viagem vira um cartão na timeline com título, cidade, descrição rica, imagem opcional, pernoite e regime de refeições.

O usuário normalmente chega aqui logo após criar a excursão com tipo Pacote de Viagem e preencher os Dados do Pacote (destino, hotel, regime). O conteúdo cadastrado aqui alimenta o site público, o PDF do roteiro para envio ao cliente e o voucher de viagem.

Como usar

1. Acesse a excursão em Excursões > Editar e abra a página de gestão do pacote em Gestão do Pacote (botão na barra de navegação superior da excursão). A aba Roteiro aparece entre Dados do Pacote e Componentes.
2. Clique em Adicionar Dia (botão azul no canto superior direito do bloco "Roteiro dia-a-dia"). Será aberto um modal com a numeração do próximo dia já preenchida.
3. Preencha os campos do dia:
   • Título (obrigatório) - frase curta que aparece no card e no PDF. Ex: "Chegada em Barcelona".
   • Cidade - exibida com ícone de pin abaixo do título.
   • Imagem do dia - upload com recorte automático em formato landscape, salvo em excursoes/{id}/roteiro no storage da sua empresa. Quando preenchida, vira capa do card e fundo do título.
   • Descrição - editor TinyMCE em português com formatação básica (negrito, itálico, listas, link, citação). O conteúdo é renderizado como HTML rico no card e no PDF.
   • Pernoite - texto livre. Ex: "Hotel Serra Azul". Exibido como badge índigo no card.
   • Regime de refeições - texto livre. Ex: "Café da manhã incluso". Exibido como badge âmbar no card.
4. Clique em Salvar. O dia é inserido ao final da timeline. A data calendário (Dia 1 · Segunda, 15/06) é calculada automaticamente a partir da data_inicio da excursão.
5. Repita para os demais dias da viagem.

Casos especiais

Editar um dia já criado

Use o botão Editar no rodapé do card. O modal abre com todos os dados preenchidos, inclusive a imagem e a descrição rica. Ao salvar, o card é atualizado na timeline sem reload da página.

Remover um dia

Clique em Remover no rodapé do card. Após a confirmação, o dia é excluído e a numeração dos dias seguintes é decrementada localmente na lista (Dia 3 vira Dia 2, etc.). A renumeração persistente exige reabrir o modal de cada dia e ajustar o campo, ou usar a função de reordenação.

Pacote sem data de início definida

Se a excursão ainda não tem data_inicio salva, o card mostra apenas "Dia 1", "Dia 2", "Dia 3" - sem o dia da semana e a data calendário. Defina a data nos Dados do Pacote para que o cálculo automático funcione.

Imagem do dia

O upload aceita JPG, JPEG, PNG e WEBP até 5 MB e usa o preset excursao_capa com recorte landscape. A imagem fica armazenada no disco tenant, isolada por excursão.

Erros comuns e como resolver

• "Esta funcionalidade e exclusiva para pacotes de viagem." - Causa: a excursão não está com tipo_excursao = 'pacote_viagem'. Solução: editar a excursão e alterar o tipo para Pacote de Viagem antes de acessar o roteiro.
• "Título é obrigatório." (toast vermelho ao tentar salvar) - Causa: o campo Título está vazio. Solução: preencher o título antes de clicar em Salvar.
• "O campo dia é obrigatório." (resposta 422 da API) - Causa: o número do dia foi removido manualmente do payload. Solução: feche e reabra o modal para que o sistema recalcule o próximo dia automaticamente.
• Imagem maior que 5 MB recusada - Causa: o validador rejeita arquivos acima de max:5120 KB. Solução: comprimir a imagem antes do upload ou usar um arquivo de resolução menor.

Onde encontrar

• URL: /admin/excursoes/{excursao}/edit (botão Gestão do Pacote leva para /admin/excursoes/{excursao}/pacote#roteiro)
• Caminho no menu: Excursões > Editar Excursão > Gestão do Pacote > Roteiro
• Permissão necessária: editar as viagens
• Módulo necessário: nenhum (o modo Pacote de Viagem faz parte do core de Excursões)

Veja também

• Excursões - Conteúdo da Excursão
• Excursões - Criar Excursão
• Excursões - Visão Geral