mirror of
https://github.com/Matysh/houseplan-card
synced 2026-10-02 04:38:55 +00:00
Codexandclaude[bot]
0c74b2fc4f
#340/#356 made expected_rev mandatory for config/set and layout/set over a non-empty store — an honest protection the release notes sold only as a stale-tab guard. A third-party script writing plans directly cannot infer from "protects from stale tabs" that it must now read the revision first. Both changelogs gain an explicit breaking-for-external-writers entry with the read-then-write recipe; ARCHITECTURE.md's WS contract section extends the #340 paragraph with the cycle external clients must follow (get rev → send expected_rev → on conflict re-read and retry); and both conflict messages now carry the actionable hint for scripts — "include expected_rev from houseplan/config/get / layout/get" — alongside the tab-oriented "reload" advice. The backend tests pin only the "revision is required" substring and stay untouched. Issue: #368 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.