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

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

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

1المتطلبات

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

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

2نشر البنية

المقر الرئيسي أولًا، ثم المناطق.

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

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

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

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

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

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

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

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

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

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

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

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

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

7قناة المتجر

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

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

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

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

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

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

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

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

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

أبقِ كل متجر على خطوطه.

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

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

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

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