Руководство администратора системы

1. Назначение и полномочия роли Администратор

Пользователи с ролью Admin наделены расширенными правами управления инфраструктурой платформы «UrFU HeatBalance». Им доступны специализированные разделы «Панель администратора» (/admin) и «Предиктивная аналитика» (/analytics).

---

2. Мониторинг работоспособности микросервисов (Healthchecks)

Вкладка «Мониторинг сервисов» осуществляет непрерывный опрос конечных точек /health всех компонентов распределённой системы:

Сервис	Порт	Проверяемые зависимости	Критерий статуса Healthy
HeatBalance.Gateway	:5000	Внутренняя сеть YARP	Успешная маршрутизация входящих пакетов
HeatBalance.Auth	:5001	PostgreSQL (heat_balance_auth)	Доступность таблиц OpenIddict и Identity
HeatBalance.DatasetService	:5002	PostgreSQL + Redis 7.0 + RabbitMQ	Запись/чтение кэша и доставка сообщений
HeatBalance.ChamberKilnService	:5003	Вычислительное ядро .NET 10	Время расчёта теплового баланса $\le 50$ мс
HeatBalance.ConveyorKilnService	:5004	Вычислительное ядро .NET 10	Время расчёта теплового баланса $\le 50$ мс
HeatBalance.ElectricKilnService	:5005	Вычислительное ядро .NET 10	Время расчёта теплового баланса $\le 50$ мс
HeatBalance.DrumDryerService	:5006	Вычислительное ядро .NET 10	Время расчёта теплового баланса $\le 50$ мс
HeatBalance.RunService	:5007	PostgreSQL (heat_balance_runs)	Доступность таблицы журнала расчётов
HeatBalance.ReportService	:5008	Движок QuestPDF / SkiaSharp	Генерация тестовой страницы PDF $\le 200$ мс
HeatBalance.IoTService	:5009	PostgreSQL + RabbitMQ	Приём пакета телеметрии $\le 25$ мс
HeatBalance.AnalyticsService	:5010	Межсервисные клиенты REST API	Успешная агрегация данных $\le 300$ мс

Если один из сервисов сообщает о задержке свыше 2000 мс или возвращает ошибку подключения к базе данных, индикатор сервиса окрашивается в красный цвет со статусом Unhealthy.

---

3. Управление учётными записями и правами доступа

Вкладка «Пользователи» позволяет:

1. Просматривать реестр пользователей: список email, отображаемых имён, назначенных ролей и даты последней активности.
2. Назначать роли:
   • Для перевода инженера в статус администратора выберите пользователя и нажмите кнопку «Назначить роль Admin»;
   • Для отзыва административных полномочий переключите роль обратно в «User».
3. Блокировать доступ: деактивация учётной записи уволенных сотрудников или временных подрядчиков с немедленным аннулированием всех активных сессий (инвалидация refresh токенов).

---

4. Сквозной аудит цехового оборудования (IoT)

В отличие от стандартного пользователя, видящего только свои приборы, администратор имеет доступ ко всем зарегистрированным датчикам и технологическим группам предприятия:

• Инспекция сетевой активности: фильтрация датчиков по времени последнего контакта (LastSeenAt). Если датчик температуры или расхода не выходил на связь более 15 минут, система помечает его как Offline, что требует проверки кабельных трасс или цехового питания;
• Аудит токенов: просмотр и принудительный перевыпуск скомпрометированных токенов X-Device-Token для полевых шлюзов.

---

5. Использование модуля предиктивной аналитики

Администратор использует раздел «Аналитика» для стратегического управления энергоэффективностью завода:

5.1. Анализ глобального тренда

• Индикатор тренда (up / down / stable): сигнализирует о суммарном состоянии печного парка. Тренд down требует немедленного детального анализа по группам агрегатов;
• График SMA и МНК: визуализация долгосрочного дрейфа среднего КПД с подавлением случайных измерительных шумов.

5.2. Мониторинг технологических аномалий (Z-Score)

• В таблице аномалий администратор отслеживает события с высоким индексом отклонения ($|z| \ge 2.0$);
• События со статусом critical ($|z| \ge 3.0$) свидетельствуют об аварийной ситуации: прогаре футеровки стенки (скачок outerWallTemp), отказе нагревателей ТЭН (падение currentA) или нарушении горения (всплеск coPercentage). Администратор немедленно передает информацию сменному мастеру цеха.

5.3. Планирование планово-предупредительных ремонтов (ППР)

• На основе расчёта скорости деградации ($b$, %/сутки) модель вычисляет прогнозируемую дату достижения аварийного порога КПД ($\eta_{threshold} = 15.0\%$);
• При переходе уровня риска в категорию high (остаточный ресурс $< 30$ дней) администратор формирует заявку в отдел главного механика (ОГМ) и службу главного энергетика (СГЭ) на проведение тепловизионного обследования и закупку огнеупоров для перефутеровки.

---

6. Регламентные процедуры сопровождения

1. Очистка журналов телеметрии: при объёме таблицы TelemetryLogs свыше 5 миллионов записей рекомендуется запускать регламентную процедуру партиционирования по месяцам или архивации устаревших данных.
2. Контроль очередей RabbitMQ: через веб-консоль управления брокером (http://localhost:15672, логин/пароль по умолчанию: guest/guest) администратор контролирует длину очереди сообщений telemetry-received и save-run. В штатном режиме количество сообщений в очереди не должно превышать 100.
3. Мониторинг кэша Redis: контроль утилизации оперативной памяти ключами dataset:*. При достижении лимита памяти автоматически применяется политика вытеснения allkeys-lru.