霍利兹·梅韦兹

Mewayz 假期

Holidayz 附加组件是一个完整的酒店和度假租赁预订平台 - 面向公众的网站加上运营商管理。

Mewayz-原始模块 — 没有 Mewayz 上游。文档由包源编写，位于 packages/mewayz/Holidayz/。

演示网址

简介

Holidayz 附加组件是一个成熟的度假租赁和酒店预订模块：一个面向公众的预订网站（类似于 Airbnb / Booking.com 的布局），与操作员管理员捆绑在一起，用于管理酒店、房间、定价、日历、客户和预订。

它独立于通用 Mewayz 预订 模块——Holidayz 拥有自己的模块 holidayz_* 一组表格，专为酒店和度假租赁工作流程而构建：房间功能、房间设施、多晚预订窗口、客户帐户、优惠券、博客内容和完整的营销界面（英雄、博客、关于、常见问题解答、推荐）。

如何启用该模块

要设置 Holidayz 附加组件，您可以点击以下链接： 设置附加组件。

该附加组件的门控是 PlanModuleCheck:Holidayz。通过运营商的计划或每个租户激活它 附加组件 管理页面。

三种用户角色

Holidayz 具有三种不同的用户类型：

1. 管理员/公司 ——旅馆老板。拥有全面的管理权

酒店：创建和编辑房间类型、设置定价、管理优惠券、查看包含预订/收入/入住分析的仪表板、批准或拒绝预订、管理客户数据库、处理评论和联系查询，以及配置品牌和网站内容（横幅、常见问题解答、推荐、社交链接）。

2. 员工 — 有限运营商。公司下的子角色；可以

帮助客户支持、查看预订并在公司的监督下运行基本运营。

3. 客户 — 公众访客。使用电子邮件+密码注册，

浏览酒店列表、检查房间供应情况、将房间添加到购物车、应用优惠券、完成结账、查看过去的预订和收据，并可以提交评论和联系信息。

假日仪表板

• 导航至 假日兹 在侧边栏中。
• 仪表板位于 /holidayz/ 显示：
• 预订总数 按状态细分的卡（已付费/

待定/取消）

• 收入 具有月环比趋势的卡片
• 入住率 卡根据可用房间 ÷ 已预订的房间计算得出

间夜数

• 最近的预订 具有快速批准/拒绝操作的列表
• 即将办理登机手续 未来 7 天

客房管理

浏览房间

• 导航至 假日 → 客房。
• 每行显示房间名称、房型、底价、当前价格

可用性状态和快速行动。

创建房间

• 点击 + 新房间。
• 表单字段：
• 名称 + 描述
• 基本价格 每晚
• 容量 （最多客人数）
• 床位配置 （大号床、双胞胎等）
• 房间特色 — 多选（Wi-Fi、AC、电视等）
• 设施 — 多项选择（泳池、健身房、含早餐）
• 税率 — 多项选择 holidayz_room_taxes
• 照片 — 多重上传；第一张照片成为封面
• 标签 — 用于在公共网站上搜索/过滤
• 点击 保存。

房间特色

• Holidayz → 房间特色 — CRUD 用于“功能”设施

（Wi-Fi、空调、电视、迷你吧等）可附加到房间。

设施

• 假日 → 设施 — 酒店级设施的 CRUD（游泳池、

健身房、停车场、早餐）。设施还可以 父→子 分层（例如“水疗→按摩”、“水疗→土耳其浴室”）。

优惠券管理

• 导航至 假期 → 优惠券。
• 使用以下命令创建折扣代码：
• 代码 — 顾客在结账时输入的内容
• 折扣类型 — 百分比或固定金额
• 折扣值
• 有效期窗口 — valid_from 和 valid_to 日期
• 使用限制 — 最大总赎回次数
• 每个客户的限额 — 每个客户的最大兑换次数
• 使用情况追踪 holidayz_coupon_usages。

酒店顾客

• 导航至 Holidayz → 酒店顾客。
• 操作员管理的客户数据库 - 对于管理重复很有用

客人并联系他们进行营销。

• 每个客户都有：姓名、电子邮件、电话、出生日期、地址、身份证明

号码（用于酒店注册合规性）。

• 客户还可以通过公共网站自行注册：

/{userSlug}/hotel/register。

房间预订

• 导航至 假日 → 房间预订。
• 所有房间和客户的完整预订清单。
• 状态： 草案 → 付费的 → 取消。
• 每行操作：查看详细信息， 批准, 拒绝, 编辑,

删除, 打印 （PDF 收据）。

预订生命周期

1. 客户在公共网站上将房间添加到购物车。
2. 客户使用优惠券（可选）并继续结账。
3. 支付通过标准 Mewayz PSP 层（Stripe、

Razorpay、PayPal 等 — 平台上处于活动状态的网关）。

4. 支付成功后，进入预订 付费的 状态。如果

需要管理员批准，预订将处于待处理状态，直到操作员单击 批准。

5. 根据运营商的政策，取消会产生退款。

评论

• 导航至 假日 → 评论。
• 客户提交的客房评论（入住后）的星级评定

并发表评论。

• 操作员可以查看、隐藏或删除评论。

联系方式、新闻通讯、博客

• 联系方式 — 来自公共联系表的入站消息
• 时事通讯 — 通过时事通讯注册捕获的电子邮件列表
• 博客 — 完整博客 CRUD；发表的帖子出现在

/{userSlug}/hotel/blog

系统设置

的 系统设置 菜单控制运营商的公共网站：

• 品牌设置 — 徽标、图标、酒店名称
• 横幅设置 — 英雄横幅图像 + 副本
• 特色设置 — 主页上应展示哪些房间
• 目的地设置 — 特色目的地
• 选择我们设置 —“为什么选择我们”部分
• 感言设置 — 客户评价
• 旅行小贴士设置 — 编辑内容
• 新闻通讯设置 — 时事通讯部分副本
• 社交链接设置 — Twitter / IG / FB / 等链接
• 关于我们设置 — 关于页面内容
• 联系人设置 — 联系页面内容
• 自定义页面 — 自定义 CMS 页面（隐私、条款等）
• 常见问题设置 — 常见问题解答条目

公共前端界面

公共网站安装在 /{userSlug}/hotel/... 哪里 {userSlug} 是运营商的租户 slug。

路径	目的
/{userSlug}/hotel/	英雄主页、特色房间、博客
/{userSlug}/hotel/hotels	酒店+房间列表（搜索+过滤）
/{userSlug}/hotel/hotel/{encryptedRoom}	单间详情页面（签名URL隐藏内部ID）
`/{userSlug}/酒店/关于	联系方式	博客	常见问题解答`	营销页面
/{userSlug}/hotel/cart	购物车 — 检查可用性、添加/删除商品
/{userSlug}/hotel/checkout	结帐 — 应用/删除优惠券、付款
/{userSlug}/hotel/booking-confirm/{encryptedBooking}	确认页面
/{userSlug}/hotel/booking/{encryptedBooking}/receipt	打印友好的收据
/{userSlug}/hotel/login, /register, /forgot-password	客户身份验证（仅限访客）
/{userSlug}/hotel/profile	经过身份验证的客户资料

数据库表

该软件包添加了 20 多个表，全部带有前缀 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，加上他们的 _设施

和 _税收 枢轴

• holidayz_contacts, holidayz_reviews
• holidayz_blogs, holidayz_newsletters

权限

管理侧边栏的可见性和对管理路由的访问由 Spatie 权限控制，主要是“管理假期仪表板”和每个资源权限（管理假期房间、管理假期预订等）。通过**设置 → 角色和权限**进行分配。

操作员注意事项

• 加密 ID — 房间详细信息页面和预订

确认使用 Laravel 签名 URL ({encryptedRoom}, {encryptedBooking}），因此内部数字 ID 不会在 URL 栏中公开。

• 支付整合 — Holidayz 使用相同的共享 Mewayz

PSP层；平台上激活的任何支付网关（Stripe、Razorpay、PayPal 等）都会自动用于酒店结帐 — 无需单独的网关配置。

• 多语言内容 — 博客文章、酒店描述，以及

自定义页面支持 spatie/laravel-translatable Mewayz 使用的模式。

• 独立于预订 — Holidayz 专为

酒店，并且不与通用预订模块共享桌子。

• 的 userSlug 公共 URL 中的映射到运营商的租户 — 所以

每个白标经销商都有自己的 Holidayz 网站。