mirror of
https://github.com/Matysh/houseplan-card
synced 2026-09-29 03:09:36 +00:00
Диалог «Оптимизировать» при отказе перечисляет причину по каждому пространству (7 значений OptimizeGeometryFailureReason получили RU/EN строки), даёт «Скопировать диагностику» — JSON-блок с origin: runtime, версией карточки, отпечатками и классами исключений (граница приватности checkOptimizeGeometry; privacy-тесты дополнены позитивной проверкой) — и пишет одну структурированную запись в dev-лог (дедупликация по fingerprint). При недоступном clipboard блок раскрывается прямо в диалоге. Совет «обновите House Plan» больше не безусловный: websocket houseplan/config/get теперь возвращает integration_version (бэкенд-тест), и подсказка показывается только при реальном расхождении с версией карточки; старый бэкенд без поля — подсказки нет. Три новых мутанта (потеря причины в диалоге, блок без reason, отключённый dev-лог) — краснота каждого проверена исполнением; смок smoke_preflight_diagnostics на dev падает. Issue: #295 User-Visible: yes
Документация House Plan
Этот каталог — точка входа в русскоязычную документацию House Plan.
Сверено с версией v1.60.0. Продукт с тех пор ушёл вперёд (линия 1.64); при расхождении этого каталога с
docs/USER-GUIDE.ru.mdи changelog верить им. Пересверка каталога — отдельная документационная задача.
| Документ | Для кого | Что внутри |
|---|---|---|
| Полное руководство пользователя | Пользователи и администраторы Home Assistant | Установка, первая настройка, пространства, комнаты, стены, проёмы, устройства, визуальные состояния, заливки, подложка, солнце, пылесосы, киоск, обслуживание и диагностика |
| Редактор подложки и декора | Пользователи, тестировщики и разработчики | Инструменты, единое выделение и трансформации, физические размеры, магнит, Undo/Redo, поведение картинки-подложки и совместимость старых полей |
| GitHub Issues и Project v2 | Владелец, разработчики и контрибьюторы | Единственный актуальный backlog: задачи, приоритеты, решения и статусы выполнения |
Старые тематические документы в этом каталоге остаются инженерными спецификациями и историей решений. При расхождении пользовательского описания с интерфейсом текущей версии приоритет имеет новое руководство, а при расхождении с фактическим поведением — код текущей версии.
Неактуальные снимки аудитов, отклонённые проекты и одноразовые диагностические материалы собраны в архиве legacy.