دليل المسؤول

1. الغرض من المستند وأدوار المسؤول

الوثيقة مخصصة للمتخصصين الذين يقومون بتكوين برنامج CShark وصيانته في موقع العميل.

تم وصف العمل اليومي مع النظام في وثيقة منفصلة "دليل المستخدم"والنشر - في الوثيقة "تعليمات تثبيت نسخة من البرنامج".

يتم تحديد الحقوق حسب القدوة (القسم 12)؛ التقسيم إلى الأدوار أعلاه تنظيمي.

2. تكوين البرمجيات ووضع المكونات

تم تضمين ملف تعريف إمكانية الملاحظة في مجموعة أدوات التحقق؛ نشرته جرافانا بتاريخ 13000/tcp، فإن خدماتها المتبقية متاحة فقط داخل شبكة Compose.

يتم تشغيل جميع الخدمات في حاويات داخل محيط الشبكة المغلقة للمنشأة. لا يتم تنفيذ المكالمات إلى الخدمات الخارجية أثناء التشغيل.

3. إدارة الخدمة

دليل العمل: /opt/cshark-stand.

# حالة الخدمات
sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml --profile obs ps

# التشغيل
sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml --profile obs up -d

# الإيقاف
sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml --profile obs stop

# إعادة تشغيل خدمة منفردة
sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml restart core

# سجلات الخدمة
sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml logs -f core

4. الإعدادات

يتم تعيين المعلمات بواسطة متغيرات البيئة (file .env بجوار ملف وصف الخدمة). بعد تغيير الإعدادات، يجب إعادة تشغيل الخدمة.

5. الإعداد الأولي للكائن

عند تسجيل الدخول لأول مرة، يكون معالج الإعداد الأولي متاحًا. التسلسل:

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

6. إعداد الطوبولوجيا والدوائر

القسم "الإدارة" → "الطوبولوجيا".

التسلسل الهرمي: التنظيم → موقف السيارات → المستوى → المنطقة → مكان وقوف السيارات.

يتم عرض رموز أماكن وقوف السيارات للمستخدمين ويجب أن تتوافق مع العلامات الموجودة على الموقع.

7. إعداد كاميرات تحليل الفيديو

القسم "المعدات".

1. قم بتكوين الكاميرا لإرسال الأحداث إلى عنوان بوابة الجهاز (بروتوكول البائع عبر HTTP). يتم تحديد العنوان والمنفذ في إعدادات الكاميرا.
2. تظهر الكاميرا التي تصل إلى النظام في قائمة الأجهزة التي لم يتم اكتشافها.
3. تسجيل الكاميرا: قم بتعيين الاسم وعنوان الشبكة والموقع.
4. ربط الكاميرا بأماكن وقوف السيارات التي تخدمها.
5. التحقق من وصول الأحداث: يجب أن تتغير حالة أماكن وقوف السيارات المرتبطة عندما يتغير الوضع.

يتم إجراء مراقبة الأداء تلقائيًا بناءً على إشارات التواجد الدورية. يتم عرض حالة الجهاز في قسم "المعدات" وفي الرسم التخطيطي للموقع. يتم حفظ تاريخ تغييرات الحالة.

بالنسبة للأجهزة التي تدعم التحكم، يتوفر نقل الأوامر عبر قناة الأوامر.

8. إنشاء لوحات المعلومات

القسم "لوحة النتائج".

8.1. قوالب

يصف القالب تخطيط الإطار ويتكون من مناطق:

يتم ضبط حجم الخط تلقائيًا وفقًا لحجم المنطقة؛ إذا كانت سعة المنطقة غير كافية، فسيتم إصدار تحذير عند حفظ القالب.

8.2. أجهزة العرض

1. أنشئ جهازًا، وحدد فئة: لوحة LED نصية (EK07، بروتوكول TCP/RS-485) أو كشك ويب على شاشة عالية الدقة.
2. تحديد معلمات الاتصال.
3. قالب الارتباط والمنطقة ونقطة الدخول.
4. تحقق من النتيجة من خلال معاينة الإطار الذي تم إنشاؤه.

يتم إنشاء عنوان عام للنموذج لكشك الويب /kiosk/display/<المعرّف>?token=<الرمز>; تفتح الشاشة هذه الصفحة في وضع الكشك. الرمز يقيد الوصول إلى المحتوى.

8.3. أولويات المحتوى

الطوارئ ← الاستبدال اليدوي ← الجدول الزمني ← التوظيف. يحل محتوى الطوارئ (وضع الحريق أو المأوى) محل أي محتوى آخر ولا يمكن استبداله يدويًا.

8.4. المرسل إليه النصوص

تنقسم أسباب عدم التوفر إلى عامة (معروضة للسائق) وإدارية (متاحة للموظفين فقط). النصوص الإدارية غير موجودة فعليًا في استجابة الكشك العام وفي تدفق WebSocket. الحالة التشخيصية للشاشة متاحة على /api/displays/{id}/state للموظفين المعتمدين فقط.

9. إعدادات الملاحة

القسم "الإدارة" ← "المناطق"علامة تبويب الاتصالات.

1. حدد حواف الرسم البياني لإمكانية الوصول بين المناطق (أي المناطق يمكن الوصول إليها منها).
2. الإشارة إلى نقاط الدخول إلى الموقع.
3. قم بإرفاق أدلة اللوحة بنقاط الدخول.

يقوم النظام باحتساب عدد المقاعد الفارغة المتوفرة بالنسبة لنقطة دخول محددة واتجاه الحركة إليها. يتم عرض حالة "البيانات غير متوفرة" على الشاشة برمز مختلف عن القيمة "صفر" - ويجب ألا يخطئ السائق في فهم العطل على أنه نقص المقاعد.

10. تحديد أوضاع ومناطق الكائن

حالات المنطقة والكائن: الموظفون، والحرائق، والمأوى، والصيانة.

يتغير تغيير الوضع على الفور: توفر أماكن وقوف السيارات في المنطقة، ومحتويات لوحات المعلومات (يحظى محتوى الطوارئ بالأولوية القصوى)، وقواعد معالجة الأحداث، وتكوين الإشعارات.

يعود المسؤول إلى الوضع العادي يدويًا بعد إزالة السبب.

11. وضع قواعد معالجة الأحداث

القسم "الإدارة" ← "القواعد".

يتم تعيين القاعدة وفقًا للمخطط التالي:

الزناد (نوع الحدث) × المنطقة (الجسم، المنطقة، مجموعة الأماكن، مكان محدد) × شرط (الوقت، الحالة، علامات أخرى) → الإجراءات

الإجراءات المتاحة: إخطار المشغل، إنشاء حادث، تغيير الحالة، إرسال أمر إلى الجهاز.

تدخل القاعدة حيز التنفيذ دون إعادة تشغيل الخدمات. يتم تحديد الترتيب الذي يتم به تطبيق القواعد حسب أولويتها.

أمثلة: "انتهاك العلامات في منطقة للأشخاص ذوي القدرة المحدودة على الحركة ← خلق حادثة ذات مستوى حرج"؛ "تم احتلال مكان وقوف السيارات عند المدخل لأكثر من 10 دقائق دون إذن ← قم بإبلاغ مشرف المناوبة."

12. إدارة المستخدمين والأدوار والحقوق

القسم "الإدارة" ← "المستخدمون" و"الأدوار".

• يتم تعيين الأذونات في مساحة واحدة بالنموذج "resource:action" (على سبيل المثال، displays:manage, users:manage).
• الدور هو مجموعة مسماة من الأذونات. يتم تعيين دور للمستخدم؛ بالإضافة إلى ذلك، قد يتم إصدار تصاريح فردية.
• لا يتم عرض أقسام الواجهة التي لا يمكن للمستخدم الوصول إليها بسبب الحقوق في التنقل.
• يتم تسجيل إجراءات المستخدم في سجل الإجراءات.

متطلبات كلمة المرور: 6 أحرف على الأقل. يتم تخزين كلمات المرور في شكل تجزئات (خوارزمية bcrypt)؛ ولا يتم تخزينها أو نقلها بنص واضح.

يتم تنفيذ الجلسات بواسطة الرموز الموقعة؛ يتم تحديد سر التوقيع بواسطة المعلمة CSHARK_AUTH_SECRET. يؤدي تغيير السر إلى إنهاء جميع الجلسات النشطة.

13. إعداد التكامل مع الأنظمة الخارجية

القسم "الإدارة" ← "التكاملات".

ويتم التفاعل مع نظام ركن السيارات الآلي الشريك (مجموعة المدخل) من خلال هذه الآليات.

14. الاحتفاظ بالبيانات وسياسات الاحتفاظ بها

يتم تحديد فترة التخزين من خلال السياسات الموجودة في قسم إعدادات النظام. اللقطات متاحة فقط عبر روابط محدودة الوقت؛ تم إغلاق الوصول العام المباشر إلى مرافق التخزين.

15. النسخ الاحتياطي والاستعادة

15.1. النسخ الاحتياطي

tools/backup/backup.sh /path/to/backups

يتم إنشاء تفريغ قاعدة البيانات وبيان الوسائط. يتم نسخ كائنات التخزين بشكل منفصل باستخدام أدوات المزامنة - يتم إصدار الأمر بواسطة البرنامج النصي. التردد الموصى به: قاعدة البيانات - يوميًا (وفقًا للجدول الزمني الخاص بالمضيف)، المواد الإعلامية - أسبوعيًا. لا يقل عمق تخزين النسخ عن مدة تخزين البيانات في النظام.

15.2. التحقق من النسخة

الاستعادة إلى قاعدة بيانات مؤقتة دون المخاطرة بقاعدة البيانات العاملة:

tools/backup/restore.sh backups/cshark-XXXX.dump cshark_restore_check

يعرض البرنامج النصي عدادات التحكم (مساحات السيارات، الزيارات، الحوادث، المستخدمين) للتسوية.

15.3. التعافي

توقف قبل التعافي core وgateway عبر ملف الإنشاء /opt/cshark-stand/compose.yml، قم بتنفيذ برنامج الاسترداد القياسي من التسليم ثم ابدأ تشغيل نفس الخدمات. يتم تسجيل الأوامر والمسار إلى النسخة الاحتياطية في سجل العمل؛ يتم اختبار الاستعادة أولاً على حامل منفصل.

تتم استعادة مواد الوسائط عن طريق المزامنة في حاوية كائن مع التحقق من البيان.

16. المراقبة والتشخيص

يقوم البرنامج بإنشاء مقاييس وسجلات وتتبعات وفقًا لمعيار OpenTelemetry. عند تمكين ملف تعريف إمكانية المراقبة، تتوفر لوحات Grafana.

المؤشرات الرئيسية:

يتم استبعاد البيانات الشخصية والحساسة تلقائيًا من السجلات.

17. تحديث البرنامج

يتم بدء التحديث من قبل مسؤول العميل. لا توجد آليات للتحديث القسري والتحكم عن بعد من خارج محيط المنشأة.

الإصدار الحالي لا يتضمن التحديث التلقائي عن بعد. قبل تنفيذ آلية مُدارة واعدة، يتم إجراء التحديث كتسليم تنظيمي منفصل: قبول المجموعة الموقعة غير المتصلة بالإنترنت، والتحقق من SHA-256 وتوقيع المفتاح الخارجي، وإنشاء نسخة احتياطية والتحقق منها، وتنفيذ التعليمات الخاصة بالإصدار واختبار الدخان الكامل. يتم تنفيذ العملية من قبل المسؤول خلال فترة الصيانة المتفق عليها.

تتبع عمليات الترحيل مبدأ الضغط والتوسيع: يتم إصدار تغييرات المخطط التفصيلية في إصدار يتبع إصدار التعليمات البرمجية التي تعمل بدونها. لذلك، يعد الرجوع إلى إصدار سابق من التعليمات البرمجية أمرًا آمنًا ولا يتطلب التراجع عن المخطط.

يُسمح بالإرجاع فقط على المجموعة المحفوظة والمختبرة مسبقًا من الإصدار السابق بعد تقييم مدى توافق نظام البيانات. إن التغيير التعسفي لعلامة الحاوية في مثيل مثبت ليس تحديثًا قياسيًا.

18. الأعطال والحلول النموذجية

19. موقع الملفات والمكونات

الوصول داخل الحاوية:

sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml exec core sh
docker run --rm cshark-core:<الإصدار> cat /etc/os-release    # نظام التشغيل الأساسي للصورة

20. الدعم الفني

يتم عرض إجراءات معالجة الطلبات والأولويات وأوقات الاستجابة في الوثيقة "وصف العمليات التي تضمن صيانة دورة حياة البرنامج".