mirror of
https://github.com/Matysh/houseplan-card
synced 2026-09-29 03:09:36 +00:00
Claude
89950e9944
Внешний пользователь завёл #370 как баг: в houseplan-space-card нет теней от стен, хотя в houseplan-card они есть. Разбор показал, что кода это не касается — ограничение намеренное и записано в src/space-render.ts:353 («the compact card intentionally has no live radial pools»). visibilityPolygon из src/light-visibility.ts импортируют ровно два файла, houseplan-card.ts и houseplan-editor-runtime.ts; space-render.ts не импортирует его вовсе. Пулов нет, а тень существует только как форма пула — затенять нечего. Но претензия справедлива, просто адресована не туда. Единственная запись о намеренности жила в комментарии исходника, которого пользователь видеть не может, а руководство обещало обратное: «маркеры используют те же состояния, значения, тревоги и эффекты, что полный план» — про свет ни слова. В LIGHT.md про компактную карточку тоже не было ничего. Человек полез в код именно потому, что документация молчала, и сам корректно предположил, что это может быть намеренно. Теперь сказано в трёх местах: оба руководства и LIGHT.md, с причиной — пулы это самая дорогая часть отрисовки, у неё свой перф-воркфлоу и бюджеты, и компактная карточка платит за дешевизну именно ими. Issue: #370 User-Visible: no
Документация 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.