الأدلة دي بتطابق مفاهيم المجال مع العناصر الموجودة في المنصة دلوقتي (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) بعنوان عام أو نطاق، وعرض نطاق صاعد كفاية للمباريات اللي ناوي تبثها.
- الكاميرا والمشفّر في الملعب اللي يقدروا يدفعوا RTMP، وملفات التدريب والتحليل المسجّلة اللي مدربينك محتفظين بيها فعلًا.
- قرار بخصوص مين بيشوف إيه: أنهي فرق بتتشارك المواد، وأنهي مباريات للأعضاء بس، ومين في الجهاز الفني ياخد حساب في اللوحة.
نشر البنية
الأكاديمية الأول، وNode لما أيام المباريات تحتاجها.
- شغّل المثبّت على سيرفر الأكاديمية وحط اللوحة ورا ريفرس بروكسي مع TLS؛ واضبط الوكلاء الموثوقين عشان السجلات وقواعد IP تشوف عنوان المشاهد الحقيقي.
- اضبط عنوان أساس التشغيل على العنوان العام اللي المشاهدين بيوصلوله، عشان الروابط اللي اللوحة بتصدرها تشتغل من البيت.
- لو عائلات كتير بتتفرج على نفس المباراة، سجّل Node من Servers؛ اللوحة بتثبّتها عبر SSH وبتوزّع منها القناة المباشرة.
- اعمل حساب شريك (موزّع) للجهاز الفني بصلاحيات للكتالوج ومن غير صلاحيات لخطوط الأعضاء.
تنظيم المحتوى
الفرق والمواسم كتصنيفات، والوصول كـ bouquets.
- اعمل تصنيفات لكل فئة عمرية ولكل موسم، ومسلسلات للمسابقات بحلقة لكل مباراة.
- اعمل bouquet لمواد تحليل كل فريق، وواحد لقنوات المباريات المباشرة، وواحد للأكاديمية كلها.
- اعمل حزمة لكل نوع عضوية: الـ bouquets اللي بتديها، والموسم كمدة، وسعر بالكريدت لو الموظفين بيبيعوها.
- سمّي الـ bouquets باسم الفريق أو المسابقة اللي تبعها، عشان الموظفين يعرفوا أنهي حزمة يدّوها للعائلة.
إعداد الشركاء (الموزّعين)
موظفين بيديروا أعضاءهم بنفسهم، لو النادي عايز كده.
- اعمل مجموعة بصلاحيات الكتالوج للمدربين ومجموعة بصلاحيات الخطوط لسكرتير العضوية.
- ضيف كل واحد منهم كموزّع بالمجموعة المناسبة؛ وادّي السكرتير كريدت لو العضويات بتتباع من اللوحة بس.
- أكاديمية تابعة أو نادي مشجعين ليه أعضاؤه بياخد حساب شريك وحزم خاصة بيه.
إعداد وصول الأعضاء والعائلات
خط لكل عضو أو لكل عائلة.
- اعمل مفتاح Reseller API للمتجر أو نظام إدارة النادي واحتفظ بيه في أسرار النظام ده.
- عند التسجيل النظام بينادي action=create_line مع حزمة العضوية ومعرّف الطلب؛ والموسم هو مدة الحزمة.
- اضبط max connections على الأجهزة اللي العيلة محتاجاها (عادةً تلاتة أو أربعة) عشان عضوية واحدة ما تتشاركش برا البيت.
- ليوم مباراة تجريبي، ضيف خط من Lines ← إضافة بحزمة تجريبية، أو اطبع رموز تفعيل للمشجعين في المدرجات.
مكتبة التحليل والإعادة
المباريات والحصص عند الطلب.
- ارفع كل مباراة أو حصة كمصدر حلقة، أو استوردها بمهمة استيراد الفيديو عند الطلب؛ واحتفظ بالتاريخ والخصم والفريق في العنوان.
- اربط التسجيل بـ bouquet الفريق من خلال مسلسله، فخطوط الفريق ده بس هي اللي تشوفه.
- افحص التشغيل بخط تجريبي من كل عضوية عشان تتأكد مين بيشوف إيه.
بث المباريات والتدريبات
كاميرا الملعب كقناة مباشرة.
- ضيف بث مباشر لكل مشفّر في الملعب (دفع RTMP) وحطه في bouquet يوم المباراة.
- فعّل Catch-up عشان العيلة اللي بتنضم متأخرة تقدر ترجع لورا، وضيف التسجيل للمكتبة بعد صافرة النهاية.
- في يوم مباراة زحمة، اتأكد إن الـ Node بتاخد القناة مرة واحدة من المصدر الأصلي وبتخدم المشاهدين المتوجّهين ليها.
انتهاء العضوية
الوصول بيتبع الموسم.
- الخط بينتهي في نهاية فترة حزمته؛ والمتجر بيجدّده بـ action=renew_line لما رسوم الموسم الجاي تتدفع.
- اشترك المتجر في webhooks عشان يبعت تذكير عند line.expiring ويقفل العضوية عند line.expired.
- اللاعب اللي بيسيب في نص الموسم المتجر بيوقفه بـ action=disable_line؛ والخط بيتحتفظ بيه للسجلات.
التكامل مع المتجر أو برنامج النادي
الأنظمة بتدير الوصول؛ والمشغّل بيشغّل.
- ثبّت موصّل منصة التجارة (WooCommerce وShopify وغيرهم) في ناحية المتجر عشان الشراء يعمل الخط والدفع يجدّده.
- نظام إدارة النادي أو التذاكر بيتوصّل عبر Reseller API وwebhooks؛ ومفيش موصّل أصلي ليه.
- مفيش تسجيل دخول موحّد للمشاهدين: الأعضاء بيسجّلوا الدخول للمشغّل ببيانات خطوطهم، اللي المتجر بيبعتها ليهم.
اعتبارات الأمان
مواد الفريق بتفضل مع الفريق.
- قدّم اللوحة وعنوان أساس التشغيل عبر TLS واضبط TRUSTED_PROXIES على الريفرس بروكسي بتاعك.
- تسجيل دخول بخطوتين لكل حساب في اللوحة، ومجموعات صلاحيات عشان السكرتير ما يغيّرش الكتالوج والمدربين ما يشوفوش الخطوط.
- روابط تشغيل موقّعة وبتنتهي، وحد اتصالات لكل خط، وربط بعنوان IP أو بلد لخطوط الموظفين.
- نسخ احتياطية مشفّرة لقاعدة البيانات مع نسخة برا الموقع، وسجل التدقيق لكل تغيير في الخطوط والكتالوج.
حل المشاكل
الفحوص الأولى المعتادة.
- ولي أمر شايف تحليل الفريق الأول: افحص حزمة الخط والـ bouquets اللي بتديها.
- عضو جديد من غير وصول بعد ما دفع: افحص سجل نداءات Reseller API لطلب المتجر وتاريخ انتهاء الخط.
- بث المباراة بيتقطّع عند الانطلاق: افحص رفع المشفّر في الملعب، ونبض الـ Node لو في واحدة بتخدم المشاهدين.
- سجل التدقيق بيعرض عنوان البروكسي: اضبط TRUSTED_PROXIES على البروكسي وأعد تشغيل اللوحة.