دليل إعداد المتاحف والمراكز الثقافية

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

مفيش حاجة في اللوحة اسمها قاعة أو عضو. الجدول بيقول أنهي كائن بيلعب أنهي دور؛ والفصول اللي تحت بتظبطهم بالترتيب ده.

1المتطلبات

اللي لازم يكون موجود قبل التثبيت.

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

2نشر البنية

السيرفر في المبنى، بيتفعّل في المكان.

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

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

القاعات والأرشيف ومجموعات الأعضاء.

1. اعمل تصنيفات لكل معرض ولكل سنة، ومسلسل لسلسلة محاضرات بحلقة لكل محاضرة.
2. اعمل bouquet لشاشات القاعات وواحد لمكتبة الأعضاء من المحاضرات والأفلام الأرشيفية.
3. اعمل حزمة للقاعات وحزمة لكل نوع عضوية، كل واحدة بتدّي bouquets بتاعتها؛ ومدة حزمة العضوية هي فترة العضوية.
4. ضيف ملصقات ووصف قصير لكل فيلم عشان المكتبة تتقري كويس في المشغّل.

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

المكتب والمتجر كحسابات مفوَّضة.

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

5إعداد وصول الزوار والأعضاء

الشاشات والأعضاء على خطوط.

1. اعمل خط لكل شاشة قاعة من Lines ← إضافة بحزمة القاعات، واربطه بعنوان الشاشة لما الشبكة بتدي عناوين ثابتة.
2. اعمل رموز تفعيل عند المكتب لكل عضوية بتتباع؛ العضو بيدخل الرمز في المشغّل فالخط يبدأ.
3. اضبط max connections لكل عضوية على عدد الأجهزة اللي العضو يقدر يستخدمها، عادةً اتنين.
4. سلّم العضو تطبيق المشغّل أو قائمة M3U أو عنوان مشغّل الويب، أيهم يناسب جهازه.

6فيلم المعرض والأرشيف

المكتبة عند الطلب.

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

7الافتتاحات والمحاضرات

فعالية كقناة مباشرة.

1. ضيف بث مباشر لمشفّر قاعة المحاضرات (دفع RTMP) وحطه في bouquet الأعضاء، أو في bouquet القاعات لافتتاح بيتعرض على الشاشات.
2. فعّل Catch-up عشان العضو اللي بيوصل متأخر يقدر يرجع لورا، وارفع التسجيل للمكتبة بعد كده.
3. جرّب المشفّر والبث قبل الفعالية بخط تجريبي، على نفس الشبكة اللي الجمهور هيستخدمها.

8انتهاء العضوية وتجديدها

العضوية كصلاحية للخط.

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

9التكامل مع المتجر أو نظام العضويات

الأنظمة بتبيع الوصول؛ والمشغّل بيشغّل.

1. اعمل مفتاح Reseller API للمتجر أو نظام العضويات؛ بينادي create_line وrenew_line وdisable_line، بمعرّف طلب مع كل كتابة.
2. استخدم موصّل تجارة لما العضويات بتتباع أونلاين؛ وأي نظام تاني بيستخدم Reseller API وwebhooks.
3. مفيش تسجيل دخول موحّد للمشاهدين: العضو بيسجّل الدخول للمشغّل ببيانات الخط أو بكود التفعيل.

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

خلّي المجموعات في مكانها.

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

11حل المشاكل

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

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