هوليدايز في Mewayz
إضافة Holidayz هي منصة كاملة لحجز الفنادق والإيجارات السكنية — موقع إلكتروني عام بالإضافة إلى لوحة إدارة للمشغّل.
Mewayz- الوحدة الأصلية — لا Mewayz المنبع. التوثيق مؤلف من مصدر الحزمة في
packages/mewayz/Holidayz/.

مقدمة
إضافة Holidayz هي وحدة كاملة لإيجار العطلات وحجز الفنادق: موقع حجز عام (بتخطيط مشابه لـ Airbnb / Booking.com) مدمج مع إدارة للمشغّل لإدارة الفنادق والغرف والأسعار والتقويمات والعملاء والحجوزات.
وهي مستقلة عن العام Mewayz الحجوزات الوحدة — يحتفظ Holidayz بسجلّه الخاص holidayz_* مجموعة جداول ومبنية لغرض محدد لسير عمل الفنادق وتأجير العطلات: ميزات الغرف، مرافق الغرف، نوافذ حجز متعددة الليالي، حسابات العملاء، الكوبونات، محتوى المدونة، وسطح تسويقي كامل (البطل، المدونة، حول، الأسئلة الشائعة، الشهادات).
كيفية تمكين هذه الوحدة
لإعداد إضافة Holidayz، يمكنك اتباع هذا الرابط: إضافة الإعداد.
الإضافة مقيّدة بـ PlanModuleCheck:Holidayz. فعّلها على خطة المشغّل أو لكل مستأجر عبر الإضافات صفحة المشرف.
ثلاثة أدوار للمستخدمين
لدى Holidayz ثلاثة أنواع مستخدمين متميزة:
- المشرف / الشركة — مالك الفندق. لديه إدارة كاملة لـ
- طاقم العمل — مشغّل محدود. دور فرعي ضمن الشركة؛ يمكنه
- العميل — زائر عام. يسجّل ببريد إلكتروني + كلمة مرور،
العقار: ينشئ ويحرّر أنواع الغرف، ويحدد الأسعار، ويدير الكوبونات، ويعرض لوحة التحكم مع تحليلات الحجوزات/الإيرادات/الإشغال، ويعتمد أو يرفض الحجوزات، ويدير قاعدة بيانات العملاء، ويتعامل مع المراجعات واستفسارات التواصل، ويهيّئ العلامة التجارية ومحتوى الموقع (اللافتات، الأسئلة الشائعة، الشهادات، روابط التواصل الاجتماعي).
المساعدة في دعم العملاء وعرض الحجوزات وتشغيل العمليات الأساسية تحت إشراف الشركة.
يتصفّح قوائم الفنادق، ويتحقق من توفّر الغرف، ويضيف الغرف إلى السلة، ويطبّق القسائم، ويُكمل الدفع، ويعرض الحجوزات السابقة مع الإيصالات، ويمكنه إرسال المراجعات + رسائل التواصل.
لوحة تحكم Holidayz
- انتقل إلى Holidayz في الشريط الجانبي.
- لوحة التحكم في
/holidayz/يعرض: - إجمالي الحجوزات بطاقة بتفصيل حسب الحالة (مدفوع /
- الإيرادات بطاقة باتجاه شهري بشهر
- معدل الإشغال بطاقة محسوبة من الغرف المتاحة ÷ المحجوزة
- الحجوزات الأخيرة قائمة بإجراءات موافقة / رفض سريعة
- تسجيلات الوصول القادمة خلال الأيام الـ 7 القادمة
معلق/ملغي)
ليالي الغرف
إدارة الغرف
تصفّح الغرف
- انتقل إلى Holidayz ← الغرف.
- يعرض كل صف اسم الغرفة، ونوع الغرفة، والسعر الأساسي، والسعر الحالي
حالة التوفّر، وإجراءات سريعة.
إنشاء غرفة
- انقر + غرفة جديدة.
- حقول النموذج:
- الاسم + الوصف
- السعر الأساسي لكل ليلة
- السعة (الحد الأقصى للضيوف)
- تكوين الأسرّة (مزدوج، توأم، إلخ.)
- ميزات الغرفة — اختيار متعدد (واي فاي، تكييف، تلفزيون، إلخ.)
- المرافق — اختيار متعدد (مسبح، صالة رياضية، إفطار مشمول)
- معدلات الضريبة — اختيار متعدد من
holidayz_room_taxes - الصور — رفع متعدد؛ تصبح الصورة الأولى الغلاف
- العلامات — للبحث/التصفية على الموقع العام
- انقر حفظ.
ميزات الغرفة
- Holidayz → ميزات الغرف — CRUD لوسائل الراحة "المميزة"
(واي فاي، تكييف، تلفزيون، ميني بار، إلخ) التي يمكن إرفاقها بالغرف.
المرافق
- Holidayz → المرافق — عمليات إنشاء وقراءة وتحديث وحذف لمرافق الفندق (حمام السباحة،
صالة رياضية، موقف سيارات، فطور). يمكن أن تكون المرافق الأصل → الفرع هرمي (مثل "سبا → تدليك"، "سبا → حمّام").
إدارة الكوبونات
- انتقل إلى Holidayz ← القسائم.
- أنشئ رموز خصم بـ:
- كود — ما يكتبه العميل عند الدفع
- نوع الخصم — نسبة مئوية أو مبلغ ثابت
- قيمة الخصم
- نافذة الصلاحية —
valid_fromوvalid_toالتواريخ - حد الاستخدام — الحد الأقصى لإجمالي الاستردادات
- حد لكل عميل — أقصى عدد للاستبدالات لكل عميل
- يُتتبّع الاستخدام في
holidayz_coupon_usages.
عملاء الفنادق
- انتقل إلى Holidayz ← عملاء الفنادق.
- قاعدة بيانات عملاء يديرها المشغّل — مفيدة لإدارة المتكررين
- لكل عميل: الاسم والبريد الإلكتروني والهاتف وتاريخ الميلاد والعنوان والهوية
- يمكن للعملاء أيضًا التسجيل ذاتيًا عبر الموقع العام في
الضيوف والتواصل معهم لأغراض التسويق.
الرقم (للامتثال لتسجيل الفندق).
/{userSlug}/hotel/register.
حجوزات الغرف
- انتقل إلى Holidayz ← حجوزات الغرف.
- قائمة الحجوزات الكاملة عبر جميع الغرف والعملاء.
- الحالات: مسودة ← مدفوع ← ملغاة.
- إجراءات لكل صف: عرض التفاصيل، موافقة، رفض، تعديل،
حذف، طباعة (إيصال PDF).
دورة حياة الحجز
- يضيف العميل الغرف إلى السلة على الموقع العام.
- يطبّق العميل قسيمة (اختياري) ويتابع إلى الدفع.
- يتم الدفع عبر طبقة Mewayz PSP القياسية (الشريط،
- بعد إتمام الدفع بنجاح، يدخل الحجز إلى مدفوع الحالة. إذا
- يُنشئ الإلغاء استردادًا وفق سياسة المُشغّل.
Razorpay وPayPal وغيرها — أيًّا كانت البوابات المفعّلة على المنصة).
تتطلّب موافقة المشرف، يبقى الحجز معلّقاً حتى ينقر المشغّل موافقة.
التقييمات
- انتقل إلى Holidayz → المراجعات.
- مراجعات الغرف المقدّمة من العملاء (بعد الإقامة) مع تقييم بالنجوم
- يمكن للمشغّلين عرض المراجعات أو إخفاؤها أو حذفها.
وعلّق.
جهات الاتصال، والنشرات الإخبارية، والمدونات
- جهات الاتصال — الرسائل الواردة من نموذج الاتصال العام
- النشرات الإخبارية — قائمة بريد إلكتروني تم التقاطها عبر التسجيل في النشرة الإخبارية
- المدونات — إدارة كاملة للمدوّنات؛ تظهر المنشورات المنشورة في
/{userSlug}/hotel/blog
إعداد النظام
ال إعداد النظام تتحكم القائمة في الموقع الإلكتروني العام للمشغّل:
- إعدادات العلامة التجارية — الشعار وأيقونة favicon واسم الفندق
- إعدادات اللافتة — صورة بانر البطل + النص
- الإعدادات المميزة — الغرف التي ستُعرض في الصفحة الرئيسية
- إعدادات الوجهات — وجهات مميزة
- إعدادات "اخترنا" — قسم "لماذا تختارنا"
- إعدادات الشهادات — شهادات العملاء
- إعدادات نصائح السفر — محتوى تحريري
- إعدادات النشرة البريدية — نص قسم النشرة الإخبارية
- إعدادات الروابط الاجتماعية — روابط Twitter / IG / FB / إلخ.
- إعدادات صفحة من نحن — محتوى صفحة حول
- إعدادات جهات الاتصال — محتوى صفحة الاتصال
- الصفحات المخصصة - صفحات CMS مخصصة (الخصوصية، الشروط، الخ.)
- إعدادات الأسئلة الشائعة — مدخلات الأسئلة الشائعة
سطح الواجهة الأمامية العامة
يُركّب الموقع العام في /{userSlug}/hotel/... حيث {userSlug} هو معرّف المستأجر للمشغّل.
| المسار | الغرض | |||
|---|---|---|---|---|
/{userSlug}/hotel/ | صفحة رئيسية بقسم رئيسي وغرف مميزة ومدونة | |||
/{userSlug}/hotel/hotels | قائمة الفنادق + الغرف (بحث + تصفية) | |||
/{userSlug}/hotel/hotel/{encryptedRoom} | صفحة تفاصيل غرفة واحدة (يخفي عنوان URL الموقّع المعرّف الداخلي) | |||
| `/{userSlug}/hotel/about | جهة اتصال | مدونة | faq` | صفحات التسويق |
/{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_pagesholidayz_rooms،holidayz_room_images،holidayz_room_tags،holidayz_facilities،holidayz_facility_childrenholidayz_coupons،holidayz_coupon_usagesholidayz_hotel_customers،holidayz_password_resetsholidayz_room_bookings،holidayz_room_booking_items،holidayz_carts،holidayz_cart_items، بالإضافة إلى _facilitiesholidayz_contacts،holidayz_reviewsholidayz_blogs،holidayz_newsletters
holidayz_room_features، holidayz_room_taxes، holidayz_room_room_features
holidayz_room_booking_item_facilities، holidayz_room_booking_item_taxes
و _taxes المحاور
الأذونات
تُتحكَّم رؤية الشريط الجانبي للمسؤول والوصول إلى مسارات المسؤول عبر صلاحيات Spatie، بشكل أساسي `manage-holidayz-dashboard` والصلاحيات لكل مورد (manage-holidayz-rooms، manage-holidayz-bookings، إلخ.). عيّنها عبر **الإعدادات → الأدوار والصلاحيات**.
ملاحظات المشغّل
- معرّفات مشفّرة — صفحات تفاصيل الغرف والحجز معًا
- تكامل الدفع - يستخدم Holidayz نفس Mewayz المشترك
- محتوى متعدد اللغات — منشورات المدونة، وأوصاف الفنادق، و
- مستقل عن الحجوزات — صُمِّم Holidayz خصيصًا لـ
- ال
userSlugفي عناوين URL العامة يرتبط بمستأجر المشغّل — لذا
تستخدم التأكيدات عناوين URL موقّعة من Laravel ({encryptedRoom}، {encryptedBooking}) حتى لا تُكشف المعرّفات الرقمية الداخلية في شريط العنوان.
طبقة مزود خدمة الدفع؛ أي بوابات دفع نشطة على المنصة (Stripe وRazorpay وPayPal وغيرها) تعمل تلقائياً لإتمام دفع الفندق — دون الحاجة إلى تكوين بوابة منفصل.
تدعم الصفحات المخصصة الـ spatie/laravel-translatable النمط المستخدم عبر Mewayz.
الفنادق ولا تشارك جداولها مع وحدة الحجوزات العامة.
لكل موزّع بعلامة بيضاء موقع Holidayz خاص به على المعرّف (slug) الخاص به.