كتالوج الجلسات
يمنح كتالوج الجلسات المعلمين مساراً سريعاً وموثوقاً لإعداد جلسة صفية دون انتظار مسودة من ذكاء اصطناعي. الكتالوج هو مكتبة من القوالب التعليمية المُؤلَّفة مسبقاً — كل منها مجموعة منسّقة من المهارات الفرعية وموضوع رئيسي ومدة مستهدفة للجلسة، تُكتَب وتُراجَع خارج المنصة قبل نشرها. لا يوجد محتوى مُولَّد ولا نموذج لغوي على هذا المسار.
عند اختيار قالب، تستخدمه أمل كمجموعة تعليمات. لكل طالب مؤهَّل في فصلك، يختار النظام أسئلة من بنك الأسئلة، ويُخصّص الترتيب ومستوى الدعم بناءً على حالة مهارة الطالب وخطّة الدعم النشطة، ثم يُسلّم الناتج كقائمة تدريب إلكتروني أو ورقة عمل قابلة للطباعة مع رمز QR. بنك الأسئلة ومحرك التجميع (ISM) وملف كل طالب تبقى كما هي — القالب يُحدّد الموضوع والمهارات الفرعية المستهدفة فقط.
لا تُكتَب أسئلة جديدة عند إنشاء الجلسة. القالب يختار أسئلة قائمة من البنك؛ لا يُولّد أسئلة جديدة.
التبويبات الثلاث
انتقل إلى الجلسات في شريط التنقل الجانبي. تفتح الشاشة الرئيسية على ثلاث تبويبات:
⭐ المقترحة
تعرض تبويبة المقترحات القوالب التي يراها أمل الأنسب لفصلك الآن. يعتمد الترتيب على المهارات الفرعية التي تظهر أكثر كمجالات حاجة فعلية بين طلابك — مع منح وزن أكبر لطلاب الدعم المكثّف — بحيث يكون للطلاب ذوي الحاجة الأعلى أثر أقوى في التوصية.
تُظهر كل بطاقة:
- اسم القالب ومحوره الرئيسي.
- “لماذا مُقتَرَح” — انقر للاطلاع على المهارات الفرعية المطابقة وعدد الطلاب في فصلك الذين لديهم حاجة فعلية في تلك المجالات. العدد رقم مجرّد وليس نسبة مئوية أو درجة خطورة.
- زر “اختيار” لبدء معالج الجلسة لهذا القالب.
قائمة المقترحات اقتراح فقط. لستِ مُلزَمة باتباعها. كل قالب في الكتالوج متاح عبر تبويبة تصفّح، وتُؤكّدين دائماً قبل إرسال أي شيء للطلاب.
تصفّح
تعرض تبويبة التصفّح الكتالوج التشغيلي الكامل. استخدمي المرشّحات للتضييق بحسب:
- المرحلة الدراسية — تتطابق مع مستوى فصلك تلقائياً.
- الموضوع — موضوع المحتوى (مثل موضوع قراءة محدد أو عائلة مهارة).
- المهارة الفرعية — مهارة القراءة الفرعية الأساسية المستهدفة.
- كلمة مفتاحية — بحث نصي حر في العنوان والوسوم.
تظهر النتائج بالتدريج مع زر “تحميل المزيد” (ترقيم قائم على cursor). تُظهر كل بطاقة اسم القالب
والموضوع والمهارة الفرعية الرئيسية والمدة المستهدفة للجلسة.
المُنشأة مؤخراً
تُدرج تبويبة المُنشأة مؤخراً الجلسات التي حظي بها فصلك سابقاً، الأحدث أولاً. تُظهر كل صف القالب
المستخدم وحالة الجلسة (draft / previewed / delivered / cancelled) وأسلوب التسليم (إلكتروني
أو قابل للطباعة).
تفتح روابط الصفوف تفاصيل الجلسة في وضع القراءة فقط للمراجعة. زر “جلسة جديدة” يعيد التوجيه دائماً إلى معالج القوالب الكامل — لا تُعاد استخدام جلسة سابقة كما هي حفاظاً على دقة التخصيص لكل طالب.
اختيار ← تعديل ← قبول ← تسليم
الخطوة الأولى: اختيار قالب
انقر “اختيار” على أي بطاقة قالب (من تبويبة المقترحات أو التصفّح). يُنشئ أمل جلسة draft مثبَّتة
على إصدار ذلك القالب. تفتح المسودة صفحة تفاصيل الجلسة.
الخطوة الثانية: التعديل (اختياري)
في حالة المسودة يمكنكِ تعديل:
- المهارات الفرعية المستهدفة — أضيفي مهارات فرعية من مجموعة القالب الافتراضية أو احذفي منها. يجب أن يبقى العدد بين 1 و5 مهارات فرعية. إن أضفتِ مهارة فرعية بتغطية محدودة في بنك الأسئلة لمرحلتك الدراسية، تظهر ملاحظة نصية كهرمانية للتوجيه؛ هذا إرشاد فقط ولا يمنعكِ من المتابعة.
- الموضوع — بدّلي موضوع المحتوى إذا كان موضوع آخر أنسب لوحدتك الدراسية الحالية.
هذه التعديلات تضبط مجموعة التعليمات لمحرك التجميع (ISM). لا تُختار الأسئلة ولا تُنشأ حتى القبول.
لإلغاء الجلسة كلياً، استخدمي زر “إلغاء الجلسة” (يظهر مربع حوار تأكيد). الجلسة الملغاة تبقى في تبويبة المُنشأة مؤخراً للرجوع إليها.
الخطوة الثالثة: القبول
انقر “قبول” لإغلاق المسودة وبدء التوزيع على الطلاب. لكل طالب مؤهَّل:
- يتحقق أمل من حالة مهارة الطالب الحالية وخطّة الدعم النشطة (تعيين حزمة إن وُجد) ومستوى السقالة.
- يختار محرك التجميع (ISM) أسئلة من البنك وفق مجموعة تعليمات القالب (المهارات الفرعية والموضوع والمرحلة الدراسية) وسياق التخصيص الخاص بالطالب.
- يُنشأ فتحة جلسة للطالب.
تُظهر شاشة المعاينة عدد الطلاب المُضمَّنين وعدد الطلاب المستبعَدين مؤقتاً (راجعي قسم “الطلاب غير المُضمَّنين” أدناه). لا يمكن التعديل بعد القبول.
الخطوة الرابعة: التسليم
بمجرد انتقال الجلسة إلى حالة previewed يمكنكِ التسليم بأسلوبين أو كليهما:
التسليم الإلكتروني
“توزيع إلكتروني” يُضيف جلسة تدريب في قائمة انتظار كل طالب مُضمَّن. في المرة القادمة التي يفتح فيها الطالب أمل، ستكون الجلسة في انتظاره. النظام يُعيد العملية بأمان: تشغيل التوزيع أكثر من مرة للطالب ذاته يُظهر “سبق التوزيع” دون إنشاء نسخة مكررة.
ورق العمل القابلة للطباعة
“إنشاء ملفات PDF” ينتج ملف PDF خاصاً بكل طالب وملف ZIP لكل الأوراق. كل ورقة بحجم A4
ومحاذاة من اليمين إلى اليسار وتتضمن رمز QR يمكن للطالب استخدامه لتقديم الإجابات إلكترونياً. إن
احتوت أي نصوص PDF موجَّهة للطالب على انتهاك لسلامة اللغة، تُعيد الواجهة البرمجية خطأ 422
وتُرفض عملية إنشاء الملفات لكامل الدفعة. تبقى الجلسة في حالة previewed؛ صحّحي
مشكلة المحتوى ثم أعيدي المحاولة. حالة filter_failed مخصَّصة للكشف عن الفشل الجزئي
مستقبلاً وليست مكتوبة حالياً من قِبَل النظام.
الطلاب غير المُضمَّنين
عند قبول الجلسة، يُستبعد تلقائياً من التوزيع الطلاب الذين يحملون إشارة do_not_decide_yet — أي
أن النظام لم يجمع بعد بيانات كافية لتحديد ملف مهاراتهم. يُدرَج هؤلاء الطلاب في قسم “غير مُضمَّنين”
في شاشة المعاينة مع سبب مصاغ بلغة النمو.
يمكنكِ تضمين طالب يدوياً بالنقر على “تضمين” بجانب اسمه. يفتح مربع حوار تأكيد دون حقل نص حر — يُسجَّل التجاوز في النظام برمز سبب ثابت. الطلاب المُضمَّنون يدوياً يتلقون جلسة مجمَّعة عبر ISM باستخدام بيانات الملف الشخصي المتوفرة حالياً.
إن كان جميع طلاب فصلك مستبعَدين مؤقتاً، تُعطَّل أزرار التسليم. يمكنكِ إما تضمين الطلاب يدوياً واحداً تلو الآخر، أو العودة لاحقاً حين يُجمَع مزيد من بيانات التقييم.
التخصيص يبقى لكل طالب على حدة
يُحدّد القالب الموضوع والمهارات الفرعية المستهدفة. يحدث التخصيص داخل هذا التركيز، لكل طالب على حدة:
- تُوافَق صعوبة الأسئلة مع تقدير قدرة الطالب الحالي.
- إن كان الطالب يمتلك خطّة دعم نشطة (تعيين حزمة)، يعمل محرك ISM في وضع سياق الحزمة — تُختار الأسئلة لتعزيز الخيط الأساسي والخيوط الداعمة للحزمة.
- مستوى الدعم إشارة داخلية لمحرك ISM؛ لا تُعرض للطالب أبداً.
طالبان في الفصل ذاته يحصلان على القالب نفسه سيتلقيان أسئلة مختلفة وترتيباً مختلفاً وربما مدة جلسة مختلفة بحسب ملفيهما الشخصيين.
نقاط نهاية واجهة برمجة التطبيقات
مسارات المعلم تستلزم مصادقة ونطاق ClassTeacher.
| الأسلوب | المسار | الغرض |
|---|---|---|
GET | /api/sessions/catalog | تصفّح / البحث / تصفية القوالب التشغيلية (FR-SGE-15) |
GET | /api/sessions/catalog/recommended | القائمة المقترحة الموزونة بـ RTI لفصل محدد (FR-SGE-16) |
GET | /api/sessions/recently-generated | الجلسات المُنشأة مؤخراً لفصل محدد (FR-SGE-13) |
POST | /api/sessions/from-blueprint | اختيار قالب وإنشاء جلسة draft (FR-SGE-17) |
PATCH | /api/sessions/:id/edit | تعديل المهارات الفرعية / الموضوع في حالة draft (FR-SGE-17) |
POST | /api/sessions/:id/accept | قبول المسودة وبدء توزيع ISM لكل طالب (FR-SGE-5) |
POST | /api/sessions/:id/distribute-online | إضافة الجلسة إلى قائمة انتظار التدريب للطلاب المُضمَّنين (FR-SGE-6) |
POST | /api/sessions/:id/generate-pdfs | إنشاء ملفات PDF لكل طالب وملف ZIP (FR-SGE-7) |
POST | /api/sessions/:id/deliver-mixed | «مختلط»: تسليم كل طالب بالوسيط المثبَّت عند القبول، إلكترونيًا وورقيًا في خطوة واحدة (FR-TV3-16) |
POST | /api/sessions/:id/recipients/:studentId/include | تضمين طالب مستبعَد يدوياً (FR-SGE-14) |
POST | /api/sessions/:id/cancel | إلغاء جلسة مسودة |
GET | /api/sessions/:id | تفاصيل الجلسة (قراءة المعلم) |
GET | /api/sessions/:id/audit | مجموعة دبابيس إعادة تشغيل V-6 الكاملة ولقطة مجمَّعة (يتطلب RUN_BACKOFFICE) |
للاطلاع على أشكال الطلب والاستجابة الكاملة، راجعي مرجع واجهة برمجة التطبيقات.
حدّ إنشاء الجلسات (للمسؤولين والدعم): يستطيع كل معلّم إنشاء 30 جلسة كحدّ أقصى في كل 15 دقيقة (POST /api/sessions/from-blueprint). المحاولة الحادية والثلاثون تُجاب بالرمز 429 وبالجسم { "code": "RATE_LIMITED", "message": "Too many sessions created in the last 15 minutes", "retryAfter": <ثوانٍ> }. يعود الإنشاء متاحًا بعد انقضاء retryAfter؛ ودليل التشغيل (docs/runbooks/wp-tdv3.md §9) يشرح إعادة ضبط نافذة معلّم واحد عند وجود طلب دعم.
الإدارة: استيراد القوالب والموافقة عليها
قبل ظهور أي قالب في كتالوج المعلم، يستورد المدير دفعةً ويوافق عليها خبير المحتوى.
تستلزم هذه المسارات إذن RUN_BACKOFFICE وليست متاحة للمعلمين.
| الأسلوب | المسار | الغرض |
|---|---|---|
POST | /api/session-blueprints/import | استيراد دفعة JSON من القوالب؛ يُعيد batchId |
GET | /api/session-blueprints/import | سرد جميع دفعات استيراد القوالب |
GET | /api/session-blueprints/import/:batchId | فحص دفعة استيراد محددة |
POST | /api/session-blueprints/:batchId/approve | الموافقة على دفعة؛ تصبح القوالب مرئية في الكتالوج |
GET | /api/session-blueprints/:id | تفاصيل قالب واحد (قراءة المدير) |
تبدأ القوالب في حالة pending_review بعد الاستيراد. تظهر في GET /api/sessions/catalog
أو GET /api/sessions/catalog/recommended القوالبُ الموافق عليها (operational) فقط.
لا تتم الموافقة على أي قالب تلقائياً عند الاستيراد.
ملاحظة الموجة الثانية
إدخال موضوع نصي حر ورفع مستند (اللذان يحتاجان نموذج Teacher AI اللغوي على مسار الجلسة) مُؤجَّلان إلى الموجة الثانية. تعتمد الموجة الأولى على القوالب المُؤلَّفة مسبقاً فقط.
أدلة ذات صلة
- حزم التدخل: كيف يؤثر تعيين الحزمة في وضع سياق ISM
- ملفات الطلاب: إشارات الملف التي يقرأها التوزيع لكل طالب
- تسليم المهام: كيف يختار محرك ISM الأسئلة ويُسلّمها من البنك
- سير عمل تفعيل المعلم: الشاشة المنفصلة لتفعيل خطط الدعم