1.   Общие сведения
1.1.   Наименование программы
Аист — веб-приложение для мониторинга и управления объектами дорожно-транспортной инфраструктуры автомобильных дорог Уральского региона России.
1.2.   Назначение программы
Программа предназначена для:
·         централизованного мониторинга состояния объектов дорожной инфраструктуры в режиме реального времени;
·         визуализации объектов на интерактивной карте с возможностью фильтрации и поиска;
·         управления видеонаблюдением (просмотр в реальном времени и архив);
·         мониторинга метеорологической обстановки на дорогах;
·         создания и сопровождения заявок о нарушениях содержания дорог;
·         управления табло переменной информации (ТПИ) и знаками переменной информации (ЗПИ);
·         анализа интенсивности транспортных потоков;
·         управления пользователями, подрядными организациями и документацией.
1.3.   Область применения
Программа применяется организациями, осуществляющими эксплуатацию автомобильных дорог федерального и регионального значения: дорожными службами, ЦУП и подрядными организациями.
2.   Функциональное назначение2.1.   Перечень решаемых задач
Программа решает следующие функциональные задачи:
1.       Мониторинг технического состояния объектов — отображение текущего статуса (работоспособности) устройств пяти типов: видеокамер, метеостанций (АСМО), знаков переменной информации (ТПИ и ЗПИ), пунктов учёта интенсивности движения (ПУИД).
2.       Визуализация на интерактивной карте — отображение объектов на картографической основе с кластеризацией, фильтрацией, оверлеями погодных данных и покраской дорог по интенсивности потока.
3.       Видеомониторинг — просмотр видеопотоков с камер в режиме реального времени, работа с архивом фотографий, формирование видеостены с одновременным отображением нескольких камер.

4.       Метеомониторинг — получение и отображение данных метеостанций, автоматическая проверка показателей по настраиваемым правилам, формирование уведомлений о критических и предупредительных значениях.
5.       Управление заявками — регистрация нарушений и неисправностей, назначение ответственных, отслеживание статусов в рамках регламентированного жизненного цикла, хранение файлов и переписки.
6.       Управление знаками переменной информации — настройка сценариев отображения на ТПИ и ЗПИ, загрузка изображений, применение изменений к устройствам, управление библиотекой сценариев.
7.       Анализ транспортных потоков — визуализация исторических данных интенсивности движения по дорогам и отдельным участкам, отображение скоростных данных с ПУИД на карте.
8.       Управление пользователями и правами доступа — создание и редактирование учётных записей, назначение ролей и индивидуальных разрешений.
9.       Управление подрядной деятельностью — ведение реестров подрядчиков, государственных контрактов, участков обслуживания, кураторов и ответственных исполнителей.
10.   Хранение нормативной документации — загрузка, поиск и просмотр документов, привязанных к конкретным дорогам.
11.   Экспорт данных — выгрузка сведений об объектах, событиях и организациях в форматы Excel и PDF.

3.   Описание экранных форм (разделов программы)
Программа построена по принципу однооконного приложения с переключением между разделами через верхнюю навигационную панель. Состав доступных разделов определяется ролью пользователя.
3.1.   Раздел «Карта»
Основной раздел. Отображает интерактивную карту на базе библиотеки OpenLayers.
Функциональные возможности:
·         Отображение объектов пяти типов (камеры, метеостанции, ТПИ/ЗПИ, ПУИД, заявки) в виде маркеров с цветовой индикацией статуса.
·         Кластеризация — автоматическое объединение близко расположенных маркеров в группы с агрегированным статусом (цвет кластера определяется наихудшим статусом входящих объектов). Расстояние кластеризации настраивается (20–200 пикселей), функция отключаема.
·         Фильтрация — включение/отключение отображения каждого типа объектов через боковую панель. Фильтры сохраняются между сессиями.
·         Поиск — полнотекстовый поиск по наименованию, адресу и дороге объекта любого типа с выделением результата на карте.
·         Погодные слои — наложение тайловых слоёв от сервиса OpenWeatherMap поверх карты. Доступные слои: температура, осадки, облачность, атмосферное давление, скорость ветра, снег. Пользователь выбирает тип слоя и дату/время (доступны архив с 2020 года и прогноз до +4 суток). При клике по карте отображается значение параметра в выбранной точке.
·         Слой трафика — наложение данных о загруженности дорог и дорожных событиях (ДТП, ремонтные работы и пр.) на основе тайлов Яндекс.Карт. Данные

обновляются автоматически каждые 2 минуты. При клике на дорожное событие отображаются подробности.
·         Слой дорог — отображение трасс с цветовой покраской по показателям интенсивности транспортного потока. Год данных выбирается пользователем.
·         Километровые столбы — отображение на карте при достаточном уровне масштабирования.
·         Оверлей скоростей — отображение текущих скоростных данных с ПУИД непосредственно на карте.
·         Уведомления метеослужбы — наложение предупреждений и уведомлений по погодным правилам.
·         Открытие карточки объекта по клику на маркер или элемент кластера.
·         Сохранение положения карты (центр, масштаб) между сессиями.
Боковая панель (Sidebar):
·         Счётчики объектов по типу и статусу с возможностью быстрой фильтрации.
·         Переключатели видимости слоёв.
·         Настройки карты.
·         Кнопки активации дополнительных функций.
3.2.   Раздел «Видеостена»
Предназначен для одновременного наблюдения за несколькими видеокамерами.
Функциональные возможности:
·         Отображение потокового видео с выбранных камер в сеточной компоновке.
·         Настройка количества камер в ряду (1–6).
·         Фильтрация камер по статусу (активные, предупреждение, неактивные), по дороге и региону.
·         Выбор камер для отображения — вручную или через массовое добавление по фильтру.
·         Режим автопрокрутки — автоматическое листание камер с настраиваемой скоростью.
·         Режим архива — просмотр исторических снимков с выбором камеры и временного диапазона.
·         Настройка интервала обновления изображения для каждой камеры (1–60 минут).
·         Редактирование параметров камеры: наименование, интервал обновления, чувствительность.
·         Все настройки видеостены сохраняются между сессиями.
3.3.   Раздел «Метеостена»
Предназначен для мониторинга метеорологических данных со всех станций в табличном виде.
Функциональные возможности:
·         Таблица с текущими показателями всех активных метеостанций: температура воздуха и дорожного покрытия, относительная влажность, скорость ветра, атмосферное давление, видимость, осадки.
·         Организация данных по дорогам и километровым постам.

·         Цветовая сигнализация — ячейки с показателями, нарушающими пороговые значения, выделяются в соответствии с уровнем критичности (критический, предупредительный, информационный).
·         Режим архива — просмотр исторических данных за выбранный период.
·         Автоматическое обновление данных каждые 10 минут (синхронизировано с системным временем).
·         Панель уведомлений с перечнем активных погодных предупреждений.
Настройка погодных правил (только для администраторов и ЦУП):
·         Создание, редактирование и удаление правил проверки метеопоказателей.
·         Настройка условий (порог, операция сравнения, параметр).
·         Настройка уровня критичности и текста уведомления.
·         Привязка изображений к правилам для автоматического применения на ТПИ.
3.4.   Раздел «Устройства»
Табличное представление всех объектов мониторинга.
Функциональные возможности:
·         Отображение устройств всех типов (камеры, ТПИ/ЗПИ, метеостанции, ПУИД) в единой таблице.
·         Фильтрация по типу устройства, статусу, дороге.
·         Сортировка по дороге и километровому посту.
·         Открытие подробной карточки устройства.
·         Экспорт в Excel — выгрузка текущего списка с фильтрами в файл формата xlsx.
3.5.   Раздел «Заявки»
Система регистрации и сопровождения заявок о нарушениях и неисправностях.
Функциональные возможности:
·         Список заявок с пагинацией (50 записей на странице).
·         Фильтрация по статусу, типу нарушения, дате создания, дороге, источнику.
·         Сортировка по любому полю (по возрастанию/убыванию).
·         Создание заявки — через форму или через выбор точки на карте.
·         Редактирование заявки — изменение полей, смена статуса, назначение исполнителя, ответственного, подрядчика, плановой даты исполнения.
·         Прикрепление файлов — загрузка и просмотр документов, фотографий и иных материалов к заявке.
·         Переписка — встроенная система комментариев по каждой заявке.
·         Экспорт в Excel — выгрузка отфильтрованного списка заявок.
Жизненный цикл заявки (7 статусов):
 

Вкладки раздела «Заявки»:
·         Заявки — основной список с фильтрацией и управлением.
·         Подрядчики — реестр подрядных организаций (CRUD).
·         Контракты — реестр государственных контрактов с привязкой к участкам обслуживания (CRUD).
·         Кураторы — назначение кураторов на участки (CRUD).
·         Сроки — управление нормативными сроками исполнения по видам нарушений.
3.6.   Раздел «Документы»
Хранилище нормативной и технической документации, проектов организации дорожного движения.
Функциональные возможности:
·         Загрузка файлов (PDF, изображения, иные форматы).
·         Поиск по наименованию документа.
·         Фильтрация по дороге.
·         Просмотр PDF и изображений непосредственно в браузере.
·         Скачивание файлов.
·         Редактирование и удаление (только для администраторов и ЦУП).
3.7.   Раздел «Пользователи»
Управление учётными записями (доступен только администратору).
Функциональные возможности:
·         Список пользователей с указанием роли и статуса.
·         Создание нового пользователя.
·         Редактирование данных пользователя: ФИО, имя пользователя, роль, доступные регионы.
·         Назначение индивидуальных разрешений (доступ к видеостене, метеостене).
·         Смена пароля.
·         Удаление учётной записи.

4.   Карточки объектов (модальные окна)
При клике на объект на карте, в списке или кластере открывается детализированная карточка.
4.1.   Карточка видеокамеры
·         Наименование, адрес, дорога, направление.
·         Статус с индикатором времени последнего сигнала.
·         Изображение с камеры в реальном времени.
·         Увеличение изображения.
·         Дополнительная информация (только для администраторов).

4.2.   Карточка метеостанции (АСМО)
·         Наименование, адрес, дорога, статус.
·         Таблица текущих метеопоказателей с единицами измерения.
·         Дополнительная информация (только для администраторов).
4.3.   Карточка знака переменной информации (ТПИ/ЗПИ)
·         Наименование, адрес, дорога, статус, направление.
·         Просмотр текущего сценария отображения.
·         Управление изображениями — загрузка, удаление, предпросмотр, создание изображения из текста.
·         Редактор сценария — последовательность слайдов с изображениями и интервалами отображения.
·         Сохранение сценариев — сохранение в библиотеку шаблонов для повторного использования.
·         Выбор из библиотеки — применение сохранённого сценария к устройству.
·         Копирование сценария — перенос сценария с одного ТПИ/ЗПИ на другие.
·         Дополнительная информация (только для администраторов).
4.4.   Карточка ПУИД
·         Наименование, адрес, дорога, статус.
·         Данные последнего отчёта: скорость по полосам, интенсивность движения.
·         Дополнительная информация (только для администраторов).
4.5.   Карточка заявки
·         Полные реквизиты заявки: тип нарушения, адрес, дата создания, статус.
·         Назначение исполнителя, ответственного должностного лица, подрядчика.
·         Дата планового исполнения.
·         Список прикреплённых файлов с возможностью загрузки и просмотра.
·         Блок переписки (комментарии по заявке).
·         Смена статуса (в соответствии с правами роли пользователя).
·         Сохранение изображения заявки с информацией.
5.   Роли пользователей и разграничение доступа5.1.   Перечень ролей

5.2.   Матрица доступа к разделам


Примечание: доступ к видеостене и метеостене может быть предоставлен ролям ЦУП подрядчика и Исполнитель индивидуальным разрешением администратора.
5.3.   Ограничения по работе с заявками
Переходы между статусами заявок ограничены ролью пользователя:

5.4.   Ограничения по управлению ТПИ
Управление сценариями знаков переменной информации (создание, редактирование, применение) доступно ролям: Администратор, ЦУП, Куратор. Роли ЦУП подрядчика и Исполнитель данная функция недоступна.
5.5.   Фильтрация данных по роли
·         Куратор — видит только заявки, относящиеся к закреплённым за ним участкам дороги.
·         ЦУП подрядчика — видит только заявки, привязанные к контрактам своей организации.
·         Исполнитель — видит только заявки, назначенные лично ему.
6.   Типы устройств и статусная модель6.1.   Типы объектов мониторинга


6.2.   Статусы технических устройств
Видеокамеры (определяется по времени последнего сигнала):

Метеостанции, ТПИ/ЗПИ, ПУИД (определяется по полю active):

7.   Используемые технические средства7.1.   Серверная инфраструктура
Программа является клиентским веб-приложением и взаимодействует с тремя серверными системами:

7.2.   Требования к клиентскому устройству
·         Браузер: Chrome 90+, Firefox 90+, Safari 15+, Edge 90+ (с поддержкой ES2020 и CSS Grid).
·         Разрешение экрана: от 375 пикселей в ширину (оптимально — 1280×720 и выше).
·         Интернет-соединение: требуется постоянное подключение для получения данных в реальном времени.
7.3.   Поддержка мобильных устройств
Программа адаптирована для работы на мобильных устройствах и планшетах. Контрольные разрешения:
·         375 пикселей (смартфон, портретная ориентация)
·         768 пикселей (планшет)
·         1024 пикселей (планшет в альбомной ориентации, небольшой ноутбук)
На мобильных устройствах боковая панель сворачивается, модальные окна занимают до 95% ширины экрана, таблицы переходят в режим горизонтальной прокрутки или карточного отображения.

8.   Вход в систему и аутентификация8.1.   Способ аутентификации
Для входа в систему пользователь вводит имя пользователя и пароль. После успешной проверки учётных данных сервер возвращает токен доступа (JWT), который сохраняется в локальном хранилище браузера и используется для авторизации всех последующих запросов.
8.2.   Управление сессией
·         Токен хранится в localStorage браузера.
·         При закрытии и повторном открытии браузера сессия восстанавливается автоматически (если токен не истёк).
·         Выход из системы очищает токен и возвращает пользователя на страницу входа.
9.   Входные данные
Система получает следующие категории входных данных:

10.   Выходные данные
Система формирует следующие категории выходных данных:



11.   Хранение пользовательских настроек
Следующие параметры сохраняются в локальном хранилище браузера (localStorage) и восстанавливаются при следующем сеансе:
·         положение и масштаб карты;
·         состояние фильтров видимости объектов;
·         настройки кластеризации;
·         выбранные слои погодных оверлеев;
·         настройки видеостены (список камер, количество в ряду, скорость прокрутки);
·         параметры фильтрации заявок;
·         активный раздел приложения.
12.   Показатели производительности и надёжности
·         Автоматическое обновление метеоданных каждые 10 минут.
·         Автоматическое обновление погодных уведомлений каждые 60 секунд.
·         Кэширование изображений ТПИ с TTL 15 минут, параллельная предзагрузка (до 3 изображений одновременно).
·         Постраничная загрузка списка заявок (50 записей на страницу) для снижения нагрузки.
·         Фильтрация километровых столбов по уровню масштабирования для оптимизации отрисовки карты.
·         При сбое соединения с сервером данные заменяются пустыми массивами без краша интерфейса.