ما تحتاجه
- 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="" حتى لا تُنشأ حسابات المدرّبين التجريبيين.
التالي: التثبيت اليدوي والنشر.