feat: коррекция значений контролов виджетов

[ilyatikhonyuk]

Описание

Добавлена функция коррекции значений для контролов виджетов. Позволяет пользователю задать формулу преобразования отображаемого значения прямо в редакторе виджетов.

Зачем это нужно

Контролы Wiren Board отдают значения в системных единицах (милливольты, байты, °C). На практике пользователям часто нужны другие единицы — вольты, гигабайты, °F. Особенно актуально для объектов в ЕС, где используется Фаренгейт и другие локальные стандарты.

До этого изменения для пересчёта приходилось писать правила в wb-rules вручную. Теперь — галочка и формула в редакторе виджета.

Примеры использования

Задача	Формула	Единицы
мВ → В	/ 1000	В
°C → °F	* 1.8, + 32	°F
байт → ГБ	/ 1024	GB
Масштабирование	* 500, / 1000	—

---

Скриншоты

Тестовый виджет на панели (дашборде)

Виджет с различными типами коррекции: перевод единиц, цепочки формул, отключённая коррекция, нечисловые типы контролов.

Редактор виджета — настройка коррекции

Верхняя часть: колонка «Коррекция» с чекбоксами, раскрытые панели формул.

Нижняя часть: нечисловые типы (switch, text, pushbutton) с прочерками вместо коррекции.

Страница «Устройства» — каналы коррекции

Скорректированные каналы появляются рядом с оригинальными: A1_corrections, CPU Temperature_corrections, ram_used_corrections и другие.

Канал Vin_corrections в блоке «Статус питания»: оригинал 24.2 В → скорректированное 0.0242 kV.

)

---

Что изменено

1. Утилита коррекции (frontend/src/utils/correction.ts)

• Парсер формул с поддержкой операций * / + -
• Цепочки операций: * 1.8, + 32 (запятые как разделители)
• Валидация: пустая формула, деление на ноль, невалидный формат
• Применение формулы к числовому значению

2. Отображение значений (frontend/src/components/cell/)

• CellValue применяет формулу к значению через useMemo
• Пользовательские единицы измерения заменяют оригинальные
• Коррекция передаётся через цепочку: страница → Cell → CellValue

3. Редактор виджетов (frontend/src/pages/dashboards/.../widget-edit/)

• Колонка «Коррекция» для числовых типов контролов
• Чекбокс включения/выключения (для нечисловых типов — прочерк)
• Раскрывающаяся панель с полями «Формула» и «Единицы измерения»
• Валидация формулы в реальном времени
• Ошибки блокируют сохранение виджета

4. CSS-сетка (styles.css)

• Адаптивная сетка для всех комбинаций колонок
• Заголовки переносят слова вместо обрезания (поддержка длинных переводов)

5. Переводы (EN/RU)

• Подписи: Correction/Коррекция, формула, единицы, плейсхолдеры
• Ошибки валидации на обоих языках

6. Серверный скрипт (wb-corrections.js)

• Скрипт для wb-rules (Duktape, ES5)
• Создаёт MQTT-топики {control}_corrections с readonly значениями
• Правила создаются один раз, формулы читаются из глобальной карты
• Автоматический опрос конфига каждые 5 секунд
• Дедупликация: один контрол = одна коррекция
• Двухуровневое логирование: log.info (общее) + log.debug (детали)
• Стиль кода соответствует системным скриптам Wiren Board

---

Типы данных

interface CorrectionConfig {
  enabled: boolean;    // включена ли коррекция
  formula: string;     // формула: "* 2, / 1000, + 5"
  units?: string;      // кастомные единицы (опционально)
}

Хранится в widget.cells[].extra.correction в /etc/wb-webui.conf.

---

MQTT-топики (серверная часть)

Для каждого контрола с включённой коррекцией создаётся readonly топик:

/devices/power_status/controls/Vin           → 24200 (оригинал)
/devices/power_status/controls/Vin_corrections → 24.2  (скорректированное)

Скорректированные топики можно использовать в сценариях автоматизации.

---

Развёртывание

Фронтенд:

cd frontend && npm run build
# Скопировать frontend/dist/* → /var/www/ на контроллере

Серверный скрипт:

# Скопировать wb-corrections.js → /etc/wb-rules/wb-corrections.js
# wb-rules подхватит автоматически (hot-reload)

---

Тестирование

Проверено на контроллере WB8.5.3 (wb-2507, wb-rules 2.34.0):

• Формулы: простые (/ 1000), цепочки (* 1.8, + 32), с запятыми
• Типы контролов: voltage, temperature, value, range
• Нечисловые типы (switch, text, pushbutton) — коррекция недоступна
• Дедупликация при одном контроле в нескольких виджетах
• Отключённая коррекция — формула не применяется
• Валидация: пустая формула, деление на ноль, невалидный формат
• Локализация: EN и RU корректно отображаются
• MQTT: скорректированные топики создаются и обновляются
• Перезагрузка контроллера: скрипт стартует автоматически

🤖 Generated with Claude Code