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

حل المشكلات

أكثر المشكلات شيوعاً وطريقة حلها.

«AUTH_SECRET is missing or too short»

توقّع اللوحة ملف الجلسة بـ AUTH_SECRET. اضبطه في .env على 32 حرفاً عشوائياً أو أكثر ثم أعد التشغيل. تغييره لاحقاً يُخرج الجميع من اللوحة، ولا يؤثر على شيء آخر.

«Settings row missing: run npm run db:seed»

قاعدة البيانات موجودة لكنها فارغة. شغّل npm run db:seed (أو npm run setup على نسخة جديدة).

«Set OWNER_PASSWORD (10+ characters)» عند تعبئة البيانات

تنشئ البيانات التجريبية حساب المالك الأول من OWNER_EMAIL وOWNER_PASSWORD. ضع في .env كلمة مرور من 10 أحرف على الأقل.

تفشل تعبئة البيانات بخطأ «Unknown file extension .ts» أو خطأ صياغة

تستورد البيانات التجريبية واختبارات الوحدات الملف src/lib/booking-rules.ts مباشرة، وهذا يحتاج Node.js 22.18 أو أحدث. تحقّق بالأمر node -v وحدّث الإصدار.

التقويم يُظهر الليالي متاحة، والحجز يقول إنها محجوزة

حجز شخص آخر إحدى هذه الليالي قبل لحظات من ضغطك، بعد أن حُمّل التقويم. الجواب صحيح، فقاعدة البيانات ترفض الحجز الثاني. حدّث الصفحة لترى التقويم الحالي.

حجوزات البطاقة تحجز لياليها 30 دقيقة ما دام الضيف في صفحة ثواني. وإن لم يكتمل الدفع تُحرَّر الليالي تلقائياً عند أول بحث أو حجز بعد ذلك.

التواريخ متأخرة أو متقدمة يوماً

«اليوم» يُحسب من COMPANY_TIMEZONE (الافتراضي Asia/Muscat)، لا من ساعة الخادم. اضبطه على المنطقة الزمنية لإقاماتك.

لا يظهر خيار «بطاقة (ثواني)» في نموذج الحجز

يجب أن تتحقق كل هذه الشروط:

  1. THAWANI_SECRET_KEY وTHAWANI_PUBLISHABLE_KEY مضبوطان في .env (وأعد التشغيل بعد التعديل).
  2. اللوحة > إعدادات الشركة > الدفع > الدفع بالبطاقة مفعّل.
  3. العملة OMR، فثواني تستوفي بالريال العُماني فقط.

انظر الدفع.

الضيف لا يرى رمز الباب

يظهر رمز الباب في «ابحث عن حجزك» ابتداءً من اليوم السابق للوصول، وفقط للحجوزات المؤكدة أو التي سُجّل وصولها. يبقى طلب الحجز «بانتظار التأكيد» حتى يؤكده المضيف.

صفحة الدخول تعود في كل مرة

  • المتصفح يمنع ملفات تعريف الارتباط لهذا الموقع: اسمح بها.
  • في الإنتاج يبدأ SITE_URL بـ https:// لكنك فتحت الموقع عبر http://، فلا يُرسل الملف الآمن. استخدم HTTPS أو صحّح SITE_URL.
  • أُوقف الحساب من اللوحة > المشرفون.

مضيف يقول إن اللوحة فارغة

لا يرى المضيف إلا الإقامات المسندة إليه. افتح الإقامة من اللوحة > الإقامات واختر اسمه في حقل المضيف.

يفشل رفع صورة

  • تُقبل صور JPEG وPNG وWebP حتى 4 ميغابايت، ويُفحص نوع الملف الحقيقي لا اسمه.
  • خلف Nginx، اضبط client_max_body_size 5m;.
  • في الاستضافات التي قرصها للقراءة فقط لا يمكن الحفظ في public/uploads: انظر التثبيت اليدوي والنشر.

«Too many requests»

للأفعال العامة حدود لكل زائر: 6 حجوزات، و10 عمليات بحث عن حجز، و5 استفسارات، و120 حساب سعر في الدقيقة، و10 محاولات دخول في الدقيقة (8 لكل بريد خلال 15 دقيقة). تُحفظ العدادات في ذاكرة الخادم وتُصفَّر عند إعادة تشغيله. خلف وسيط عكسي تأكد أنه يضبط X-Forwarded-For، وإلا تشارك كل الزوار عداداً واحداً.

عدّلت prisma/schema.prisma فتعطل التطبيق

طبّق التعديل وأعد بناء العميل:

npx prisma db push
npx prisma generate