ملفات الطلاب

ملف الطالب هو طبقة التركيب في حلقة التدخل المبني على الاستجابة (RTI). بعد أن يُنتج محرك حالة المهارة حالةَ المهارة والمجال لكل طالب، تقوم وحدة modules/profile بتركيب تلك الحالات في ملف تعليمي واحد لكل طالب لكل نافذة تقييم: كائن منظَّم يُحرِّك توصية التدخل والسردية الموجَّهة للمعلم.

الملفات هي تمثيلات داخلية للمطوِّرين بالكامل. الرموز الواردة في هذه الصفحة (معرِّفات الملفات الأولية، ومفاتيح التعديل، والأعلام الفرعية) هي معرِّفات في نموذج بيانات النظام. لا تُعرض أبدًا للطلاب أو العائلات.

ما يحتويه الملف

يتكون الملف المُحلَّل من خمس طبقات، كل منها أكثر تحديدًا من السابقة.

الطبقة	ما تُجيب عنه
الملف الأولي	ما النمط التعليمي الأوسع الذي يصف هذا الطالب حاليًا؟
محرِّك الوصول	للملفات المرتبطة بالاستيعاب، هل العائق هو فك التشفير أم الدقة أم الطلاقة؟
الملف الفرعي للاستيعاب	إذا كانت الفجوة في الاستيعاب، هل هي حرفية أم استنتاجية أم مختلطة؟
ملفات التعديل (حتى 5)	ما الأنماط المصاحبة التي يجب إضافتها على التوصية الأساسية؟
الأعلام الفرعية (حتى 8)	ما إشارات المهارة الدقيقة التي يجب إبرازها للمعلم؟

الملفات الأولية

يُختار الملف الأولي من قائمة مغلقة تضم نحو 12 رمزًا. PR2-00 / DATA_INCOMPLETE هو حارس النظام الذي يشير إلى عدم توفر أدلة كافية بعد لتعيين أي ملف تعليمي. فهو ليس ملفًا تعليميًا “حقيقيًا” أبدًا ويحجب مسار توصية التدخل بالكامل.

عندما يُرجع محرك حالة المهارة do_not_decide_yet (مؤشر قاعدة التعادل الموضَّح في محرك القرار)، أو عندما يكون الطالب في حالة DATA_INCOMPLETE، لا تكتب وحدة الملفات أي صف تعيين، بل تسجّل رفضًا منظَّمًا في سجل التدقيق ويُعيد نقطة نهاية القراءة حالة الحارس مع حالة 200. هذا مقصود: ليس لدى النظام ما يقوله ذا معنى بعد، والصدق أفضل من التخمين.

محرِّك الوصول

يُضيق الملفات الأولية ذات الصلة بالاستيعاب. القيم: decoding_driven، accuracy_driven، fluency_driven، mixed_access.

الملف الفرعي للاستيعاب

يُضيق أكثر ملفات فجوة الاستيعاب. القيم: literal_gap، inferential_gap، mixed_comprehension_gap.

ملفات التعديل

يمكن أن تتزامن حتى 5 ملفات تعديل مع الملف الأولي. تمثِّل أنماطًا ثانوية يجب أن تعالجها خطة التدخل جنبًا إلى جنب مع المحور:

مفتاح التعديل	ما تشير إليه
`VOCAB_SYNTAX_MORPH_GAP`	ضعف في المفردات أو بنية الجملة أو الصرف مصاحب للملف الأولي
`ARABIC_ACCURACY_ONLY_MONITOR`	مؤشرات دقة الميزات العربية تحتاج إلى مراقبة (ليست ملفًا مستقلًا)
`WRITING_SPELLING_SUPPORT`	طبقة دعم الكتابة والإملاء مطلوبة
`LISTENING_LANGUAGE_SUPPORT`	دعم الاستماع وفهم اللغة مطلوب
`ON_TRACK_WITH_SKILL_ALERT`	على المسار عمومًا لكن هناك تنبيه مهارة مفتوح

الأعلام الفرعية

الأعلام الفرعية الـ 8 هي أكثر إشارة دقيقة في الملف:

العلم الفرعي	قيد النطاق
`AR_MADD_FLAG`	عناصر مكتوبة/بصرية فقط؛ لا يُستنتج من قياسات الطلاقة
`AR_SHORT_VOWEL_FLAG`	عناصر مكتوبة/بصرية فقط
`AR_ORTHOGRAPHIC_CONFUSION_FLAG`	ارتباك بصري/إملائي فقط (ليس سمعيًا)
`AR_SHADDA_FLAG`	مُعطَّل في هذه المرحلة (`enabled=false`، لا يتقدّم أبدًا)
`VOCAB_ALERT`	إشارة مفردات
`SYNTAX_ALERT`	إشارة بنية الجملة
`MORPH_ALERT`	إشارة صرف
`WR_SP_ALERT`	إشارة كتابة وإملاء

أعلام الميزات العربية الفرعية (AR_MADD_FLAG، AR_SHORT_VOWEL_FLAG، AR_ORTHOGRAPHIC_CONFUSION_FLAG، AR_SHADDA_FLAG) لا يمكن اشتقاقها إلا من عناصر التقييم المكتوبة/البصرية، أبدًا من قياسات طلاقة القراءة الشفهية أو مسابر القياس. AR_ORTHOGRAPHIC_CONFUSION_FLAG بصري/إملائي فقط، وليس سمعيًا. AR_SHADDA_FLAG مُعطَّل صراحةً (enabled=false) ولا يتقدّم أبدًا. الهمزة خارج نطاق هذه المرحلة.

R12: الأعلام الفرعية محرّك أنماط ذو حالة في وقت التدريب

أعادت R12 (Q4) تأطير الأعلام الفرعية من ربط مسطّح في وقت التقييم بصيغة “تتجمع في ملفات التعديل” إلى محرّك أنماط دقيقة ذي حالة يعمل في وقت التدريب (الوحدة الجديدة modules/subflag؛ الوثيقة 23-student-profiles.md §4b، FR-SPR-4). والمرحلتان مختلفتان عمدًا:

أثناء التقييم لا يوجد أي تنبيه علم فرعي قائم على عدّ الأخطاء. فالضعف المؤكَّد في المهارة/المجال هو الدليل، ويتدفّق مباشرةً إلى الملف والحزمة؛ ولا يُستدعى محرّك الأعلام الفرعية أبدًا على استجابة تقييم.
أثناء التدريب (التمرين) يعمل سُلَّم لكل (طالب × micro_pattern):

المستوى	الشرط	الأثر
L1 (`candidate`)	أول حدوث صالح	تسجيل فقط — لا مؤشر ولا دعم ولا تنبيه للمعلم
L2 (`automatic_support_active`)	≥ 2 حدوث عبر ≥ 2 عنصرين صالحين متمايزين، في الجلسة نفسها	يُطلَق دعم تلقائي (سقالة/تلميح/جسر دقيق) — بلا تنبيه للمعلم
L3 (`teacher_alert_active`)	≥ 3 حدوثات صالحة عبر ≥ 2 جلستين، والدعم سبق تقديمه، والنمط مستمر	تنبيه معلم خفيف إعلامي

ثابتٌ حامل لمبدأ V-12. تنبيه L3 إعلامي فقط: يجب ألّا يُغيّر الدرجة الخام، ولا حالة المجال، ولا الملف الأولي، ولا مستوى RTI، ولا الطبقة (Tier). يُحرّك المحرّك الدعم التلقائي أولًا ثم تنبيهًا لا يُغيّر الدرجة فقط عند استمرار النمط. ويكتب فقط sub_flag_indicator_state وsub_flag_indicator_occurrence ومصبّ الإصدار-فقط platform_alert_log، بفرض من lint:subflag-alert-no-mutation. أخطاء ORF/CBM لا تُطلِق هذه المؤشرات أبدًا.

دورة حياة تعيين الملف

كل تعيين ملف يبدأ في حالة pending_teacher_review. يصبح active فقط عندما يؤكده المعلم صراحةً. وهذا هو مبدأ V-12 بأن المعلم يقرر في كل خطوة. حالات دورة الحياة هي:

الحالة	المعنى
`pending_teacher_review`	محسوب؛ ينتظر تأكيد المعلم
`active`	المعلم أكّده؛ يُحرِّك توصية التدخل
`superseded`	إعادة حساب أنتجت تعيينًا أحدث؛ هذا مؤرشَف
`withdrawn`	أشار المعلم إلى الحاجة لمزيد من البيانات؛ لا تعيين نشط

عند إعادة الحساب، ينتقل أي تعيين active سابق إلى superseded ويُكتب صف pending_teacher_review جديد. لا يكون للطالب ملف نشط حتى يؤكد المعلم الجديد. تُطبِّق قاعدة بيانات قيد UNIQUE جزئي على (org, student, window) WHERE status='active'.

السرديات

كل ملف نشط يُنتج سردية مكتوبة مسبقًا تُعرض حسب الجمهور. قيم الجمهور المدعومة الثلاث لمعامل API هي teacher وparent وadmin. (student_tasks_only هو وضع عرض داخلي؛ وليس قيمة صالحة لمعامل الاستعلام audience. تُعيد النقطة الطرفية خطأ 422 لأي قيمة خارج teacher وparent وadmin.) لا تُقدَّم نسخة موجَّهة للطالب عبر هذه النقطة.

السرديات مصدرها مكتبة من 15 قالب SPOT × 4 مستويات دراسية (60 نسخة مُصيَّغة). هي مؤلَّفة بالقواعد، ولا يوجد ذكاء اصطناعي في مسار السردية. كل نص سردية يمر عبر مرشح سلامة اللغة قبل الكتابة أو الإرجاع. النسخة الموجَّهة للوالدين تُطبِّق المرشح الأكثر صرامة: بدون درجات رقمية، بدون مصطلحات داخلية، لغة نمو فقط.

السرديات موجَّهة للمطوِّرين بمعنى أنها تُعاد من API، لكن محتواها مصمَّم لجمهور المعلمين والعائلات. لا تعرض سردية teacher أو admin مباشرةً لولي أمر. اطلب دائمًا audience=parent للأسطح الموجَّهة للوالدين.

الحتمية وإعادة التشغيل

تحليل الملفات حتمي بالكامل (V-6): نفس لقطة محرك حالة المهارة + نفس إصدار الكتالوج المثبَّت ينتج دائمًا نفس تعيين الملف. نقطة نهاية إعادة التشغيل للمشرف (POST /api/admin/profile-replay) تُشغِّل عملية التحليل بأكملها جافًّا (بدون كتابة أي صفوف)، حتى تتمكن من معاينة كيفية تأثير تغيير إصدار الكتالوج على التعيينات الموجودة قبل النشر.

نقاط النهاية الرئيسية

تُقدِّم وحدة الملفات 6 مسارات، كلها للمعلمين/المشرفين فقط ولا تُواجه الطلاب أبدًا.

نقطة النهاية	الغرض
`GET /api/profile/:studentId`	التعيين النشط أو المعلَّق، أو حالة حارس DATA_INCOMPLETE
`GET /api/profile/:studentId/narrative`	السردية المُرشَّحة (`audience=teacher\|parent\|admin`)
`GET /api/profiles/class/:classId`	توزيع الفصل (نطاق ClassTeacher)
`POST /api/profile/:studentId/review-resolution`	المعلم يؤكد أو يسحب أو يُبقي
`POST /api/admin/profile-catalog/publish`	نشر إصدار كتالوج جديد (بوابة اكتمال)
`POST /api/admin/profile-replay`	إعادة تشغيل جافة V-6؛ لا يكتب شيئًا

الارتباطات

المصدر: محرك حالة المهارة: محرك القرار ذو الـ 5 طبقات الذي تُغذِّي لقطات حالة مهاراته ومجالاته تحليلَ الملفات.
المصبّ: حزم التدخل: الملف النشط هو المفتاح الذي يختار حزمة من خريطة الـ 21 صفًا من الملف إلى الحزمة.
سير العمل: سير عمل تفعيل المعلم: خطوة مراجعة المعلم التي تنقل الملف من pending_teacher_review إلى active.
قواعد اللغة: سلامة اللغة: المرشح المُطبَّق عند كل كتابة وعرض للسردية.