mirror of
https://github.com/Matysh/houseplan-card
synced 2026-09-29 03:09:36 +00:00
Matysh
bc98116a31
Five times in this project a green test meant nothing was checked. The continuity smoke stayed green after the entire mechanism it guards was cut out. The golden scene created to protect doorway light was empty — 1,177 warm pixels against 107,119, all of them icons. The shadow smoke passed while no shadow was drawn. Each time the test had been written alongside the code, went green at once, and nobody ever asked whether it could go red. The gate makes that question routine. Each mutant is a few lines of patch that reproduce a known breakage, plus the name of the test that must fail on it. A worktree is patched, the bundle rebuilt, the guard run — and a guard that stays green fails the gate. Six mutants cover the holes documented in #85; the anchors are exact strings from today's source, so the registry cannot silently drift — a unit test that runs with the ordinary suite refuses a stale anchor. The full run rebuilds the bundle per mutant, so it lives in its own workflow, before a stable release and on a weekly schedule, not in Validate. The rules for new tests are written at the top of docs/TESTING.md, and the sixth of them is the cheapest: an assertion that reads back the property the code just set is not written at all. Issue: #85 User-Visible: no
Документация House Plan
Этот каталог — новая точка входа в русскоязычную документацию House Plan. Материалы ниже сверены с исходным кодом и интерфейсом версии v1.60.0.
| Документ | Для кого | Что внутри |
|---|---|---|
| Полное руководство пользователя | Пользователи и администраторы Home Assistant | Установка, первая настройка, пространства, комнаты, стены, проёмы, устройства, визуальные состояния, заливки, подложка, солнце, пылесосы, киоск, обслуживание и диагностика |
| Редактор подложки и декора | Пользователи, тестировщики и разработчики | Инструменты, единое выделение и трансформации, физические размеры, магнит, Undo/Redo, поведение картинки-подложки и совместимость старых полей |
| GitHub Issues и Project v2 | Владелец, разработчики и контрибьюторы | Единственный актуальный backlog: задачи, приоритеты, решения и статусы выполнения |
Старые тематические документы в этом каталоге остаются инженерными спецификациями и историей решений. При расхождении пользовательского описания с интерфейсом текущей версии приоритет имеет новое руководство, а при расхождении с фактическим поведением — код текущей версии.
Неактуальные снимки аудитов, отклонённые проекты и одноразовые диагностические материалы собраны в архиве legacy.