EduBridge Palestine — جسر التعليم فلسطين

منصة تعليمية تكيفية (MVP) لاسترداد الفاقد التعلمي في فلسطين، موجهة للصفوف 7–10 ودعم قرار المسار للصف العاشر.

المتطلبات

• Node.js 18+
• npm أو yarn

التثبيت والتشغيل

1. تثبيت الاعتماديات

npm install
cd backend && npm install
cd ../frontend && npm install

2. إعداد قاعدة البيانات (Backend)

cd backend
cp .env.example .env
# عدّل .env إذا رغبت (DATABASE_URL، JWT_SECRET، PORT)
npx prisma generate
npx prisma db push
npx prisma db seed

3. تشغيل الواجهة الخلفية (API)

cd backend
npm run dev

الـ API يعمل على: http://localhost:4000

4. تشغيل الواجهة الأمامية

في طرفية أخرى:

cd frontend
echo "NEXT_PUBLIC_API_URL=http://localhost:4000" > .env.local
npm run dev

الواجهة تعمل على: http://localhost:3000

تشغيل الاثنين معاً من الجذر

npm run dev

(يشغّل backend و frontend معاً عبر concurrently)

حسابات تجريبية

الدور	البريد	كلمة المرور
معلم	teacher@edubridge.ps	password123
طالب	student@edubridge.ps	password123

الطالب التجريبي مسجّل في الصف 8. يمكن إنشاء طالب جديد من صفحة التسجيل واختيار الصف (7–10).

هيكل المشروع

├── backend/                 # Node.js + Express + Prisma
│   ├── prisma/
│   │   ├── schema.prisma    # النماذج وقاعدة SQLite
│   │   └── seed.js          # بيانات أولية (مواد، مفاهيم، دروس، أسئلة، مستخدمين)
│   └── src/
│       ├── routes/          # مسارات API (auth, assessment, learning, reports, ...)
│       ├── services/        # منطق التقييم والتخطيط والتوصية (قابل لاستبداله بـ ML لاحقاً)
│       ├── middleware/      # المصادقة JWT
│       └── server.js
├── frontend/                # Next.js 14 (App Router) + TypeScript + Tailwind
│   ├── app/
│   │   ├── page.tsx         # الصفحة الرئيسية
│   │   ├── (auth)/          # تسجيل الدخول / إنشاء حساب
│   │   ├── dashboard/       # لوحة الطالب (التقييم، التعلم، التحليلات، التقارير، المسار)
│   │   └── report/[token]/  # تقرير مشارك (رابط عام)
│   ├── contexts/            # AuthContext
│   └── lib/api.ts           # استدعاءات API
└── README.md

المميزات المنجزة (MVP)

1. الصفحة الرئيسية — شرح الفاقد التعلمي والتعلم التكيفي + CTA "ابدأ التقييم التشخيصي".
2. المصادقة — تسجيل طالب (بريد + كلمة مرور + صف) وتسجيل دخول طالب/معلم.
3. لوحة الطالب — الصف، آخر تشخيصي، مفاهيم ضعيفة، خطة تعلم، زر "تابع التعلم".
4. التقييم التشخيصي — أسئلة حسب المادة/الصف/المفهوم، إرسال، تحليل وإيجاد فجوات، حفظ النتائج وإنشاء خطة تعلم.
5. التعلم التكيفي — دروس لها متطلبات سابقة؛ إدراج تلقائي للمتطلبات ثم فتح الدرس الحالي؛ عرض مسار التعلم.
6. مولد خطة التعلم — خدمة (قاعدة قواعد) تولّد ترتيب الدروس وتقوية المفاهيم (جاهزة لاستبدالها بنماذج ML).
7. التتبع والتحليلات — دقة، وقت، تحسن حسب المفهوم؛ مقارنة تشخيصي/نهائي؛ رسوم (Recharts).
8. التقارير — فجوات قبل/بعد، نسبة التحسن، مستوى الجاهزية، تصدير PDF ورابط مشاركة.
9. توصية مسار الصف العاشر — واحد من 5 مسارات، تفسير بالعربية وخطة تقوية (قاعدة قواعد قابلة للاستبدال بـ ML).

خدمات الـ "ذكاء الاصطناعي" (قاعدة قواعد — قابلة لاستبدالها لاحقاً)

• AssessmentAnalyzer — تحليل إجابات التقييم وحساب النسب حسب المفهوم.
• LearningGapDetector — تحديد المفاهيم الضعيفة (تحت عتبة إتقان).
• LearningPlanGenerator — ترتيب الدروس مع مراعاة المتطلبات السابقة والفجوات.
• PathRecommendationEngine — توصية المسار (علمي/أدبي/صناعي/تجاري/زراعي) مع تفسير عربي.

أوامر مفيدة

# إنشاء/تحديث جداول DB
cd backend && npx prisma db push

# إعادة تعبئة البيانات الأولية
cd backend && npx prisma db seed

# فتح Prisma Studio
cd backend && npx prisma studio

الترخيص

هذا المشروع لأغراض تعليمية وتمكين استرداد الفاقد التعلمي في فلسطين.