الأدلة دي بتطابق مفاهيم المجال مع العناصر الموجودة في المنصة دلوقتي (bouquets وخطوط وحزم وحسابات موزّعين وعقد والـ API). دي مطابقات مفاهيمية، مش ميزات خاصة بمجال، وحساب الموزّع حساب مفوَّض، مش tenant معزول.
المطابقة المفاهيمية
مفيش حاجة في اللوحة اسمها غرفة أو إقامة. الجدول بيقول أنهي عنصر بيلعب أنهي دور؛ والفصول تحت بتجهّزهم بالترتيب ده.
| في مجالك | على المنصة | فين في اللوحة |
|---|---|---|
| مشغّل الفندق أو شريك معتمد | حساب موزّع (reseller): لوحة مفوَّضة بكريديت وصلاحيات وخطوطه الخاصة | Users → ضيف موزّع؛ Groups لصلاحياته |
| حزمة قنوات | Bouquet: مجموعة مسمّاة من القنوات أو الأفلام أو المسلسلات اللي الحزمة بتديها | Bouquets، من Streams وMovies / Series |
| غرفة أو جهاز | الخط: وصول واحد بحزمته وbouquets وانتهائه وحد اتصالاته ومخرجاته | Lines → إضافة، أو أكواد التفعيل، أو الـ Reseller API |
| فيديوهات معلومات الفندق | كتالوج VOD: أفلام ومسلسلات بمواسم وحلقات وتصنيفات وبيانات وصفية | Movies وSeries، أو مهمة استيراد VOD |
| قنوات تلفزيونية مرخّصة | قناة مباشرة: بث بمصادره وEPG وصيغ الإخراج | Streams → ضيف بث مباشر (رابط المصدر أو RTMP push) |
| مدة الإقامة | تاريخ انتهاء الخط، بيتجدّد بحزمة أو كريديت أو الـ API | تاريخ انتهاء الخط ومدة الحزمة |
| Node لكل مبنى أو جناح | عقد البث: سيرفرات حافة بتتسجّل من اللوحة، واحدة لكل موقع أو مبنى | Servers → ضيف Node، بتتثبّت عن طريق SSH |
المتطلبات
اللي لازم يكون عندك قبل التثبيت.
- سيرفر على شبكة المنشأة (Ubuntu 22.04 أو 24.04)، والمثبّت، وعنوان أجهزة الغرف تقدر توصله.
- بث القنوات اللي المنشأة عندها حقوقها (روابط pull أو RTMP)، وفيديوهات معلومات الفندق، وأجهزة الغرف (بوكسات Android TV، بوكسات MAG أو Enigma2، تلفزيونات ذكية بتطبيق مشغّل أو متصفح).
- قدرة الـ PMS على استدعاء HTTP API عند تسجيل الوصول والمغادرة، أو إجراء في الاستقبال لعملها في اللوحة.
نشر البنية
السيرفر المركزي وNode لكل مبنى.
- شغّل المثبّت على السيرفر المركزي؛ واضبط أساس التشغيل على العنوان الداخلي للمنشأة عشان الغرف تفضل على الشبكة المحلية.
- ضيف بث القنوات تحت Streams وفيديوهات المعلومات تحت Movies؛ وافحصهم في مشغّل الويب.
- سجّل Node لكل جناح أو مبنى من Servers؛ اللوحة بتثبّتها عن طريق SSH وبتوجّه غرف المبنى ده ليها.
- اضبط مفتاح الرخصة على السيرفر؛ التفعيل بيتم في الموقع والخدمة بتشتغل من غير الإنترنت الخارجي.
تنظيم المحتوى
حزم القنوات وفيديوهات الفندق.
- اعمل bouquet لكل حزمة قنوات (غرف عادية، أجنحة، مؤتمرات) من قنوات المنشأة.
- اعمل bouquet لفيديوهات الفندق (ترحيب، مرافق، سلامة) وضيفه لكل حزمة.
- اعمل حزمة لكل فئة غرفة بالـ bouquets اللي بتديها ومدة يوم واحد: عند تسجيل الوصول بيتجدّد خط الغرفة مرة عن كل ليلة إقامة (كل تجديد بيضيف مدة الحزمة)، وعند المغادرة بيتعطّل (الفصل 8).
- رتّب القنوات واديها شعارات عشان القائمة على التلفزيون تبان كويس.
إعداد الشركاء (الموزّعين)
المنشأة، أو مشغّل بيدير كذا منشأة، كحساب مفوَّض.
- اعمل مجموعة بصلاحيات محدودة بالخطوط (الغرف) ومن غير تغيير الكتالوج.
- ضيف استقبال المنشأة، أو المشغّل، كموزّع بالمجموعة دي وحزم الغرف.
- مشغّل لكذا منشأة بياخد موزّع لكل منشأة، كل واحد بغرفه وكريديته.
إعداد الغرفة (الخط)
خط لكل غرفة، باسم رقمها.
- اعمل خط لكل غرفة تحت Lines برقم الغرفة كاسم وحزمة فئة الغرفة.
- اضبط max connections على 1 (تلفزيون واحد) أو على عدد الشاشات في الغرفة.
- اربط الخط بعنوان جهاز الغرفة لما الشبكة بتدي الأجهزة عناوين ثابتة.
- اظبط الجهاز (Xtream Codes API أو M3U ببيانات الخط، أو بوابة MAG / Enigma2) مرة واحدة؛ والبيانات بتفضل مع الغرفة.
فيديوهات معلومات الفندق
فيديوهات المنشأة نفسها عند الطلب.
- ارفع فيديوهات الترحيب والمعلومات كأفلام، ونسخ لغات المنشأة كعناصر منفصلة أو مسارات صوت.
- حطهم في bouquet فيديوهات الفندق عشان كل فئة غرف تستقبلها.
- حدّثهم من اللوحة كل ما المعلومات تتغير؛ والغرف بتشوف النسخة الجديدة فورًا.
قنوات تلفزيونية مرخّصة
قنوات المنشأة كبث مباشر.
- ضيف كل قناة مرخّصة تحت Streams ببثها؛ فعّل Timeshift أو Catch-up بس لو الرخصة بتسمح.
- ضيف مصدر EPG عشان الدليل على التلفزيون يعرض البرامج.
- خلّي القنوات المحدودة بإقليم في bouquets الحزم الصح بس هي اللي بتديها.
تسجيل الوصول والمغادرة والانتهاء
الإقامة كصلاحية للخط.
- عند تسجيل الوصول فعّل خط الغرفة وجدّده بطول الإقامة (الـ PMS عن طريق الـ API، أو الاستقبال في اللوحة).
- عند المغادرة عطّل الخط؛ والإقامة الجديدة بتفعّله تاني، فالبيانات مبتخرجش من الغرفة.
- اشترك بالـ PMS أو الاستقبال في webhooks عشان تشوف الخطوط المفعّلة والمعطّلة والمنتهية.
التكامل مع الـ PMS
تسجيل الوصول والمغادرة بيشغّلوا الغرف.
- اعمل مفتاح Reseller API للـ PMS وخلّيه في إعدادات الـ PMS.
- عند تسجيل الوصول الـ PMS بينادي action=enable_line وaction=renew_line لخط الغرفة بمعرّف طلب؛ وعند المغادرة action=disable_line.
- تطبيق خدمات الضيوف (نداء الموظفين، التنظيف، المغادرة السريعة، خدمة الغرف) واتصاله بالـ back-office جزء من خطة Enterprise وبيتحدد مع المنشأة.
اعتبارات الأمان
خلّي القنوات جوه المنشأة.
- خلّي أساس التشغيل والعقد على شبكة المنشأة؛ ومتعرّضش للإنترنت حاجة الغرف مش محتاجاها.
- اتصال واحد لكل غرفة، مربوط بالجهاز؛ الروابط الموقّعة بتنتهي، فالرابط المنسوخ بيبطّل يشتغل.
- تسجيل دخول بخطوتين للوحة؛ والاستقبال بياخد مجموعة صلاحيات محدودة.
- شغّل النسخ الاحتياطي المشفّر لقاعدة البيانات؛ بيانات الغرف موجودة فيها.
حل المشاكل
الفحوص الأولى المعتادة.
- غرفة من غير تلفزيون: افحص إن خطها مفعّل ومش منتهي، وبعدين بيانات الجهاز وعنوانه.
- قناة ناقصة في غرفة: افحص bouquet حزمة فئة الغرفة.
- التلفزيون بيقف وقت انقطاع الإنترنت: افحص إن أساس التشغيل والمصادر عناوين داخلية؛ البث الخارجي بيعتمد على الإنترنت.
- استدعاء الـ PMS بيفشل: افحص مفتاح الـ API، وإن الكتابة POST، ومعرّف الطلب في إعادة المحاولة.