دليل إعداد الفنادق والمنتجعات

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

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

1المتطلبات

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

1. خادم على شبكة المنشأة (Ubuntu 22.04 أو 24.04)، والمثبّت، وعنوان تستطيع أجهزة الغرف الوصول إليه.
2. خلاصات القنوات التي تملك المنشأة حقوقها (روابط سحب أو RTMP)، وفيديوهات معلومات الفندق، وأجهزة الغرف (أجهزة Android TV، أجهزة MAG أو Enigma2، تلفزيونات ذكية بتطبيق مشغّل أو متصفح).
3. قدرة PMS على استدعاء HTTP API عند تسجيل الوصول والمغادرة، أو إجراء في الاستقبال لتنفيذ ذلك في اللوحة.

2نشر البنية

الخادم المركزي وعقدة لكل مبنى.

1. شغّل المثبّت على الخادم المركزي؛ واضبط أساس التشغيل على العنوان الداخلي للمنشأة لتبقى الغرف على الشبكة المحلية.
2. أضف خلاصات القنوات تحت Streams وفيديوهات المعلومات تحت Movies؛ وافحصها في مشغّل الويب.
3. سجّل عقدة لكل جناح أو مبنى من Servers؛ تثبّتها اللوحة عبر SSH وتوجّه غرف ذلك المبنى إليها.
4. اضبط مفتاح الرخصة على الخادم؛ يتم التفعيل في الموقع وتعمل الخدمة دون الاتصال الخارجي.

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

حزم القنوات وفيديوهات الفندق.

1. أنشئ باقة قنوات لكل حزمة قنوات (غرف عادية، أجنحة، مؤتمرات) من قنوات المنشأة.
2. أنشئ باقة قنوات لفيديوهات الفندق (ترحيب، مرافق، سلامة) وأضفها إلى كل حزمة.
3. أنشئ حزمة لكل فئة غرفة بباقات القنوات التي تمنحها ومدة يوم واحد: عند تسجيل الوصول يُجدَّد خط الغرفة مرة عن كل ليلة إقامة (يضيف كل تجديد مدة الحزمة)، وعند المغادرة يُعطَّل (الفصل 8).
4. رتّب القنوات وأعطها شعارات لتظهر القائمة على التلفزيون بوضوح.

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

المنشأة، أو مشغّل يدير عدة منشآت، بوصفه حسابًا مفوَّضًا.

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

5إعداد الغرفة (الخط)

خط لكل غرفة، باسم رقمها.

1. أنشئ خطًا لكل غرفة تحت Lines برقم الغرفة اسمًا وحزمة فئة الغرفة.
2. اضبط max connections على 1 (تلفزيون واحد) أو على عدد الشاشات في الغرفة.
3. اربط الخط بعنوان جهاز الغرفة عندما تمنح الشبكة الأجهزة عناوين ثابتة.
4. اضبط الجهاز (Xtream Codes API أو M3U ببيانات الخط، أو بوابة MAG / Enigma2) مرة واحدة؛ وتبقى البيانات مع الغرفة.

6فيديوهات معلومات الفندق

فيديوهات المنشأة نفسها عند الطلب.

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

7قنوات تلفزيونية مرخّصة

قنوات المنشأة بثًا مباشرًا.

1. أضف كل قناة مرخّصة تحت Streams بخلاصتها؛ وفعّل Timeshift أو Catch-up حيث تسمح الرخصة فقط.
2. أضف مصدر EPG ليعرض الدليل على التلفزيون البرامج.
3. أبقِ القنوات المقيّدة بإقليم في باقات قنوات لا تمنحها إلا الحزم المناسبة.

8تسجيل الوصول والمغادرة والانتهاء

الإقامة بوصفها صلاحية الخط.

1. عند تسجيل الوصول فعّل خط الغرفة وجدّده بطول الإقامة (PMS عبر واجهة API، أو الاستقبال في اللوحة).
2. عند المغادرة عطّل الخط؛ وتفعّله الإقامة الجديدة من جديد، فلا تغادر البيانات الغرفة.
3. اشترك بـ PMS أو الاستقبال في webhooks لترى الخطوط المفعّلة والمعطّلة والمنتهية.

9التكامل مع PMS

يشغّل تسجيل الوصول والمغادرة الغرف.

1. أنشئ مفتاح Reseller API لـ PMS واحتفظ به في إعدادات PMS.
2. عند تسجيل الوصول يستدعي PMS الإجراءين action=enable_line وaction=renew_line لخط الغرفة بمعرّف طلب؛ وعند المغادرة action=disable_line.
3. تطبيق خدمات النزلاء (استدعاء الموظفين، التدبير المنزلي، المغادرة السريعة، خدمة الغرف) واتصاله بالـ back-office جزء من خطة Enterprise ويُحدَّد نطاقه مع المنشأة.

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

أبقِ القنوات داخل المنشأة.

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

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

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

1. غرفة بلا تلفزيون: افحص أن خطها مفعّل وغير منتهٍ، ثم بيانات الجهاز وعنوانه.
2. قناة مفقودة في غرفة: افحص باقة قنوات حزمة فئة الغرفة.
3. يتوقف التلفزيون أثناء انقطاع الإنترنت: افحص أن أساس التشغيل والمصادر عناوين داخلية؛ فالخلاصات الخارجية تعتمد على الاتصال الخارجي.
4. يفشل استدعاء PMS: افحص مفتاح API، وأن الكتابة بـ POST، ومعرّف الطلب عند إعادة المحاولة.