دليل إعداد القطاع العام

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

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

1المتطلبات

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

1. خادم في مركز بيانات المؤسسة (Ubuntu 22.04 أو 24.04)، والمثبّت، ونطاق خلف الوكيل العكسي للمؤسسة للعنوان العام.
2. مشفّر القاعة أو خلّاط الفيديو القادر على دفع RTMP، وتسجيلات الجلسات السابقة، وفيديوهات تدريب الموظفين.
3. قرار بشأن ما هو عام وما هو داخلي، ومدة الخط العام، ومن بين المشغّلين يحصل على حساب في اللوحة.

2نشر البنية

خادم الإدارة، ثم أي موقع بعيد.

1. شغّل المثبّت على خادم المؤسسة؛ وضع اللوحة خلف الوكيل العكسي مع TLS واضبط TRUSTED_PROXIES ليرى سجل التدقيق وقواعد IP العناوين الحقيقية.
2. اضبط أساس التشغيل على العنوان العام الذي يصل إليه المقيمون، وأدخل مفتاح الترخيص على الخادم.
3. سجّل عقدة من الخوادم لموقع يحتاج إليها، مثل مبنى ثانٍ فيه قاعة؛ تثبّتها اللوحة عبر SSH.
4. أنشئ حساب شريك (موزّع) لفريق الاتصال بأذونات الخطوط العامة، وآخر للموارد البشرية أو التدريب لخطوط الموظفين.

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

برنامج عام ومجموعات الإدارات.

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

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

الفرق التي تمنح الوصول.

1. أنشئ مجموعة بأذونات الخطوط فقط، ودون وصول إلى الكتالوج أو الإعدادات.
2. أضف فريق الاتصال كحساب شريك بحزمة المقيمين، والموارد البشرية أو التدريب بحزم الموظفين.
3. يمكن لجهة لها عدة خدمات أن تمنح كل خدمة حساب شريك خاصًا بها؛ وهو حساب مفوَّض لا تثبيت معزول.

5إعداد خطوط المقيمين والموظفين

خطوط للجمهور وخطوط للموظفين.

1. أنشئ مفتاح Reseller API لموقع المجلس واحتفظ به ضمن أسراره؛ وحين يطلب مقيم الوصول يستدعي action=create_line مع الحزمة العامة ومعرّف الطلب.
2. اضبط مدة طويلة للخطوط العامة، وحدّ اتصالات يناسب مشاهدة المنزل.
3. أنشئ خطوط الموظفين لكل إدارة بحزم الموظفين، من نظام موظفي المجلس عبر API أو من الخطوط ← إضافة.
4. اربط خطوط الموظفين بنطاق عناوين المؤسسة حيث تسمح الشبكة بذلك.

6أرشيف الجلسات ومكتبة التدريب

تسجيلات عند الطلب.

1. أضف كل جلسة مسجّلة كحلقة في مسلسل هيئتها، مستوردة بمهمة استيراد الفيديو عند الطلب أو مرفوعة، مع عنوان وتاريخ ووصف.
2. ضع مسلسل الجلسات في الباقة العامة ومكتبة التدريب في باقات الإدارات.
3. افحص التشغيل بخط تجريبي من الحزمة العامة وآخر من حزمة موظفين للتأكد من من يرى ماذا.

7الجلسات المباشرة

القاعة كقناة مباشرة.

1. أضف بثًا مباشرًا بدفع RTMP من مشفّر القاعة وضعه في الباقة العامة.
2. فعّل Catch-up ليتمكن المشاهدون المتأخرون من الرجوع إلى الوراء، وأضف مدخل EPG أو عنوانًا ليعرف المشاهدون أي اجتماع يُعرض.
3. اختبر البث قبل كل اجتماع، واحتفظ بعقدة قرب موقع ثانٍ إن كان يستضيف جلسات أيضًا.

8الانتهاء والتجديد

طويل للجمهور، ومرتبط بالتوظيف للموظفين.

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

9التكامل مع أنظمة المؤسسة

الأنظمة تدير الوصول؛ والمشغّل يشغّل.

1. ينشئ الموقع ونظام الموظفين الخطوط ويجدّدونها ويفعّلونها ويعطّلونها عبر Reseller API بمفتاح ومعرّف طلب.
2. لا يوجد تسجيل دخول موحّد للمشاهدين ولا تكامل أصلي مع منتج محدد للقطاع العام: يسجّل المشاهدون الدخول إلى المشغّل ببيانات خطوطهم.
3. استخدم مفاتيح Admin API بعلامة القراءة فقط وقائمة IP مسموحة وتاريخ انتهاء لأدوات التقارير.

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

تديرها المؤسسة، وبشفافية حيث ينبغي.

1. أبقِ المنصة على بنية المؤسسة خلف الوكيل العكسي مع TLS، واحتفظ بالمواد العامة والداخلية في باقات منفصلة.
2. دخول بخطوتين لكل حساب في اللوحة ومجموعات أذونات لكل فريق؛ وreCAPTCHA أو Turnstile عند تسجيل الدخول إن كانت اللوحة متاحة من الخارج.
3. روابط تشغيل موقّعة ومنتهية الصلاحية، وحدّ اتصالات لكل خط، وربط بالعنوان لخطوط الموظفين.
4. نسخ احتياطية مشفّرة لقاعدة البيانات مع نسخة خارج الموقع، وسجل التدقيق لكل تغيير في الخطوط والكتالوج.

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

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

1. مقيم لا يستطيع المشاهدة: افحص تاريخ انتهاء الخط وأنه مفعّل، والباقة العامة في الحزمة.
2. جلسة لا تبدأ: افحص دفع المشفّر إلى البث وحالة البث في اللوحة.
3. الموظفون لا يرون مكتبة التدريب: افحص حزمة خط الموظف والباقات التي تمنحها.
4. يُظهر سجل التدقيق عنوان الوكيل: اضبط TRUSTED_PROXIES على الوكيل وأعد تشغيل اللوحة.