دليل إعداد الأندية والأكاديميات الرياضية

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

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

1المتطلبات

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

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

2نشر البنية

الأكاديمية أولًا، وعقدة حين تتطلبها أيام المباريات.

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

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

الفرق والمواسم كتصنيفات، والوصول كباقات.

1. أنشئ تصنيفات لكل فئة عمرية ولكل موسم، ومسلسلات للمسابقات بحلقة لكل مباراة.
2. أنشئ باقة قنوات لمواد تحليل كل فريق، وباقة لقنوات المباريات المباشرة، وباقة للأكاديمية كلها.
3. أنشئ حزمة لكل نوع عضوية: الباقات التي تمنحها، والموسم كمدة، وسعرًا بالرصيد إن كان الموظفون يبيعونها.
4. سمِّ الباقات باسم الفريق أو المسابقة التي تتبعها، ليعرف الموظفون أي حزمة يمنحون العائلة.

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

موظفون يديرون أعضاءهم بأنفسهم، إن أراد النادي ذلك.

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

5إعداد وصول الأعضاء والعائلات

خط لكل عضو أو لكل عائلة.

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

6مكتبة التحليل والإعادة

المباريات والحصص عند الطلب.

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

7بث المباريات والتدريبات

كاميرا الملعب كقناة مباشرة.

1. أضف بثًا مباشرًا لكل مشفّر في الملعب (دفع RTMP) وضعه في باقة يوم المباراة.
2. فعّل Catch-up ليتمكن الأهل المتأخرون من الرجوع إلى الوراء، وأضف التسجيل إلى المكتبة بعد صافرة النهاية.
3. في يوم مباراة مزدحم، تحقق من أن العقدة تأخذ القناة مرة واحدة من المصدر الأصلي وتخدم المشاهدين الموجَّهين إليها.

8انتهاء العضوية

الوصول يتبع الموسم.

1. ينتهي الخط في نهاية فترة حزمته؛ ويجدّده المتجر بـ action=renew_line حين تُدفع رسوم الموسم التالي.
2. اشترك بالمتجر في webhooks لإرسال تذكير عند line.expiring ولإغلاق العضوية عند line.expired.
3. اللاعب الذي يغادر في منتصف الموسم يعطّله المتجر بـ action=disable_line؛ ويُحتفظ بالخط للسجلات.

9التكامل مع المتجر أو برنامج النادي

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

1. ثبّت موصّل منصة التجارة (WooCommerce وShopify وغيرهما) في جانب المتجر ليُنشئ الشراء الخط ويجدّده الدفع.
2. يرتبط نظام إدارة النادي أو التذاكر عبر Reseller API وwebhooks؛ ولا يوجد موصّل أصلي له.
3. لا يوجد تسجيل دخول موحّد للمشاهدين: يسجّل الأعضاء الدخول إلى المشغّل ببيانات خطوطهم، التي يرسلها المتجر إليهم.

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

مواد الفريق تبقى مع الفريق.

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

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

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

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