🎓 RSA Academy — رياض الصالحين
منصة تعليمية متكاملة (Next.js + Supabase) لإدارة سنترات ومراكز التقوية: متابعة الطلاب والمعلمين وأولياء الأمور من مكان واحد، بأربع بوابات دخول منفصلة حسب الدور.
لقطة من المنصة وهي شغالة (النسخة المنشورة على الإنترنت)
(الصفحة الرئيسية للمنصة على الدومين الفعلي — لسه مرحلة الإطلاق الأولى، وبعض الخدمات ظاهرة عليها "SOON" لحد ما يتم تفعيلها بالكامل.)
المميزات
- أربع بوابات حسب الدور: أدمن، معلم (Teacher)، ولي أمر (Parent)، وطالب (Student)، كل واحدة بصلاحياتها وواجهتها الخاصة.
- لوحة تحكم الأدمن: إدارة الطلاب، المعلمين، أولياء الأمور، الفصول (Classes)، المواد الدراسية، الإعلانات، والتقارير، مع سجل أمان (Security Logs) لتتبع العمليات الحساسة.
- درجات وامتحانات لحظية: تحديث الدرجات يوصل للطالب/ولي الأمر بدون ما يعمل Refresh للصفحة.
- ربط الطالب بولي الأمر ومتابعة أكتر من طالب من حساب واحد.
- دفتر درجات للمعلم (Gradebook) لكل فصل يدرّسه.
- إشعارات وتذكيرات مجدولة (Cron Jobs) للمدفوعات والحضور.
- مصادقة ثنائية (2FA) وتسجيل دخول آمن عبر Supabase Auth.
- واجهة عربية بالكامل (RTL) بخط Cairo.
لقطة الشاشة
اللقطة أعلاه من الرابط الفعلي اللي المشروع منشور عليه: rsa-academy.online
التقنيات المستخدمة
- Next.js 16 (App Router) + React 19 + TypeScript
- Supabase (قاعدة بيانات + مصادقة)
- Tailwind CSS 4 + shadcn/ui
- React Hook Form + Zod للتحقق من صحة البيانات
- Resend للإيميلات، Google Drive API للتخزين، Upstash Redis للـ Rate Limiting
طريقة التشغيل محليًا
npm install
cp .env.example .env.local # وحطّ فيه بيانات Supabase وباقي المفاتيح (راجع CREDENTIALS_GUIDE.md)
npm run dev
المشروع هيفتح على http://localhost:3000.
البناء للإنتاج
npm run build
npm run start
مستندات إضافية
الريبو فيه توثيق تفصيلي جاهز:
MASTER_README.md / RSA_ACADEMY_COMPLETE_BLUEPRINT_FINAL_V2.md — الخطة الكاملة للمشروعCREDENTIALS_GUIDE.md — إزاي تجيب كل الـ API Keys المطلوبةTECHNICAL_DECISIONS.md — القرارات التقنية وأسبابهاSTUDENT_SUBJECTS_SYSTEM_DOCUMENTATION.md / TEACHER_PAYMENT_SYSTEM.md — توثيق أنظمة فرعية داخل المنصة
