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

واجهة خطط التعلّم الأولى للقراءة فقط. وتتطلب learning_plans:read ووصول قراءة API فعالاً للمدرسة المصادق عليها. وإذا عطلت المدرسة خطط التعلّم لاحقاً، تظل القراءة التاريخية المخوّلة متاحة كما هو موضح أدناه.

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

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

تتضمن الخطة:

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

يتضمن مصدر إنشاء الكمية بيانات غير حساسة: طريقة الإنشاء والكمية المطلوبة والفعلية ووحدتها والاتجاه وحالة الحساب وأساس التقدم ونهاية المصدر وفئة تقييمه وإصدارات البيانات والحساب وتجاوزات البداية والاتجاه والكمية وسبب الإعادة وارتباط عملية المجموعة. ويتعمد حذف معرّف تلاوة المصدر. تكون القيمة null للخطط ذات النطاق الثابت واليدوية والتاريخية التي لا تملك سجل مصدر؛ فلا تستنتجها أو تصطنعها.

عامل إصدار مصدر البيانات في الـ API كقيمة تقنية لإعادة إنتاج الحساب، لا كنص للعرض. تستخدم الواجهات البشرية اسم نسخة المصحف أو إصدارها المترجم في وقار، ولا تحاول تفسير قيمة المصدر التقنية.

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

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

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

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

عند تعطيل خطط التعلّم تحافظ العمليات الثلاث على توافق القراءة التاريخية وتعيد الترويسة X-Waqar-Feature-Mode: historical-read-only. تعني الترويسة أنه لا يمكن إنشاء عمل تخطيط جديد أو تغييره، ولا تتجاوز فحوص المستأجر أو إطلاق API أو المفتاح أو النطاق أو التعليق أو الحصة. استمر في مزامنة السجلات المحفوظة ولا تحذفها محلياً لمجرد ظهور هذه الترويسة.

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

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