دليل مستخدم برنامج CShark

تحديد المثيل المقدم

الحالي على 2026-08-06.

1. الغرض

يحتوي الدليل على المعلومات اللازمة للاستخدام اليومي لـ CShark بعد التثبيت. يشير المستند إلى النسخة التجريبية المتوفرة لـ Ubuntu Server 24.04 LTS AMD64.

يتم التثبيت وفقًا لتعليمات منفصلة. الأوامر في هذا البرنامج التعليمي تفترض الدليل /opt/cshark-stand وتأليف المشروع cshark-stand.

2. ظروف التشغيل

للعمل تحتاج:

• خادم Ubuntu Server 24.04 LTS AMD64 العامل ؛
• ما لا يقل عن 8 غيغابايت من ذاكرة الوصول العشوائي و 30 غيغابايت من المساحة الحرة؛
• التاريخ والوقت والمنطقة الزمنية الصحيحة؛
• وصول المستخدم إلى المنفذ 8088/tcp;
• وصول المسؤول إلى الخادم عبر قناة آمنة؛
• تخزين النسخ الاحتياطي منفصل عن مثيل الإنتاج.

الوصول الخارجي إلى PostgreSQL وNATS غير مطلوب ويجب عدم نشره.

3. ابدأ وتوقف

التحقق من الحالة:

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 down

4. فحص الجاهزية

بعد الإطلاق، قم بتشغيل:

curl -fsS http://127.0.0.1:8088/api/health

تحقق بالإضافة إلى ذلك:

• الحاويات لها حالة running أو healthy;
• واجهة الويب متاحة عبر http://<IP-أو-DNS>:8088;
• جرافانا متوفر في http://<IP-أو-DNS>:13000;
• مساحة القرص الحرة ليست أقل من عتبة التشغيل؛
• تتم مزامنة وقت الخادم.

5. الدخول الأول

التفاصيل الأولية موجودة في الملف:

sudo cat /opt/cshark-stand/INITIAL-CREDENTIALS.txt

قم بتسجيل الدخول كمسؤول وإنشاء حسابات مستخدمين شخصية. لا تستخدم حسابًا واحدًا مشتركًا لعدة مشغلين: السجلات الشخصية ضرورية للتدقيق الصحيح.

6. مساحات العمل والأدوار

بعد تسجيل الدخول، يرى المستخدم فقط الأقسام المسموح بها له. مساحات العمل الرئيسية:

إذا كان القسم غير متاح، يتحقق المسؤول من الدور والأذونات المعينة بدلاً من نقل حساب شخص آخر إلى المستخدم.

7. عرض الحالة الأولية

بعد التثبيت، يقوم المسؤول بالتحقق مما يلي:

1. لا تحتوي منشأة انتظار السيارات التجريبية "Severny" على عنوان حقيقي؛
2. هناك مستوى المستوى 1؛
3. هناك مناطق القطاع الأزرق والقطاع الأخضر.
4. تم إنشاء 50 مكانًا بالضبط DEMO-01–DEMO-50;
5. هناك أماكن لـ MGN، EV، الدراجات النارية والخدمة؛
6. يتم تسجيل كاميرا توضيحية وثلاثة أجهزة بوابة ولوحة النتائج؛
7. الحادث التجريبي متاح.
8. APS الوهمية لها حالة running أو healthy;
9. يقوم حدث المحاكي بتغيير حالة الموقع المرتبط؛
10. لا توجد لقطات كاميرا حقيقية حتى يتم توصيل حزمة وسائط منفصلة.

الكائن التجريبي ليس بيانات من عميل حقيقي وهو مخصص فقط لاختبار وإظهار وظائف النظام.

8. العمل مع الدائرة

يفتح المشغل قسم "المخطط"، ويحدد الكائن والمستوى، ثم:

• يقيم حالة الملخص؛
• ينتقل من النظرة العامة إلى القطاع والموقع؛
• يستخدم البحث.
• يفتح بطاقة مكان؛
• تاريخ عرض الحالة؛
• يراجع الحوادث ذات الصلة؛
• يتضمن فقط الطبقات الإضافية الضرورية.

لا يتم تغيير الحالة التشغيلية للمكان إلا بإذن. بالنسبة للعملية الجماعية، يجب عليك التحقق من عدد المواقع المتأثرة قبل التأكيد.

9. التعامل مع الحوادث

الترتيب الموصى به:

1. فتح قائمة انتظار من الأحداث النشطة؛
2. التحقق من الكائن والمستوى والمكان والوقت والمواد؛
3. اتخاذ الحادث موضع التنفيذ؛
4. تنفيذ إجراء وفقًا للوائح المنشأة؛
5. إضافة المعلومات اللازمة؛
6. إنهاء الحادث أو تجاهله بشكل معقول؛
7. تأكد من تحديث الحالة.

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

10. المجلة والتحليلات

يستخدم سجل الزيارة عوامل التصفية بناءً على المعلمات المتاحة. يقتصر الوصول إلى معرفات المركبات على الأدوار التي تحتاج إليها.

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

11. المعدات

يتحكم الاختصاصي الفني في:

• حالة الحالة online أو offline;
• وقت الحدث الأخير؛
• تاريخ التغييرات التوفر؛
• ملزمة لكائن ومنطقة؛
• معلمات السائق
• نتيجة أمر آمن.

قبل إرسال أمر إلى بوابة أو مشغل آخر، يجب عليك التأكد من أن الأمر مقبول بموجب لوائح المنشأة ولا يشكل أي خطر.

تُستخدم المحاكيات للاختبار الوظيفي دون توصيل أجهزة حقيقية.

12. لوحات النتائج والقوالب

في قسم لوحة النتائج، يقوم المسؤول أو الأخصائي الفني المعتمد بما يلي:

1. يخلق تسجيل الشاشة.
2. يحدد فئته والمعلمات؛
3. إنشاء قالب أو تحريره؛
4. معاينة الشيكات؛
5. يعين قالبًا للشاشة؛
6. يتحقق من العرض الفعلي.
7. يلغي رمز الشاشة إذا لزم الأمر.

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

تعد إدارة قوالب الورديات ونسخ التخطيطات الشخصية للمشغل بمثابة تطور مستقبلي؛ يتم استخدام مجموعة معتمدة من قوالب لوحة النتائج من جانب الخادم قبل إصدارها.

13. المستخدمين والحقوق

المسؤول:

• إنشاء حسابات شخصية؛
• يعين الحد الأدنى من الأدوار المطلوبة؛
• تعطيل حسابات الموظفين الذين تم إنهاء خدمتهم أو نقلهم؛
• يتحقق بشكل دوري من تكوين الأدوار؛
• ويحلل سجل التدقيق؛
• لا يشارك أسرار الخدمة مع المستخدمين العاديين.

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

14. التحكم في التحول

في بداية الوردية، يقوم المشغل بالتحقق مما يلي:

• إمكانية الوصول إلى واجهة الويب؛
• صحة الكائن والمستوى.
• عدد الحوادث النشطة؛
• توافر الأجهزة غير المتصلة بالإنترنت؛
• أهمية شاشات المعلومات؛
• لا توجد تحذيرات النظام.

أثناء تسليم الوردية، يتم تسجيل الحوادث غير المكتملة والمواقع المعطلة مؤقتًا والأجهزة المعيبة ورسائل الطوارئ المطبقة.

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

إنشاء نسخة من قاعدة البيانات:

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

يتم نسخ الوسائط إلى وحدة تخزين منفصلة متوافقة مع S3 مع التحقق من SHA-256. يتم نقل تفاصيل تخزين النسخ الاحتياطي من خلال ملف env محمي مع الحقوق 0600بدلاً من استخدام وسيطات سطر الأوامر.

يوصى بنسخ قاعدة البيانات يوميًا والوسائط أسبوعيًا. يتم إجراء الاستعادة إلى بيئة مؤقتة بشكل دوري ويتم فحص عدادات التحكم.

16. التحديث

قبل التحديث:

1. الاتفاق على نافذة العمل؛
2. الالتزام بالإصدار الحالي؛
3. التحقق من الصحة والمساحة الحرة؛
4. إنشاء نسخة احتياطية تم التحقق منها؛
5. احصل على مجموعة الإصدار الجديد؛
6. تحقق من SHA-256 وملاحظات الإصدار.

يتم إجراء التحديث بواسطة مسؤول النظام وفقًا لتعليمات منفصلة لإصدار معين. لا يمكنك تحديث النظام باستخدام أمر بالعلامة latest دون تحديد الصور ومخطط قاعدة البيانات.

لا يوجد تحديث تلقائي من الواجهة في الإصدار الحالي.

17. السجلات والتشخيصات

أحدث المجلات:

sudo docker compose \
  --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml \
  --profile obs logs --no-color --tail 200

سجل التثبيت:

sudo cat /opt/cshark-stand/install.log

عند الاتصال بالدعم، يقومون بحفظ الإصدار والوقت وتسلسل الإجراءات والخطأ وحالة الحاويات والسجلات ذات الصلة. تتم إزالة الأسرار والبيانات الشخصية أو إخفاؤها قبل الإرسال.

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

19. الإجراءات في حالة الفشل

19.1. ناتس غير متوفر

أعد تشغيل NATS وتحقق /healthz. لا تقم بحذف صندوق الصادر لبوابة وحدة التخزين: بعد الاسترداد، يجب أن تقوم البوابة بإرسال الأحداث المحفوظة.

19.2. الكاميرا غير متوفرة

تحقق من طاقة الكاميرا وشبكتها وآخر مرة نبضات وسجل الجهاز. وحتى يتم ترميمها، قد تظل أماكنها في آخر حالة معروفة لها.

19.3. القرص ممتلئ

تحديد مصدر النمو. يمكن مسح سجل إمكانية المراقبة باستخدام إجراء منفصل، ولكن لا يمكن حذف البريد الصادر لـ PostgreSQL أو S3 أو Gateway بدون نسخة احتياطية وتقييم العواقب.

19.4. تلف البيانات

أوقف مكونات تعديل البيانات، واحفظ السجلات والحالة الحالية، ثم قم بالاستعادة من نسخة تم التحقق منها فقط. لا تقم بتشغيل عمليات الترحيل المتكررة بشكل أعمى.

20. مدة الصلاحية

القيم الافتراضية:

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

21. متطلبات السلامة

• استخدام الحسابات الشخصية؛
• تطبيق مبدأ الامتيازات الأقل؛
• تقييد الوصول إلى الشبكة باستخدام جدار الحماية؛
• تخزين ملفات env والنسخ الاحتياطية في أدلة مغلقة؛
• لا تنشر PostgreSQL وNATS؛
• مزامنة وقت النظام؛
• التحقق من سجل التدقيق بانتظام؛
• لا تقم بتمكين البحث العام عن سيارة دون قبول خصوصية منفصل؛
• لا تقم بحذف البيانات لحل أحد الأعراض دون تشخيصه.

22. الانتهاء من العملية

قبل إيقاف تشغيل الوحدة:

1. التوقف عن قبول الأحداث الجديدة؛
2. إنشاء نسخة احتياطية نهائية؛
3. التحقق من سهولة قراءة النسخة؛
4. تصدير التقارير اللازمة؛
5. وإلغاء مفاتيح API ورموز الشاشة؛
6. إيقاف الحاويات؛
7. حذف البيانات فقط وفقا للقانون المعتمد؛
8. تسجيل النتيجة وموقع تخزين المحفوظات.