## نظرة عامة على المشروع
نظام إدارة مدرسة متكامل يربط بين جميع أطراف العملية التعليمية: الإدارة، المعلمين، الطلاب، وأولياء الأمور. يتكون النظام من ثلاثة مكونات رئيسية تعمل معاً لتوفير بيئة تعليمية متكاملة وشاملة.
---
## المكونات الرئيسية للنظام
### 1. تطبيق الإدارة (huda_admin)
تطبيق مخصص للإدارة والمعلمين والمشرفين لإدارة جميع جوانب المدرسة.
#### الوظائف الرئيسية:
**أ. إدارة المستخدمين:**
- إنشاء حسابات جديدة لجميع أنواع المستخدمين (مدير عام، مشرف، معلم، طالب، ولي أمر)
- عرض جميع المستخدمين مع إمكانية التصفية حسب الدور
- تعديل بيانات المستخدمين (الاسم، البريد الإلكتروني، الهاتف، العنوان)
- تفعيل أو تعطيل حسابات المستخدمين
- تفعيل أو تعطيل خاصية المحادثة للمستخدمين
- حذف المستخدمين (حذف ناعم أو حذف نهائي)
- إدارة صلاحيات المستخدمين حسب الأدوار
- دعم إضافة أشقاء للطلاب (طلاب مرتبطين بنفس ولي الأمر)
**ب. إدارة الصفوف:**
- إنشاء صفوف جديدة مع تحديد الاسم، القسم، السنة الدراسية، والسعة
- تعيين مشرف لكل صف
- عرض جميع الصفوف مع عدد الطلاب في كل صف
- تعديل بيانات الصفوف
- حذف الصفوف (مع التحقق من عدم وجود طلاب)
- إضافة طلاب للصفوف
- نقل طلاب بين الصفوف
- عرض الطلاب المتاحين (غير المخصصين لصف)
- عرض قائمة الطلاب في كل صف
**ج. إدارة البرنامج الدراسي:**
- إدارة المواد الدراسية (إنشاء، تعديل، عرض)
- إنشاء الجدول الدراسي للصفوف
- تعيين معلمين للمواد
- تحديد أوقات الحصص
- عرض الجدول الدراسي لكل صف
- تعديل الجدول الدراسي
- حذف الحصص من الجدول
**د. إدارة الواجبات:**
- إرسال واجبات للطلاب حسب الصف
- تحديد موعد التسليم
- تحديد نوع الواجب (واجب منزلي، مشروع، تقرير)
- إضافة تعليمات للواجب
- عرض الواجبات المرسلة لكل صف
- تصحيح الواجبات وتقييمها
- عرض الواجبات المقدمة من الطلاب
- حذف الواجبات
**هـ. إدارة الدرجات:**
- إعدادات درجات المواد لكل صف
- تحديد الحد الأقصى للدرجات (شفهي، دراسة، واجب، امتحان، المجموع)
- إدخال درجات الطلاب لكل مادة
- حساب النتيجة السنوية للطلاب
- نشر درجات الطلاب (لطالب واحد أو لصف كامل)
- عرض درجات الطلاب حسب المادة
- عرض النتيجة السنوية للطالب
**و. شؤون الطلاب:**
- **السلوكيات:** تسجيل سلوكيات الطلاب (إيجابية أو سلبية) مع النقاط
- **الغياب:** تسجيل غياب الطلاب مع تحديد الحصة وسبب الغياب
- **التأخير:** تسجيل تأخير الطلاب مع عدد الدقائق وسبب التأخير
- **الانضباط:** تسجيل إجراءات انضباطية للطلاب
- **زيارات أولياء الأمور:** تسجيل زيارات أولياء الأمور للمدرسة
- **ملاحظات المرشد:** تسجيل ملاحظات المرشد الطلابي عن الطلاب
- **ملاحظات أولياء الأمور:** تسجيل ملاحظات أولياء الأمور
- **المستلزمات:** إدارة بيع المستلزمات للطلاب
- **التوزيع التلقائي:** توزيع الطلاب تلقائياً على الصفوف
- **نقل الطلاب:** طلب نقل طالب من صف لآخر مع نظام الموافقة
**ز. نظام المحادثات:**
- إنشاء محادثات بين المستخدمين
- إرسال واستقبال الرسائل النصية
- عرض حالة الاتصال للمستخدمين (متصل الآن، آخر نشاط)
- تفعيل/تعطيل المحادثة للمستخدمين
- دعم المحادثات الفردية والجماعية
- عرض عدد الرسائل غير المقروءة
- تمييز الرسائل كمقروءة
- البحث في المحادثات
**ح. الإشعارات:**
- إرسال إشعارات لجميع المستخدمين أو فئة معينة
- إشعارات عند إرسال واجب جديد
- إشعارات عند إرسال رسالة جديدة
- إشعارات عند نشر الدرجات
- إشعارات عند إضافة ملاحظة أو سلوك
- عرض جميع الإشعارات
- تمييز الإشعارات كمقروءة
**ط. التقارير:**
- تقارير السلوكيات (حسب الطالب، الصف، الفترة الزمنية)
- تقارير الغياب (حسب الطالب، الصف، الفترة الزمنية)
- تقارير التأخير (حسب الطالب، الصف، الفترة الزمنية)
- تقارير الانضباط (حسب الطالب، الصف، الفترة الزمنية)
- تقرير شامل للطالب (يشمل جميع البيانات)
- تصدير التقارير
**ي. لوحة المعلومات:**
- إحصائيات المستخدمين (إجمالي المستخدمين، الطلاب، المشرفين)
- إحصائيات الصفوف (عدد الصفوف النشطة)
- إحصائيات الرسائل (إجمالي الرسائل، الرسائل غير المقروءة)
- إحصائيات قاعدة البيانات (عدد السجلات في كل جدول)
**ك. الإعدادات:**
- عرض إحصائيات قاعدة البيانات
- إدارة الإعدادات العامة
- عرض معلومات النظام
**ل. المساعدة:**
- دليل استخدام النظام
- الأسئلة الشائعة
- معلومات الاتصال
---
### 2. تطبيق الطلاب وأولياء الأمور (alhuda_school)
تطبيق مخصص للطلاب وأولياء الأمور لمتابعة الشؤون الدراسية.
#### الوظائف الرئيسية:
**أ. البرنامج الدراسي:**
- عرض الجدول الدراسي للطالب
- عرض المواد الدراسية
- عرض أوقات الحصص
- عرض أسماء المعلمين
**ب. الواجبات:**
- عرض الواجبات المرسلة للطالب
- عرض تفاصيل كل واجب (الموعد، التعليمات)
- تقديم الواجبات
- عرض حالة الواجب (معلق، مسلم، مصحح)
- عرض الدرجة والملاحظات على الواجب
**ج. الدرجات:**
- عرض درجات الطالب في جميع المواد
- عرض الدرجات التفصيلية (شفهي، دراسة، واجب، امتحان)
- عرض النتيجة السنوية
- عرض حالة النشر (منشور، غير منشور)
**د. المحادثات:**
- عرض قائمة المحادثات
- إنشاء محادثة جديدة مع المعلمين أو الإدارة
- إرسال واستقبال الرسائل
- عرض حالة الاتصال
- عرض عدد الرسائل غير المقروءة
**هـ. الإشعارات:**
- عرض جميع الإشعارات
- إشعارات الواجبات الجديدة
- إشعارات الرسائل الجديدة
- إشعارات الدرجات المنشورة
- تمييز الإشعارات كمقروءة
**و. الملف الشخصي:**
- عرض معلومات الطالب
- عرض معلومات ولي الأمر (للطلاب)
- عرض معلومات الأبناء (لأولياء الأمور)
- تغيير كلمة المرور
- تحديث البيانات الشخصية
**ز. لوحة المعلومات:**
- عرض ملخص سريع للواجبات المعلقة
- عرض ملخص سريع للرسائل غير المقروءة
- عرض ملخص سريع للإشعارات الجديدة
---
### 3. النظام الخلفي (Backend)
النظام الخلفي الذي يدير جميع العمليات والبيانات.
#### الوظائف الرئيسية:
**أ. إدارة المصادقة:**
- تسجيل الدخول للمستخدمين
- تسجيل الخروج
- تحديث كلمة المرور
- استعادة كلمة المرور
- تحديث البيانات الشخصية
- إدارة الجلسات
- التحقق من الصلاحيات
**ب. إدارة المستخدمين:**
- عمليات CRUD كاملة للمستخدمين
- إدارة الأدوار والصلاحيات
- تفعيل/تعطيل الحسابات
- تفعيل/تعطيل المحادثة
- تصدير بيانات الطلاب حسب التاريخ
**ج. إدارة الصفوف:**
- عمليات CRUD كاملة للصفوف
- إدارة الطلاب في الصفوف
- نقل الطلاب بين الصفوف
- إحصائيات الصفوف
**د. إدارة المواد والجدول:**
- إدارة المواد الدراسية
- إدارة الجدول الدراسي
- تعيين المعلمين
**هـ. إدارة الواجبات:**
- إرسال الواجبات
- استقبال تسليمات الطلاب
- تصحيح الواجبات
- إشعارات الواجبات
**و. إدارة الدرجات:**
- إعدادات درجات المواد
- إدخال درجات الطلاب
- حساب النتائج
- نشر الدرجات
**ز. شؤون الطلاب:**
- إدارة السلوكيات
- إدارة الغياب
- إدارة التأخير
- إدارة الانضباط
- إدارة الزيارات
- إدارة الملاحظات
- إدارة المستلزمات
- إدارة النقل
**ح. نظام المحادثات:**
- إدارة المحادثات
- إدارة الرسائل
- إدارة حالة الاتصال
- إدارة حالة القراءة
- دعم المحادثات الفردية والجماعية
**ط. نظام الإشعارات:**
- إرسال الإشعارات
- إدارة رموز الإشعارات
- تتبع حالة الإشعارات
**ي. التقارير:**
- توليد التقارير المختلفة
- تصدير البيانات
**ك. الأمان:**
- حماية المسارات
- التحقق من الصلاحيات
- تحديد معدل الطلبات
- حماية من الهجمات
---
## الإحصائيات والبيانات
### إحصائيات لوحة المعلومات:
1. **إجمالي المستخدمين:** عدد جميع المستخدمين النشطين في النظام
2. **الطلاب:** عدد الطلاب المسجلين
3. **المشرفون:** عدد المشرفين
4. **الصفوف:** عدد الصفوف النشطة
### إحصائيات قاعدة البيانات:
1. **المستخدمين:** عدد سجلات المستخدمين
2. **المحادثات:** عدد المحادثات
3. **الرسائل:** عدد الرسائل
4. **الإشعارات:** عدد الإشعارات
5. **الطلاب:** عدد سجلات الطلاب
6. **المعلمين:** عدد المعلمين
7. **الصفوف:** عدد الصفوف
8. **المواد:** عدد المواد الدراسية
9. **الجدول:** عدد الحصص في الجداول
10. **الواجبات:** عدد الواجبات
11. **التسليمات:** عدد تسليمات الواجبات
12. **الطلبات:** عدد طلبات القبول
### إحصائيات الطلاب:
- عدد الطلاب في كل صف
- عدد الطلاب المتاحين (غير المخصصين)
- عدد الطلاب حسب السنة الدراسية
### إحصائيات الواجبات:
- عدد الواجبات المرسلة لكل صف
- عدد الواجبات المقدمة
### إحصائيات الدرجات:
- عدد المواد التي تم إدخال درجاتها
- عدد الطلاب الذين تم نشر درجاتهم
- عدد الطلاب الذين لم يتم نشر درجاتهم
### إحصائيات شؤون الطلاب:
- عدد السلوكيات المسجلة
- عدد حالات الغياب
- عدد حالات التأخير
- عدد إجراءات الانضباط
- عدد الزيارات
- عدد الملاحظات
---
## الميزات الإضافية
### 1. نظام الصلاحيات:
- تسلسل هرمي للصلاحيات (مدير عام > مشرف > معلم > طالب/ولي أمر)
- كل دور له صلاحيات محددة
- التحقق من الصلاحيات في كل عملية
### 2. نظام الإشعارات:
- إشعارات فورية عند الأحداث المهمة
- إشعارات محلية على الجهاز
- إشعارات عبر الإنترنت
- تتبع حالة الإشعارات
### 3. نظام المحادثات:
- محادثات فردية بين مستخدمين
- محادثات جماعية
- عرض حالة الاتصال
- تتبع الرسائل المقروءة وغير المقروءة
- تفعيل/تعطيل المحادثة للمستخدمين
### 4. الأمان:
- تشفير كلمات المرور
- حماية المسارات
- تحديد معدل الطلبات
- التحقق من الصلاحيات
- حماية من الهجمات الشائعة
### 5. التصدير والاستيراد:
- تصدير بيانات الطلاب
- تصدير التقارير
- استيراد بيانات الطلاب
### 6. البحث والتصفية:
- البحث في المستخدمين
- البحث في الطلاب
- التصفية حسب الدور
- التصفية حسب الصف
- التصفية حسب التاريخ
### 7. التقارير الشاملة:
- تقارير مفصلة لكل جانب من جوانب النظام
- إمكانية التصدير
- تقارير حسب الفترة الزمنية
- تقارير حسب الطالب أو الصف
---
## سير العمل في النظام
### 1. تسجيل الدخول:
- المستخدم يسجل الدخول بحسابه
- النظام يتحقق من البيانات
- يتم توجيه المستخدم للوحة المعلومات المناسبة حسب دوره
### 2. إدارة الطلاب:
- الإدارة تنشئ حسابات للطلاب
- يتم تعيين الطلاب للصفوف
- يمكن نقل الطلاب بين الصفوف
### 3. إدارة المواد والجدول:
- الإدارة تنشئ المواد الدراسية
- يتم إنشاء الجدول الدراسي
- يتم تعيين المعلمين للمواد
### 4. إرسال الواجبات:
- المعلم يرسل واجب للصف
- الطلاب يتلقون إشعار
- الطلاب يقدمون الواجب
- المعلم يصحح الواجب
### 5. إدخال الدرجات:
- المعلم يدخل درجات الطلاب
- يتم حساب النتيجة السنوية
- يتم نشر الدرجات للطلاب
### 6. شؤون الطلاب:
- يتم تسجيل السلوكيات والغياب والتأخير
- يتم إرسال إشعارات لأولياء الأمور
- يمكن لأولياء الأمور التواصل مع المدرسة
### 7. التواصل:
- يمكن للمستخدمين إنشاء محادثات
- إرسال واستقبال الرسائل
- تتبع حالة الرسائل
---
## الخلاصة
نظام إدارة مدرسة متكامل يغطي جميع جوانب العملية التعليمية من إدارة المستخدمين والصفوف إلى الواجبات والدرجات وشؤون الطلاب والتواصل. النظام يوفر واجهات سهلة الاستخدام لكل نوع من المستخدمين مع نظام صلاحيات محكم وأمان عالي.
---