قراءة خطط التعلّم عبر API

واجهة خطط التعلّم الأولى للقراءة فقط. وتتطلب learning_plans:read ووصول قراءة API فعالاً وتفعيل خطط التعلّم للمدرسة المصادق عليها.

• يسرد GET /learning-plans الخطط ويقبل مرشحي status وstudent_id ومعاملات مزامنة اللقطات.
• يعيد GET /learning-plans/{id} خطة واحدة.
• يعيد GET /learning-plans/{id}/assignments تاريخ تكليفاتها واستبدالها، ويمكن ترشيحه بحالة التكليف.

لا توجد عمليات API v1 لإنشاء خطط التعلّم أو تفعيلها أو إيقافها أو تعديلها أو توليدها أو اعتمادها أو نشرها أو تأجيلها أو استبدالها أو إلغائها. استخدم تطبيق المدرسة المصادق عليه لهذه الإجراءات البشرية.

تتضمن الخطة:

• معرّفي الطالب والفصل الاختياري؛
• الاسم وبداية الفترة وتاريخ الإنجاز المستهدف؛
• الاتجاه التصاعدي أو التنازلي؛
• موضعي البداية والوجهة الأصليين؛
• حالة الخطة؛
• معرّف إصدار بيانات الحمل القرآني؛
• سياسة النشر الفعلية الحالية وإيقاف الأتمتة ومصدر السياسة؛
• مسارات الحمل بنوعها ووحدتها وهدفها وسماحيتها وموضعها التالي ووقت إكمالها.

قد تتغير السياسة الفعلية عند تغيير ضبط المدرسة أو الحلقة أو الطالب. عاملها كحالة استجابة حالية لا كبيانات إنشاء ثابتة.

تتضمن التكليفات تاريخ الاستحقاق وحالة دورة الحياة والمصدر والشرح الآمن وأوقات النشر والبدء والإكمال والاستبدال ورابط البديل عند انطباقه ومقاطع القرآن الأصلية المرتبة.

لا تعاد ملاحظات الطاقم الخاصة أبداً. وقد تتضمن API المدرسة بين الخوادم المسودات وحالات الطاقم الأخرى لأنها ليست بوابة ولي الأمر؛ فاحمِ الاستجابة.

1. اسرد الخطط بمرشح الحالة أو الطالب المطلوب.
2. اجتز اللقطة المرتبطة بالمرشح كاملة.
3. نفّذ upsert لحالة الخطة باستخدام id.
4. اجتز تاريخ التكليف للخطط المطلوبة واحفظ روابط الاستبدال بدلاً من حذف القديم.
5. استخدم updated_after في الدورات الكاملة اللاحقة.
6. لا تدمج سجلات مدارس مختلفة ولا تعرض حالات الطاقم للأولياء.

قد تعيد الميزة غير المتاحة رفضاً خاصاً حتى إذا احتوى المفتاح النطاق. ولا تحصل المفاتيح الموجودة على learning_plans:read تلقائياً؛ دوّر إلى مفتاح مقصود النطاق.

راجع الترقيم والمزامنة و مفاهيم خطط التعلّم.