mirror of https://github.com/Matysh/houseplan-card synced 2026-09-28 19:01:34 +00:00

Files

T

Claudeandclaude[bot] df46fd1c3e docs(hygiene): ТЗ выпущенных задач без живых ссылок — в legacy/specs (#682 )

Волна 5 эпика #674, перенос ТЗ (класс C). Из 240 файлов `docs/specs/` в
`legacy/specs/` уехали 219: на них не ссылается ни один живой файл (код,
тесты, скрипты, workflow, документы вне архива и ревью). Остались 21 ТЗ —
на которые ссылаются код, ADR, ISOMETRIC, SUN, RADAR, LIGHT (`docs/specs/067`),
DECOR-EDITOR, support-relay, и те, на которые ссылаются они сами; README
каталога объясняет, где искать остальное. Открытых issue с файлом ТЗ среди
перенесённых нет. Относительные ссылки перенесённых файлов переписаны
(`../X` → `../../docs/X`, соседние оставшиеся ТЗ → `../../docs/specs/…`) —
все 26 резолвятся. Попутно: битая ссылка в
`089-isometric-view-stage1.md:8` на удалённый `089-isometric-view.md` —
теперь команда `git show` по истории. Строка в `legacy/README.md`.

Issue: #682
User-Visible: no
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018qZfe7YS4rqEMKoVeS3GKd

2026-09-27 22:10:46 +00:00

3.2 KiB

Raw Permalink Blame History

ТЗ #8 — Матрица поддержки пылесосов и подсказка XCME

Issue: https://github.com/Matysh/houseplan-card/issues/8
Приоритет: P1
Статус ТЗ: реализовано по HP-VAC-02 rev.7; целевой gate v1.61.0-beta.1 пройден, ожидается публикация
Родительский контракт: HP-VAC-02 §5.1 и §5.3

Цель

Пользователь должен до настройки понимать фактическое покрытие интеграции, а при найденной Xiaomi Cloud Map Extractor без нужных атрибутов — видеть точную инструкцию вместо общего «источник не найден».

Документация

В docs/VACUUM.md, пользовательском руководстве и обзорном README должна быть одна непротиворечивая матрица:

Семейство	Position	Rooms/auto-fit	Integration path	Map id	Discovery
XCME	при включённых attributes	да	да, включая subpaths	`map_name` при наличии	явный picker допустим
Dreame/Mova	да	да, `x/y` anchor	нет в Stage 1	`selected_map` fallback	same-device
Valetudo camera	да	при outline rooms	нет в Stage 1	обычно `default`	same-device
Roomba string pose	Stage 2	нет room fit	нет	—	Stage 2

Диагностика и подсказка

Диалог показывает source, integration/platform, статус, position, rooms, совпадения имён, path и map id.
Registry-confirmed same-device XCME с отсутствующей position показывает hint независимо от того, выбран ли этот source.
Явно выбранная camera без position также показывает hint.
Глобальная невыбранная camera не должна случайно активировать подсказку для другого устройства.
Hint содержит готовый YAML-фрагмент vacuum_position, rooms, path, map_name и ссылку на документацию.
Documentation action видим при любом source status, включая missing.

Локализация и доступность

Весь текст ru/en; YAML не переводится.
Hint имеет текстовый заголовок, код можно выделить, ссылка открывается в новой вкладке с noopener.
Capability не сообщается только цветом.

Приёмка

новый пользователь XCME получает конкретный путь исправления;
матрица не обещает неподдерживаемый path;
диагностика и реальная доступность auto-calibration используют один matcher;
ссылки и термины одинаковы в README/User Guide/VACUUM.

3.2 KiB Raw Permalink Blame History Unescape Escape