المخطط في 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)، وتبقى حجوزاتها وأسعارها كما هي. - لا تُحذف وجهة فيها إقامات.
- حذف الإغلاق يحذف لياليه. وإلغاء الحجز يحذف لياليه لكنه يُبقي الحجز وسجله.
- حساب اللوحة يُوقف ولا يُحذف، فتبقى أسماء من قاموا بالأفعال في السجلات.