Документация, содержащая описание функциональных характеристик и информацию, необходимую для эксплуатации экземпляра программного обеспечения, предоставленного для проведения экспертной проверки
Документ содержит описание функциональных характеристик АПК «Верста» и информацию, необходимую пользователям и администраторам для эксплуатации экземпляра программного обеспечения, предоставленного для экспертной проверки.
1. Назначение
Программное обеспечение обеспечивает единое рабочее пространство для организаций, использующих камеры и алгоритмы компьютерного зрения. Система принимает сведения от периферийных агентов и аналитических модулей, сохраняет их в базе данных и предоставляет пользователям инструменты просмотра, поиска, проверки и формирования отчетов.
АПК «Верста» применяется для мониторинга состояния камер и серверов, учета аналитических моделей, обработки событий, контроля снимков, разграничения доступа и оценки результатов работы видеоаналитики.
2. Задачи программного обеспечения
- ведение единого реестра камер, серверов и аналитических моделей;
- получение событий распознавания и результатов аналитической обработки;
- получение контрольных снимков с периферийных серверов;
- получение телеметрии и сведений о состоянии программных агентов;
- поиск, фильтрация и просмотр событий и медиаматериалов;
- пользовательская проверка и классификация результатов;
- формирование статистики и отчетных представлений;
- управление пользователями, ролями, группами и доступом к камерам;
- настройка моделей, расписаний, зон анализа и типов событий;
- формирование уведомлений для настроенных групп получателей.
3. Состав программного обеспечения
| Компонент | Назначение | Основная технология |
|---|---|---|
| Серверное веб-приложение | Пользовательский интерфейс, API, бизнес-логика, разграничение доступа | PHP, HTML, CSS, JavaScript |
| База данных | Хранение объектов, настроек, событий, снимков и телеметрии | MariaDB или MySQL |
| Периферийный агент | Обмен конфигурацией, отправка состояния, снимков и результатов обработки | Python 3 |
| Медиакомпонент | Проксирование тестовых потоков и предоставление воспроизведения | MediaMTX, ffmpeg, RTSP и HLS |
| Веб-браузер | Работа пользователя с интерфейсом | HTML5, JavaScript, cookies, HTTPS |
4. Пользовательские роли
| Роль | Возможности |
|---|---|
| Администратор | Управление пользователями, группами, камерами, серверами, моделями, настройками и доступом |
| Пользователь группы | Работа с объектами своей группы, назначение доступных моделей и управление разрешенными камерами |
| Оператор | Просмотр панели, событий, отчетов и разрешенных объектов без административных операций |
| Наблюдатель | Просмотр назначенных камер, снимков, событий и отчетов без изменения данных и результатов проверки |
5. Функциональные характеристики
5.1. Авторизация и разграничение доступа
- вход по имени пользователя и паролю;
- хранение паролей в виде криптографических хешей;
- ограничение одновременных пользовательских сессий;
- разграничение функций по ролям;
- разграничение доступа к камерам и объектам по группам;
- завершение пользовательской сессии по команде выхода.
5.2. Главная панель
- сводные показатели по событиям и состоянию инфраструктуры;
- просмотр последних событий и связанных изображений;
- фильтрация по периоду, камере, модели и типу события;
- переход из события к карточке камеры;
- отображение данных на картографическом представлении при наличии координат.
5.3. Управление камерами
- ведение карточек камер и параметров подключения;
- поиск и фильтрация камер;
- привязка камеры к группе и периферийному серверу;
- назначение одной или нескольких аналитических моделей;
- настройка расписаний и областей анализа;
- просмотр истории событий и тестового видеопотока при его доступности.
5.4. Аналитические модели
- ведение реестра моделей и их функциональных описаний;
- хранение параметров запуска и типов событий;
- массовое назначение модели на выбранные камеры;
- настройка расписания работы;
- настройка полигонов и зон на контрольном изображении;
- создание ключей для взаимодействия с интеграционным API.
5.5. События и контрольные снимки
- прием события с идентификатором, временем, камерой, моделью и типом;
- защита от повторной записи события с тем же идентификатором;
- связывание события с камерой и изображением;
- фильтрация по периоду, камере, статусу и типу нарушения;
- просмотр изображения и служебных сведений;
- фиксация результата пользовательской проверки;
- указание области и типа выявленного нарушения;
- ведение истории обработки.
5.6. Серверы и периферийные агенты
- ведение реестра периферийных серверов;
- выдача агенту конфигурации доступных камер;
- прием отчетов о состоянии и времени последней активности;
- прием контрольных снимков;
- прием структурированной телеметрии аналитических запусков;
- отображение диагностических сведений в интерфейсе.
5.7. Отчеты, статистика и уведомления
- формирование показателей за выбранный период;
- агрегация событий по камерам, моделям и типам;
- просмотр успешных, пропущенных и ошибочных запусков;
- формирование экранного и печатного представления отчета;
- ведение групп получателей уведомлений;
- отправка тестового уведомления в настроенный канал.
6. Входные данные
| Категория | Состав данных |
|---|---|
| Пользователи | Имена учетных записей, роли, группы и разрешения |
| Камеры | Наименование, адрес потока, координаты, сервер и принадлежность группе |
| Модели | Описание, типы событий, параметры запуска, расписания и зоны |
| События | Идентификатор, время, камера, модель, тип, вероятность и связанное изображение |
| Телеметрия | Состояние процесса, время запуска, длительность, результат и диагностические сведения |
| Снимки | Файл изображения, время получения, камера, статус и результат проверки |
7. Выходные данные
- экранные списки и карточки камер, серверов, моделей, событий и снимков;
- сводные показатели и отфильтрованные выборки;
- результаты пользовательской проверки изображений;
- отчеты и статистические представления;
- конфигурация камер и моделей для периферийного агента;
- уведомления настроенным группам получателей;
- ответы API об успешном выполнении операции или причине отказа.
8. Интеграционные интерфейсы
| Интерфейс | Назначение | Формат |
|---|---|---|
| Получение конфигурации | Передача агенту списка камер и параметров | HTTPS, JSON |
| Отчет состояния | Передача времени активности и состояния агента | HTTPS, JSON |
| Загрузка снимков | Передача файлов и связанных метаданных | HTTPS, multipart/form-data |
| События детекции | Прием результатов аналитической обработки | HTTPS, JSON |
| Телеметрия | Прием структурированных событий выполнения | HTTPS, JSON |
| Видеопоток | Просмотр тестового потока в браузере | RTSP и HLS |
9. Требования к ресурсам
| Узел | Минимальная конфигурация | Примечание |
|---|---|---|
| Сервер веб-приложения и БД для экспертной проверки | 2 vCPU, 4 ГБ ОЗУ, 20 ГБ диска | Без длительного хранения большого объема медиаданных |
| Рекомендуемая тестовая конфигурация | 4 vCPU, 8 ГБ ОЗУ, 40 ГБ диска | Для одновременной проверки портала, агента и тестового потока |
| Рабочее место пользователя | Экран от 1280×720, современный браузер, сетевой доступ по HTTPS | Локальная установка клиентского приложения не требуется |
Ресурсы промышленной среды рассчитываются с учетом количества камер, интенсивности событий, числа одновременных пользователей, периода хранения и объема медиаматериалов.
10. Ограничения тестового контура
- используются обезличенные тестовые сведения;
- набор камер, событий и медиаматериалов ограничен задачами проверки;
- видеопоток доступен только при включенном тестовом источнике;
- картографическое представление зависит от настройки картографического сервиса;
- уведомления отправляются только в специально настроенный тестовый канал;
- доступные действия определяются ролью экспертной учетной записи;
- изменения в тестовом контуре не влияют на рабочие данные пользователей.
11. Результат работы
Результатом работы АПК «Верста» является централизованное представление состояния инфраструктуры видеоаналитики, событий и медиаматериалов, а также возможность контролировать работу периферийных агентов, проверять результаты аналитики, формировать статистику и управлять доступом пользователей.
12. Требования к рабочему месту пользователя
| Компонент | Требование |
|---|---|
| Компьютер | Персональный компьютер или ноутбук с экраном не менее 1280×720 |
| Браузер | Актуальная версия Chromium, Microsoft Edge, Mozilla Firefox, Яндекс Браузера или эквивалентного браузера с поддержкой JavaScript, cookies и HTML5 |
| Сеть | Стабильный доступ к демонстрационному контуру по протоколу HTTPS |
| Дополнительное ПО | Не требуется; для экспертной проверки серверной части отдельно используются OpenVPN и SSH-клиент |
13. Начало работы
- Получить у правообладателя адрес демонстрационного контура, имя пользователя и временный пароль.
- Открыть https://demo.ai.yotabit.ru/ в поддерживаемом браузере.
- Убедиться, что соединение установлено по HTTPS без предупреждения о сертификате.
- Ввести имя пользователя и пароль и нажать кнопку входа.
- После авторизации убедиться, что отображается главная панель и пункты меню, соответствующие выданной роли.
Тестовые реквизиты. Действующие логин и временный пароль передаются эксперту в заявлении или по согласованному защищенному каналу. Если пароль был изменен либо срок его действия истек, правообладатель выдает новый пароль.
14. Навигация по системе
| Раздел | Назначение |
|---|---|
| Главная | Сводные показатели, карта, последние события и фильтры по периоду, камере, модели, городу и типу события |
| Камеры | Список камер, карточки, назначенные модели, принадлежность группе, состояние и тестовый просмотр потока |
| Снимки | Контрольные изображения, поиск, взятие в работу, проверка и указание результата |
| Отчеты | Отчетные показатели по моделям и контрольным снимкам за выбранный период |
| Статистика | Телеметрия запусков, успешные и ошибочные выполнения, длительность и диагностические показатели |
| Серверы | Учет периферийных серверов и контроль времени их последней активности |
| Модели | Реестр аналитических моделей, ключи, типы событий, расписания и параметры |
| Уведомления | Настройка групп получателей и отправка тестового сообщения |
| Пользователи | Учетные записи, роли, группы и разрешения; раздел доступен администратору |
15. Основные пользовательские сценарии
15.1. Просмотр и фильтрация событий
- Открыть раздел «Главная».
- Задать период и при необходимости выбрать камеру, модель, город или тип события.
- Применить фильтр и открыть карточку нужного события.
- Проверить изображение, время, камеру, модель и служебные сведения.
- При наличии соответствующих прав установить результат проверки события.
15.2. Работа с контрольными снимками
- Открыть раздел «Снимки» и задать доступные фильтры.
- Выбрать изображение и, если предусмотрено ролью, взять его в работу.
- Просмотреть увеличенное изображение и сведения о камере и времени получения.
- Отметить результат проверки, область и тип нарушения либо подтвердить отсутствие нарушения.
- Сохранить результат и убедиться, что изменились статус и сведения о проверившем пользователе.
15.3. Просмотр камеры
- Открыть раздел «Камеры» и найти камеру с помощью фильтра.
- Перейти в карточку камеры.
- Проверить основные сведения, назначенный периферийный сервер и аналитические модели.
- Просмотреть связанные события и контрольные снимки.
- Если тестовый источник включен, открыть воспроизведение видеопотока.
15.4. Формирование отчета
- Открыть раздел «Отчеты».
- Выбрать тип отчета и отчетный месяц.
- При наличии фильтра выбрать договорную метку или иной доступный признак.
- Сформировать экранное представление и проверить итоговые показатели.
- При необходимости использовать печатное представление браузера.
16. Административные сценарии
16.1. Создание и изменение камеры
- Открыть раздел «Камеры» и выбрать создание новой записи.
- Указать наименование, периферийный сервер и основной адрес RTSP-потока.
- При необходимости заполнить внешний идентификатор, адрес, координаты, город и дополнительные параметры.
- Сохранить карточку и назначить доступные аналитические модели.
- Убедиться, что камера отображается в списке и доступна только разрешенным группам.
16.2. Настройка аналитической модели
- Открыть раздел «Модели» и создать либо выбрать модель.
- Заполнить наименование и функциональное описание.
- Настроить типы событий и параметры запуска.
- При необходимости задать расписание и области анализа.
- Назначить модель выбранным камерам и проверить отображение назначения.
16.3. Управление пользователями
- Открыть раздел «Пользователи» под учетной записью администратора.
- Создать учетную запись либо открыть существующую.
- Назначить роль, группу и разрешения в объеме, необходимом для работы.
- Сохранить изменения и проверить доступ под тестовой учетной записью.
- При прекращении полномочий заблокировать учетную запись или изменить ее доступ.
17. Завершение работы
Для завершения пользовательской сессии необходимо выбрать команду выхода. На общедоступном или чужом компьютере после выхода следует закрыть окно браузера. Учетные данные нельзя сохранять в браузере или передавать другим лицам.
18. Диагностика типовых проблем
| Ситуация | Действия пользователя |
|---|---|
| Страница не открывается | Проверить подключение к сети и точность адреса; зафиксировать время и сообщение браузера; передать сведения в поддержку |
| Браузер предупреждает о сертификате | Не вводить учетные данные и сообщить правообладателю адрес и время появления предупреждения |
| Не выполняется вход | Проверить раскладку и регистр; при повторной ошибке запросить сброс временного пароля |
| Не отображается нужный раздел | Уточнить назначенную роль и права доступа у администратора |
| Нет изображения или видеопотока | Проверить, включен ли тестовый источник; сообщить идентификатор камеры и время проверки |
| События или снимки не поступают | Сообщить идентификатор камеры, выбранный период и время последнего ожидаемого события; серверную диагностику выполняет правообладатель |
| Данные не сохранились | Не повторять массовую операцию; зафиксировать раздел, последовательность действий и текст сообщения |
19. Правила безопасной эксплуатации
- не передавать другим лицам логин, пароль, VPN-профиль, SSH-ключи и ключи интеграционного API;
- не вводить в тестовый контур реальные персональные данные и реквизиты действующих видеопотоков без отдельного согласования;
- не изменять системные настройки и данные за пределами сценариев экспертной проверки;
- не публиковать полученные изображения, журналы и диагностические сведения;
- после завершения проверки сообщить правообладателю, чтобы временный доступ был отозван.
20. Обращение в техническую поддержку
В обращении следует указать адрес тестового контура, имя учетной записи без пароля, раздел системы, дату и время возникновения проблемы, последовательность действий, ожидаемый и фактический результат, текст ошибки и снимок экрана при наличии. Пароли, VPN-профили, закрытые ключи и иные секреты в обращение не включаются.
Каналы и режим работы технической поддержки опубликованы в документе «Описание процессов, обеспечивающих поддержание жизненного цикла программного обеспечения» и передаются эксперту вместе с реквизитами доступа.
Документ актуализирован 20 октября 2026 года.