Feriado mewayz

Férias em Mewayz

O complemento Holidayz é uma plataforma completa de reservas de hotéis e aluguéis de temporada - site público e administrador da operadora.

Mewayz-módulo original — não Mewayz a montante. Documentação de autoria da fonte do pacote em packages/mewayz/Holidayz/.

URL de demonstração

Introdução

O complemento Holidayz é um módulo completo de aluguel por temporada e reserva de hotel: um site de reservas público (layout semelhante ao Airbnb / Booking.com) junto com um administrador de operadora para gerenciar hotéis, quartos, preços, calendários, clientes e reservas.

É independente do genérico Mewayz Reservas módulo - Holidayz mantém seu próprio holidayz_* conjunto de tabelas e foi desenvolvido especificamente para fluxos de trabalho de hotéis e aluguéis por temporada: recursos de quartos, instalações de quartos, janelas de reserva de várias noites, contas de clientes, cupons, conteúdo de blog e uma superfície de marketing completa (herói, blog, sobre, perguntas frequentes, depoimentos).

Como habilitar este módulo

Para configurar o complemento Holidayz, você pode seguir este link: Complemento de configuração.

O Add-On é bloqueado por PlanModuleCheck:Holidayz. Ative-o no plano da operadora ou por locatário através do Complementos página de administração.

Três funções de usuário

Holidayz tem três tipos de usuários distintos:

1. Administrador / Empresa — O dono do hotel. Possui gestão completa do

propriedade: cria e edita tipos de quartos, define preços, gerencia cupons, visualiza o painel com análises de reservas/receitas/ocupação, aprova ou rejeita reservas, gerencia o banco de dados de clientes, lida com avaliações e consultas de contato e configura a marca e o conteúdo do site (banners, perguntas frequentes, depoimentos, links sociais).

2. Pessoal — Operador limitado. Subfunção na Companhia; pode

ajudar no suporte ao cliente, visualizar reservas e executar operações básicas sob a supervisão da Empresa.

3. Cliente — Visitante público. Cadastra-se com e-mail + senha,

navega nas listas de hotéis, verifica a disponibilidade de quartos, adiciona quartos a um carrinho, aplica cupons, conclui a compra, visualiza reservas anteriores e recibos e pode enviar comentários + mensagens de contato.

Painel Holidayz

• Navegue até Férias na barra lateral.
• O painel em /holidayz/ mostra:
• Total de reservas cartão com detalhamento por status (pago /

pendente/cancelado)

• Receita cartão com tendência mês a mês
• Taxa de ocupação cartão calculado a partir de quartos disponíveis ÷ reservados

pernoites

• Reservas recentes lista com ações rápidas de aprovação/rejeição
• Próximos check-ins pelos próximos 7 dias

Gerenciamento de salas

Navegar pelas salas

• Navegue até Férias → Quartos.
• Cada linha mostra o nome do quarto, tipo de quarto, preço base, preço atual

status de disponibilidade e ações rápidas.

Crie uma sala

• Clique + Novo quarto.
• Campos do formulário:
• Nome + Descrição
• Preço base por noite
• Capacidade (máximo de hóspedes)
• Configuração da cama (rainha, gêmea, etc.)
• Características do quarto — Seleção múltipla (Wi-Fi, AC, TV, etc.)
• Instalações — Seleção múltipla (piscina, academia, café da manhã incluído)
• Taxas de imposto - Seleção múltipla de holidayz_room_taxes
• Fotos — Multi-upload; primeira foto vira capa
• Etiquetas — Para pesquisa/filtro no site público
• Clique Salvar.

Características do quarto

• Férias → Características do quarto — CRUD para comodidades de "recursos"

(Wi-Fi, AC, TV, frigobar, etc.) que podem ser acoplados aos quartos.

Instalações

• Holidayz → Instalações — CRUD para instalações de nível hoteleiro (piscina,

academia, estacionamento, café da manhã). As instalações podem ser pai → filho hierárquico (por exemplo, "Spa → Massagem", "Spa → Hammam").

Gerenciamento de cupons

• Navegue até Holidayz → Cupons.
• Crie códigos de desconto com:
• Código - o que o cliente digita na finalização da compra
• Tipo de desconto — Porcentagem ou valor fixo
• Valor com desconto
• Janela de validade - valid_from e valid_to datas
• Limite de uso - Máximo total de resgates
• Limite por cliente — Máximo de resgates por cliente
• Uso rastreado em holidayz_coupon_usages.

Clientes de hotéis

• Navegue até Holidayz → Clientes do Hotel.
• Banco de dados de clientes gerenciado pelo operador — útil para gerenciar repetições

convidados e contatá-los para marketing.

• Cada cliente possui: nome, email, telefone, data de nascimento, endereço, identificação

número (para conformidade de registro do hotel).

• Os clientes também podem se registrar através do site público em

/{userSlug}/hotel/register.

Reservas de quartos

• Navegue até Holidayz → Reservas de quartos.
• A lista completa de reservas de todos os quartos e clientes.
• Status: rascunho → pago → cancelado.
• Ações por linha: visualizar detalhes, aprovar, rejeitar, editar,

excluir, imprimir (recibo em PDF).

Ciclo de vida da reserva

1. O cliente adiciona salas ao carrinho no site público.
2. O cliente aplica um cupom (opcional) e prossegue para finalizar a compra.
3. O pagamento passa pela camada padrão Mewayz PSP (Stripe,

Razorpay, PayPal, etc. — quaisquer gateways que estejam ativos na plataforma).

4. Após o pagamento bem sucedido, a reserva entra pago estado. Se

a aprovação do administrador é necessária, a reserva fica pendente até que um operador clique Aprovar.

5. O cancelamento cria um reembolso de acordo com a política da operadora.

Avaliações

• Navegue até Férias → Comentários.
• Avaliações de quartos enviadas por clientes (pós-estadia) com classificação por estrelas

e comente.

• Os operadores podem visualizar, ocultar ou excluir avaliações.

Contato, Boletins Informativos, Blogs

• Contatos — Mensagens recebidas do formulário de contato público
• Boletins informativos — Lista de e-mail capturada por meio da inscrição no boletim informativo
• Blogues — Blog completo CRUD; postagens publicadas aparecem em

/{userSlug}/hotel/blog

Configuração do sistema

O Configuração do sistema menu controla o site público da operadora:

• Configurações de marca — Logotipo, favicon, nome do hotel
• Configurações de banner — Imagem do banner do herói + cópia
• Configurações em destaque — Quais salas apresentar na página inicial
• Configurações de destinos — Destinos em destaque
• Escolha-nos configurações — Seção "Por que nos escolher"
• Configurações de depoimentos - Depoimentos de clientes
• Configurações de dicas de viagem - Conteúdo editorial
• Configurações do boletim informativo — Cópia da seção do boletim informativo
• Configurações de links sociais - Links Twitter / IG / FB / etc.
• Configurações sobre nós — Sobre o conteúdo da página
• Configurações de contato — Conteúdo da página de contato
• Páginas personalizadas — Páginas CMS personalizadas (privacidade, termos, etc.)
• Configurações de perguntas frequentes - Entradas de perguntas frequentes

Superfície de front-end público

O site público está montado em /{userSlug}/hotel/... onde {userSlug} é o slug do locatário do operador.

Caminho	Objetivo
/{userSlug}/hotel/	Página inicial com herói, salas em destaque, blog
/{userSlug}/hotel/hotels	Listagem de hotel + quarto (pesquisa + filtro)
/{userSlug}/hotel/hotel/{encryptedRoom}	Página de detalhes de quarto único (URL assinado oculta ID interno)
`/{userSlug}/hotel/sobre	contato	blog	perguntas frequentes`	Páginas de marketing
/{userSlug}/hotel/cart	Carrinho – verifique a disponibilidade, adicione/remova itens
/{userSlug}/hotel/checkout	Checkout – aplicar/remover cupons, pagar
/{userSlug}/hotel/booking-confirm/{encryptedBooking}	Página de confirmação
/{userSlug}/hotel/booking/{encryptedBooking}/receipt	Recibo para impressão
/{userSlug}/hotel/login, /register, /forgot-password	Autenticação do cliente (somente convidados)
/{userSlug}/hotel/profile	Perfil de cliente autenticado

Tabelas de banco de dados

O pacote adiciona mais de 20 tabelas, todas prefixadas holidayz_:

• holidayz_setups, holidayz_destinations, holidayz_custom_pages
• holidayz_rooms, holidayz_room_images, holidayz_room_tags,

holidayz_room_features, holidayz_room_taxes, holidayz_room_room_features

• holidayz_facilities, holidayz_facility_children
• holidayz_coupons, holidayz_coupon_usages
• holidayz_hotel_customers, holidayz_password_resets
• holidayz_room_bookings, holidayz_room_booking_items,

holidayz_room_booking_item_facilities, holidayz_room_booking_item_taxes

• holidayz_carts, holidayz_cart_items, além de seus _instalações

e _impostos pivôs

• holidayz_contacts, holidayz_reviews
• holidayz_blogs, holidayz_newsletters

Permissões

A visibilidade da barra lateral do administrador e o acesso às rotas administrativas são controlados pelas permissões do Spatie, principalmente `manage-holidayz- dashboard` e permissões por recurso (manage-holidayz-rooms, manage-holidayz-bookings, etc.). Atribua via **Configurações → Funções e permissões**.

Notas do Operador

• IDs criptografados — Páginas de detalhes do quarto e reserva

confirmações usam URLs assinados pelo Laravel ({encryptedRoom}, {encryptedBooking}) para que os IDs numéricos internos não sejam expostos na barra de URL.

• Integração de pagamento — Holidayz usa o mesmo Mewayz compartilhado

Camada PSP; quaisquer gateways de pagamento ativos na plataforma (Stripe, Razorpay, PayPal, etc.) funcionam automaticamente para check-out do hotel – nenhuma configuração de gateway separada é necessária.

• Conteúdo multilíngue — Postagens de blog, descrições de hotéis e

páginas personalizadas suportam o spatie/laravel-translatable padrão usado em Mewayz.

• Independente de reservas — Holidayz foi desenvolvido especificamente para

hotéis e não compartilha mesas com o módulo genérico de Reservas.

• O userSlug em URLs públicos mapeiam para o locatário da operadora — então

cada um dos revendedores de marca branca tem seu próprio site Holidayz em seu próprio slug.