أكواد حضور الطلاب ومؤشرات مركز الحضور (Attendance Reference)

يوفر هذا المرجع التقني الأكواد الفنية المعتمدة لتمثيل حالة حضور الطلاب، وكيفية حساب مؤشرات الأداء (KPIs) في مركز الحضور والغياب (Attendance Hub).

1. أكواد حالات الحضور الثلاثية (Tri-State Attendance Codes)

تُحفظ حالة حضور الطالب في كشف الحصص فنيًا تحت حقل isAttended الذي يقبل ثلاث قيم منطقية فقط:

القيمة البرمجية (Value)	المسمى في الواجهة	المسمى المعتمد بالعربية	التأثير الإحصائي والتشغيلي
`true`	`Present`	حاضر	يُحتسب الطالب كحاضر في النسبة المئوية للحصة والمدرسة.
`false`	`Absent`	غائب	يُحتسب الطالب كغائب ويُسجل الغياب في ملفه ويؤثر على النسبة سلباً.
`null` (أو فارغ)	`Unmarked`	غير محضر	لا يدخل الطالب في الحساب الإحصائي للنسبة (تجاهل) بانتظار تحضيره.

تُحسب الأرقام والمؤشرات المعروضة في شاشة مركز الحضور للمدرسة كالتالي:

التعريف: عدد الأنشطة الجارية التي تحتوي على حصة واحدة على الأقل في الماضي لم تكتمل نسبة تحضير طلابها بنسبة 100%.
المعنى التشغيلي: ينبه المنسق بوجود حصص مهملة لم يقم المدرب بتحضيرها بعد.

التعريف: المجموع الإجمالي لعدد الطلاب المتبقين دون رصد حالة (حاضر أو غائب) في كافة الحصص الماضية للفرع.
المعادلة: SUM(Unmarked Student Sessions)

التعريف: النسبة المئوية للطلاب الحاضرين الفعليين مقارنة بإجمالي الطلاب الذين تم رصد حالاتهم (حاضرين وغائبين معاً).
المعادلة الرياضية: $$\text{Attendance Rate} = \left( \frac{\text{Attended Count}}{\text{Marked Count}} \right) \times 100$$ (ملاحظة: لا تدخل قيم Unmarked في حساب هذه النسبة تجنباً لإعطاء مؤشرات منخفضة خاطئة).

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