CShark бағдарламалық құралының функционалдық сипаттамаларының сипаттамасы

Қамтамасыз етілген дананы анықтау

1. Мақсат

CShark - бұл тұрақ орнын, қондырғы құрылғыларын, оқиғаларды, және ақпараттық құралдарды басқаруға арналған серверлік бағдарламалық құрал. Жүйе меншік иесінің инфрақұрылымында жергілікті орналастыруға арналған және операторлар, әкімшілер, техникалық қызметкерлер және талдаушылар үшін бірыңғай веб-интерфейсті қамтамасыз етеді.

Құжат нұсқада берілген дананың функцияларын сипаттайды demo. Орнатқаннан кейін «Солтүстік» демо-паркингінің жалған нысаны заңды тұлғаның нақты мекенжайынсыз және деректемелерінсіз құрылады: бір деңгей, екі аймақ және 50 кеңістік. Жеткізу Device Gateway, жалған APS және қажетті эмуляторларды қамтиды.

2. Бағдарламалық құрал құрамы

Құрамдас бөліктер жергілікті контейнер кескіндері ретінде жеткізіледі және Docker Compose арқылы іске қосылады. Ішкі қызметтер сыртқы контейнер тізіліміне қосылуды қажет етпейді.

3. Пайдаланушылар және қол жеткізуді басқару

Жүйе аутентификацияны, рөлдік модельдеуді және пайдаланушы әрекеттері үшін рұқсатты тексеруді қолдайды. Қол жетімді бөлімдер мен операциялардың құрамы тағайындалған рөлдермен анықталады.

Негізгі теңшелетін контурлар:

• оператор: нысан диаграммасы, орналасу күйлері, оқиғалар және журнал;
• әкімші: топология, пайдаланушылар, рөлдер, параметрлер және интеграциялар;
• техник: құрылғылар, байланыс күйі және командалар;
• талдаушы немесе иесі: жұмыспен қамту көрсеткіштері және динамикасы;
• ақпарат экраны: тағайындалған көрініске шектеулі құрылғы қатынасы.

Маңызды әкімшілік және оператор әрекеттері пайдаланушыны, уақытты және әрекет объектісін анықтай отырып, аудит ізіне жазылады.

4. Объект топологиясы

Әкімші автотұрақ нысанының цифрлық құрылымын қалыптастырады:

1. объект;
2. деңгейлері;
3. аймақтар мен өрт бөлімдері;
4. автотұрақтар;
5. орындар топтары;
6. құрылғылар және олардың қосылымдары.

Орындарға қолдау көрсетілетін түрлер: стандартты (standard), қозғалыс мүмкіндігі шектеулі адамдар үшін (mgn), мотоцикл (moto), қызмет көрсету (service) және таңдалған (vip). Электрлік көлікті зарядтау мүмкіндігі бөлек атрибутпен көрсетіледі ev_charging. Аймақтардың келесі режимдері бар: стандартты (normal), өрт (fire), баспана (shelter) және қызмет көрсету (service). Диаграмманы көрсету кезінде орын геометриясы мен деңгей фон пайдаланылады.

Опцияда demo seed 2026.07.2 бір деңгей, Көк сектор және Жасыл сектор аймақтарын, сондай-ақ кодтары бар 50 орынды жасайды DEMO-01–DEMO-50. Олардың арасында MGN, EV, moto және service орындары бар. Негізгі демонстрацияда нақты мекенжайлар, ұйымдардың мәліметтері және камералық түсірілімдер жоқ.

5. Оператор схемасы

Диаграмма бөлімі объектінің ағымдағы күйін бақылауға арналған. Ол қамтамасыз етеді:

• объект пен деңгейді таңдау;
• деңгейге шолу және секторларға өту;
• басып алынған, бос, қолжетімсіз және белгісіз орындарды көрсету;
• орынды іздеу;
• қосымша қабаттардың көрінуін сүзу және бақылау;
• орын картасын және оның шарттарының тарихын қарау;
• байланысты белсенді оқиғаларды көрсету;
• бір немесе бірнеше орындарды тиісті рұқсатпен жұмыс істемейтін жағдайға ауыстыру.

Нысан және деңгей мәтінмәні URL мекенжайында сақталады және байланысты аналитикалық көріністер арқылы пайдаланылады.

6. Оқиғаларды қабылдау және орындардың жағдайы

Device Gateway камералардан және басқа құрылғылардан оқиғаларды қабылдайды, оларды қалыпқа келтіреді және оқиғалар шинасы арқылы Core-ға жібереді. Камералар тіркеуді, байланыс күйін, жүрек соғысын, аймақты және орынды бақылауды және командалық арнаны қолдайды.

Егер NATS уақытша қолжетімсіз болса, шлюз арқылы алынған оқиғалар жергілікті тұрақты кезекте сақталады және байланыс қалпына келтірілгенде жіберіледі. Қайта жеткізу іскерлік оқиғалардың қайталануын жасамауы керек.

Жүйе орындардың күйіндегі өзгерістер тарихын сақтайды және аналитика үшін бос орындардың суретін пайдаланады.

7. Оқиғалар

Оқиғаның ішкі жүйесі мыналарды қамтамасыз етеді:

• оқиғаны қолмен немесе оқиға бойынша жасау;
• белсенді және аяқталған оқиғалардың тізімі;
• оқиғаны қабылдау;
• шешіммен елемеу;
• оқиғаның аяқталуы;
• орынды, аймақты, уақытты және материалдарды көрсету;
• күй өзгерген кезде интерфейсті жаңарту;
• өңдеу уақытын және эскалациясын бақылау.

Оператордың әрекеттері оқиға тарихында және тексеру журналында жазылады.

8. Журналға кіру

Журнал жазылған сапарлар мен байланысты трафик оқиғаларының тізімін береді. Пайдаланушы жазбаларды көре алады және қол жетімді сүзгілерді қолдана алады. Көлік идентификаторлары мен материалдарына қол жеткізу құқықтары шектелген және аудитке жатады.

9. Аналитика

Аналитикалық бөлім мыналарды көрсетеді:

• таңдалған объектінің жиынтық көрсеткіштері;
• алып жатқан орындардың саны мен үлесі;
• жұмыспен қамту динамикасы;
• жағдайдың тарихи суреттері;
• қол жетімді уақыт диапазонының көрсеткіштері.

Деректер аймағы нақты көрсетілуі керек: нақты деңгей, нысан немесе нысандар жинағы.

10. Жабдық

Жабдық тізілімі камералар, қақпалар, өртке қарсы есіктер және эмуляцияланған құрылғылар үшін қолданылады. Қол жетімді:

• құрылғыны тіркеу және өңдеу;
• класты, драйверді және қосылым параметрлерін қарау;
• соңғы оқиғаның онлайн немесе офлайн күйі және уақыты;
• диагностикалық тарих;
• растаумен қолдау көрсетілетін пәрменді жіберу;
• тіркелмеген камераларды анықтау;
• құрылғыны топология элементтерімен байланыстыру.

Жеткізуде физикалық жабдықсыз оқиғалар тізбегін тексеруге мүмкіндік беретін эмуляторлар бар.

11. Бақылау тақтасы және ақпарат экрандары

Ақпараттық ішкі жүйе мыналарды қамтамасыз етеді:

• таблолардың тізілімін жүргізу;
• шаблондарды құру және өңдеу;
• үлгіні алдын ала қарау;
• белгілі бір таблоға үлгі тағайындау;
• бос орындардың есептегіштерін және мәтіндік хабарламаларды көрсету;
• бірінші кезектегі шұғыл хабарлама;
• экран клиенті үшін шектеулі қол жеткізу белгісі;
• тағайындалған экранның күйін жаңартыңыз.

Үлгілер мен тапсырмалар серверде сақталады және оператордың интерактивті сеансына тәуелді емес. Ауысым үлгілерін толық басқару және операторлар арасындағы жеке макеттерді көшіру одан әрі дамытумен байланысты және ағымдағы дананың функциясы ретінде көрсетілмейді.

12. Әкімшілік

Әкімшілік схемаға мыналар кіреді:

• пайдаланушылар, рөлдер және рұқсаттар;
• жүйе параметрлері;
• топология және геометрия;
• құрылғы тізілімі және біріктіру кілттері;
• ережелер мен Webhook жазылымдары;
• навигациялық график және оның нұсқалары;
• аудит журналы.

Өзгерту әрекеттері рұқсаттарды тексеру арқылы қорғалады. Қызметтік құпиялар пайдаланушы интерфейсінде анық мәтінде көрсетілмейді.

13. Интеграциялық мүмкіндіктер

Core жарияланған OpenAPI схемасына негізделген HTTP API ұсынады. Device Gateway оқиға келісім-шарттары мен аппараттық пәрмендерді қолдайды. Сыртқы жүйелер үшін API кілттері, Webhook жеткізу және сәтсіз хабарларды қайта жеткізу қамтамасыз етіледі.

Интеграциялық мәліметтердің негізгі түрлері:

• тұрақ орнының жағдайы;
• көлік құралдарын қадағалау;
• камераның, қақпаның және өртке қарсы кіреберістің жағдайы;
• оқиғаның өзгеруі;
• аймақ режимін өзгерту;
• құрылғыға немесе экранға пәрмен беру.

14. Бақылау және диагностика

Жүйе мыналарды қамтамасыз етеді:

• дайындықтың соңғы нүктесі /api/health;
• контейнер күйлері;
• Прометейдің техникалық көрсеткіштері;
• Grafana бақылау тақталары;
• орталықтандырылған Loki журналдары;
• үлестірілген темп іздері;
• жеткізу және оқиғаларды өңдеу есептегіштері.

Бақылау мүмкіндігі диагностикалық мақсаттарға арналған және бизнес деректерінің сақтық көшірмесін жасауды алмастырмайды.

15. Қорғау және тұрақтылық

Инстанция келесі шараларды жүзеге асырады:

• рөлге негізделген қол жеткізуді басқару;
• дерекқордың жеке рөлдері;
• дананың бірегей құпиялары;
• конфигурация файлдарына шектеулі құқықтар;
• тіркеу әрекеттері;
• Core іске қоспас бұрын дерекқор схемасын тексеру;
• Шлюздің тұрақты кезегі;
• оқиғалардың тұрақты ағыны;
• жинақтың бақылау сомасы және жергілікті кескіндер;
• Деректер қоры мен медианың сақтық көшірмесі.

16. Ағымдағы дананың шекаралары

Ағымдағы жинақ:

• Ubuntu Server 24.04 LTS AMD64 үшін әзірленген;
• ARM64 қолдамайды;
• жергілікті контейнер тізбегінде орнатылған;
• опцияда demo заңды тұлғаның нақты мекен-жайы мен деректемелері жоқ тек жалған демонстрациялық тұрақ жасайды; опция clean демонстрациялық тұрақтарды жасамайды;
• оның конфигурациясы жоқ нақты жабдықпен өнеркәсіптік интеграцияны қамтымайды;
• пайдаланушы интерфейсінен автоматты жаңартуды көрсетпейді;
• ұсынылған дананың ерекшелігі ретінде есеп айырысу немесе зарядтау станциясын басқаруды талап етпейді.

17. Функционалды қол жетімділікті басқару

Орнатқаннан кейін мынаны тексеріңіз:

• пайдаланушыға кіру;
• рөлге сәйкес бөлімдердің болуы;
• негізгі топологияны құру;
• эмулятордан оқиғаны алу;
• жер жағдайының өзгеруі;
• оқиғаны құру және өңдеу;
• келу журналы;
• аналитикалық қорытынды;
• құрылғы күйі;
• табло үлгісін құру және тағайындау;
• аудит ізі;
• көрсеткіштер мен жүйелік журналдар.