دليل إعداد التعليم والتدريب

المطابقة المفاهيمية

لا شيء في اللوحة يُسمى دورة أو طالبًا. يبيّن الجدول أي عنصر يؤدي أي دور؛ وتُعدّه الفصول أدناه بهذا الترتيب.

1المتطلبات

ما ينبغي توفره قبل التثبيت.

1. خادم Linux (Ubuntu 22.04 أو 24.04) على شبكة الحرم، يثبّت المثبّت عليه Postgres وRedis وffmpeg، ونطاق أو عنوان داخلي للوحة والمشغّل.
2. التسجيلات التي ستنشرها (ملفات أو نظام تسجيل قادر على دفع RTMP)، وللحصص المباشرة، encoder في كل قاعة ستبث منها.
3. مفتاح رخصة: لا تحتاج خطة Free إلى واحد؛ وتطلب المؤسسات المؤهّلة مفتاح Professional المجاني بالبريد الإلكتروني من نطاقها الأكاديمي.

2نشر البنية

ثبّت خادم الإدارة، ثم عقدة لكل مبنى.

1. شغّل المثبّت على خادم الإدارة؛ فيثبّت اللوحة وواجهة API والـ worker والـ origin بوصفها وحدات systemd وينشئ أول مدير.
2. اضبط العنوان العام لواجهة API (API_PUBLIC_URL) وأساس التشغيل ليشير روابط المشغّل إلى عنوان الحرم.
3. سجّل عقدة من Servers ← إضافة عقدة لكل مبنى ستشاهد قاعاته؛ تثبّتها اللوحة عبر SSH من حزمة العقدة.
4. افحص صفحة Servers: تبلّغ العقدة بالـ heartbeat والحركة، ويُوجَّه مشاهدو ذلك المبنى إليها.

3تنظيم المحتوى

الدورات مسلسلات، والبرامج باقات قنوات وحزم.

1. أنشئ تصنيفًا لكل كلية أو مادة تحت Movies / Series.
2. أضف كل دورة مسلسلًا: موسمًا لكل وحدة وحلقة لكل درس، والتسجيل مصدرًا (رفع أو مهمة استيراد VOD).
3. أنشئ باقة قنوات لكل مجموعة دورات (مثل دورات برنامج لفصل دراسي) من المسلسلات التي أضفتها.
4. أنشئ حزمة لكل برنامج: باقات القنوات التي تمنحها، وفترة الوصول مدةً، وحد الجلسات المتزامنة.

4إعداد الشركاء (الموزّعين)

مركز تدريب أو كلية بوصفه حسابًا مفوَّضًا.

1. أنشئ مجموعة بالصلاحيات التي يحتاجها المركز (خطوطه الخاصة دون تغيير الكتالوج) تحت Groups.
2. أضف المركز موزّعًا تحت Users بتلك المجموعة ورصيد والحزم التي يجوز له توزيعها.
3. أعطه عنوان اللوحة؛ يدير طلابه من هناك، وتحتفظ اللوحة بسجل التدقيق.

5إعداد وصول الطلاب

خط لكل طالب، يُنشأ عند القيد.

1. للدفعات الصغيرة، أضف الخطوط من Lines ← إضافة بحزمة البرنامج؛ ويتبع الانتهاء مدة الحزمة.
2. ليوم القيد، ولّد أكواد تفعيل للحزمة؛ يستبدل الطالب الكود في المشغّل ويحصل على خط.
3. لنظام الطلاب أو LMS، أنشئ مفتاح Reseller API ودع النظام ينشئ الخطوط بـ action=create_line ومعرّف طلب لكل طالب.
4. اضبط max connections على عدد الأجهزة التي يجوز للطالب استخدامها في آن واحد؛ ويرفض المشغّل الاتصال التالي.

6إعداد VOD

دروس مسجّلة عند الطلب.

1. ارفع كل تسجيل مصدرًا لحلقة، أو وجّه مهمة استيراد VOD إلى الملف ودع الـ worker ينزّله ويرمّزه في جذر الوسائط.
2. املأ البيانات الوصفية (العنوان والوصف والملصق) يدويًا أو من TMDB للمواد العامة؛ وتحتاج الدروس عادةً إلى عنوان ووصف فقط.
3. افحص التشغيل في مشغّل الويب بخط تجريبي؛ الرابط موقّع وينتهي بعد المدة المضبوطة.

7بث الحصص المباشرة

المحاضرة قناة مباشرة.

1. أضف بثًا مباشرًا تحت Streams بـ encoder القاعة مصدرًا (عنوان دفع RTMP أو رابط سحب).
2. ضع البث في باقة قنوات الدورة ليراه الطلاب المسجّلون فقط؛ وأضفه إلى EPG إن كان لديك جدول زمني.
3. فعّل Catch-up أو Timeshift على البث عندما يجوز للطلاب مشاهدة الحصة لاحقًا؛ ويمكن أيضًا رفع التسجيل حلقةً.

8الاشتراك وانتهاء الوصول

وصول ينتهي مع الدورة.

1. امنح الحزمة فترة الوصول مدةً؛ فينتهي الخط المنشأ منها في نهاية تلك الفترة.
2. جدّد الخط لفصل جديد من اللوحة، برصيد المركز، أو عبر واجهة API بـ action=renew_line.
3. اشترك بنظامك في webhooks: فيُبلَّغ عندما يقترب الخط من الانتهاء أو ينتهي أو يُعطَّل.

9التكامل مع LMS خارجي

يتحكم LMS في الوصول؛ ويتولى المشغّل التشغيل.

1. أنشئ مفتاح Reseller API لـ LMS؛ واحتفظ به في أسرار LMS، لا في صفحة أبدًا.
2. عند القيد يستدعي LMS الإجراء action=create_line بحزمة البرنامج ومعرّف طلب؛ وعند الانسحاب action=disable_line.
3. اربط من صفحة الدورة في LMS بمشغّل الويب أو أعطِ الطالب بيانات المشغّل؛ لا يوجد تسجيل دخول موحّد بين الاثنين.

10اعتبارات الأمان

أبقِ الخدمة داخل المؤسسة.

1. فعّل تسجيل الدخول بخطوتين لكل حساب في اللوحة، وامنح الموظفين أصغر مجموعة صلاحيات تفي بالغرض.
2. أبقِ البيانات الشخصية للطلاب في نظام الطلاب؛ فالخط لا يحتاج إلا إلى اسم وتاريخ انتهاء.
3. أبقِ max connections منخفضًا وفكّر في ربط التشغيل بعنوان المشاهد لمنع المشاركة.
4. فعّل النسخ الاحتياطي المشفّر لقاعدة البيانات، وإن توفر لديك تخزين متوافق مع S3 فعّل النسخة خارج الموقع.

11استكشاف الأخطاء

الفحوص الأولى المعتادة.

1. طالب لا يستطيع تسجيل الدخول: افحص انتهاء الخط وأنه مفعّل، ثم الحزمة وباقة قنوات الدورة.
2. تسجيل لا يعمل: افحص نتيجة مهمة الاستيراد في صفحة Jobs، ثم الملف في جذر الوسائط وانتهاء الرابط الموقّع.
3. مشاهدو مبنى يصلون إلى الـ origin: افحص heartbeat العقدة وأن عنوان المشاهد يقع ضمن توجيه العقدة.
4. ترفض واجهة API استدعاءً: افحص المفتاح، وطريقة الإجراء (الكتابة بـ POST)، ومعرّف الطلب في الاستدعاء المعاد.