CShark программасынын функционалдык мүнөздөмөлөрүнүн сүрөттөлүшү

Берилген инстанцияны аныктоо

1. Максат

CShark - бул паркинг мейкиндигин, объекттин түзүлүштөрүн, окуяларды, инциденттерди жана маалымат куралдарын башкаруу үчүн сервердик программа. Система ээсинин инфраструктурасында локалдык жайылтуу үчүн иштелип чыккан жана операторлор, администраторлор, техникалык персонал жана аналитиктер үчүн бирдиктүү веб-интерфейс менен камсыз кылат.

Документ вариантта берилген инстанциянын функцияларын сүрөттөйт demo. Орнотуудан кийин, жасалма объект Demo Parking "Түндүк" юридикалык жактын реалдуу дареги жана реквизиттери жок түзүлөт: бир деңгээл, эки зона жана 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, мото жана сервис орундары бар. Негизги демо үрөндө чыныгы даректер, уюмдардын деталдары жана камералык кадрлар жок.

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

Диаграмма бөлүмү объекттин учурдагы абалын көзөмөлдөө үчүн арналган. Ал камсыз кылат:

• объект жана деңгээл тандоо;
• деңгээлге сереп салуу жана секторлорго өтүү;
• ээлеген, бош, жеткиликсиз жана белгисиз жерлерди көрсөтүү;
• жайгашкан жерди издөө;
• чыпкалоо жана кошумча катмарлардын көрүнүшүн көзөмөлдөө;
• жер картасын жана анын шарттарынын тарыхын көрүү;
• тиешелүү активдүү окуяларды көрсөтүү;
• тиешелүү уруксат менен бир же бир нече жерди эксплуатациядан тыш абалга өткөрүү.

Объект жана деңгээлдеги контекст URL дарегинде сакталат жана ага байланышкан аналитикалык көрүнүштөр тарабынан колдонулат.

6. Окуяларды кабыл алуу жана жерлердин абалы

Device Gateway камералардан жана башка түзмөктөрдөн окуяларды кабыл алып, аларды нормалдаштырат жана окуялар автобусу аркылуу Coreге өткөрүп берет. Камералар каттоону, байланыш абалын, жүрөктүн согушун, аймакты жана жайгашкан жерди көзөмөлдөөнү жана буйрук каналын колдойт.

Эгерде NATS убактылуу жеткиликсиз болсо, Шлюз тарабынан кабыл алынган окуялар жергиликтүү туруктуу кезекте сакталат жана байланыш калыбына келгенде жөнөтүлөт. Кайра жеткирүү бизнес окуяларды кайталабашы керек.

Система жерлердин абалынын өзгөрүшүнүн тарыхын сактайт жана аналитика үчүн ээлөөнүн сүрөттөрүн колдонот.

7. Окуялар

Окуянын подсистемасы төмөнкүлөрдү камсыз кылат:

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

Оператордун аракеттери окуянын тарыхында жана текшерүү журналында жазылат.

8. Visit log

Журнал жазылган баруулардын жана ага байланыштуу трафик окуяларынын тизмесин берет. Колдонуучу жазууларды көрө алат жана жеткиликтүү чыпкаларды колдоно алат. Транспорт каражаттарынын идентификаторлоруна жана материалдарына жетүү укуктар менен чектелген жана текшерүүдөн өтүүгө тийиш.

9. Аналитика

Аналитикалык бөлүм төмөнкүлөрдү көрсөтөт:

• тандалган объект үчүн жыйынды көрсөткүчтөр;
• ээлеген жерлердин саны жана үлүшү;
• иш менен камсыз кылуу динамикасы;
• абалдын тарыхый сүрөттөрү;
• жеткиликтүү убакыт диапазону үчүн көрсөткүчтөр.

Маалымат аймагы так көрсөтүлүшү керек: белгилүү бир деңгээл, объект же объекттердин жыйындысы.

10. Жабдуулар

Жабдуулардын реестри камералар, дарбазалар, өрткө каршы кире бериштер жана эмуляцияланган түзүлүштөр үчүн колдонулат. Жеткиликтүү:

• аппаратты каттоо жана редакциялоо;
• класс, айдоочу жана байланыш параметрлерин көрүү;
• акыркы окуянын онлайн же оффлайн абалы жана убактысы;
• диагностикалык тарыхы;
• ырастоо менен колдоого алынган буйрук жөнөтүү;
• катталбаган камераларды аныктоо;
• аппаратты топология элементтерине байланыштыруу.

Жеткирүү эмуляторлорду камтыйт, алар окуялардын схемасын физикалык жабдууларсыз текшерүүгө мүмкүндүк берет.

11. Упайлар тактасы жана маалымат экрандары

Маалыматтык подсистема төмөнкүлөрдү камсыз кылат:

• таблолордун реестрин жүргүзүү;
• калыптарды түзүү жана редакциялоо;
• шаблонду алдын ала көрүү;
• белгилүү бир табло үчүн шаблон дайындоо;
• жеткиликтүү орундардын эсептегичтерин жана тексттик билдирүүлөрдү көрсөтүү;
• артыкчылыктуу шашылыш билдирүү;
• экран кардары үчүн чектелген жеткиликтүүлүк белгиси;
• дайындалган экрандын статусун жаңыртуу.

Шаблондор жана тапшырмалар серверде сакталат жана оператордун интерактивдүү сессиясынан көз каранды эмес. Сменалык шаблондорду толук башкаруу жана операторлор ортосундагы жеке макеттерди көчүрүү андан ары өнүктүрүүгө байланыштуу жана учурдагы инстанциянын функциясы катары айтылган эмес.

12. Башкаруу

Административдик схема төмөнкүлөрдү камтыйт:

• колдонуучулар, ролдор жана уруксаттар;
• системанын параметрлери;
• топология жана геометрия;
• түзмөк реестри жана интеграция ачкычтары;
• эрежелер жана Webhook жазылуулары;
• навигациялык график жана анын версиялары;
• аудит журналы.

Өзгөртүү операциялары уруксат текшерүүлөрү менен корголот. Кызмат сырлары колдонуучунун интерфейсинде ачык текстте көрсөтүлбөйт.

13. Интеграциялоо мүмкүнчүлүктөрү

Core жарыяланган OpenAPI схемасынын негизинде HTTP API менен камсыз кылат. Device Gateway окуя келишимдерин жана аппараттык буйруктарды колдойт. Тышкы системалар үчүн API ачкычтары, Webhook жеткирүү жана ийгиликсиз билдирүүлөрдү кайра жеткирүү каралган.

Интеграцияланган маалыматтардын негизги түрлөрү:

• унаа токтотуучу жайдын абалы;
• унаа көзөмөлдөө;
• камеранын, дарбазанын жана өрт кире беришинин абалы;
• окуянын өзгөрүшү;
• зона режимин өзгөртүү;
• түзмөккө же экранга буйрук.

14. Байкоо жана диагностика

Система төмөнкүлөрдү камсыз кылат:

• даярдыгынын акыркы чекити /api/health;
• контейнер статустары;
• Prometheus техникалык көрсөткүчтөрү;
• Grafana такталары;
• борборлоштурулган Loki журналдары;
• бөлүштүрүлгөн Темп издери;
• жеткирүү жана окуяларды иштетүү эсептегичтери.

Байкоо мүмкүнчүлүгү диагностикалык максаттар үчүн арналган жана бизнес маалыматтарынын резервдик көчүрмөсүн алмаштыруу эмес.

15. Коргоо жана туруктуулук

Инстанция төмөнкү чараларды ишке ашырат:

• ролго негизделген кирүүнү башкаруу;
• жеке маалыматтар базасынын ролдору;
• инстанциянын уникалдуу сырлары;
• конфигурация файлдарына чектелген укуктар;
• журналга алуу аракеттери;
• Coreди иштетүүдөн мурун маалымат базасынын схемасын текшерүү;
• Шлюздун туруктуу кезеги;
• окуялардын туруктуу агымы;
• комплекттин контролдук суммалары жана жергиликтүү сүрөттөр;
• Маалыматтар базасы жана медиа резервдик көчүрмөсү.

16. Учурдагы инстанциянын чек аралары

Учурдагы комплект:

• Ubuntu Server 24.04 LTS AMD64 үчүн иштелип чыккан;
• ARM64 колдобойт;
• жергиликтүү контейнер схемасында орнотулган;
• вариантта demo юридикалык жактын реалдуу дареги жана реквизиттери жок жасалма көрсөтмө токтоочу жайды гана түзсө; параметр clean демонстрациялык унаа токтоочу жайларды түзбөйт;
• конфигурациясы жок конкреттүү жабдуулар менен өнөр жай интеграциясын камтыбайт;
• колдонуучу интерфейсинен автоматтык жаңыртууну билдирбейт;
• берилген инстанциянын өзгөчөлүгү катары эсептешүү же заряддоо станциясын башкарууну талап кылбайт.

17. Функционалдык жеткиликтүүлүктү башкаруу

Орнотуудан кийин, текшерүү:

• колдонуучунун кирүү;
• ролуна жараша бөлүмдөрдүн болушу;
• негизги топологияны түзүү;
• эмулятордон окуяны алуу;
• жердин абалынын өзгөрүшү;
• инцидентти түзүү жана иштетүү;
• зыярат журналы;
• аналитикалык корутунду;
• аппараттын абалы;
• табло үлгүсүн түзүү жана дайындоо;
• аудит изи;
• көрсөткүчтөр жана система журналдары.