تطابق هذه الأدلة مفاهيم القطاع مع العناصر الموجودة في المنصة اليوم (باقات القنوات والخطوط والحزم وحسابات الموزّعين والعقد وواجهة API). وهي مطابقات مفاهيمية لا ميزات خاصة بقطاع، وحساب الموزّع حساب مفوَّض لا tenant معزول.
المطابقة المفاهيمية
لا شيء في اللوحة يُسمّى قاعة أو عضوًا. يبيّن الجدول أي كائن يؤدي أي دور؛ وتُعدّه الفصول أدناه بهذا الترتيب.
| في قطاعك | على المنصة | أين في اللوحة |
|---|---|---|
| فيلم المعرض والأرشيف | كتالوج VOD: أفلام ومسلسلات بمواسم وحلقات وتصنيفات وبيانات وصفية | Movies وSeries، أو مهمة استيراد VOD |
| بث افتتاح أو محاضرة | قناة مباشرة: بث بمصادره وEPG وصيغ الإخراج | Streams ← إضافة بث مباشر (رابط المصدر أو دفع RTMP) |
| مجموعة القاعات أو الأعضاء | باقة قنوات (bouquet): مجموعة مسمّاة من القنوات أو الأفلام أو المسلسلات تمنحها الحزمة | Bouquets، من Streams وMovies / Series |
| وصول زائر أو عضو | الخط: وصول واحد بحزمته وباقات قنواته وانتهائه وحد اتصالاته ومخرجاته | Lines ← إضافة، أو رموز التفعيل، أو Reseller API |
| فترة العضوية | تاريخ انتهاء الخط، يُجدَّد بحزمة أو رصيد أو واجهة API | تاريخ انتهاء الخط ومدة الحزمة |
| أجهزة لكل عضو | الحد الأقصى لاتصالات الخط: عدد الأجهزة التي يمكنها المشاهدة في آن واحد | الحد الأقصى لاتصالات الخط |
المتطلبات
ما يجب توفيره قبل التثبيت.
- خادم في المبنى (Ubuntu 22.04 أو 24.04)، والمثبّت، وشبكة القاعات التي ستستخدمها الشاشات وأجهزة الأعضاء.
- فيلم المعرض، وتسجيلات الأرشيف التي تملك حقوقها، ومشفّر لقاعة المحاضرات، والشاشات أو مشغّلات الوسائط للقاعات.
- مفتاح الترخيص، وإجراء التفعيل دون اتصال إن لم يكن في المبنى إنترنت؛ وقرار بشأن من يبيع العضويات عند المكتب.
نشر البنية
الخادم في المبنى، يُفعَّل في الموقع.
- شغّل المثبّت على الخادم واضبط عنوان أساس التشغيل على العنوان الذي تصل إليه شبكة القاعات.
- فعّل مفتاح الترخيص دون اتصال من اللوحة؛ وبعد التفعيل تعمل الخدمة على الشبكة المحلية دون إنترنت.
- أضف فيلم المعرض ضمن الأفلام وبث قاعة المحاضرات ضمن البثوث، وافحصهما في مشغّل الويب.
- لموقع ثانٍ أو برنامج عام كبير، سجّل عقدة من الخوادم؛ تثبّتها اللوحة عبر SSH وتوجّه إليها مشاهدي ذلك الموقع.
تنظيم المحتوى
القاعات والأرشيف ومجموعات الأعضاء.
- أنشئ تصنيفات لكل معرض ولكل سنة، ومسلسلًا لسلسلة محاضرات بحلقة لكل محاضرة.
- أنشئ باقة قنوات لشاشات القاعات وأخرى لمكتبة الأعضاء من المحاضرات والأفلام الأرشيفية.
- أنشئ حزمة للقاعات وحزمة لكل نوع عضوية، تمنح كل منها باقاتها؛ ومدة حزمة العضوية هي فترة العضوية.
- أضف ملصقات ووصفًا قصيرًا لكل فيلم لتُقرأ المكتبة جيدًا في المشغّل.
إعداد الشركاء (الموزّعين)
المكتب والمتجر كحسابات مفوَّضة.
- أنشئ مجموعة بأذونات مقصورة على الخطوط ورموز التفعيل، ودون وصول إلى الكتالوج أو الخوادم.
- أضف المكتب، أو المتجر، كموزّع بتلك المجموعة وحزم العضوية ورصيد.
- يمكن لمركز ثقافي يدير عدة مواقع إضافة موزّع لكل موقع، يبيع كل منها العضويات من رصيده.
إعداد وصول الزوار والأعضاء
الشاشات والأعضاء على خطوط.
- أنشئ خطًا لكل شاشة قاعة من الخطوط ← إضافة بحزمة القاعات، واربطه بعنوان الشاشة حين تمنح الشبكة عناوين ثابتة.
- أنشئ رموز تفعيل عند المكتب لكل عضوية تُباع؛ يدخل العضو الرمز في المشغّل فيبدأ الخط.
- اضبط الحد الأقصى للاتصالات لكل عضوية على عدد الأجهزة التي يجوز للعضو استخدامها، عادةً اثنان.
- سلّم العضو تطبيق المشغّل أو قائمة M3U أو عنوان مشغّل الويب، أيها يناسب جهازه.
فيلم المعرض والأرشيف
المكتبة عند الطلب.
- ارفع فيلم المعرض والأرشيف المرقمن كأفلام، أو استوردهما بمهمة استيراد الفيديو عند الطلب إلى جذر الوسائط.
- أضف بيانات TMDB الوصفية حيث توجد، واكتب العنوان والوصف بنفسك لبقية المواد.
- احتفظ بالأرشيف غير المخصص للعامة في باقة الأعضاء فقط، وافحص ما تراه كل حزمة بخط تجريبي.
الافتتاحات والمحاضرات
فعالية كقناة مباشرة.
- أضف بثًا مباشرًا لمشفّر قاعة المحاضرات (دفع RTMP) وضعه في باقة الأعضاء، أو في باقة القاعات لافتتاح يُعرض على الشاشات.
- فعّل Catch-up ليتمكن العضو الذي يصل متأخرًا من الرجوع إلى الوراء، وارفع التسجيل إلى المكتبة بعد ذلك.
- اختبر المشفّر والبث قبل الفعالية بخط تجريبي، على الشبكة نفسها التي سيستخدمها الجمهور.
انتهاء العضوية وتجديدها
العضوية كصلاحية للخط.
- ينتهي الخط في نهاية فترة حزمته؛ والتجديد عند المكتب يضيف فترة أخرى.
- عطّل الخط حين تُلغى عضوية؛ أما رموز التفعيل التي لم تُستخدم قط فتبقى غير مستخدمة حتى تُستبدل.
- اشترك بالمتجر أو بنظام العضويات في webhooks لرؤية الخطوط التي توشك على الانتهاء أو انتهت.
التكامل مع المتجر أو نظام العضويات
الأنظمة تبيع الوصول؛ والمشغّل يشغّل.
- أنشئ مفتاح Reseller API للمتجر أو نظام العضويات؛ يستدعي create_line وrenew_line وdisable_line، بمعرّف طلب مع كل كتابة.
- استخدم موصّل تجارة حين تُباع العضويات عبر الإنترنت؛ وأي نظام آخر يستخدم Reseller API وwebhooks.
- لا يوجد تسجيل دخول موحّد للمشاهدين: يسجّل العضو الدخول إلى المشغّل ببيانات الخط أو برمز التفعيل.
اعتبارات الأمان
أبقِ المجموعات في مكانها.
- افصل شبكة القاعات عن شبكة الزوار، وقدّم أي وصول عام خلف وكيل عكسي مع TLS وTRUSTED_PROXIES مضبوطًا.
- دخول بخطوتين لكل حساب في اللوحة؛ ويحصل المكتب على مجموعة أذونات مقصورة على الخطوط والرموز.
- روابط تشغيل موقّعة ومنتهية الصلاحية، وحدّ اتصالات لكل عضوية، وربط بالعنوان لشاشات القاعات.
- فعّل النسخ الاحتياطي المشفّر لقاعدة البيانات مع نسخة خارج الموقع، واستخدم سجل التدقيق لمراجعة تغييرات الخطوط والكتالوج.
استكشاف الأخطاء
الفحوص الأولى المعتادة.
- شاشة قاعة سوداء: افحص أن خطها مفعّل وغير منتهٍ، وربط عنوان الشاشة، وأن الخادم يمكن الوصول إليه على شبكة القاعات.
- رمز عضو لا يعمل: افحص أن الرمز لم يُستبدل من قبل وأن الحزمة التي يفتحها لا تزال مسندة إلى المكتب.
- فشل تفعيل الترخيص دون اتصال: افحص ملف التفعيل مقابل مفتاح الترخيص وساعة الخادم.
- يتقطّع الافتتاح المباشر: قارن معدل بت المشفّر بالوصلة الصاعدة وافحص حالة البث ضمن البثوث.