التثبيت

من الملفات التي نزّلتها إلى أكاديمية تعمل ببيانات تجريبية في خمس دقائق.

ما تحتاجه

  • Node.js بالإصدار 20.9 أو أحدث (ننصح بـ 22 LTS) مع npm.
  • لا شيء غيرهما في التشغيل الأول: قاعدة البيانات ملف SQLite يُنشأ داخل المشروع. للإنتاج وPostgreSQL راجع المتطلبات.

الخطوات

npm install
cp .env.example .env        # في ويندوز: copy .env.example .env

افتح ملف .env واضبط على الأقل:

المتغير لماذا
AUTH_SECRET يوقّع ملفات الدخول. استخدم 32 حرفًا عشوائيًا فأكثر: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
ADMIN_EMAIL وADMIN_PASSWORD أول حساب مشرف (كلمة مرور من 8 أحرف فأكثر)

ثم أنشئ الجداول والأكاديمية التجريبية:

npm run setup
npm run dev

يشغّل npm run setup ثلاثة أوامر: prisma generate وprisma db push وnode prisma/seed.mjs، ويطبع الحسابات التي أنشأها.

الدخول

المكان الحساب
اللوحة، مشرف: http://localhost:3305/ar/dashboard ADMIN_EMAIL / ADMIN_PASSWORD (في النسخة التجريبية: admin@maarifa.test / maarifa-demo-2026)
اللوحة، مدرّب khalid@maarifa.test (وكذلك reem وnoor وsaeed وlaila وdaniel) بكلمة المرور DEMO_INSTRUCTOR_PASSWORD (تجريبيًا: maarifa-teach-2026)
الموقع، متعلّم (فقط مع SEED_DEMO_STUDENT="1") student@maarifa.test / maarifa-student-2026

للمتعلّمين التجريبيين الأربعين كلمات مرور عشوائية ولا يستطيعون الدخول؛ وجودهم يجعل بيانات اللوحة واقعية فقط.

أوامر مفيدة

الأمر
npm run dev خادم التطوير على المنفذ 3305
npm run build ثم npm start بناء الإنتاج وتشغيله
npm run db:seed ملء قاعدة بيانات فارغة (آمن عند تكراره: يتجاوز الموجود)
npm test اختبارات الوحدات: قواعد التعلّم، وتصحيح الاختبارات، والشهادات، والتسعير، والكوبونات، والأدوار، والتصفية، والترجمات
npm run lint فحص الأنواع
python scripts/e2e_api.py اختبار شامل للـ API على خادم يعمل بقاعدة بيانات تجريبية جديدة
python scripts/check_pages.py يتأكد أن كل صفحة باللغتين وكل رابط في التوثيق يعمل

البدء من جديد

أوقف الخادم، واحذف prisma/maarifa.db، ثم شغّل npm run setup مرة أخرى.

البدء دون الأكاديمية التجريبية

شغّل npx prisma generate && npx prisma db push، ثم أفرغ المصفوفات في prisma/data/*.mjs وشغّل node prisma/seed.mjs لإنشاء المشرف وحده، أو احذف الدورات التجريبية من اللوحة (والدورات التي فيها متعلّمون تُؤرشف بدل الحذف). واضبط DEMO_INSTRUCTOR_PASSWORD="" حتى لا تُنشأ حسابات المدرّبين التجريبيين.

التالي: التثبيت اليدوي والنشر.