Files
houseplan-card/docs/specs/README.md
T
2026-08-13 13:53:54 +03:00

12 KiB

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

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

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 черновик: требуется a11y-проверка
#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 ТЗ на ревью, ревизия 3
#98 Единая система пульсаций и активностей устройства 098-device-pulse-system.md реализовано локально; ожидает prerelease/CI gate

P2

Issue ТЗ Статус ТЗ
#10 Roomba live position 010-vacuum-roomba-live-position.md черновик: требуется UX-решение
#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 реализовано в v1.61.0-beta.2
#20 Glow through open doors 020-glow-open-door-spill.md готово к реализации
#21 Safe color CSS variables 021-color-css-injection.md реализовано в v1.61.0-beta.1
#36 Room Glow override 036-room-glow-override.md черновик продуктового решения
#37 Room scale system 037-room-scale-system.md черновик migration semantics
#38 Icon rule builder 038-icon-rule-builder.md черновик data model
#39 Large backdrops 039-large-backdrops.md research-first
#40 Floors/Areas onboarding 040-floor-area-onboarding.md черновик fallback-политики
#41 Keyboard object editing 041-keyboard-object-editing.md prototype-first draft
#42 Backend engineering quality 042-backend-engineering-quality.md готово к реализации
#43 Private support report 043-private-support-report.md черновик privacy defaults
#44 Filtering/grouping policy 044-filter-grouping-policy.md готово к product review
#51 Custom decor images 051-custom-decor-images.md черновик: security dependencies
#52 Dimensions in View 052-view-dimensions.md готово к ревью
#54 Zigbee topology overlay 054-zigbee-topology-overlay.md research + adapter contract
#55 Independent Glow overlay 055-independent-glow-overlay.md реализовано в v1.61.0-beta.2; #61 — v1.61.0-beta.3
#56 Static room color 056-static-room-color.md реализовано в v1.61.0-beta.3
#68 Подсказки к настройкам 068-help-affordance.md выпущено в v1.62.0-beta.1; локально усилено после ревью
#75 + #76 Единый поток размещения проёмов 075-076-opening-placement-flow.md реализовано и локально отревьюено; ожидает prerelease/CI gate
#84 Источник «Всегда» без сущности HA + #88 ведущая сущность 084-passive-forced-light-sources.md реализовано локально вместе; ожидает prerelease/CI gate
#90 Управляемый бейдж со значением 090-device-value-badge.md реализовано локально; ожидает prerelease/CI gate
#94 Универсальное действие «Переключить состояние» 094-universal-state-toggle.md реализовано в v1.62.0-beta.3; review/hardening включены в кандидат v1.62.0-beta.4
#101 Плавный переход View ↔ редакторы 101-view-editor-transition.md реализовано локально; ожидает prerelease/CI gate

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

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