دليل استكشاف الأخطاء وإصلاحها (Troubleshooting Guide)

مرحباً بك في مركز الدعم واستكشاف الأخطاء لوحة تحكم Skool.Cool. يحتوي هذا الدليل على الحلول الفورية لأشهر المشاكل التشغيلية التي تواجه مديري المدارس والمنسقين في الميدان.

---

🔍 فهرس الحلول السريعة

1. مشاكل الدخول وتعليق الحساب (Login & Temporary Password)

• الأعراض: المستخدم غير قادر على تسجيل الدخول ويواجه خطأ متكرراً، أو يدخل في حلقة مفرغة لإعادة التوجيه لصفحة تغيير كلمة المرور.
• السبب: انتهاء صلاحية الجلسة، أو إدخال خاطئ متكرر أدى لقفل الحساب (عدّاد المحاولات الفاشلة), أو عدم إتمام شروط كلمة المرور القوية للمستفيد الجديد.
• الحل:
  1. تأكد من خلو بريد المستخدم من المسافات الفارغة قبل الرفع.
  2. إذا كانت كلمة المرور مؤقتة، تأكد من استيفاء الشروط الخمسة للقوة (8 خانات، حرف كبير، حرف صغير، رقم، ورمز).
  3. إذا قُفل الحساب، اطلب من SystemAdmin الدخول لشاشة إدارة الحسابات والضغط على زر إلغاء قفل الحساب [Unlock Account].

2. النشاط لا يظهر لأولياء الأمور (Activity Not Visible)

• الأعراض: يقوم ولي الأمر بالبحث عن الدورة الجديدة في تطبيقه ولا يجدها للتسجيل.
• السبب: حالة النشاط الفنية لا تزال مسودة (Closed)، أو لم يحن تاريخ بدء التسجيل الفعلي، أو أن الفئة العمرية للطفل لا تتطابق مع الفئات المحددة للنشاط.
• الحل:
  1. توجه لشاشة الأنشطة وتأكد من حالة النشاط. إذا كان مكتوباً بجانبه Closed أو Draft باللون البرتقالي، افتحه واضغط على نشر [Publish].
  2. تحقق من أن خيار [Allowed for Parent] مفعل في التبويب الخامس لتمكين أولياء الأمور من التصفح.
  3. تأكد من مطابقة تاريخ ميلاد الطفل مع الفئات العمرية المسندة للنشاط.

3. تعذر اعتماد طلب التسجيل (Cannot Approve)

• الأعراض: يضغط المنسق على زر القبول [Approve] ولكن تظهر رسالة خطأ باللون الأحمر ولا تتغير حالة الطالب.
• السبب: وصول النشاط للحد الأقصى للسعة الاستيعابية (Capacity)، أو تم أرشفة النشاط في الخلفية.
• الحل:
  1. تحقق من عدد الطلاب المقبولين حالياً مقارنة بالسعة.
  2. إذا امتلأ النشاط، يجب عليك أولاً زيادة السعة الاستيعابية من خيارات تعديل النشاط (مثلاً من 20 إلى 25)، أو الاكتفاء بالضغط على خيار النقل لقائمة الانتظار [Move to Waiting List] للطالب لحين خلو مقعد.

4. قفل وتجميد تعديل جداول الحصص (Schedule Locked)

• الأعراض: يحاول المسؤول تعديل أيام الحصص أو أوقات البدء ولكن الحقول تظهر رمادية ومجمدة (Read-only).
• السبب: تم تسجيل حضور وغياب الطلاب لأول حصة فعلياً في الجدول، مما يدعو الخادم لقفل المواعيد تلقائياً لحماية المزامنة التاريخية لدفاتر التحضير.
• الحل:
  • لا يمكن تعديل الجداول برمجياً بعد بدء الحضور. إذا كان التعديل ضرورياً جداً بسبب خطأ هيكلي كبير، يجب عليك نسخ النشاط بالكامل عبر خيار [Copy Activity] وتصحيح الجدول في النسخة الجديدة، ثم نقل الطلاب إليها وتأدية الحضور مجدداً.

5. أخطاء شائعة عند استيراد Excel (Excel Import Failures)

• الأعراض: تفشل عملية رفع ملف أولياء الأمور أو الطلاب وتظهر رسالة خطأ حمراء عامة.
• السبب: اختلاف ترتيب الأعمدة عن النموذج القياسي، وجود سطور فارغة في منتصف الملف، أو رفع أرقام هاتف أطفال غير مقرونة بأولياء أمورهم.
• الحل:
  1. قم دائماً بتحميل النموذج الفارغ عبر زر [Download Template] وعبئ بياناتك داخله دون تغيير أسماء أو ترتيب الترويسات في الصف الأول.
  2. تأكد من أن ملف الطلاب يحتوي فقط على أرقام جوالات لأولياء أمور تم استيرادهم وتفعيلهم مسبقاً في النظام.
  3. قم بتحميل تقرير الأخطاء [Download Error File] المولد تلقائياً لقراءة تفاصيل الخطأ المحددة لكل سطر خاطئ.

6. تعثر العمليات المالية المعلقة (Payment Stuck)

• الأعراض: قام ولي الأمر بالسداد البنكي وخصم المبلغ من بطاقته، ولكن لا يزال حسابه يظهر بانتظار الدفع [Awaiting Payment].
• السبب: انقطاع لحظي لشبكة الاتصال التلقائية مع بوابة الدفع الإلكتروني StreamPay.
• الحل:
  • توجه لصفحة إدارة التسجيل للطالب، واضغط على زر تأكيد الدفع [Confirm Payment]، ثم أدخل رقم المعاملة المرجعي للبنك في حقل رقم الإيصال لتأكيد التسوية يدوياً وتحويل الطالب لحالة نشط.

7. فشل حفظ تحضير الحضور والغياب (Attendance Not Saving)

• الأعراض: تظهر علامة خطأ حمراء [Error] في أعلى شاشة تحضير الحصة وتتوقف حركة الحفظ التلقائي.
• السبب: انقطاع مؤقت لشبكة الواي فاي أو شبكة الإنترنت لدى المدرب أثناء تواجده في الميدان.
• الحل:
  1. لا تغلق تبويب المتصفح لتجنب ضياع التحضير الجاري (يقوم النظام بحمايتك عبر unload guard).
  2. استمر في رصد حضور الطلاب بشكل طبيعي، حيث سيتم تجميع الحركات مؤقتاً في ذاكرة المتصفح.
  3. بمجرد عودة إشارة الإنترنت للعمل، اضغط على زر إعادة المحاولة [Retry Save] لتثبيت وحفظ الحركات التراكمية في قاعدة البيانات دفعة واحدة.