Конфигуратор

Назначение

Конфигуратор — это центральный модуль управления системой. Через него администратор настраивает подключение к базе данных, управляет модулями, задаёт параметры языковой модели, настраивает тарифы и счётчики, редактирует системные промпты и просматривает документацию.

Конфигуратор доступен только пользователям с правами администратора или инженера. Изменения, сделанные в конфигураторе, сохраняются в файл конфигурации и применяются после перезапуска системы (для большинства настроек) или немедленно (для тарифов и промптов).

Возможности

► Настройка подключения к базе данных (адрес, порт, имя, пользователь, пароль)

► Управление модулями: включение и отключение функциональных модулей

► Настройка города и географических координат объекта

► Настройка параметров языковой модели (модель, температура, максимальная длина ответа)

► Управление тарифами на энергоресурсы

► Привязка счётчиков к тегам телеметрии

► Редактирование системных промптов языковой модели

► Просмотр встроенной документации

Как пользоваться

Раздел «Система»

Настройка подключения к базе данных

Откройте «Конфигуратор» → раздел «Система».
В блоке «База данных (PostgreSQL)» укажите:
Хост: адрес сервера базы данных
- Если база данных на том же сервере, что и система: host.docker.internal
- Если база данных на удалённом сервере: прямой IP-адрес или host.docker.internal с пробросом порта
Порт: порт, на котором слушает база данных (обычно 5432 или 5433)
Имя базы: имя базы данных с телеметрией
Пользователь: имя пользователя для подключения
Пароль: пароль пользователя
Нажмите «Сохранить».
Перезапустите систему: stop.bat → start.bat (или ./stop.sh → ./start.sh на Linux).
После перезапуска проверьте статус подключения в боковой панели: индикатор рядом с «БД» должен стать зелёным.

Настройка города и координат

В разделе «Система» найдите блок «Местоположение».
Укажите:
Город: название города (например, «Москва», «Екатеринбург», «Нижний Тагил»)
Широта и Долгота: географические координаты объекта
Часовой пояс: определяется автоматически по долготе, но можно указать вручную
Нажмите **«Сохранить»».
Координаты используются для:
Определения светлого и тёмного времени суток (для оценки энергоэффективности освещения)
Привязки к часовому поясу (для корректного отображения времени)
Интерпретации погодных условий в ответах языковой модели

Настройка параметров языковой модели

В разделе «Система» найдите блок «Языковая модель».
Укажите:
Модель: версия языковой модели (по умолчанию используется актуальная версия)
Температура: степень креативности ответов (0.0 — строго фактические ответы, 1.0 — более творческие)
- Для технических ответов рекомендуется 0.05-0.1
- Для более свободных ответов — 0.3-0.5
Максимальная длина ответа: максимальное количество токенов в ответе (по умолчанию 32000)
Таймаут: максимальное время ожидания ответа от модели (по умолчанию 30 секунд)
Нажмите **«Сохранить»».
Изменения применяются немедленно, перезапуск не требуется.

Раздел «Модули»

Включение и отключение модулей

Откройте «Конфигуратор» → раздел «Модули».
Вы увидите список всех доступных модулей:
Здоровье — мониторинг состояния здания (базовый, не отключается)
Аналитика — тренды и прогнозы
Глубокий анализ — детекция аномалий, сезонный анализ, сравнение
Энергоучёт (электричество) — учёт электроэнергии
Энергоучёт (вода) — учёт воды
Энергоучёт (тепло) — учёт тепла
Системные журналы — просмотр логов
Для каждого модуля есть переключатель:
Включён: модуль активен, доступен в интерфейсе
Выключен: модуль не загружается, не отображается в интерфейсе
Нажмите на переключатель для изменения состояния.
Нажмите «Сохранить».
Перезапустите систему для применения изменений.

Когда отключать модули

Если модуль не используется на вашем объекте (например, нет счётчиков тепла — отключите модуль «Энергоучёт (тепло)»)
Если нужно ускорить запуск системы (меньше модулей — быстрее загрузка)
Если модуль временно не нужен для обслуживания

Важное ограничение

Модуль «Здоровье» является базовым и не может быть отключён. Он обеспечивает минимальный мониторинг состояния системы и нужен для работы остальных модулей.

Нельзя отключить все модули одновременно. Система должна иметь хотя бы один активный модуль.

Раздел «Тарифы»

Настройка тарифов на энергоресурсы

Откройте «Конфигуратор» → раздел «Тарифы».
Для каждого ресурса укажите тариф:
Электроэнергия: стоимость за кВт·ч
- Если тариф интервальный: укажите тариф «День» и тариф «Ночь», а также границы интервалов
Вода: стоимость за м³
Тепло: стоимость за Гкал
Нажмите **«Сохранить»».
Тарифы применяются немедленно. Перезапуск системы не требуется.

Пример интервального тарифа для электроэнергии

Параметр	Значение
Тариф «День»	6.50 руб/кВт·ч
Тариф «Ночь»	2.80 руб/кВт·ч
Начало дневного интервала	07:00
Конец дневного интервала	23:00

Система будет автоматически определять, к какому интервалу относится каждое показание счётчика, и рассчитывать стоимость по соответствующему тарифу.

Раздел «Счётчики»

Привязка счётчиков к тегам телеметрии

Откройте «Конфигуратор» → раздел «Счётчики».
Вы увидите список настроенных счётчиков.
Для каждого счётчика указан:
Тип ресурса: электроэнергия, вода, тепло
Тег телеметрии: имя тега в базе данных, из которого читаются показания
Единицы измерения: кВт·ч, м³, Гкал
Статус: активен / нет данных
Для добавления нового счётчика:
Нажмите «Добавить счётчик»
Выберите тип ресурса
Выберите тег телеметрии из списка доступных тегов
Укажите единицы измерения
Нажмите «Сохранить»
Для изменения привязки существующего счётчика:
Нажмите на счётчик
Измените тег или единицы измерения
Нажмите «Сохранить»

Раздел «Промпты»

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

Откройте «Конфигуратор» → раздел «Промпты».
Вы увидите список системных промптов, которые используются языковой моделью для формирования ответов.
Каждый промпт содержит:
Название: краткое описание назначения промпта
Текст: сам промпт (инструкция для модели)
Для редактирования:
Нажмите на промпт
Измените текст
Нажмите «Сохранить»
Изменения применяются немедленно. Перезапуск не требуется.

Когда редактировать промпты

Если ответы модели не соответствуют вашим ожиданиям
Если нужно добавить специфические инструкции для вашего объекта
Если нужно изменить стиль ответов (более формальный или более свободный)

Важное предупреждение

Редактируйте промпты осторожно. Некорректный промпт может привести к некорректным ответам модели. Перед изменением сохраните исходный текст промпта в отдельный файл, чтобы можно было вернуть его при необходимости.

Раздел «Документация»

Просмотр встроенной документации

Откройте «Конфигуратор» → раздел «Документация».
Вы увидите список доступных документов:
Руководство по установке
Описание модулей
Часто задаваемые вопросы
История изменений
Нажмите на документ для просмотра.
Документация открывается во встроенном просмотрщике.

Что вы видите на экране

Структура экрана «Конфигуратор»:

Боковая панель разделов - Система - Модули - Тарифы - Счётчики - Промпты - Документация

Центральная область - Форма настроек для выбранного раздела - Кнопки «Сохранить» и «Отменить» - Индикатор статуса: «Сохранено» / «Есть несохранённые изменения»

Верхний блок - Заголовок текущего раздела - Краткое описание раздела

Практические советы

Сохраняйте резервную копию настроек. Перед изменением критичных настроек (база данных, модули) сохраните текущие значения в отдельный файл. Это позволит вернуть настройки при ошибке.

Изменяйте настройки последовательно. Не меняйте несколько параметров одновременно. Измените один параметр, сохраните, проверьте результат, затем переходите к следующему.

Проверяйте подключение к базе данных после изменения. Если вы изменили адрес, порт или пароль базы данных, обязательно проверьте подключение после перезапуска. Если подключение не устанавливается, проверьте правильность введённых данных.

Отключайте неиспользуемые модули. Если на вашем объекте нет счётчиков тепла или воды, отключите соответствующие модули. Это ускорит запуск системы и упростит интерфейс.

Не редактируйте промпты без необходимости. Системные промпты настроены оптимально для большинства сценариев. Редактируйте их только если вы точно понимаете, что хотите изменить.

Координаты важны для энергоэффективности. Если координаты указаны неверно, система будет неправильно определять светлое и тёмное время суток, и оценка энергоэффективности освещения будет некорректной.

Перезапускайте систему после изменения критичных настроек. Настройки базы данных, модулей и города требуют перезапуска. Тарифы и промпты применяются немедленно.

Частые вопросы и ответы

Вопрос: Я изменил настройки, но они не применились. Что делать? Проверьте: 1. Нажали ли вы кнопку «Сохранить» после изменения 2. Требуется ли перезапуск системы для применения изменений (настройки БД, модулей, города — требуют; тарифы и промпты — не требуют) 3. Правильно ли введены данные (особенно адрес и порт базы данных)

Вопрос: Я отключил модуль, но он всё ещё отображается в интерфейсе. Почему? Для применения изменений модулей требуется перезапуск системы. Выполните stop.bat → start.bat (или ./stop.sh → ./start.sh на Linux). После перезапуска отключенный модуль исчезнет из интерфейса.

Вопрос: Можно ли изменить настройки без прав администратора? Нет. Конфигуратор доступен только пользователям с правами администратора или инженера. Пользователи с правами оператора и руководителя не имеют доступа к конфигуратору.

Вопрос: Я забыл пароль от базы данных. Что делать? Обратитесь к администратору базы данных для восстановления пароля. Система не хранит пароли в открытом виде и не может восстановить их самостоятельно.

Вопрос: Можно ли вернуть настройки по умолчанию? Да. Удалите файл конфигурации data/system_config.json и перезапустите система. При запуске система создаст новый файл с настройками по умолчанию. Внимание: это сбросит все ваши настройки (база данных, тарифы, модули).

Вопрос: Изменения в конфигураторе влияют на всех пользователей? Да. Настройки, сделанные в конфигураторе, являются общими для системы и влияют на всех пользователей. Индивидуальные настройки пользователей (например, тема интерфейса) хранятся отдельно.