Hospedagem - Relatório de Ocupacao

O que é

O Relatório de Ocupacao e uma tela do módulo de Hospedagem que mostra, em uma única visao, quantos quartos estao ocupados em cada excursão que tem hospedagem vinculada. Ele cruza os quartos cadastrados em ExcursaoHospedaria com os passageiros alocados em cada quarto e calcula a taxa de ocupacao por excursão e o total geral.

O operacional costuma chegar nesta página para acompanhar quantos lugares ainda restam nas hospedagens das proximas excursões e para descobrir onde ha quartos parcialmente vazios que poderiam ser remanejados. A página não analisa noites em uma hospedaria fora do contexto de uma excursão - toda a contagem e por excursão.

Como usar

1. No menu lateral, expanda Hospedagem e clique em Ocupacao.
   • URL direta: /admin/hospedagem/relatorios/ocupacao.
2. Use os filtros no topo para focar a analise:
   • Período - Proximas excursoes (padrão, data_inicio >= hoje), Excursoes passadas (data_inicio < hoje) ou Todas.
   • Hospedagem - limita o relatório a uma hospedaria especifica. Deixe vazio para ver todas.
3. O formulario aplica os filtros automaticamente (sem botao Aplicar) assim que você muda um dos selects.
4. Leia os quatro KPIs na linha de cards:
   • Total de Quartos - soma dos quartos de todas as ExcursaoHospedaria filtradas.
   • Quartos Ocupados - quartos que tem ao menos um passageiro alocado.
   • Taxa de Ocupacao - quartos_ocupados / total_quartos * 100. Verde a partir de 80%, ambar entre 50% e 79%, vermelho abaixo de 50%.
   • Hospedes Alocados - total de passageiros vinculados aos quartos.
5. Analise a tabela Ocupacao por excursão, ordenada por data_inicio ascendente. Cada linha mostra: excursão, data, hospedagem, contagem ocupados/total, percentual, hospedes e o status da hospedagem (confirmado ou pendente).
6. Cores das linhas seguem a faixa de ocupacao: verde (>=80%), ambar (>=50%) e vermelho (>0%). Linhas com zero ocupacao ficam sem destaque.

Casos especiais

Excursão sem quartos cadastrados

Quando a ExcursaoHospedaria existe mas ainda não tem quartos lancados, a linha aparece com 0/0 e percentual 0%. Não conta para a taxa geral (divisão por zero protegida no controller). Cadastre os quartos antes para o relatório refletir a realidade.

Hospedagens canceladas

Hospedagens com status = cancelado são automaticamente excluidas do relatório (filtro fixo no controller). Para revisar uma hospedagem cancelada, abra-a direto pela tela da excursão.

Excursão com mais de uma hospedaria

Cada ExcursaoHospedaria aparece como uma linha propria. Se a mesma excursão usa dois hoteis, você verra duas linhas separadas - uma por hospedaria - e os KPIs somam ambas.

Sem resultados

Se a combinacao de filtros não retornar nada, a tela mostra o estado vazio com a mensagem "Nenhum dado encontrado". Troque o período para Todas ou remova o filtro de hospedaria para ampliar a busca.

Erros comuns e como resolver

• "Nenhum dado encontrado" - Causa: filtros muito restritos ou nenhuma excursão tem hospedagem vinculada no período escolhido. Solucao: troque para Todas ou cadastre a hospedagem via Hospedagem > Hospedagens > [excursão] > Quartos.
• Taxa de Ocupacao em 0% mesmo com quartos - Causa: os quartos existem mas nenhum passageiro foi alocado. Solucao: faca a alocacao pela rooming list (artigo Alocacao de Quartos).
• Total de quartos diferente do esperado - Causa: alguma ExcursaoHospedaria esta com status cancelado e não entra no relatório. Solucao: abra a hospedagem cancelada na tela da excursão para confirmar.
• Erro 403 ao abrir a página - Causa: usuário sem permissão de ver a hospedagem ou módulo de hospedagem inativo na sua empresa. Solucao: ajustar permissão do papel ou ativar o módulo em Configurações > Módulos.

Onde encontrar

• URL: /admin/hospedagem/relatorios/ocupacao
• Caminho no menu: Hospedagem > Ocupacao
• Permissão necessária: ver a hospedagem
• Módulo necessário: hospedagem

Veja também

• Listagem de Hospedagens
• Relatório de Custos
• Alocacao de Quartos