«AUTH_SECRET is missing or too short»
اضبط AUTH_SECRET في .env بطول 16 حرفًا فأكثر (ننصح بـ 32 حرفًا عشوائيًا) ثم أعد التشغيل.
«Settings row missing: run npm run db:seed»
في قاعدة البيانات جداول دون بيانات. شغّل npm run db:seed.
يقول أمر التعبئة «Set ADMIN_PASSWORD (8+ characters)»
اضبط ADMIN_PASSWORD في .env. يرفض أمر التعبئة إنشاء مشرف بكلمة مرور ضعيفة أو فارغة.
لا أستطيع دخول اللوحة
- راجع البريد في
ADMIN_EMAIL: يُنشأ المشرف فقط حين لا يوجد أي حساب في اللوحة. إن غيّرت البريد بعد التعبئة فادخل بالبريد القديم، أو احذفprisma/maarifa.dbوشغّلnpm run setup. - بعد 8 كلمات مرور خاطئة لبريد واحد يتوقف الدخول 15 دقيقة.
- خلف HTTPS تأكد أن
SITE_URLيبدأ بـhttps://، فعلى HTTP العادي في الإنتاج قد يتجاهل المتصفح ملف الدخول الآمن.
يرى المدرّب «Your account is not linked to an instructor profile»
افتح «اللوحة > المشرفون»، وعدّل الحساب، واختر ملف المدرّب المرتبط به. يدير المدرّب دورات ذلك الملف فقط.
لا يستطيع المدرّب نشر دورة
هذا هو الوضع الافتراضي: صلاحية «نشر الدورات» مغلقة للمدرّبين. ينشر المشرف الدورة، أو يفتح الصلاحية من «اللوحة > أدوار المشرفين».
لا يظهر الدفع بالبطاقة عند إتمام الشراء
يلزم الثلاثة معًا: المفتاح في «اللوحة > الإعدادات»، وTHAWANI_SECRET_KEY وTHAWANI_PUBLISHABLE_KEY في .env، وأن تكون العملة الريال العُماني. راجع الدفع.
دفع المتعلّم ولم تُفتح الدورة
تُفتح الدورة حين تؤكد «ثواني» الدفع في صفحة العودة. إن أغلق المتعلّم المتصفح قبل العودة يبقى الطلب «معلّقًا». راجع الجلسة في بوابة «ثواني»؛ فإن كانت مدفوعة يستطيع المتعلّم فتح /api/payments/thawani/return?order=CODE مرة أخرى، أو استرد المبلغ. أما التحويل البنكي فلا يفتح الدورة إلا حين يعلّم المشرف الطلب مدفوعًا.
«Not eligible» عند إصدار الشهادة
تخبرك الرسالة بما ينقص: دروس لم تُعلَّم مكتملة، أو اختبارات مطلوبة لم تُجتز. وإضافة درس إلى دورة أنهاها متعلّم تنزل بتقدّمه عن 100% حتى يكمل الدرس الجديد، أما الشهادات الصادرة فتبقى صالحة.
يقول الاختبار «لا محاولات متبقية»
استنفد المتعلّم المحاولات المسموحة. ارفع «المحاولات المسموحة» في منشئ الاختبارات (صفر = غير محدودة).
لا يظهر مشغّل الفيديو في الدرس
تُعرض فقط روابط https من YouTube وVimeo، أو ملفات .mp4 أو .webm أو .m4v المباشرة. تُتجاهل الروابط الأخرى حفاظًا على الأمان.
تظهر «namespace.key» بدل النص
ترجمة ناقصة في messages/ar.json أو messages/en.json. يسرد npm test كل مفتاح ناقص.
يتوقف البناء بخطأ «JavaScript heap out of memory»
امنح Node ذاكرة أكبر: NODE_OPTIONS=--max-old-space-size=2048 npm run build.