الأدلة دي بتطابق مفاهيم المجال مع العناصر الموجودة في المنصة دلوقتي (bouquets وخطوط وحزم وحسابات موزّعين وعقد والـ API). دي مطابقات مفاهيمية، مش ميزات خاصة بمجال، وحساب الموزّع حساب مفوَّض، مش tenant معزول.
المطابقة المفاهيمية
مفيش حاجة في اللوحة اسمها برنامج أو داعم. الجدول بيقول أنهي كائن بيلعب أنهي دور؛ والفصول اللي تحت بتظبطهم بالترتيب ده.
| في مجالك | على المنصة | فين في اللوحة |
|---|---|---|
| قناة الاستوديو | قناة مباشرة: بث بمصادره وEPG وصيغ الإخراج | Streams → ضيف بث مباشر (رابط المصدر أو RTMP push) |
| مكتبة البرامج | كتالوج VOD: أفلام ومسلسلات بمواسم وحلقات وتصنيفات وبيانات وصفية | Movies وSeries، أو مهمة استيراد VOD |
| مستوى الاشتراك | Bouquet: مجموعة مسمّاة من القنوات أو الأفلام أو المسلسلات اللي الحزمة بتديها | Bouquets، من Streams وMovies / Series |
| وصول الداعم | الخط: وصول واحد بحزمته وbouquets وانتهائه وحد اتصالاته ومخرجاته | Lines → إضافة، أو أكواد التفعيل، أو الـ Reseller API |
| فترة الفوترة | تاريخ انتهاء الخط، بيتجدّد بحزمة أو كريديت أو الـ API | تاريخ انتهاء الخط ومدة الحزمة |
| حساب مسوّق أو موزّع | حساب موزّع (reseller): لوحة مفوَّضة بكريديت وصلاحيات وخطوطه الخاصة | Users → ضيف موزّع؛ Groups لصلاحياته |
| تكامل المتجر أو العضويات | Reseller API وwebhooks: عمليات اللوحة من نظامك إنت | مفاتيح Reseller API وwebhooks في لوحة الموزّع |
المتطلبات
اللي لازم يكون موجود قبل التثبيت.
- سيرفر (Ubuntu 22.04 أو 24.04) بعنوان عام أو نطاق، وعرض نطاق صاعد كفاية للجمهور المتوقع.
- الحلقات الجاهزة، ومنظومة بث الاستوديو أو مشفّره للقناة، ومتجر على منصة ليها موصّل، أو القدرة على نداء HTTP API.
- قرار بخصوص المستويات والمسوّقين: كل اشتراك بيدّي إيه، ومين يقدر يبيعه.
نشر البنية
سيرفر واحد الأول، وعقد مع كبر الجمهور.
- شغّل المثبّت على سيرفر الإدارة وحط اللوحة ورا ريفرس بروكسي مع TLS؛ واضبط الوكلاء الموثوقين عشان قواعد IP تشوف عنوان المشاهد الحقيقي.
- اضبط أساس التشغيل على العنوان العام اللي جمهورك بيوصله.
- سجّل Node من Servers في منطقة فيها داعمين كتير؛ اللوحة بتثبّتها عبر SSH وبتوجّه مشاهدي المنطقة دي ليها.
- اعمل حساب شريك (موزّع) لكل موظف بيدير الكتالوج أو الداعمين، بمجموعة صلاحيات خاصة بيه.
تنظيم المحتوى
البرامج كمسلسلات، والمستويات كـ bouquets.
- اعمل تصنيفات لكل نوع، ومسلسل لكل برنامج بموسم لكل دفعة إصدار وحلقة لكل فيديو.
- اعمل bouquet للقناة المباشرة، وواحد للمحتوى المجاني أو الأساسي، وواحد لكل مستوى أعلى.
- اعمل حزمة لكل مستوى مدتها فترة الفوترة، وحزمة تجريبية للزوار الجداد لو عايز، وسعر بالكريدت للمسوّقين.
- خلّي الأرشيف في تصنيف خاص بيه عشان يتنقل بين المستويات من غير ما تلمس المسلسلات.
إعداد الشركاء (الموزّعين)
المسوّقين بالعمولة والموزّعين.
- اعمل مجموعة للمسوّقين بصلاحيات الخطوط بس، فمايقدروش يغيّروا الكتالوج.
- ضيف كل مسوّق كموزّع بالمجموعة دي ورصيد كريدت؛ وسعر حزمته هو اللي الاستوديو يقرره.
- الموزّع اللي عنده مسوّقين فرعيين ممكن يعمل موزّعين فرعيين تحت حسابه، لحد خمس مستويات.
إعداد وصول الداعمين
خط لكل داعم.
- ثبّت موصّل متجرك (WooCommerce مثلًا) وادخل مفتاح Reseller API والحزمة المطابقة لكل منتج.
- عند الاشتراك الموصّل بينادي create_line مع الحزمة ومعرّف الطلب؛ وفترة الفوترة هي مدة الحزمة.
- اضبط max connections على عدد الأجهزة اللي الداعم يقدر يستخدمها، عادةً اتنين أو تلاتة.
- للهدايا أو الإطلاق، ولّد رموز تفعيل بالجملة أو ضيف خطوط من Lines ← إضافة بحزمة تجريبية.
مكتبة البرامج
حلقات عند الطلب.
- ارفع كل حلقة كمصدر، أو استوردها بمهمة استيراد الفيديو عند الطلب؛ واملا العنوان والموسم ورقم الحلقة وبيانات TMDB الوصفية لو البرنامج ليه.
- اربط كل مسلسل بـ bouquets المستويات اللي يحق لها تتفرج عليه.
- افحص التشغيل بخط تجريبي من كل مستوى قبل ما تعلن عن إصدار.
قناة الاستوديو
قناة على مدار الساعة.
- ضيف بث مباشر لمنظومة بث الاستوديو (دفع RTMP) وحطه في bouquets كل مستوى بيشمل القناة.
- حمّل دليل القناة بصيغة XMLTV عشان الداعمين يشوفوا اللي بيتعرض، وفعّل Catch-up للبرامج اللي تستاهل الإعادة.
- خلّي منظومة البث شغالة بين الإصدارات بمحتوى الاستوديو المجدول؛ اللوحة بتنقل البث بس.
انتهاء الاشتراك
الوصول بيتبع الدفع.
- الخط بينتهي في نهاية فترة حزمته؛ والمتجر بيجدّده بـ renew_line لما الدفعة الجاية توصل.
- اشترك المتجر في webhooks عشان يبعت تذكير عند line.expiring ويخفّض مستوى الداعم عند line.expired.
- الداعم اللي بيلغي بيوقفه المتجر بـ disable_line، والخط ممكن يتجدّد بعدين من غير حساب جديد.
التكامل مع المتجر
المتجر بيبيع؛ والمشغّل بيشغّل.
- الموصّل بيعمل الخطوط ويجدّدها ويوقفها حسب الطلبات؛ وأي متجر تاني بيستخدم Reseller API وwebhooks.
- المسوّقين بيشوفوا خطوطهم في لوحتهم، وReseller API بيخليهم يعملوا ده أوتوماتيك.
- مفيش تسجيل دخول موحّد للمشاهدين: الداعمين بيسجّلوا الدخول للمشغّل ببيانات خطهم، اللي المتجر بيبعتها ليهم.
اعتبارات الأمان
احمي الاشتراك، مش السيرفر بس.
- قدّم اللوحة وعنوان أساس التشغيل عبر TLS واضبط TRUSTED_PROXIES على الريفرس بروكسي بتاعك.
- تسجيل دخول بخطوتين لكل حساب في اللوحة، ومجموعات صلاحيات عشان المسوّقين ما يغيّروش الكتالوج.
- روابط تشغيل موقّعة وبتنتهي وحد اتصالات لكل خط؛ واربط الخط ببلد لو الرخصة إقليمية.
- نسخ احتياطية مشفّرة لقاعدة البيانات مع نسخة برا الموقع، وسجل التدقيق لكل تغيير في الخطوط والكتالوج.
حل المشاكل
الفحوص الأولى المعتادة.
- داعم جديد مش قادر يتفرج بعد ما دفع: افحص نداء موصّل المتجر في سجل Reseller API وتاريخ انتهاء الخط.
- داعم شايف محتوى مستوى أعلى: افحص حزمة الخط والـ bouquets اللي بتديها.
- القناة بتقف في نهاية دورة البث: افحص دفع المشفّر للبث المباشر وحالة فحص البث.
- عملية بيع مسوّق مش ظاهرة: افحص رصيده وإن الحزمة اللي استخدمها تبع مجموعته.