Hospedagem - Listagem de hospedarias

O que é

A Listagem de Hospedagens é a página principal do módulo Hospedagem e funciona como o catálogo central de hotéis, pousadas, resorts, hostels, chácaras, campings e outros tipos de acomodação que você utiliza nas suas excursões. Cada hospedaria cadastrada aqui fica disponível para ser vinculada a uma excursão, gerar tipos de quarto, suplementos e, mais adiante, alimentar a alocação de passageiros e o rooming list.

O usuário normalmente chega nesta página quando precisa consultar quais hospedarias já existem, conferir vínculos com excursões, ajustar o cadastro de uma hospedaria existente, ativar/desativar temporariamente um fornecedor ou cadastrar uma nova hospedaria antes de montar a parte de hospedagem de uma excursão.

No topo, três cartões resumem os números do catálogo: Total de Hospedagens, Hospedagens Ativas e Tipos cadastrados (soma de todos os tipos de quarto registrados nas hospedarias). A lista abaixo é paginada de 15 em 15 e ordenada alfabeticamente pelo nome.

Como usar

1. Vá em Módulos > Hospedagem no menu lateral. A página abre direto na listagem em /admin/hospedagem.
2. Use a barra de filtros logo abaixo dos cartões de estatísticas para refinar a lista:
   • Buscar hospedagem... - busca por nome, cidade ou nome do contato (sem distinção de maiúsculas/acentos).
   • Status - Todos status, Ativos ou Inativos.
   • Tipo - Todos os tipos, Hotel, Pousada, Resort, Hostel, Chácara, Camping ou Outro.
3. Para cadastrar uma nova hospedaria, clique no botão flutuante Nova Hospedagem no canto superior direito do cabeçalho. Você é levado para /admin/hospedagem/create.
4. Para cada hospedaria na lista, você vê:
   • Nome, badge de status (Ativo/Inativo) e badge do tipo (Hotel, Pousada, etc.).
   • Localização (cidade/estado), telefone, contagem de tipos de quarto e contagem de suplementos cadastrados.
   • Quando houver, indicador de excursões vinculadas.
5. Na barra de ações rápidas de cada item, use:
   • Editar - abre o formulário de edição da hospedaria.
   • Visualizar - abre a tela de detalhes (show) da hospedaria com tipos de quarto, suplementos e excursões vinculadas.
6. No menu de três pontos Ações à direita de cada linha, você ainda tem:
   • Editar e Visualizar (mesmas ações).
   • Desativar / Ativar - alterna o campo ativo da hospedaria.
   • Excluir - remove a hospedaria (soft delete). Abre o modal de confirmação <x-confirm-delete-modal> antes de efetivar.
7. Use a paginação no rodapé para navegar entre as páginas quando houver mais de 15 hospedarias.

Casos especiais

Filtrar a lista por URL direta

Os três filtros aceitam querystring, o que permite linkar visões específicas direto em outros lugares do sistema:

• ?busca=copacabana - filtra por nome, cidade ou contato.
• ?status=ativo ou ?status=inativo - só ativos ou só inativos.
• ?tipo=hotel, ?tipo=pousada, ?tipo=resort, ?tipo=hostel, ?tipo=chacara, ?tipo=camping, ?tipo=outro.

Os filtros podem ser combinados (ex: /admin/hospedagem?status=ativo&tipo=pousada) e a paginação preserva os filtros via withQueryString().

Desativar em vez de excluir

Hospedarias usadas em excursões passadas (mas que não serão mais contratadas) devem ser desativadas, não excluídas. Uma hospedaria desativada continua aparecendo na listagem quando o filtro Status é "Todos" ou "Inativos", mas pode ser ocultada nas seleções de cadastro de nova excursão. O histórico das excursões anteriores é preservado.

Hospedaria vinculada a excursões

Se a hospedaria estiver vinculada a pelo menos uma excursão (contagem em excursaoHospedarias), a tentativa de excluí-la é bloqueada com a mensagem "Não é possível excluir uma hospedagem vinculada a excursões.". Nesse caso, a saída é Desativar a hospedaria, ou primeiro remover o vínculo na excursão correspondente e tentar excluir novamente.

Lista vazia

Quando não há nenhuma hospedaria cadastrada (ou nenhum resultado para os filtros aplicados), o sistema exibe um estado vazio com o ícone de prédio, a mensagem "Nenhuma hospedagem cadastrada" e um botão Cadastrar primeira hospedagem, que leva direto para o formulário de criação.

Erros comuns e como resolver

• "Não é possível excluir uma hospedagem vinculada a excursões." - Causa: a hospedaria tem registros em excursaoHospedarias. Solução: remover o vínculo nas excursões correspondentes ou simplesmente desativar a hospedaria pelo menu Ações > Desativar.
• A hospedaria não aparece na lista mesmo cadastrada. - Causa: algum filtro ativo (busca, status ou tipo) está escondendo o registro. Solução: clicar em Limpar filtros na barra de filtros ou acessar /admin/hospedagem direto sem querystring.
• A página retorna 403 / acesso negado. - Causa: o usuário não tem a permissão de ver a hospedagem ou o módulo Hospedagem não está ativo no plano da sua empresa. Solução: verificar o papel do usuário em Sistema > Permissões e o status do módulo em Plano Atual.

Onde encontrar

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

Veja também

• Hospedagem - Cadastrar nova hospedaria
• Alocação de Quartos