تطابق هذه الأدلة مفاهيم القطاع مع العناصر الموجودة في المنصة اليوم (باقات القنوات والخطوط والحزم وحسابات الموزّعين والعقد وواجهة API). وهي مطابقات مفاهيمية لا ميزات خاصة بقطاع، وحساب الموزّع حساب مفوَّض لا tenant معزول.
المطابقة المفاهيمية
لا شيء في اللوحة يُسمّى شقة أو مقيمًا. يبيّن الجدول أي كائن يؤدي أي دور؛ وتُعدّه الفصول أدناه بهذا الترتيب.
| في قطاعك | على المنصة | أين في اللوحة |
|---|---|---|
| حساب مدير العقارات | حساب موزّع (reseller): لوحة مفوَّضة بأرصدة وصلاحيات وخطوطه الخاصة | Users ← إضافة موزّع؛ Groups لصلاحياته |
| باقة القنوات | باقة قنوات (bouquet): مجموعة مسمّاة من القنوات أو الأفلام أو المسلسلات تمنحها الحزمة | Bouquets، من Streams وMovies / Series |
| قناة أو قناة معلومات | قناة مباشرة: بث بمصادره وEPG وصيغ الإخراج | Streams ← إضافة بث مباشر (رابط المصدر أو دفع RTMP) |
| فيديوهات الترحيب والإعلانات | كتالوج VOD: أفلام ومسلسلات بمواسم وحلقات وتصنيفات وبيانات وصفية | Movies وSeries، أو مهمة استيراد VOD |
| وصول الشقة | الخط: وصول واحد بحزمته وباقات قنواته وانتهائه وحد اتصالاته ومخرجاته | Lines ← إضافة، أو رموز التفعيل، أو Reseller API |
| مدة الإيجار أو الإشغال | تاريخ انتهاء الخط، يُجدَّد بحزمة أو رصيد أو واجهة API | تاريخ انتهاء الخط ومدة الحزمة |
| عقدة المبنى | عقد البث: خوادم حافة تُسجَّل من اللوحة، واحدة لكل موقع أو مبنى | Servers ← إضافة عقدة، تُثبَّت عبر SSH |
المتطلبات
ما يجب توفيره قبل التثبيت.
- خادم لشركة الإدارة (Ubuntu 22.04 أو 24.04)، والمثبّت، وخادم لكل مبنى يصل إلى شبكة المقيمين.
- بث القنوات التي يجوز للمجتمع إعادة بثها (عناوين سحب أو RTMP)، وإعلانات شركة الإدارة وفيديوهات الترحيب، وأجهزة المقيمين (أجهزة استقبال، أو تلفزيونات ذكية بتطبيق مشغّل، أو متصفح).
- قرار بشأن أنواع المنازل (عادي، كبار السن، طلاب)، ومن في شركة الإدارة يفتح الخطوط ويجدّدها.
نشر البنية
الخادم المركزي، ثم عقدة لكل مبنى.
- شغّل المثبّت على الخادم المركزي واضبط عنوان أساس التشغيل على عنوان تصل إليه المباني.
- أضف بث القنوات ضمن البثوث والإعلانات ضمن الأفلام، وافحصها في مشغّل الويب.
- سجّل عقدة لكل مبنى من الخوادم؛ تثبّتها اللوحة عبر SSH، أو تسجّل العقدة نفسها برمز لمرة واحدة، وتوجّه إليها مقيمي ذلك المبنى.
- أضف مدير العقارات من المستخدمون ← إضافة موزّع، بمجموعة تسمح بالخطوط ودون تغيير الكتالوج.
تنظيم المحتوى
باقات القنوات لكل نوع منزل.
- أنشئ باقة قنوات لكل مجموعة من قنوات كل نوع منزل، وباقة لمعلومات شركة الإدارة.
- أضف باقة المعلومات إلى كل حزمة ليتلقى كل مقيم الإعلانات.
- أنشئ حزمة لكل نوع منزل بباقاتها ومدة تطابق الإيجار أو فترة الإشغال.
- رتّب القنوات وأعطها شعارات لتُقرأ قائمة التلفزيون جيدًا.
إعداد الشركاء (الموزّعين)
مدير العقارات كحساب مفوَّض.
- أنشئ مجموعة بأذونات مقصورة على الخطوط، دون وصول إلى الكتالوج أو الخوادم.
- أضف كل مدير عقارات كموزّع بتلك المجموعة وحزم منازله ورصيد.
- يمكن لمدير عدة مبانٍ إضافة موزّع فرعي لكل مبنى، له منازله ورصيده.
إعداد الشقق (الخطوط)
خط لكل شقة، باسم رقمها.
- أنشئ خطًا لكل شقة من الخطوط ← إضافة، باسم رقم الشقة وحزمة ذلك النوع من المنازل.
- اضبط الحد الأقصى للاتصالات على عدد أجهزة التلفزيون في المنزل.
- استخدم رمز تفعيل بدل كلمة المرور حين يجب أن يدخل المقيم رمزًا قصيرًا على الجهاز.
- اضبط الجهاز مرة واحدة (Xtream Codes API أو M3U ببيانات دخول الخط، أو بوابة MAG أو Enigma2)؛ وتبقى بيانات الدخول مع الشقة حتى يُمنح الخط بيانات جديدة.
فيديوهات الترحيب والإعلانات
فيديوهات شركة الإدارة عند الطلب.
- ارفع فيديو الترحيب وقواعد المبنى وأدلة الصيانة كأفلام، بتصنيف لكل موضوع.
- ضعها في باقة المعلومات لتشملها كل حزمة.
- استبدل فيديو من اللوحة حين تتغير المعلومات؛ فيرى المقيمون النسخة الجديدة فورًا.
القنوات وقناة المعلومات
باقة القنوات وقناة الإعلانات كبثوث مباشرة.
- أضف كل قناة مرخّصة ضمن البثوث مع بثها، ومصدر EPG ليعرض الدليل على التلفزيون البرامج.
- أضف قناة المعلومات كبث مباشر، يغذّيه مشفّر عبر RTMP أو مصدر متكرر، وضعها في باقة المعلومات.
- احتفظ بالقنوات ذات القيود الجغرافية في باقات لا تمنحها إلا الحزم المناسبة.
الانتقال والمغادرة والانتهاء
الإشغال كصلاحية للخط.
- ينتهي الخط في نهاية فترة حزمته؛ جدّده بالحزمة أو برصيد لكل فترة جديدة من الإيجار.
- حين يغادر المقيم عطّل الخط؛ ويفعّله المقيم التالي ببيانات جديدة، فلا يبقى شيء لدى الأسرة السابقة.
- اشترك بنظام الإسكان أو المدير في webhooks لرؤية الخطوط التي توشك على الانتهاء أو انتهت.
التكامل مع نظام إسكان أو فوترة
الأنظمة تفتح الوصول؛ والمشغّل يشغّل.
- أنشئ مفتاح Reseller API لنظام الإسكان أو الفوترة؛ يستدعي create_line وrenew_line وenable_line وdisable_line، ويرسل معرّف طلب مع كل كتابة.
- استخدم موصّل تجارة حين يشتري المقيمون حزمًا إضافية عبر الإنترنت؛ وأي نظام آخر يستخدم Reseller API وwebhooks.
- لا يوجد تسجيل دخول موحّد للمشاهدين: يسجّل المقيم الدخول إلى المشغّل ببيانات الخط.
اعتبارات الأمان
أبقِ الخدمة داخل المجتمع.
- قدّم اللوحة خلف وكيل عكسي مع TLS واضبط TRUSTED_PROXIES ليرى سجل التدقيق وقواعد IP العناوين الحقيقية.
- دخول بخطوتين لكل حساب إدارة؛ ويحصل مديرو العقارات على مجموعة أذونات مقصورة على الخطوط.
- حدّ اتصالات لكل خط، وروابط تشغيل موقّعة ومنتهية الصلاحية، وربط بالعنوان حيث تملك الأجهزة عناوين ثابتة.
- فعّل النسخ الاحتياطي المشفّر لقاعدة البيانات مع نسخة خارج الموقع؛ فبيانات دخول الخطوط محفوظة فيه.
استكشاف الأخطاء
الفحوص الأولى المعتادة.
- شقة بلا تلفزيون: افحص أن خطها مفعّل وغير منتهٍ، ثم بيانات دخول الجهاز وعنوان التشغيل.
- مبنى يتقطّع في المساء: افحص نبض عقدة المبنى وأن مقيميه موجَّهون إليها.
- قناة مفقودة لنوع منزل واحد: افحص باقات تلك الحزمة.
- مدير لا يستطيع إنشاء خطوط: افحص رصيد الموزّع وأذونات مجموعته والحزم المسندة إليه.