lighthub/RELEASE_PLAN_v4.6.0.md

RELEASE PLAN v4.6.0

Статус: подготовка (docs-фаза завершена 2026-10-02).

Что вошло в релизную линию с v4.5.2 (28 коммитов)

• Multivent (CH 18) — завершён, в продакшене
• Sprinkler (CH 23) — релиз
• CAN (full-featured driver, lightspot) — релиз с v4.4.0
• Rotary encoder (T:32) с профилями
• DRY-режим полива: переопределяет ON, персистентен; статусные публикации при старте/смене режима; FREEZE > DISABLE
• Mercury: длинный таймер сессии (uint32 pollingInterval)
• OTA на ESP (ArduinoOTA, partitions min_spiffs)

Готово (этап «документация и код», 2026-10-02)

• Аудит всей документации репо по коду; исправлены расхождения (типы каналов, суффиксы, команды, JSON-форматы, HTTP API)
• Импорт 16 страниц dokuwiki в репо (core/integrations/hardware) + снапшот wiki в documentation/reference/dokuwiki-2026-10-02/
• Перенос авторских docx: CAN (integrations/can_lightspot.md), Rotary Encoder (core/rotary_encoder.md); WIP-секции помечены «Не реализовано»
• Реструктуризация documentation/: core/ integrations/ modules/ hardware/ reference/; новый мастер-индекс documentation/README.md; удалены AI-артефакты (MIGRATION_GUIDE, START_HERE, COMPLETION_REPORT и пр.)
• CHANGELOG.md в корне (ex CHANGELOG_v2.md)
• EN-комментарии Doxygen по всем ключевым заголовкам (item, itemCmd, abstractch/in/out, inputs, utils, config, main, candriver, owTerm, ipmodbus, dmx, statusled, options, все modules/out_*, in_ccs811_hdc1080, colorchannel, bright)
• doxygen-docs/Doxyfile — относительные пути, main.md, PROJECT_NUMBER 4.6.0; генерация doxygen-docs/html (gitignored)
• lighthub.github.io (отдельная папка ~/dev/lighthub.github.io): index.md + doxygen/, git init (push — руками)
• Корневой README.md актуализирован (16 целей, CAN/sprinkler/multivent, ссылки)
• Контрольная компиляция due — SUCCESS

Осталось (следующие этапы / другие сессии)

1. GitHub Wiki (EN, полная версия)

• Порт актуальной документации в GitHub Wiki (EN): структура по documentation/README.md
• Источники: documentation/ (RU) + этот план; перевод, а не копирование

2. DokuWiki (RU)

• Обновить lazyhome.ru wiki: синхронизировать со снапшотом 2026-10-02 изменения (CAN 50 kbit/s, новые типы, sprinkler DRY-фичи, rotary encoder)
• Решить: wiki остаётся RU-источником, репо — каноническим

3. Сайт lighthub.github.io

• Push репо lighthub.github.io (папка ~/dev/lighthub.github.io)
• При желании: домен, CI-перегенерация doxygen (GitHub Actions) при изменениях кода

4. Релиз v4.6.0

1. pio run по всем 16 env (due, mega2560, mega2560slim, mega2560-optiboot, mega2560-5100, esp8266-wifi, esp32-wifi, esp32c3-wifi, lighthub21, m5stack, nrf52840, nrf52840-5500, controllino, stm32, stm32-enc2860, stm32-noip)
2. Бинарники в compiled/<target>/ (git) — или в GitHub Release assets
3. Тег v4.6.0 + GitHub Release с release notes (из CHANGELOG.md + этот план)
4. Проверить OTA-процедуру на живых устройствах

Как перегенерировать Doxygen

brew install doxygen           # 1.18+
doxygen doxygen-docs/Doxyfile  # из корня репо → doxygen-docs/html
cp -R doxygen-docs/html ~/dev/lighthub.github.io/doxygen
cd ~/dev/lighthub.github.io && git add -A && git commit -m "doxygen update" && git push