CShark dasturiy ta'minot foydalanuvchi uchun qo'llanma

Taqdim etilgan namunani aniqlash

Joriy yoqilgan 2026-08-06.

1. Maqsad

Qo'llanma o'rnatishdan keyin CShark-dan kundalik foydalanish uchun zarur bo'lgan ma'lumotlarni o'z ichiga oladi. Hujjat Ubuntu Server 24.04 LTS AMD64 uchun taqdim etilgan demo nusxasiga ishora qiladi.

O'rnatish alohida ko'rsatmalarga muvofiq amalga oshiriladi. Ushbu qo'llanmadagi buyruqlar katalogni nazarda tutadi /opt/cshark-stand va Loyiha yaratish cshark-stand.

2. Ishlash shartlari

Ishlash uchun sizga kerak:

• ishlaydigan Ubuntu Server 24.04 LTS AMD64 serveri;
• kamida 8 GB operativ xotira va 30 GB bo'sh joy;
• to'g'ri sana, vaqt va vaqt zonasi;
• foydalanuvchining portga kirishi 8088/tcp;
• xavfsiz kanal orqali serverga administrator kirishi;
• ishlab chiqarish nusxasidan ajratilgan zaxira saqlash.

PostgreSQL va NATS ga tashqi kirish shart emas va chop etilmasligi kerak.

3. Boshlash va to'xtatish

Holatni tekshirish:

sudo docker compose \
  --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml \
  --profile obs ps

Yugurish:

sudo docker compose \
  --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml \
  --profile obs up -d

Ma'lumotlarni o'chirmasdan to'xtating:

sudo docker compose \
  --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml \
  --profile obs down

4. Tayyorlikni tekshirish

Ishga tushgandan so'ng, ishga tushiring:

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

Qo'shimcha tekshirish:

• konteynerlarning holati bor running yoki healthy;
• Veb-interfeys orqali mavjud http://<IP-YOKI-DNS>:8088;
• Grafana saytida mavjud http://<IP-YOKI-DNS>:13000;
• bo'sh disk maydoni operatsion chegaradan past emas;
• server vaqti sinxronlashtiriladi.

5. Birinchi kirish

Asosiy ma'lumotlar faylda:

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

Administrator sifatida tizimga kiring va shaxsiy foydalanuvchi hisoblarini yarating. Bir nechta operatorlar uchun bitta umumiy hisobdan foydalanmang: to'g'ri tekshirish uchun shaxsiy yozuvlar kerak.

6. Ish joylari va rollar

Tizimga kirgandan so'ng, foydalanuvchi faqat unga ruxsat berilgan bo'limlarni ko'radi. Asosiy ish joylari:

Agar bo'lim mavjud bo'lmasa, administrator boshqa birovning hisobini foydalanuvchiga o'tkazish o'rniga tayinlangan rol va ruxsatlarni tekshiradi.

7. Dastlabki holat namoyishi

O'rnatishdan so'ng administrator quyidagilarni tekshiradi:

1. "Severny" Demo to'xtash joyida haqiqiy manzil mavjud emas;
2. 1-darajali daraja mavjud;
3. Moviy sektor va yashil sektor zonalari mavjud;
4. aniq 50 ta joy yaratildi DEMO-01–DEMO-50;
5. MGN, EV, moto va servis uchun joylar mavjud;
6. ko'rgazmali kamera, uchta darvoza moslamasi va skorbord ro'yxatga olingan;
7. Demo hodisasi mavjud;
8. soxta APS holati bor running yoki healthy;
9. emulyator hodisasi bog'langan joyning holatini o'zgartiradi;
10. Alohida media to'plami ulanmaguncha, haqiqiy kamera tasvirlari mavjud emas.

Namoyish ob'ekti haqiqiy mijozning ma'lumotlari emas va faqat tizim funktsiyalarini sinab ko'rish va namoyish qilish uchun mo'ljallangan.

8. Sxema bilan ishlash

Operator "Sxema" bo'limini ochadi, ob'ekt va darajani tanlaydi, so'ngra:

• xulosa holatini baholaydi;
• umumiy ko'rinishdan sektor va joylashuvga o'tadi;
• qidiruvdan foydalanadi;
• joy kartasini ochadi;
• ko'rishlar holati tarixi;
• tegishli hodisalarni ko'rib chiqish;
• faqat kerakli qo'shimcha qatlamlarni o'z ichiga oladi.

Joyning operatsion holatini o'zgartirish faqat ruxsatnoma bilan amalga oshiriladi. Guruh operatsiyasi uchun tasdiqlashdan oldin ta'sirlangan joylar sonini tekshirishingiz kerak.

9. Hodisalarni hal qilish

Tavsiya etilgan buyurtma:

1. faol hodisalarning navbatini ochish;
2. ob'ekt, daraja, joy, vaqt va materiallarni tekshirish;
3. voqeani chora ko'rish;
4. ob'ekt qoidalariga muvofiq harakatlarni amalga oshirish;
5. kerakli ma'lumotlarni kiritish;
6. hodisani tugatish yoki oqilona e'tiborsizlik;
7. holat yangilanganligiga ishonch hosil qiling.

Xatoni yashirish uchun hodisa o'chirilmaydi: operatorning qarori tarixda va auditda qolishi kerak.

10. Jurnal va tahlil

Tashrif jurnali mavjud parametrlarga asoslangan filtrlardan foydalanadi. Avtomobil identifikatorlariga kirish unga kerak bo'lgan rollar bilan cheklangan.

Analitikada ko'rsatkichlarni sharhlashdan oldin tanlangan ob'ekt va darajani tekshiring. Kontekstni hisobga olmagan holda siz turli xil ma'lumotlar maydonlarining qiymatlarini taqqoslay olmaysiz.

11. Uskunalar

Texnik mutaxassis nazorat qiladi:

• holati - holatini ko‘rsatadi. online yoki offline;
• oxirgi voqea vaqti;
• mavjudlik o'zgarishlari tarixi;
• ob'ekt va zonaga bog'lash;
• haydovchi parametrlari;
• xavfsiz buyruqning natijasi.

Darvoza yoki boshqa aktuatorga buyruq yuborishdan oldin, buyruq ob'ekt qoidalariga muvofiq qabul qilinishiga va xavf tug'dirmasligiga ishonch hosil qilishingiz kerak.

Emulatorlar haqiqiy uskunani ulamasdan funktsional sinov uchun ishlatiladi.

12. Ko'rsatkichlar jadvali va shablonlari

Tablo bo'limida ma'mur yoki vakolatli texnik mutaxassis:

1. ekran yozuvini yaratadi;
2. uning sinfi va parametrlarini belgilaydi;
3. shablonni yaratadi yoki tahrirlaydi;
4. oldindan ko'rishni tekshiradi;
5. ekranga shablonni tayinlaydi;
6. haqiqiy displeyni tekshiradi;
7. agar kerak bo'lsa, ekran belgisini bekor qiladi.

Shablon va maqsad serverda saqlanadi. Ekran operatorning ochiq sessiyasiga bog'liq bo'lmasligi kerak. Favqulodda vaziyat xabari odatiy ma'lumotlardan ustun turadi.

Shift shablonlarini boshqarish va operatorning shaxsiy maketlarini nusxalash kelajakdagi rivojlanishdir; Tasdiqlangan server tomonidagi skorbord shablonlari chiqarilishidan oldin foydalaniladi.

13. Foydalanuvchilar va huquqlar

Administrator:

• shaxsiy hisoblarni yaratadi;
• minimal talab qilinadigan rollarni tayinlaydi;
• tugatilgan yoki o'tkazilgan xodimlarning hisoblarini o'chirib qo'yadi;
• vaqti-vaqti bilan rollar tarkibini tekshiradi;
• audit jurnalini tahlil qiladi;
• oddiy foydalanuvchilar bilan xizmat sirlarini baham ko'rmaydi.

Serverga jismoniy kirish bilan alohida buyruq yordamida administrator parolini tiklash rejalashtirilgan xususiyatdir. Chiqarilishidan oldin kirishni tiklash faqat tasdiqlangan texnik protsedura bo'yicha zaxira nusxasi va harakatlar jurnali bilan amalga oshiriladi.

14. Shift boshqaruvi

Smenaning boshida operator quyidagilarni tekshiradi:

• veb-interfeysdan foydalanish imkoniyati;
• ob'ekt va darajaning to'g'riligi;
• faol hodisalar soni;
• oflayn qurilmalarning mavjudligi;
• axborot ekranlarining dolzarbligi;
• tizim ogohlantirishlari yo'q.

Smenani topshirish vaqtida tugallanmagan hodisalar, vaqtinchalik o'chirilgan joylar, noto'g'ri qurilmalar va qo'llaniladigan favqulodda xabarlar qayd etiladi.

15. Zaxira

Ma'lumotlar bazasi nusxasini yarating:

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

Media SHA-256 tekshiruvi bilan alohida S3-mos xotiraga ko'chiriladi. Zaxira saqlash tafsilotlari huquqlarga ega himoyalangan env fayli orqali uzatiladi 0600buyruq qatori argumentlari orqali emas.

Ma'lumotlar bazasini har kuni va har hafta ommaviy axborot vositalaridan nusxalash tavsiya etiladi. Vaqtinchalik muhitga tiklash vaqti-vaqti bilan amalga oshiriladi va nazorat hisoblagichlari tekshiriladi.

16. Yangilash

Yangilashdan oldin:

1. ish oynasida kelishib olish;
2. joriy versiyani qabul qilish;
3. salomatlik va bo'sh joyni tekshiring;
4. tasdiqlangan zaxira nusxasini yaratish;
5. yangi versiya to'plamini oling;
6. SHA-256 ni tekshiring va eslatmalarni chiqaring.

Yangilash tizim ma'muri tomonidan ma'lum bir versiya uchun alohida ko'rsatmalarga muvofiq amalga oshiriladi. Teg bilan buyruq yordamida tizimni yangilay olmaysiz latest tasvirlar va ma'lumotlar bazasi sxemasini aniqlamasdan.

Joriy versiyada interfeysdan avtomatik yangilanish mavjud emas.

17. Jurnallar va diagnostika

Eng so'nggi jurnallar:

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

O'rnatish jurnali:

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

Qo'llab-quvvatlash xizmatiga murojaat qilganda, ular versiyani, vaqtni, harakatlar ketma-ketligini, xatolikni, konteynerlar holatini va tegishli jurnallarni saqlaydi. Sirlar va shaxsiy ma'lumotlar uzatishdan oldin o'chiriladi yoki maskalanadi.

18. Odatdagi nosozliklar

19. Muvaffaqiyatsizlik holatlarida harakatlar

19.1. NATS mavjud emas

NATS-ni qayta ishga tushiring va tekshiring /healthz. Gateway chiqish qutisi hajmini o'chirmang: qayta tiklangandan so'ng, Gateway saqlangan voqealarni yuborishi kerak.

19.2. Kamera mavjud emas

Kamera quvvati va tarmog‘ini, oxirgi yurak urish vaqti va qurilma jurnalini tekshiring. Qayta tiklanmaguncha, uning joylari ma'lum bo'lgan oxirgi holatida qolishi mumkin.

19.3. Disk to'lgan

O'sish manbasini aniqlang. Kuzatish tarixi alohida protsedura yordamida tozalanishi mumkin, ammo PostgreSQL, S3 yoki Gateway chiqish qutisini zaxira nusxasisiz va oqibatlarini baholamasdan o'chirib bo'lmaydi.

19.4. Ma'lumotlarning buzilishi

Ma'lumotni o'zgartirish komponentlarini to'xtating, jurnallarni va joriy holatni saqlang, keyin faqat tasdiqlangan nusxadan tiklang. Takroriy migratsiyalarni ko'r-ko'rona ishlatmang.

20. Yaroqlilik muddati

Standart qiymatlar:

Haqiqiy vaqt ob'ekt egasining siyosati va amaldagi talablari bilan belgilanadi. Tekshiruvlar va hisobotlarga ta'sir muddati qisqartirilgunga qadar ko'rib chiqiladi.

21. Xavfsizlik talablari

• shaxsiy hisoblardan foydalanish;
• eng kam imtiyoz tamoyilini qo'llash;
• tarmoqqa kirishni xavfsizlik devori bilan cheklash;
• env fayllari va zaxira nusxalarini yopiq kataloglarda saqlash;
• PostgreSQL va NATS-ni nashr qilmang;
• tizim vaqtini sinxronlashtirish;
• audit jurnalini muntazam tekshirib turing;
• alohida maxfiylikni qabul qilmasdan avtomobilni ommaviy qidirishni yoqmang;
• Alomatni tashxis qilmasdan hal qilish uchun ma'lumotlarni o'chirmang.

22. Operatsiyaning tugallanishi

Qurilmani o'chirishdan oldin:

1. yangi voqealarni qabul qilishni to'xtatish;
2. yakuniy zaxira nusxasini yaratish;
3. nusxaning o'qilishi mumkinligini tekshirish;
4. zarur hisobotlarni eksport qilish;
5. API kalitlari va ekran tokenlarini bekor qilish;
6. konteynerlarni to'xtatish;
7. ma'lumotlarni faqat tasdiqlangan aktga muvofiq o'chirish;
8. natijani va arxivlarni saqlash joyini yozib oling.