دليل المستخدم

لوحة إدارة الربط مع المركز الوطني للتعليم الإلكتروني (نلك)

← لوحة الإدارة

نظرة عامة

يربط هذا النظام منصة بلاك بورد (elearn.oc.edu.sa) بـ مستودع التعلم LRS التابع لنلك عبر بيانات xAPI. بلاك بورد لا يرسل xAPI مباشرة — الخدمة تجمع الأحداث من واجهة REST وتُرسلها إلى نلك.

بلاك بورد → المُجمّع → صندوق الصادر → المُرسِل → LRS نلك → بوابة التكامل

تسجيل الدخول

عيّن ADMIN_TOKEN في ملف .env، ثم أدخل الرمز في الشريط العلوي واضغط حفظ. لا تشارك الرمز ولا ترفع ملف .env إلى المستودع.

لوحة المعلومات

إعدادات الشركة

• الشعار — رفع صورة أو رابط
• مفتاح المنصة — يجب أن يكون elearn.oc.edu.sa في كل بيان
• أسماء المنصة — عربي/إنجليزي لامتدادات نلك

ملفي الشخصي

اسم المشغّل، البريد، الدور، والجهة — يظهر في الشريط الجانبي.

نقاط نهاية LRS

• البيئة النشطة — تُوسَم بها عناصر صندوق الصادر الجديدة
• إدارة النقاط — إضافة/تعديل/حذف/تفعيل/تعطيل
• صحة الاتصال — فحص الاتصال دون كتابة في الصندوق
• بيئتا staging و production مدمجتان ولا تُحذفان

العامل (Worker)

• Poll Blackboard — مزامنة يدوية للمقررات والتسجيل والدرجات
• Dispatch Outbox — إرسال فوري للبيانات المعلّقة
• الحجر — متعلمون بدون هوية وطنية من 10 أرقام (تبدأ بـ 1 أو 2 أو 4)

الإجراءات (اختبار)

صندوق الصادر (Outbox)

المسارات (Journeys)

الأفعال السبعة: registered → initialized → watched → completed → attempted → rated → earned

المرحلة 2 تؤتمت registered و initialized و attempted. الباقي يحتاج مرحلة 3.

قواعد نلك الأساسية

• context.platform = elearn.oc.edu.sa
• actor.name = رقم الهوية الوطنية (10 أرقام)
• جميع الأفعال السبعة مطلوبة للاعتماد — بما فيها earned
• الإرسال من الخادم فقط — بدون تكرار