Excursões - Checklist de Embarque

O que é

O Checklist de Embarque é a tela central do dia da viagem. Reúne em um só lugar a lista completa de passageiros confirmados e pendentes, agrupada por transporte e, dentro de cada transporte, por ponto de embarque. No topo, sete cartões de estatísticas mostram a saúde geral da operação (total, aptos, pendências, check-in OK, aguardando, check-out OK e percentual de presentes). A página é o complemento administrativo do app do guia: enquanto o guia registra check-ins no campo (QR Code ou manual), o operador acompanha em tempo real do escritório.

O usuário normalmente chega aqui na véspera (para conferir lista e resolver pendências) e no próprio dia da viagem (para monitorar o embarque ao vivo, atender exceções e exportar a lista final). A página serve apenas para passageiros com status confirmado ou pendente - cancelados não entram na contagem nem na lista.

Como usar

1. Vá em Viagens (Excursões) no sidebar, abra a excursão desejada e clique em Checklist na barra de navegação interna da excursão. A URL fica /admin/excursoes/{excursao}/checklist.

2. Confira os sete cards de estatísticas gerais no topo:

   • Total - passageiros confirmados ou pendentes.
   • Aptos - sem pendências bloqueantes (contrato, documento, pagamento).
   • Pendências - passageiros com ao menos uma pendência aberta.
   • Check-in OK - já embarcaram.
   • Aguardando - ainda não embarcaram.
   • Check-out OK - já desembarcaram.
   • Presentes - percentual de check-ins sobre o total.

3. Use a barra de filtros branca logo abaixo dos cards:

   • Buscar por nome, CPF, telefone… - campo de texto livre.
   • Todos embarques - restringe a um ponto de embarque específico.
   • Todos status - Check-in Pendente, Check-in OK, Check-out Pendente ou Check-out OK.
   • Todas pendências - Sem contrato assinado, Documentos pendentes, Pagamento pendente, Somente convidados, Somente dependentes. As opções de contrato e documentos só aparecem quando a excursão realmente exige cada uma delas.

4. Percorra a lista por transporte: cada bloco mostra o nome do transporte, placa do veículo (clicável para abrir detalhes), guias designados (clicáveis), contador X/Y check-in em verde e X/Y check-out em roxo. Dentro do bloco, os passageiros aparecem agrupados por ponto de embarque, na ordem configurada em Pontos de Embarque.

5. Acompanhe em tempo real clicando em Ver ao Vivo (botão verde no canto superior direito). O botão só aparece de véspera até um dia após a viagem. Enquanto ativo, a página faz polling no endpoint /checklist/live e exibe toasts a cada novo check-in. Para encerrar, clique em Parar (o mesmo botão fica vermelho com indicador pulsante).

6. Veja os detalhes de um check-in ou check-out clicando no horário verde (check-in) ou roxo (check-out) ao lado do passageiro. O modal mostra data/hora, embarque, método (Manual ou QR Code), operador que registrou, dispositivo, IP e - quando há GPS - o link para o Google Maps. A partir desse modal é possível clicar em Cancelar Registro, informar um motivo (até 500 caracteres) e confirmar.

7. Exporte a lista clicando em Exportar Lista (botão índigo no cabeçalho). O modal permite escolher os campos, formato (PDF, Excel ou CSV), ordenação, agrupamento, filtros de status, formatação do nome, inclusão de guias, mapa de assentos e rooming. É possível salvar a configuração em um dos perfis (Empresa, Guia ou Seguradora) ou gerar um link público válido por 24 horas para compartilhar a exportação.

8. Abra o mapa clicando em Ver no Mapa (botão verde, visível somente quando já existe pelo menos um check-in) para visualizar os pontos GPS dos check-ins registrados pelo guia.

Casos especiais

Excursão com mais de um transporte

Cada transporte vira um bloco separado, com nome, veículo, guias e seus próprios contadores X/Y check-in e X/Y check-out. Os cards de estatísticas no topo somam todos os transportes.

Passageiro com pendência (contrato, documento ou pagamento)

A linha do passageiro destaca a pendência e o filtro Todas pendências ajuda a isolar quem ainda não está apto. A pendência não bloqueia o registro de check-in - fica a critério do operador liberar o embarque. Para resolver antes, use os atalhos da linha (Enviar Contrato, Cartão de Embarque, abrir o passageiro para edição).

Botão "Ver ao Vivo" não aparece

A janela de monitoramento ao vivo é de um dia antes a um dia depois da data de início da excursão. Fora desse intervalo o botão é ocultado. Para inspecionar histórico após o evento, use o Mapa de Check-ins ou abra cada passageiro individualmente.

Botão "Ver no Mapa" não aparece

O botão só é exibido depois que pelo menos um check-in foi registrado (com ou sem GPS). Antes do primeiro embarque, a página não mostra o atalho - abra Mapa de Check-ins a partir da URL direta se precisar.

Excursão sem ponto de embarque definido

Passageiros sem embarque_id aparecem em um grupo final chamado Sem embarque definido. Recomenda-se voltar a Pontos de Embarque e vincular cada passageiro antes do dia da viagem.

Compartilhar a exportação com terceiros

Em vez de baixar e reenviar o arquivo, use Gerar link dentro do modal de Exportar Lista. O sistema cria um token público (cache de 24h) que pode ser enviado a guias, motoristas ou parceiros - o link regenera o arquivo no momento do acesso.

Erros comuns e como resolver

• "Este passageiro já fez check-in." - Causa: tentou registrar check-in mais de uma vez para o mesmo passageiro. Solução: abra os detalhes do registro existente; se foi engano, clique em Cancelar Registro.

• "Este passageiro precisa fazer check-in primeiro." - Causa: tentou registrar check-out antes do check-in. Solução: registre o check-in primeiro e só então o check-out.

• "Este passageiro já fez check-out." - Causa: check-out duplicado. Solução: abra o modal de detalhes do check-out e cancele o registro anterior se for engano.

• "Não é possível cancelar o check-in porque existe um check-out ativo. Cancele o check-out primeiro." - Causa: ordem incorreta de cancelamento. Solução: clique no horário roxo (check-out) do passageiro, cancele esse registro e depois cancele o check-in.

• "Check-in não pertence a esta excursão." - Causa: tentou cancelar um registro vinculado a outra excursão (link antigo, URL manipulada). Solução: volte para o checklist da excursão correta.

• "Selecione pelo menos um campo para exportar." ou "Nenhum campo válido selecionado." - Causa: o modal de Exportar Lista foi enviado sem campos marcados. Solução: marque ao menos uma coluna em "Dados do Passageiro", "Viagem", "Status", "Financeiro" ou "Reserva".

• "Formato inválido." - Causa: parâmetro de formato fora do conjunto permitido. Solução: escolha PDF, Excel ou CSV no modal de exportação.

• "Este link de exportação expirou ou é inválido." - Causa: o link público gerado tem validade de 24 horas. Solução: gere um novo link pelo botão Exportar Lista > Gerar link.

Onde encontrar

• URL: /admin/excursoes/{excursao}/checklist
• Caminho no menu: Viagens (Excursões) > abrir a excursão > Checklist
• Permissão necessária: ver as viagens
• Módulo necessário: nenhum (núcleo do produto)

Veja também

• Check-in de Passageiros
• Mapa de Check-ins
• Gerenciar Passageiros
• Pontos de Embarque
• Gerenciar Transportes