شرح مشروع حلقة 📚
🎯 ما هو المشروع؟
Halaqa هو نظام إدارة حلقات دراسة القرآن الكريم. يساعد المؤسسات التعليمية على تنظيم الحلقات، جدولة الجلسات، وتتبع حضور الطلاب بسهولة.
🏗️ البنية التقنية
المشروع عبارة عن Monorepo يحتوي على:
client: واجهة المستخدم (React 19 + Vite + Tailwind v4)
backend: الخادم (NestJS + Prisma + MySQL)
shared: الأكواد المشتركة (DTOs, Enums, Utils)
✨ المميزات الرئيسية
👥 إدارة المستخدمين
أدوار متعددة: مدير، مشرف، معلم، طالب
صلاحيات محددة لكل دور
حسابات جاهزة للتجربة
🕌 إدارة الحلقات
إنشاء وتعديل حلقات الدراسة
تعيين معلمين وطلاب
ربط كل حلقة بمنطقة زمنية محددة
📅 جدولة الجلسات
جدولة تلقائية حسب قواعد متكررة
دعم المناطق الزمنية المختلفة
حساب دقيق للأوقات (UTC → منطقة الحلقة → منطقة المستخدم)
✅ تتبع الحضور
تسجيل حضور الطلاب
حالات متعددة: حاضر، غائب، غائب بعذر
https://github.com/BelalHaiss/halaqa
للتجربة
https://staging.ummahplatform.com/
username :admin - moderator- tutor
password:12345678
