رسالة «AUTH_SECRET is missing or too short»
لا يحتوي .env على AUTH_SECRET أو أنه أقصر من 16 حرفاً. ولّد قيمة جديدة (انظر التثبيت) وأعد التشغيل.
رسالة «Settings row missing: run npm run db:seed»
الجداول موجودة لكنها فارغة. شغّل npm run db:seed.
لا أستطيع الدخول إلى اللوحة
- يُنشأ حساب المالك فقط حين يكون جدول الموظفين فارغاً. إن غيّرت
OWNER_EMAILبعد أول تعبئة فالعنوان القديم هو المالك. أعد الضبط بالأمرnpm run db:reset(يحذف كل البيانات) أو عدّل البريد في قاعدة البيانات. - بعد 8 محاولات فاشلة لبريد واحد، أو 10 محاولات في الدقيقة من عنوان IP واحد، تظهر رسالة «طلبات كثيرة» لبضع دقائق.
- الحساب الموقوف لا يستطيع الدخول.
كل تعديل في اللوحة يقول «عرض تجريبي للقراءة فقط»
قيمة DEMO_MODE في .env هي true. اجعلها false وأعد التشغيل. انظر وضع العرض التجريبي.
الصور المرفوعة لا تظهر
- تُحفظ في
UPLOAD_DIR(افتراضياًstorage/uploads) وتُعرض على/uploads/<file>، ويجب أن يكون المجلد قابلاً للكتابة. - تُرفض الملفات الأكبر من
UPLOAD_MAX_MB(افتراضياً 8). وخلف Nginx ارفعclient_max_body_sizeأيضاً. - لا تُقبل إلا صور JPEG وPNG وWebP، ويُتحقق من النوع من محتوى الملف لا من اسمه.
الوسيط لا يرى عقاراً أو استفساراً
هذا مقصود: لا يرى الوسيط إلا العقارات والاستفسارات المسندة إليه. يستطيع المدير إسنادها (محرر العقار ‹ الوسيط، أو الاستفسارات ‹ الوسيط المسؤول). انظر المديرون والأدوار.
رُفض تغيير الحالة («bad_transition»)
للعقارات والاستفسارات والمعاينات مسارات حالات ثابتة؛ فالعقار المعروض للإيجار يصبح «مؤجراً» لا «مباعاً»، والمعاينة تُؤكَّد قبل أن تُسجَّل «تمت». لا تعرض اللوحة إلا الخطوات المسموحة، وترفض الواجهة البرمجية ما عداها. المسارات في src/lib/rules.ts.
صفحتا الذكاء الاصطناعي تقولان إنهما غير مفعّلتين
اضبط المتغيرات في المساعد الذكي أو استوديو التأثيث وأعد التشغيل. إن ردّ المزوّد بخطأ تعرضه اللوحة كما هو، و«HTTP 401» يعني غالباً أن المفتاح خاطئ.
أكثر من نسخة من الخادم
يحفظ محدِّد الطلبات في src/lib/api.ts العدّادات في ذاكرة العملية. مع أكثر من نسخة استبدله بتخزين مشترك (Redis أو جدول في قاعدة البيانات)، واستخدم PostgreSQL، وضع الصور المرفوعة في تخزين مشترك.
المنفذ 3303 مستخدم
عملية أخرى تحجز المنفذ، وغالباً ما تكون next start سابقة. أوقفها، أو غيّر المنفذ في أمرَي dev وstart في package.json.