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