نُزُل نظام حجز متكامل لشركة تؤجّر بيوت العطلات: شاليهات وفلل وأكواخ وبيوت شاطئية ومخيمات صحراوية. واجهته عربية أولاً من اليمين إلى اليسار، ومعها نسخة إنجليزية كاملة. يضم مشروع Next.js واحد ثلاثة أجزاء تتشارك قاعدة بيانات واحدة:
| الجزء | ماذا يفعل | أين |
|---|---|---|
| موقع الإقامات | البحث بالوجهة والتواريخ وعدد الضيوف، وقائمة الإقامات مع التصفية، وصفحة الإقامة بصورها وتقويم لياليها المتاحة وسعرها للتواريخ المختارة بالضبط، والحجز بالبطاقة أو بطلب حجز، ورمز الحجز، و«ابحث عن حجزك»، ورمز الباب، وطلب الإلغاء، والتقييم، والوجهات، والمحفوظة، ومن نحن، والتواصل | /ar و/en |
| لوحة الحجوزات | نظرة عامة (الإيرادات والإشغال والواصلون والمغادرون)، وتقويم كل الإقامات بلياليها مع إغلاق التواريخ، والحجوزات وحالاتها، والإقامات بصورها وأسعارها ومواسمها، والاستفسارات، والتقييمات، والمساعد الذكي، وإعدادات الشركة، والمشرفون وأدوارهم | /ar/dashboard و/en/dashboard |
| واجهة API | نقاط REST يستخدمها الجزءان، ويمكن أن تستخدمها تطبيقاتك أيضاً | /api/... |
ماذا ستحصل عليه
- توفر حقيقي: لكل ليلة محجوزة صف واحد في قاعدة البيانات، فلا تُباع الليلة نفسها مرتين، حتى لو ضغط ضيفان «احجز» في الثانية ذاتها.
- كل سعر يُحسب على الخادم ليلة بليلة: السعر الأساسي، وسعر ليلتي الخميس والجمعة، وأسعار المواسم، ثم رسوم التنظيف والضرائب. المتصفح لا يقرر أي سعر.
- طريقتان للدفع: بالبطاقة عبر ثواني مع التحقق من الدفع على الخادم، أو طلب حجز يؤكده المضيف ويدفع الضيف عند وصوله.
- «من الحجز إلى رمز الباب»: يصل الضيفَ رمزُ الحجز فوراً، ويظهر رمز الباب في حجزه قبل وصوله بيوم.
- ثلاثة أدوار في اللوحة: المالك والمشرف والمضيف، والمضيف لا يرى إلا الإقامات المسندة إليه.
- ذكاء اصطناعي اختياري يجيب عن أسئلة الحجوزات ويكتب أوصاف الإقامات بالعربية والإنجليزية، مع أي مزوّد متوافق مع OpenAI.
- شركة تجريبية جاهزة: 6 وجهات و14 إقامة في أنحاء عُمان بصور مولّدة، ونحو 450 حجزاً من خمسة أشهر مضت إلى شهرين قادمين، مع تقييمات واستفسارات.
البدء السريع
npm install
cp .env.example .env
npm run setup
npm run dev
افتح http://localhost:3304 للموقع، وhttp://localhost:3304/ar/dashboard للوحة. حساب المالك يأتي من OWNER_EMAIL وOWNER_PASSWORD في ملف .env (انظر التثبيت).
أين تجد كل شيء
prisma/schema.prisma جداول قاعدة البيانات
prisma/seed.mjs الشركة التجريبية والحجوزات وحساب المالك (المحتوى في seed-data.mjs)
messages/ar.json, en.json كل نصوص الموقع واللوحة
src/app/[locale]/(site) صفحات الموقع
src/app/[locale]/dashboard صفحات اللوحة
src/app/api الـ API
src/lib/booking-rules.ts الليالي والتوفر والأسعار وتسلسل الحالات (دوال خالصة عليها اختبارات)
src/lib/roles.ts ما يستطيعه كل دور في اللوحة
src/lib الحجوزات والإقامات والدفع والذكاء الاصطناعي والجلسات
src/components مكوّنات الموقع واللوحة
src/app/globals.css الألوان والخطوط والزوايا (هويتك)
public/images صور الإقامات والوجهات
tests اختبارات الوحدات (npm test)
scripts/e2e_api.py اختبار الـ API من البداية إلى النهاية
الخطوات التالية
- ثبّت المشروع وادخل إلى اللوحة.
- أدخل اسم شركتك وبيانات التواصل والضرائب وقواعد الحجز من اللوحة > إعدادات الشركة.
- استبدل الوجهات والإقامات التجريبية من اللوحة > الإقامات.
- ضع ألوانك وشعارك (الهوية والألوان).
- حدّد طرق الدفع (الدفع) ثم انشر الموقع (التثبيت اليدوي والنشر).