الرئيسية
XtreamUIPro

دليل الإعداد

دليل إعداد شبكات التجزئة والامتياز

اظبط المنصة كخدمة فيديو لشبكة متاجر: قناة متجر على الشاشات، ومكتبة تدريب للموظفين، وحساب شريك لكل صاحب امتياز، وNode لكل منطقة.

الأدلة دي بتطابق مفاهيم المجال مع العناصر الموجودة في المنصة دلوقتي (bouquets وخطوط وحزم وحسابات موزّعين وعقد والـ API). دي مطابقات مفاهيمية، مش ميزات خاصة بمجال، وحساب الموزّع حساب مفوَّض، مش tenant معزول.

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

مفيش حاجة في اللوحة اسمها متجر أو صاحب امتياز. الجدول بيقول أنهي كائن بيلعب أنهي دور؛ والفصول اللي تحت بتظبطهم بالترتيب ده.

في مجالكعلى المنصةفين في اللوحة
قناة المتجر أو مجموعة التدريبBouquet: مجموعة مسمّاة من القنوات أو الأفلام أو المسلسلات اللي الحزمة بتديهاBouquets، من Streams وMovies / Series
قناة المتجرقناة مباشرة: بث بمصادره وEPG وصيغ الإخراجStreams → ضيف بث مباشر (رابط المصدر أو RTMP push)
فيديو التدريب والمنتجاتكتالوج VOD: أفلام ومسلسلات بمواسم وحلقات وتصنيفات وبيانات وصفيةMovies وSeries، أو مهمة استيراد VOD
شاشة متجر أو وصول موظفالخط: وصول واحد بحزمته وbouquets وانتهائه وحد اتصالاته ومخرجاتهLines → إضافة، أو أكواد التفعيل، أو الـ Reseller API
حساب صاحب الامتيازحساب موزّع (reseller): لوحة مفوَّضة بكريديت وصلاحيات وخطوطه الخاصةUsers → ضيف موزّع؛ Groups لصلاحياته
عقدة إقليميةعقد البث: سيرفرات حافة بتتسجّل من اللوحة، واحدة لكل موقع أو مبنىServers → ضيف Node، بتتثبّت عن طريق SSH
شاشات أو أجهزة لكل خطأقصى اتصالات للخط: كام جهاز يقدر يشوف في نفس الوقتأقصى اتصالات للخط

المتطلبات

اللي لازم يكون موجود قبل التثبيت.

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

نشر البنية

المقر الرئيسي الأول، وبعدين المناطق.

  1. شغّل المثبّت على سيرفر المقر الرئيسي واضبط عنوان أساس التشغيل على عنوان المتاجر تقدر توصله، ورا TLS.
  2. ضيف قناة المتجر تحت Streams وتسجيلات التدريب تحت Movies، وافحصهم في مشغّل الويب.
  3. سجّل Node لكل منطقة من Servers؛ اللوحة بتثبّتها عبر SSH، أو الـ Node بتسجّل نفسها برمز لمرة واحدة، وبتوجّه متاجر المنطقة دي ليها.
  4. اعمل حساب شريك لفريق محتوى المقر الرئيسي بصلاحيات للكتالوج ومن غير صلاحيات لخطوط المتاجر.

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

قناة المتجر ومكتبة التدريب.

  1. اعمل بث مباشر لقناة المتجر وحطه في bouquet خاص بيه.
  2. اعمل تصنيفات لكل موضوع ومسلسل لكل دورة تدريبية بحلقة لكل درس؛ وضيف bouquet لكل دور (موظفين المبيعات، والمسؤولين، والموظفين الجداد).
  3. اعمل حزمة لشاشات المتاجر وحزمة لكل دور، كل واحدة بتدّي bouquets بتاعتها وبتشيل فترة الوصول كمدة.
  4. ادّي أصحاب الامتياز الحزم اللي يقدروا يعيدوا بيعها لمتاجرهم وموظفيهم.

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

حساب شريك لكل صاحب امتياز.

  1. اعمل مجموعة بصلاحيات محصورة في الخطوط، من غير تغيير الكتالوج.
  2. ضيف كل صاحب امتياز من Users ← إضافة موزّع، بالمجموعة دي وحزمه ورصيد كريدت.
  3. صاحب الامتياز اللي في كذا منطقة ممكن يضيف موزّع فرعي لكل منطقة، وله متاجره.

إعداد خطوط المتاجر والموظفين

خط لكل شاشة ولكل موظف.

  1. اعمل خط لكل شاشة متجر تحت Lines ← إضافة باسم المتجر وحزمة المتجر؛ وصاحب الامتياز بيعمل نفس الحاجة لمتاجره.
  2. اضبط max connections على عدد الشاشات في المتجر، وعلى اتنين للموظف (صالة البيع والموبايل).
  3. اربط خط المتجر بعنوان المتجر لما يكون ثابت، عشان بيانات الدخول ما تشتغلش في مكان تاني.
  4. اظبط مشغّل الشاشة مرة واحدة (M3U أو Xtream Codes API أو عنوان مشغّل الويب) واحتفظ ببيانات الدخول في ملف المتجر.

فيديو التدريب والمنتجات

المكتبة للموظفين.

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

قناة المتجر

قناة واحدة لكل الشاشات.

  1. ضيف قناة المتجر كبث مباشر، بيغذّيه مشفّر المقر الرئيسي عبر RTMP أو مصدر متكرر.
  2. فعّل Catch-up لجلسات التدريب اللي بتتبث مباشر، وارفع التسجيل للمكتبة بعد كده.
  3. الـ Nodes في المناطق بتاخد القناة مرة واحدة من المصدر الأصلي وبتخدم متاجرها، فوصلات المتاجر مش بتتملي.

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

الوصول بيتبع المتجر أو العقد.

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

التكامل مع أنظمة الامتياز أو الموارد البشرية

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

  1. اعمل مفتاح Reseller API لنظام إدارة الامتياز أو الموارد البشرية؛ بينادي create_line وrenew_line وenable_line وdisable_line، بمعرّف طلب مع كل كتابة.
  2. استخدم موصّل تجارة لما بتفوتر أصحاب الامتياز على الخدمة؛ وأي نظام تاني بيستخدم Reseller API وwebhooks.
  3. مفيش تسجيل دخول موحّد للمشاهدين: الموظفين بيسجّلوا الدخول للمشغّل ببيانات خطوطهم.

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

خلّي كل متجر على خطوطه.

  1. قدّم اللوحة ورا ريفرس بروكسي مع TLS واضبط TRUSTED_PROXIES عشان سجل التدقيق وقواعد IP يشوفوا العناوين الحقيقية.
  2. تسجيل دخول بخطوتين لكل حساب في المقر الرئيسي؛ وأصحاب الامتياز بياخدوا مجموعة صلاحيات محصورة في خطوطهم.
  3. حد اتصالات لكل خط، وروابط تشغيل موقّعة وبتنتهي، وربط بالعنوان لشاشات المتاجر.
  4. فعّل النسخ الاحتياطي المشفّر لقاعدة البيانات مع نسخة برا الموقع، واستخدم سجل التدقيق لمراجعة تغييرات الخطوط والكتالوج.

حل المشاكل

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

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