نُزُل التوثيق · نُزُل

خاص بـ: الحزمة الكاملة · واجهة API

نموذج البيانات

جداول قاعدة البيانات وكيف ترتبط ببعضها.

المخطط في prisma/schema.prisma. المبالغ أعداد صحيحة بأصغر وحدة للعملة، وتواريخ الإقامات نصوص بصيغة YYYY-MM-DD.

الجدول ماذا يحفظ
Setting صف واحد (المعرّف 1): أسماء الشركة ونبذتها وبيانات التواصل والعملة ونسبة الضرائب ووقتا الوصول والمغادرة ومدة الحجز المسبق وأيام الإلغاء المجاني ومفاتيح الدفع و«نستقبل الحجوزات»
Destination مكان (الجبل الأخضر، صلالة...): الأسماء والمحافظة والملخص والوصف والصورة وأفضل الأشهر والترتيب والظهور
Stay بيت: الوجهة والنوع والأسماء والملخص والوصف وقواعد البيت (سطر لكل قاعدة) والصور والمرافق (مصفوفات JSON) وسعر الليلة وسعر نهاية الأسبوع ورسوم التنظيف وأقل عدد ليالٍ والضيوف والغرف و«اختيارنا» والظهور والمضيف
SeasonalRate سعر للإقامة بين أول ليلة وآخر ليلة، مع حد أدنى أطول للإقامة إن لزم
StayNight صف لكل ليلة محجوزة: الإقامة والتاريخ، ومعهما إما حجز أو إغلاق. فهرس فريد على (stayId, date)، وهذا ما يجعل الحجز المزدوج مستحيلاً
Block ليالٍ أغلقها الفريق، مع ملاحظة واسم من أغلقها
Booking الرمز والإقامة والوصول والمغادرة وعدد الليالي والضيوف واسم الضيف وبريده وهاتفه وبلده وملاحظاته والحالة وطريقة الدفع وحالته ومرجع ثواني ونسخة من سعر كل ليلة والمجاميع ورمز الباب وطلب الإلغاء والملاحظة الداخلية والمصدر واللغة
BookingEvent سجل الحجز: الحالة والملاحظة ومن قام بها ومتى
Review الإقامة والحجز (تقييم واحد لكل حجز) والاسم والبلد والتقييم والنص والحالة (PENDING وPUBLISHED وHIDDEN) والرد
Inquiry سؤال ضيف: الإقامة (اختيارية) وبيانات التواصل والتواريخ والضيوف والرسالة والحالة (NEW وANSWERED وCLOSED) وملاحظة الفريق
StaffUser حسابات اللوحة: الاسم والبريد وتجزئة كلمة المرور بـ scrypt والدور (OWNER وADMIN وHOST) والنشاط والإقامات التي يستضيفها
Destination 1──* Stay 1──* SeasonalRate
                  │  1──* StayNight *──1 Booking | Block
                  │  1──* Booking 1──* BookingEvent
                  │  1──* Review *──0..1 Booking
                  │  1──* Inquiry
StaffUser 1──* Stay (as host)

لماذا لكل ليلة صف

لا يكفي وحده أن نسأل «هل أي ليلة بين الوصول والمغادرة محجوزة؟» ثم نحفظ، لأن طلبين قد يسألان معاً قبل أن يحفظ أيٌّ منهما. أما مع صف StayNight لكل ليلة وفهرس فريد، فقاعدة البيانات نفسها ترفض الإدراج الثاني. يعمل هذا بالطريقة نفسها في SQLite وPostgreSQL، ويجعل التقويم استعلاماً بسيطاً.

الحذف

  • لا تُحذف إقامة لها حجوزات، بل تُخفى (active: false)، وتبقى حجوزاتها وأسعارها كما هي.
  • لا تُحذف وجهة فيها إقامات.
  • حذف الإغلاق يحذف لياليه. وإلغاء الحجز يحذف لياليه لكنه يُبقي الحجز وسجله.
  • حساب اللوحة يُوقف ولا يُحذف، فتبقى أسماء من قاموا بالأفعال في السجلات.