Раздел 1. Общие сведения о системе¶

Настоящий раздел даёт администратору эксплуатационное представление о BOX5-DIT-MGSN: какие функции выполняет система, из каких доменов состоит промышленный контур, какие подсистемы являются критичными и где искать подробные регламенты.

Полная архитектура решения приведена в ПД, разделе 3, реестр сервисов - в ПД, приложении Г, карта данных и хранилищ - в В7, разделе 1, порядок развёртывания и восстановления - в И2, разделе 2 и И2, разделе 3.

1.1. Назначение и логика работы системы¶

BOX5-DIT-MGSN предназначена для промышленной видеоаналитики в промышленном контуре. Система получает видеопотоки и архивные записи, применяет NRI-сценарии и модели компьютерного зрения, формирует события и нарушения, предоставляет web-интерфейс для работы пользователей и передаёт согласованные статусы во внешние системы заказчика.

В промышленном контуре пользователи входят через внешний контур авторизации Keycloak/OpenID Connect. После входа BOX5-DIT-MGSN работает с прикладным профилем пользователя: ролью, объектными правами доступа, доступными производственными площадками, журналом действий и доступом к камерам, событиям, сценариям, моделям и отчётам.

Исходный Mermaid-код схемы: И3-MER-001. 1.1. Назначение и логика работы системы.

Основная логика работы:

1. Камеры, виртуальные камеры и внешние видеоисточники передают видеоданные в контур inference.
2. inf-load-balancer назначает камеры на медиасерверы, inf-mediaserver получает поток и передаёт кадры в inf-nri-inference.
3. NRI-сценарии и модели формируют события, heartbeat и диагностические сообщения, которые публикуются в Kafka.
4. Сервисы statistics сохраняют события, нарушения, статусы, медиа, отчёты, аудит и данные доступа пользователей.
5. Интеграционный контур severstal синхронизирует предметные справочники, сценарии и внешние системы заказчика, включая ПК-КОТ, CSVN/VMS и АСУ ТП.
6. Web UI отображает пользователю камеры, события, отчёты, роли, журналы и мониторинг через единый API-шлюз.

Административная логика разделяется на два уровня:

PROD является промышленным контуром с полным набором камер и штатной интеграцией с ПК-КОТ. TEST используется для проверки версии, сценариев, конфигурации и моделей перед переносом в PROD, но не является источником промышленных данных. Изменения в PROD выполняются только в согласованное окно, после фиксации исходного состояния и проверки резервного копирования.

1.2. Ландшафты и схема размещения¶

Для эксплуатации BOX5-DIT-MGSN используются три контура. DEV и TEST применяются для подготовки и проверки изменений, PROD является рабочим контуром заказчика.

Сравнение контуров по эксплуатационному составу:

Состав узлов контуров:

Состав PROD-сегмента:

Размещение данных и инфраструктурные отличия:

Движение изменений между контурами:

Исходный Mermaid-код схемы: И3-MER-002. 1.2. Ландшафты и схема размещения, схема 2.

Схема размещения PROD показывает фактический состав узлов Docker Swarm и основные группы сервисов рабочего контура заказчика. Различия DEV, TEST и PROD отражены в таблицах выше, поэтому отдельные схемы подготовительных контуров в разделе не дублируются. Сетевые зоны на схеме не разделяются: для данного контура используется единая зона площадки заказчика, а контроль сетевого доступа выполняется средствами площадки заказчика. Внешние системы, источники артефактов и внешние потребители эксплуатационных данных отображаются за пределами контура BOX5-DIT-MGSN. Из балансировщиков в составе BOX5-DIT-MGSN отражён inf-load-balancer; внешние и инфраструктурные балансировщики заказчика не показываются, если они не входят в поставку исполнителя. БД, Kafka и файловые хранилища показаны как группа мастер-ноды; детализация состава данных приведена в В7, разделе 1. Внешняя Grafana заказчика получает показатели работы системы из согласованных источников BOX5-DIT-MGSN; на схеме основной поток показан от аналитических витрин ClickHouse.

Исходный Mermaid-код схемы: И3-MER-003. 1.2. Ландшафты и схема размещения, схема 3.

Размещение ролей по узлам:

DEV совмещает роли на одном сервере. TEST разворачивается как кластер из одной мастер-ноды и двух вычислительных нод. PROD разворачивается как кластер из одной мастер-ноды и 11 вычислительных GPU-нод.

1.3. Состав и структура системы¶

BOX5-DIT-MGSN разворачивается как набор Docker Compose-доменов. Домен содержит один или несколько сервисов и собственные .env-параметры, а запуск и остановка выполняются из корня поставки через compose.sh. Для промышленного контура администратор должен рассматривать домен как минимальную единицу штатного перезапуска, если нет отдельного согласованного плана.

Основные эксплуатационные артефакты:

Данные системы распределены по нескольким типам хранилищ:

Сетевые и инфраструктурные границы:

• пользовательский вход и API идут через ui-nginx;
• большинство сервисов доступно только внутри Docker-сети bx_default;
• node-red-sandbox использует отдельную сеть и собственные volumes;
• GPU и IPC/shared-memory критичны для медиасервера и NRI;
• опубликованные технические порты и внешние endpoints должны быть ограничены сетевыми правилами площадки;
• .env, токены, пароли, приватные URL, дампы БД и лицензионные файлы не публикуются в документации и общих каналах.

Для администратора базовая проверка структуры после запуска включает:

cd ~/CODE/box3

compose.sh check
compose.sh status all
docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}'
curl -fsS http://localhost/api/base/ping/
df -h / /data
nvidia-smi

Если промышленный контур развёрнут в swarm-профиле, вместо одноузловых compose-проверок используются штатные swarm-команды поставки, но логика контроля остаётся той же: состояние доменов, доступность UI/API, работа Kafka, хранилищ, GPU, инференса, интеграций и резервных копий.