دليل المستخدم الشامل

شرح عملي مطابق لشاشات النظام: التقارير، ملف الإنجاز، التذاكر، الإشعارات والتعاميم، المشاركة والطباعة.

تنزيل الدليل (PDF)

1) نظرة عامة

هذا الدليل يشرح استخدام النظام كما هو مطبق فعليًا في المشروع، مع التركيز على الأدوار، مسارات العمل، والصلاحيات.
النظام مبني لإدارة عمليات المدرسة اليومية عبر وحدات متكاملة: التقارير، ملفات الإنجاز، التعاميم/الإشعارات، الطلبات (التذاكر)، وإدارة الاشتراكات.

2) الأدوار داخل النظام

  1. مدير النظام (Superuser)
  2. إدارة المنصة كاملة.

  3. إدارة المدارس، المشرفين، الباقات، الاشتراكات، المدفوعات، وسجلات التدقيق.

  4. مشرف المنصة (Platform Admin)

  5. يعمل ضمن نطاق مدارس محدد (Scope).

  6. الوصول إلى مدارس النطاق، عرض تقاريرها وتذاكرها، وإرسال تعاميم/إشعارات ضمن النطاق.

  7. مدير/مديرة المدرسة

  8. إدارة المدرسة النشطة: المعلمين، الأقسام، أنواع التقارير، تقارير المدرسة، التذاكر، والإشعارات/التعاميم.

  9. المعلم/المعلمة

  10. إنشاء التقارير، إدارة ملف الإنجاز، استقبال التعميمات والإشعارات، إنشاء طلبات الدعم/الطلبات المدرسية.

  11. عضو قسم / مسؤول قسم (Officer)

  12. صلاحيات مرتبطة بالقسم داخل المدرسة النشطة، خصوصًا في التقارير والطلبات.

3) مفاهيم أساسية يجب فهمها

  1. المدرسة النشطة (Active School)
  2. كل العمليات تتأثر بالمدرسة المختارة في الجلسة.

  3. في بيئة متعددة المدارس، يجب اختيار مدرسة نشطة قبل تنفيذ معظم مهام الإدارة.

  4. عزل البيانات بين المدارس

  5. التقارير، الإشعارات، التذاكر، والمعلمين تُعرض ضمن نطاق المدرسة النشطة وصلاحية المستخدم.

  6. العضويات متعددة المدارس

  7. يمكن ربط نفس المستخدم بأكثر من مدرسة عبر SchoolMembership.

  8. لكل مدرسة دور مستقل للمستخدم (معلم/مدير/مشرف تقارير).

  9. مسميات اللغة حسب نوع المدرسة

  10. إذا كانت المدرسة بنات تتغير المسميات تلقائيًا (مثل: مديرة المدرسة، المعلمة، رئيسة القسم).

4) تسجيل الدخول والتنقل الأساسي

  1. تسجيل الدخول

  2. عبر رقم الجوال (الأساسي) أو رقم الهوية (إذا كان مرتبطًا بالحساب).

  3. بعد الدخول

  4. يتم التوجيه حسب الدور:
  5. مدير النظام إلى لوحة المنصة.
  6. مدير المدرسة إلى لوحة المدير.

  7. المعلم إلى الصفحة الرئيسية.

  8. اختيار/تبديل المدرسة

  9. من شاشة اختيار المدرسة أو زر "تبديل المدرسة" في الهيدر (عند وجود أكثر من مدرسة).
  10. مدير المدرسة يرى في التبديل فقط المدارس التي هو مدير فيها.
  11. المعلم يرى المدارس التي لديه فيها عضوية نشطة.

5) دليل المعلم

5.1 الصفحة الرئيسية

  • ملخص سريع للوصول إلى: تقاريري، ملف الإنجاز، الإشعارات، التعاميم، الطلبات.

5.2 التقارير

  1. إنشاء تقرير
  2. المسار: /reports/add/
  3. الحقول: العنوان، التاريخ، اليوم، عدد المستفيدين، الفكرة، نوع التقرير، حتى 4 صور.

  4. النظام يضغط الصور ويتحقق من الحجم.

  5. تقاريري

  6. المسار: /reports/my/

  7. عرض التقارير الخاصة بالمعلم ضمن المدرسة النشطة.

  8. تعديل/حذف التقرير

  9. المسارات:
  10. تعديل: /reports/<id>/edit/

  11. حذف: /reports/<id>/delete/

  12. الطباعة والمشاركة

  13. طباعة: /reports/<id>/print/
  14. مشاركة عبر رابط آمن: /reports/<id>/share/

5.3 ملف الإنجاز

  1. ملفي
  2. المسار: /achievement/my/

  3. إنشاء ملف إنجاز حسب السنة الدراسية المتاحة للمدرسة.

  4. إدارة الملف

  5. عرض التفاصيل: /achievement/<id>/
  6. تعديل السنة: /achievement/<id>/update-year/

  7. حذف: /achievement/<id>/delete/

  8. إخراج ومشاركة

  9. PDF: /achievement/<id>/pdf/
  10. طباعة: /achievement/<id>/print/
  11. مشاركة: /achievement/<id>/share/

5.4 الإشعارات والتعاميم

  1. إشعاراتي

  2. /notifications/mine/

  3. تعاميمي الواردة

  4. /circulars/mine/

  5. التوقيع على التعميم

  6. /circulars/mine/<id>/sign/
  7. يتطلب إقرار + التحقق من الجوال المسجل عند تفعيل التوقيع الإلزامي.

5.5 الطلبات (Tickets)

  1. إنشاء طلب

  2. /requests/new/

  3. طلباتي

  4. /requests/mine/

  5. تفاصيل الطلب

  6. /requests/<id>/
  7. يمكن تتبع الحالة والملاحظات حسب الصلاحية.

5.6 الحساب الشخصي

  • /profile/ لتحديث بيانات الحساب المسموح بها.

6) دليل مدير المدرسة

6.1 لوحة المدير

  • /admin-dashboard/
  • إحصاءات: التقارير، المعلمون، التذاكر، مؤشرات تشغيلية.

6.2 تقارير المدرسة

  • /reports/admin/
  • عرض كل تقارير المدرسة النشطة مع فلاتر (تاريخ، معلم، نوع).

6.3 إدارة المعلمين

  1. القائمة

  2. /staff/teachers/

  3. إضافة معلم

  4. /staff/teachers/add/

  5. إذا كان رقم الجوال موجودًا مسبقًا: يتم ربط نفس الحساب بالمدرسة الحالية بدل إنشاء حساب جديد.

  6. استيراد جماعي

  7. /staff/teachers/import/

  8. تعديل/إزالة من المدرسة

  9. تعديل: /staff/teachers/<id>/edit/
  10. إزالة: /staff/teachers/<id>/delete/
  11. في تعدد المدارس: الحذف من شاشة المدير يزيل العضوية من المدرسة الحالية فقط (لا يحذف المستخدم عالميًا).

6.4 إدارة الأقسام

  1. الأقسام

  2. /staff/departments/

  3. إضافة/تعديل/حذف

  4. إضافة: /staff/departments/add/
  5. تعديل: /staff/departments/<code>/edit/

  6. حذف: /staff/departments/<code>/delete/

  7. أعضاء القسم

  8. /staff/departments/<code>/members/

6.5 أنواع التقارير

  • /staff/report-types/
  • إضافة وتخصيص الأنواع حسب المدرسة النشطة.

6.6 التعاميم والإشعارات

  1. إنشاء إشعار

  2. /notifications/create/

  3. إنشاء تعميم

  4. /circulars/create/

  5. التعاميم في النظام مرتبطة بالتوقيع الإلزامي وتتبع القراءة/التوقيع.

  6. المرسلة

  7. إشعارات مرسلة: /notifications/sent/

  8. تعاميم مرسلة: /circulars/sent/

  9. تقارير التوقيع

  10. طباعة: /notifications/<id>/signatures/print/
  11. CSV: /notifications/<id>/signatures.csv

6.7 الطلبات المدرسية

  1. طلبات المدرسة

  2. /requests/school/

  3. صندوق الوارد/المسند

  4. /requests/inbox/

  5. /requests/assigned/

  6. تفاصيل الطلب والطباعة

  7. /requests/<id>/
  8. /requests/<id>/print/

6.8 إعدادات المدرسة

  • /staff/my-school/
  • الحقول المحمية من التعديل (حسب الإعداد الحالي):
  • اسم المدرسة
  • المرحلة
  • بنين/بنات
  • المدينة

6.9 الاشتراك والمدفوعات

  1. حالة اشتراك المدرسة

  2. /subscription/my/

  3. سجل المدفوعات

  4. /subscription/history/

  5. رفع إيصال دفع

  6. /subscription/payment/create/

7) دليل مشرف المنصة ومدير النظام

7.1 مشرف المنصة (ضمن النطاق)

  1. دليل المدارس

  2. /platform/schools/

  3. دخول مدرسة ضمن النطاق

  4. /platform/schools/<id>/enter/

  5. لوحة المدرسة ضمن المنصة

  6. /platform/school/

  7. تقارير/تذاكر المدرسة

  8. /platform/school/reports/

  9. /platform/school/tickets/

  10. إرسال إشعار/تعميم ضمن النطاق

  11. /platform/school/notify/

7.2 مدير النظام

  1. لوحة المنصة

  2. /platform-dashboard/

  3. إدارة المشرفين

  4. /platform/admins/

  5. إدارة المدارس ومدراء المدارس

  6. /staff/schools/

  7. /staff/schools/managers/

  8. إدارة الباقات والاشتراكات والمدفوعات

  9. الباقات: /platform/plans/
  10. الاشتراكات: /platform/subscriptions/

  11. المدفوعات: /platform/payments/

  12. سجل عمليات التدقيق

  13. /platform/audit-logs/

8) آلية التعاميم والتوقيع (مختصر تشغيلي)

  1. المُرسل ينشئ تعميمًا مع تفعيل التوقيع.
  2. يصل التعميم للمستلمين حسب المدرسة/النطاق.
  3. المستلم يفتح التعميم ويوقّع بعد الإقرار.
  4. المدير يستخرج تقارير من وقّع/لم يوقّع من شاشة التوقيعات.

9) قيود ونقاط مهمة في النسخة الحالية

  1. الإشعارات الفورية تعمل داخل التطبيق المفتوح (WebSocket + تحديث العدادات).
  2. لا يوجد حاليًا Web Push كامل لإظهار تنبيه نظامي عند إغلاق التطبيق.
  3. الاشتراك الفعّال شرط أساسي لبعض عمليات المدارس (مثل إضافة عضويات معلمين).
  4. يوجد حد أقصى لعدد المعلمين حسب الباقة (max_teachers).

10) رسائل الخطأ الشائعة ومعناها

  1. active_school_required

  2. يجب اختيار مدرسة نشطة أولاً.

  3. Forbidden (CSRF token from POST incorrect.)

  4. غالبًا جلسة قديمة/تعارض CSRF؛ يلزم تحديث الصفحة وإعادة المحاولة.

  5. "ليست لديك صلاحية على هذه المدرسة"

  6. المدرسة النشطة خارج نطاق العضوية/الصلاحية الحالية.

11) أفضل ممارسات الاستخدام

  1. قبل أي عملية إدارية تأكد من المدرسة النشطة الصحيحة.
  2. عند إضافة معلم موجود مسبقًا استخدم نفس رقم الجوال لربط الحساب بدل إنشاء نسخة جديدة.
  3. للتعاميم الحساسة استخدم التوقيع الإلزامي + موعد نهائي.
  4. راجع سجل التوقيع دوريًا لضمان الامتثال.

12) مرفقات مفيدة داخل النظام

  1. دليل الاستخدام داخل المنصة: /guide/
  2. تحميل الدليل: /guide/download/
  3. الأسئلة الشائعة: /faq/
  4. سياسة الخصوصية: /privacy/