دليل إعداد صنّاع المحتوى والإعلام

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

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

1المتطلبات

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

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

2نشر البنية

خادم واحد أولًا، وعقد مع نمو الجمهور.

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

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

البرامج كمسلسلات، والمستويات كباقات.

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

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

المسوّقون بالعمولة والموزّعون.

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

5إعداد وصول الداعمين

خط لكل داعم.

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

6مكتبة البرامج

حلقات عند الطلب.

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

7قناة الاستوديو

قناة على مدار الساعة.

1. أضف بثًا مباشرًا لمنظومة بث الاستوديو (دفع RTMP) وضعه في باقات كل مستوى يشمل القناة.
2. حمّل دليل القناة بصيغة XMLTV ليرى الداعمون ما يُعرض، وفعّل Catch-up للبرامج التي تستحق الإعادة.
3. أبقِ منظومة البث تعمل بين الإصدارات بمحتوى الاستوديو المجدول؛ فاللوحة تنقل البث فقط.

8انتهاء الاشتراك

الوصول يتبع الدفع.

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

9التكامل مع المتجر

المتجر يبيع؛ والمشغّل يشغّل.

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

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

احمِ الاشتراك، لا الخادم فقط.

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

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

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

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