Администратордун колдонмосу

1. Документтин максаты жана администратордун ролдору

Документ CShark программасын кардардын сайтында конфигурациялаган жана тейлеген адистер үчүн арналган.

Система менен күнүмдүк иштөө өзүнчө документте баяндалат "Колдонуучунун колдонмосу", жайылтуу - документте "Программанын көчүрмөсүн орнотуу боюнча нускамалар".

Укуктар үлгү катары белгиленет (12-бөлүм); жогорудагы ролдорго бөлүштүрүү уюштуруучулук болуп саналат.

2. Программанын курамы жана компоненттерин жайгаштыруу

Байкоо мүмкүнчүлүгү профили текшерүү комплектине киргизилген; Grafana тарабынан жарыяланган 13000/tcp, анын калган кызматтары Жазуу тармагында гана жеткиликтүү.

Бардык кызматтар объекттин жабык тармак периметри боюнча контейнерлерде иштейт. Иш учурунда тышкы кызматтарга чалуулар аткарылбайт.

3. Кызматты башкаруу

Иш каталогу: /opt/cshark-stand.

# кызматтардын абалы
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 stop

# өзүнчө кызматты кайра иштетүү
sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml restart core

# кызмат журналдары
sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml logs -f core

4. Орнотуулар

Параметрлер чөйрө өзгөрмөлөрү (file .env кызматтын сүрөттөмө файлынын жанында). Орнотууларды өзгөрткөндөн кийин, кызмат кайра иштетилиши керек.

5. Объекттин баштапкы орнотуу

Сиз биринчи жолу киргенде, Баштапкы орнотуу устасы жеткиликтүү болот. Ырааттуулук:

1. Камтылган администратор эсебинин сырсөзүн өзгөртүңүз.
2. Объектти (паркинг), деңгээлдерди, зоналарды, унаа токтотуучу жайларды түзүү.
3. Деңгээлдин графикалык фонун жүктөңүз жана объекттерди диаграммага жайгаштырыңыз.
4. Камераларды каттап, аларды унаа токтотуучу жайларга байланыштырыңыз.
5. Маалымат такталары үчүн калыптарды жана түзүлүштөрдү түзүү.
6. Жетүү аймактарынын жана кирүү чекиттеринин графигин түзүңүз.
7. Оператор ролдорун жана эсептерди түзүңүз.
8. Окуяны иштетүү эрежелерин конфигурациялаңыз.

6. Топологияны жана схеманы орнотуу

Бөлүм "Администрация" → "Топология".

Иерархия: уюм → паркинг → деңгээл → аймак → унаа токтотуучу жай.

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

7. Видео аналитика камераларын орнотуу

Бөлүм "жабдуулар".

1. Окуяларды түзмөктүн шлюз дарегине жөнөтүү үчүн камераны конфигурациялаңыз (HTTP аркылуу сатуучунун протоколу). Дарек жана порт камера жөндөөлөрүндө көрсөтүлгөн.
2. Системага кирген камера аныкталбаган түзмөктөрдүн тизмесинде пайда болот.
3. Камераны каттаңыз: атын, тармактын дарегин, жайгашкан жерин коюңуз.
4. Камераны ал тейлеген унаа токтотуучу жайларга байланыштырыңыз.
5. Окуялардын келишин текшериңиз: кырдаал өзгөргөндө, тиешелүү унаа токтотуучу жайдын абалы өзгөрүшү керек.

Аткаруу мониторинги мезгилдүү катышуусунун сигналдарынын негизинде автоматтык түрдө аткарылат. Түзмөктүн абалы "Жабдуулар" бөлүмүндө жана сайттын диаграммасында көрсөтүлөт. Мамлекеттик өзгөрүүлөрдүн тарыхы сакталат.

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

8. Маалымат такталарын орнотуу

Бөлүм "Упайлар тактасы".

8.1. Шаблондор

Шаблон кадрдын макетін сүрөттөйт жана аймактардан турат:

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

8.2. Дисплей түзмөктөрү

1. Түзмөк түзүңүз, классты тандаңыз: тексттин LED панели (EK07, TCP/RS-485 протоколу) же жогорку чечилиштеги монитордогу веб-киоск.
2. Туташуу параметрлерин көрсөтүңүз.
3. Шилтеме шаблону, зонасы жана кирүү чекити.
4. Түзүлгөн кадрды алдын ала көрүү менен натыйжаны текшериңиз.

Веб киоск үчүн форманын жалпы дареги түзүлөт /kiosk/display/<идентификатор>?token=<токен>; монитор бул баракты киоск режиминде ачат. Токен мазмунга кирүүнү чектейт.

8.3. Мазмун артыкчылыктары

Өзгөчө кырдаал → кол менен алмаштыруу → график → кадрлар. Өзгөчө кырдаал мазмуну (өрт же баш калкалоо режими) башка мазмунду алмаштырат жана аны кол менен алмаштырууга болбойт.

8.4. Тексттердин дареги

Жеткиликсиздиктин себептери коомдук (айдоочуга көрсөтүлөт) жана административдик (кызматкерлерге гана жеткиликтүү) болуп бөлүнөт. Административдик тексттер коомдук киосктун жообунда жана WebSocket агымында физикалык түрдө жок. Дисплейдин диагностикалык абалы төмөнкү жерден жеткиликтүү /api/displays/{id}/state ырасталган кызматкерлер үчүн гана.

9. Навигация орнотуулары

Бөлүм "Администрация" → "Зондор", байланыштар өтмөгү.

1. Зоналардын ортосундагы жетүү мүмкүнчүлүгү графигинин четтерин көрсөтүңүз (кайсы зоналар кайсы жерден жетүүгө болот).
2. Сайтка кирүү чекиттерин көрсөтүңүз.
3. Кирүү чекиттерине тактанын жол көрсөткүчтөрүн бекитиңиз.

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

10. Объекттин режимдерин жана зоналарын орнотуу

Зона жана объект мамлекеттери: кызматкерлер, өрт, баш калкалоочу жай, тейлөө.

Режимди өзгөртүү ошол замат өзгөрөт: зонада унаа токтотуучу жайлардын болушу, маалымат такталарынын мазмуну (шашылыш кырдаалдын мазмуну эң жогорку артыкчылыкты алат), окуяларды иштетүү эрежелери жана билдирүүлөрдүн курамы.

Администратор себепти жок кылгандан кийин кол менен кадимки режимге кайтып келет.

11. Окуяларды иштетүү эрежелерин орнотуу

Бөлүм "Администрация" → "Эрежелер".

Эреже төмөнкү схема боюнча белгиленет:

триггер (окуя түрү) × аймак (объект, зона, жерлердин тобу, белгилүү бир жер) × условие шарты условие шарттары (убакыт, абал, башка белгилер) → аракеттер

Жеткиликтүү аракеттер: операторго кабарлоо, инцидент түзүү, статусту өзгөртүү, аппаратка буйрук жөнөтүү.

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

Мисалдар: “кыймылдуулугу чектелген адамдар үчүн аймактагы белгилерди бузуу → оор деңгээлдеги инцидентти түзүү”; "Кире бериштеги унаа токтотуучу жай 10 мүнөттөн ашык убакыттан бери уруксатсыз ээлеп турат → нөөмөт жетекчисине кабарлаңыз."

12. Колдонуучуларды, ролдорду жана укуктарды башкаруу

Бөлүм "Администрация" → "Колдонуучулар" жана "Ролдор".

• Уруксаттар "ресурс: аракет" формасынын бир мейкиндигине коюлат (мисалы, displays:manage, users:manage).
• Рол - бул уруксаттардын аталган жыйындысы. Колдонуучуга роль ыйгарылган; Мындан тышкары, жеке уруксаттар берилиши мүмкүн.
• Укуктарга байланыштуу колдонуучуга жеткиликтүү болбогон интерфейстин бөлүмдөрү навигацияда көрсөтүлбөйт.
• Колдонуучунун аракеттери аракеттер журналына жазылат.

Сырсөз талаптары: кеминде 6 белги. Сырсөздөр хэштер түрүндө сакталат (bcrypt алгоритми); алар так текстте сакталбайт же берилбейт.

Сессиялар кол коюлган токендер менен ишке ашырылат; кол коюу сыры параметр менен аныкталат CSHARK_AUTH_SECRET. Сырды өзгөртүү бардык активдүү сессияларды аяктайт.

13. Тышкы системалар менен интеграцияны орнотуу

Бөлүм "Администрация" → "Интеграциялар".

Өнөктөштүн автоматташтырылган паркинг системасы (кирүү тобу) менен өз ара аракеттенүү ушул механизмдер аркылуу ишке ашырылат.

14. Маалыматтарды сактоо жана сактоо саясаты

Сактоо мөөнөтү системанын жөндөөлөрү бөлүмүндөгү саясаттар менен белгиленет. Кадрлар чектелген убакыттагы шилтемелер аркылуу гана жеткиликтүү; сактоочу жайларга калктын түздөн-түз кирүүсү жабык.

15. Камдык көчүрмөнү сактоо жана калыбына келтирүү

15.1. Камдык көчүрмө

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

Маалымат базасынын таштандысы жана медиа манифест түзүлөт. Сактоо объекттери синхрондоштуруу куралдарынын жардамы менен өзүнчө көчүрүлөт - буйрук скрипт тарабынан берилет. Сунушталган жыштык: маалымат базасы - күн сайын (хостдогу графикке ылайык), ЖМК материалдары - жума сайын. Көчүрмөлөрдү сактоо тереңдиги системада маалыматтарды сактоо мөөнөтүнөн кем эмес.

15.2. Көчүрмө текшерүү

Убактылуу маалымат базасын иштөө үчүн коркунучсуз калыбына келтирүү:

tools/backup/restore.sh backups/cshark-XXXX.dump cshark_restore_check

Скрипт элдештирүү үчүн башкаруу эсептегичтерин (унаа мейкиндиктери, сапарлар, инциденттер, колдонуучулар) көрсөтөт.

15.3. Калыбына келтирүү

калыбына келтирүү алдында токтот core жана gateway Файлды түзүү аркылуу /opt/cshark-stand/compose.yml, жеткирүүдөн стандарттык калыбына келтирүү скриптин аткарып, анан ошол эле кызматтарды баштаңыз. Командалар жана резервдик көчүрмөгө жол иш журналында жазылат; калыбына келтирүү биринчи өзүнчө стендде текшерилет.

Медиа материалдар манифестке каршы текшерүү менен объект контейнерине синхрондоштуруу жолу менен калыбына келтирилет.

16. Мониторинг жана диагностика

Программа OpenTelemetry стандартына ылайык метрикаларды, журналдарды жана издерди жаратат. Байкоо профили иштетилгенде, Grafana панелдери жеткиликтүү болот.

Негизги көрсөткүчтөр:

Жеке жана купуя маалыматтар автоматтык түрдө журналдардан чыгарылат.

17. Программаны жаңылоо

Жаңыртуу кардардын администратору тарабынан ишке ашырылат. Объекттин периметринен тышкары жерлерден мажбурлап жаңылоо жана аралыктан башкаруу механизмдери жок.

Учурдагы чыгарылыш автоматтык түрдө алыстан жаңыртууну камтыбайт. Перспективдүү башкарылуучу механизмди ишке ашыруунун алдында жаңыртуу өзүнчө регулятивдик жеткирүү катары жүзөгө ашырылат: кол коюлган оффлайн комплектин кабыл алуу, SHA-256 жана чет элдик ачкыч кол тамгасын текшерүү, резервдик көчүрмөнү түзүү жана текшерүү, чыгарууга тиешелүү инструкцияларды жана толук түтүн-тестти аткаруу. Операция администратор тарабынан макулдашылган техникалык тейлөө терезесинде жүзөгө ашырылат.

Миграциялар кеңейүү-кысуу принцибине ылайык ишке ашырылат: схеманын бузулушу өзгөртүүлөр аларсыз иштеген код чыгарылгандан кийинки релизде чыгарылат. Ошондуктан, коддун мурунку версиясына кайтуу коопсуз жана схеманы артка кайтарууну талап кылбайт.

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

18. Типтүү каталар жана аларды чечүү жолдору

19. Файлдардын жана компоненттердин жайгашуусу

Контейнердин ичине кирүү:

sudo docker compose --env-file /opt/cshark-stand/.env \
  -f /opt/cshark-stand/compose.yml exec core sh
docker run --rm cshark-core:<версия> cat /etc/os-release    # образдын негизги операциялык системасы

20. Техникалык колдоо

Документте суроо-талаптарды кароонун тартиби, артыкчылыктары жана жооп берүү мөөнөттөрү келтирилген "Программалык камсыздоонун жашоо циклин камсыз кылуучу процесстердин сүрөттөлүшү".