CShark dasturining funksional xarakteristikalari tavsifi

Taqdim etilgan namunani aniqlash

1. Maqsad

CShark - bu to'xtash joyi, ob'ekt qurilmalari, hodisalar, va axborot vositalarini boshqarish uchun server dasturi. Tizim egasining infratuzilmasida mahalliy joylashtirish uchun mo'ljallangan va operatorlar, ma'murlar, texnik xodimlar va tahlilchilar uchun yagona veb-interfeysni taqdim etadi.

Hujjat variantda taqdim etilgan namunaning funktsiyalarini tavsiflaydi demo. O'rnatishdan so'ng, "Shimoliy" Demo Parking xayoliy ob'ekti yuridik shaxsning haqiqiy manzili va tafsilotlarisiz yaratiladi: bir daraja, ikkita zona va 50 ta joy. Yetkazib berish Device Gateway, soxta APS va kerakli emulyatorlarni o'z ichiga oladi.

2. Dasturiy ta'minot tarkibi

Komponentlar mahalliy konteyner tasvirlari sifatida yetkazib beriladi va Docker Compose orqali ishga tushiriladi. Ichki xizmatlar tashqi konteyner registriga ulanishni talab qilmaydi.

3. Foydalanuvchilar va kirishni boshqarish

Tizim autentifikatsiya, rol modellashtirish va foydalanuvchi harakatlari uchun ruxsatni tekshirishni qo'llab-quvvatlaydi. Mavjud bo'limlar va operatsiyalarning tarkibi tayinlangan rollar bilan belgilanadi.

Asosiy shaxsiy konturlar:

• operator: ob'ekt diagrammasi, joylashuv holati, hodisalar va jurnal;
• administrator: topologiya, foydalanuvchilar, rollar, sozlamalar va integratsiya;
• texnik: qurilmalar, aloqa holati va buyruqlar;
• tahlilchi yoki egasi: bandlik ko'rsatkichlari va dinamikasi;
• ma'lumot ekrani: belgilangan ko'rinishga cheklangan mashina kirish.

Muhim ma'muriy va operator harakatlari foydalanuvchini, vaqtni va harakat ob'ektini identifikatsiyalash orqali auditorlik tekshiruvida qayd etiladi.

4. Obyekt topologiyasi

Ma'mur to'xtash joyining raqamli tuzilishini shakllantiradi:

1. ob'ekt;
2. darajalar;
3. zonalar va yong'in bo'linmalari;
4. to'xtash joylari;
5. joylar guruhlari;
6. qurilmalar va ularning ulanishlari.

Joylar uchun qo'llab-quvvatlanadigan turlar: standart (standard), harakatchanligi cheklangan odamlar uchun (mgn), mototsikl (moto), xizmat (service) va tanlangan (vip). Elektr transport vositasini zaryad qilish qobiliyati alohida atribut bilan belgilanadi ev_charging. Zonalarda quyidagi rejimlar mavjud: standart (normal), olov (fire), boshpana (shelter) va xizmat ko'rsatish (service). Diagrammani ko'rsatishda joy geometriyasi va daraja fonidan foydalaniladi.

Variantda demo seed 2026.07.2 bir darajali, Moviy sektor va Yashil sektor zonalarini, shuningdek, kodlar bilan 50 ta joyni yaratadi DEMO-01–DEMO-50. Ular orasida MGN, EV, moto va servis joylari bor. Asosiy demo urug'ida haqiqiy manzillar, tashkilotlar tafsilotlari va kamera tasvirlari yo'q.

5. Operator sxemasi

Diagramma bo'limi ob'ektning hozirgi holatini kuzatish uchun mo'ljallangan. U quyidagilarni ta'minlaydi:

• ob'ekt va darajani tanlash;
• daraja va tarmoqlarga o'tishning umumiy ko'rinishi;
• egallagan, bo'sh, mavjud bo'lmagan va noma'lum joylarni ko'rsatish;
• joylashuvni qidirish;
• qo'shimcha qatlamlarning ko'rinishini filtrlash va nazorat qilish;
• joy kartasini va uning shartlari tarixini ko'rish;
• tegishli faol hodisalarni ko'rsatish;
• tegishli ruxsatnoma bilan bir yoki bir nechta joylarni ishlamaydigan holatga o'tkazish.

Ob'ekt va darajadagi kontekst URL manzilida saqlanadi va bog'langan analitik ko'rinishlar tomonidan ishlatiladi.

6. Voqealarni qabul qilish va joylarning holati

Device Gateway kameralar va boshqa qurilmalardan hodisalarni qabul qiladi, ularni normallashtiradi va hodisalar avtobusi orqali Core-ga uzatadi. Kameralar ro'yxatga olish, aloqa holati, yurak urishi, zona va joylashuv monitoringi va buyruq kanalini qo'llab-quvvatlaydi.

Agar NATS vaqtincha ishlamasa, Gateway tomonidan qabul qilingan voqealar mahalliy doimiy navbatda saqlanadi va aloqa tiklanganda yuboriladi. Qayta yetkazib berish ikki nusxadagi biznes voqealarini yaratmasligi kerak.

Tizim joylar holatidagi oʻzgarishlar tarixini saqlaydi va tahlil uchun bandlik oniy suratlaridan foydalanadi.

7. Hodisalar

Voqealarning quyi tizimi quyidagilarni ta'minlaydi:

• hodisani qo'lda yoki hodisa bo'yicha yaratish;
• faol va tugallangan hodisalar ro'yxati;
• voqeani qabul qilish;
• qaror bilan e'tiborsizlik;
• hodisaning tugashi;
• joy, zona, vaqt va materiallarni ko'rsatish;
• holat o'zgarganda interfeysni yangilash;
• ishlov berish vaqtini va kuchayishini nazorat qilish.

Operatorning harakatlari voqea tarixi va audit jurnalida qayd etiladi.

8. Jurnalga tashrif buyuring

Jurnal qayd qilingan tashriflar va bog'liq transport hodisalari ro'yxatini taqdim etadi. Foydalanuvchi yozuvlarni ko'rishi va mavjud filtrlarni qo'llashi mumkin. Avtotransport vositalarining identifikatorlari va materiallariga kirish huquqlar bilan cheklangan va auditdan o'tishi kerak.

9. Analitika

Analitik bo'limda quyidagilar ko'rsatiladi:

• tanlangan ob'ekt uchun umumiy ko'rsatkichlar;
• egallagan joylar soni va ulushi;
• bandlik dinamikasi;
• holatning tarixiy suratlari;
• mavjud vaqt oralig'i uchun ko'rsatkichlar.

Ma'lumotlar maydoni aniq ko'rsatilishi kerak: muayyan daraja, ob'ekt yoki ob'ektlar to'plami.

10. Uskunalar

Uskunalar reestri kameralar, darvozalar, yong'inga kirish joylari va taqlid qilingan qurilmalar uchun ishlatiladi. Mavjud:

• qurilmani ro'yxatdan o'tkazish va tahrirlash;
• sinf, haydovchi va ulanish parametrlarini ko'rish;
• onlayn yoki oflayn holati va oxirgi voqea vaqti;
• diagnostika tarixi;
• tasdiqlash bilan qo'llab-quvvatlanadigan buyruqni yuborish;
• ro'yxatdan o'tmagan kameralarni aniqlash;
• qurilmani topologiya elementlariga ulash.

Yetkazib berish sizga jismoniy jihozlarsiz hodisalar sxemasini tekshirish imkonini beruvchi emulyatorlarni o'z ichiga oladi.

11. Skorlar jadvali va axborot ekranlari

Axborot quyi tizimi quyidagilarni ta'minlaydi:

• reyting jadvallari reestrini yuritish;
• shablonlarni yaratish va tahrirlash;
• shablonni oldindan ko'rish;
• ma'lum bir tabloga shablonni belgilash;
• mavjud o'rindiqlar hisoblagichlari va matnli xabarlarni ko'rsatish;
• ustuvor favqulodda xabar;
• ekran mijozi uchun cheklangan kirish tokeni;
• tayinlangan ekran holatini yangilash.

Shablonlar va topshiriqlar serverda saqlanadi va operatorning interaktiv sessiyasiga bog'liq emas. Shift shablonlarini to'liq boshqarish va operatorlar o'rtasida shaxsiy tartiblarni nusxalash keyingi rivojlanish bilan bog'liq bo'lib, joriy misol funktsiyasi sifatida ko'rsatilmagan.

12. Boshqaruv

Ma'muriy tizim quyidagilarni o'z ichiga oladi:

• foydalanuvchilar, rollar va ruxsatlar;
• tizim parametrlari;
• topologiya va geometriya;
• qurilma ro'yxatga olish kitobi va integratsiya kalitlari;
• qoidalar va Webhook obunalari;
• navigatsiya grafigi va uning versiyalari;
• audit jurnali.

O'zgartirish operatsiyalari ruxsat tekshiruvlari bilan himoyalangan. Xizmat sirlari foydalanuvchi interfeysida aniq matnda ko'rsatilmaydi.

13. Integratsiya imkoniyatlari

Core nashr etilgan OpenAPI sxemasi asosida HTTP API taqdim etadi. Device Gateway voqea shartnomalari va apparat buyruqlarini qo'llab-quvvatlaydi. Tashqi tizimlar uchun API kalitlari, Webhook yetkazib berish va muvaffaqiyatsiz xabarlarni qayta yetkazib berish taqdim etiladi.

Integratsiya ma'lumotlarining asosiy turlari:

• to'xtash joyining holati;
• transport vositalarini kuzatish;
• kamera, darvoza va yong'inga kirishning holati;
• hodisaning o'zgarishi;
• zona rejimini o'zgartirish;
• qurilma yoki ekranga buyruq bering.

14. Kuzatish va diagnostika

Tizim quyidagilarni ta'minlaydi:

• tayyorlikning yakuniy nuqtasi /api/health;
• konteyner holati;
• Prometey texnik ko'rsatkichlari;
• Grafana asboblar paneli;
• markazlashtirilgan Loki jurnallari;
• taqsimlangan temp izlari;
• etkazib berish va hodisalarni qayta ishlash hisoblagichlari.

Kuzatish imkoniyati diagnostika maqsadlari uchun mo'ljallangan va biznes ma'lumotlarining zaxira nusxasini o'rnini bosmaydi.

15. Himoya va barqarorlik

Institut quyidagi chora-tadbirlarni amalga oshiradi:

• rolga asoslangan kirishni boshqarish;
• individual ma'lumotlar bazasi rollari;
• misolning noyob sirlari;
• konfiguratsiya fayllariga cheklangan huquqlar;
• ro'yxatga olish harakatlari;
• Core-ni ishga tushirishdan oldin ma'lumotlar bazasi sxemasini tekshirish;
• Gateway doimiy navbat;
• voqealarning doimiy oqimi;
• to'plamning nazorat summalari va mahalliy tasvirlar;
• Ma'lumotlar bazasi va media zaxiralash.

16. Joriy instansiyaning chegaralari

Hozirgi to'plam:

• Ubuntu Server 24.04 LTS AMD64 uchun mo'ljallangan;
• ARM64 ni qo'llab-quvvatlamaydi;
• mahalliy konteyner pallasida o'rnatilgan;
• variantda demo yuridik shaxsning haqiqiy manzili va rekvizitlari ko‘rsatilmagan holda faqat uydirma ko‘rgazmali avtoturargohni tashkil qilsa; variant clean ko'rgazmali avtoturargohlarni yaratmaydi;
• konfiguratsiyasiz muayyan asbob-uskunalar bilan sanoat integratsiyasini o'z ichiga olmaydi;
• foydalanuvchi interfeysidan avtomatik yangilanishni bildirmaydi;
• taqdim etilgan misolning xususiyati sifatida hisob-kitob yoki zaryad stantsiyasini boshqarishga da'vo qilmaydi.

17. Funktsional foydalanish imkoniyatini boshqarish

O'rnatishdan so'ng quyidagilarni tekshiring:

• foydalanuvchi login;
• rolga ko'ra bo'limlarning mavjudligi;
• asosiy topologiyani yaratish;
• emulyatordan hodisani qabul qilish;
• joyning holatini o'zgartirish;
• hodisani yaratish va qayta ishlash;
• tashrif jurnali;
• analitik xulosa;
• qurilma holati;
• Tablo shablonini yaratish va belgilash;
• audit izi;
• ko'rsatkichlar va tizim jurnallari.