Files
houseplan-card/docs/specs
2026-08-17 13:16:04 +03:00
..
2026-08-09 21:51:33 +03:00
2026-08-09 21:51:33 +03:00
2026-08-09 21:51:33 +03:00
2026-08-09 21:51:33 +03:00
2026-08-09 21:51:33 +03:00
2026-08-17 12:19:58 +03:00

Спецификации задач P1 и P2

Актуально на 2026-08-17.

GitHub Issues и GitHub Projects (v2) остаются единственным каноническим backlog проекта. Этот каталог содержит развёрнутые ТЗ: каждое ТЗ ссылается на issue, а issue — на соответствующий файл. Статус, приоритет и факт завершения меняются только в GitHub.

Статусы ТЗ:

  • готово к реализации — продуктовые решения зафиксированы, остаётся техническая работа;
  • черновик решения — в ТЗ дана рекомендация, но перед реализацией требуется принять отмеченные продуктовые решения;
  • в реализации — работа уже ведётся в рамках текущего этапа;
  • реализовано — ТЗ сохранено как проверяемый acceptance contract.

Обязательные release-артефакты номерного ТЗ

Если задача меняет пользовательское поведение, её ТЗ обязано явно перечислить:

  • записи в docs/CHANGELOG.md и docs/CHANGELOG.ru.md;
  • затронутую пользовательскую документацию;
  • требуемые screenshots/golden и способ их review, если меняется визуал;
  • release/performance/security artifacts, если они входят в acceptance gate.

Отсутствие этого раздела не означает, что документация необязательна. Для чистого refactoring ТЗ должно прямо зафиксировать отсутствие пользовательских изменений и перечислить технические доказательства безопасного поведения.

P1

Issue ТЗ
#6 Vacuum XCME path segments 006-vacuum-xcme-path.md
#7 Valetudo room outlines 007-vacuum-valetudo-room-outlines.md
#8 Vacuum support docs and XCME hint 008-vacuum-support-docs-xcme-hint.md
#27 External vacuum source picker 027-vacuum-external-source-picker.md
#28 Room View card 028-room-view-card.md
#29 Device inbox lifecycle 029-device-inbox-lifecycle.md
#30 Dialog information architecture 030-dialog-information-architecture.md
#31 View accessibility 031-view-accessibility.md
#32 Unified danger confirmation 032-unified-danger-confirmation.md
#33 Config schema lifecycle 033-config-schema-lifecycle.md
#34 Frontend decomposition 034-frontend-decomposition.md
#35 Current UX documentation 035-current-ux-docs.md
#50 Экспорт и импорт конфигурации 050-config-export-import.md
#58 Vacuum integration coverage — Stage 1 058-vacuum-stage1.md
#89 Опциональный объёмный 2.5D/изометрический вид 089-isometric-view.md
#89 Этап 1: объёмный вид за флагом Labs 089-isometric-view-stage1.md
#98 Единая система пульсаций и активностей устройства 098-device-pulse-system.md
#131 Полный первый кадр View у read-only-пользователя 131-readonly-cold-start.md
#138 Автозамыкание комнаты по существующей стене 138-adjacent-room-autoclose.md
#146 Четырёхфазный фон «Следует за Солнцем» 146-four-phase-sun-background.md
#156 Регрессии Full Performance перед v1.64.0 stable 156-full-performance-regressions.md
#164 Активный цикл стиральной машины должен быть жёлтым 164-washer-active-cycle.md
#166 Солнечные лучи зеркально учитывают направление севера 166-sun-north-rotation.md
#167 Экспорт «только планировка» 167-plan-only-export.md

P2

Issue ТЗ
#10 Roomba live position 010-vacuum-roomba-live-position.md
#11 Vacuum source health 011-vacuum-source-health.md
#12 Room cleaning highlight 012-vacuum-room-cleaning-highlight.md
#13 Golden open context tray 013-golden-open-context-tray.md
#19 Additive Glow blending 019-glow-additive-blending.md
#20 Glow through open doors 020-glow-open-door-spill.md
#21 Safe color CSS variables 021-color-css-injection.md
#36 Room Glow override 036-room-glow-override.md
#37 Room scale system 037-room-scale-system.md
#38 Icon rule builder 038-icon-rule-builder.md
#39 Large backdrops 039-large-backdrops.md
#40 Floors/Areas onboarding 040-floor-area-onboarding.md
#41 Keyboard object editing 041-keyboard-object-editing.md
#42 Backend engineering quality 042-backend-engineering-quality.md
#43 Private support report 043-private-support-report.md
#44 Filtering/grouping policy 044-filter-grouping-policy.md
#51 Custom decor images 051-custom-decor-images.md
#52 Dimensions in View 052-view-dimensions.md
#54 Zigbee topology overlay 054-zigbee-topology-overlay.md
#55 Independent Glow overlay 055-independent-glow-overlay.md
#56 Static room color 056-static-room-color.md
#68 Подсказки к настройкам 068-help-affordance.md
#75 + #76 Единый поток размещения проёмов 075-076-opening-placement-flow.md
#84 Источник «Всегда» без сущности HA + #88 ведущая сущность 084-passive-forced-light-sources.md
#90 Управляемый бейдж со значением 090-device-value-badge.md
#94 Универсальное действие «Переключить состояние» 094-universal-state-toggle.md
#101 Плавный переход View ↔ редакторы 101-view-editor-transition.md
#107 Переключение виртуального источника света «Всегда» 107-virtual-light-toggle.md
#122 Изометрический режим Stage 2: скрытый режим и визуальная полировка 122-isometric-stage2.md
#123 Split из вершины не меняет наружную геометрию стен 123-corner-split-wall.md
#137 Узлы и линии привязки в редакторе Плана 137-plan-snap-overlay.md
#141 Бесшовные стыки перегородок и открытых контуров 141-wall-junctions.md

Правило актуализации

При изменении продуктового решения сначала обновляется соответствующее issue, затем ТЗ. Реализация не считается завершённой только по наличию кода: нужны выполненные acceptance criteria, предусмотренная ТЗ проверка и актуальный статус Project v2.