mirror of https://github.com/Matysh/houseplan-card synced 2026-09-29 03:09:36 +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.3 KiB

Raw Blame History

ТЗ #31 — Доступная семантика режима View

Issue: https://github.com/Matysh/houseplan-card/issues/31
Приоритет: P1
Статус ТЗ: draft, требуется UX-проверка screen reader
Зависимость: room dialog #28

Цель

Обеспечить основные View-сценарии клавиатурой и screen reader без сотен tab-stop и без изменения pointer UX.

Accessible projection

Один pure resolver создаёт для объекта:

стабильный id и role (button для действия, group для read-only);
label: имя, тип, комната, локализованное состояние, основное действие;
description: доступные метрики/предупреждения;
action: room dialog, device action/more-info, opening status.

static_icon влияет на визуал, но accessible label всё равно сообщает реальное HA-состояние. Disabled/orphaned объекты явно называются недоступными.

Keyboard и focus lifecycle

Enter/Space активирует основной action; контекстное more-info остаётся отдельной подписанной командой в открывшейся карточке.
Смена пространства фокусирует PlanNavigator heading, затем первую комнату.
Закрытие room/device dialog возвращает фокус на исходную запись.
Исчезнувший объект возвращает фокус к ближайшему соседу/заголовку.
Kiosk сохраняет доступный View, но editor controls отсутствуют.

Нецветовые состояния

Critical alarm получает alert glyph и текст; open/unlocked — outline/glyph; mechanical activity — motion glyph/accessible live text. Не добавлять постоянные satellite badges каждому marker. prefers-reduced-motion отключает pulse, но не текстовый state.

Проверки и приёмка

axe: name/role/value, landmark, focus order, dialog boundaries;
NVDA/Chrome и TalkBack ручной checklist;
keyboard: room, ordinary device, alarm, opening, disabled device;
200 markers дают один Tab entry на plan navigator, не 200;
выключенный цвет/анимация не лишает пользователя состояния;
pointer hit-testing и golden View не меняются без осознанного glyph delta.

3.3 KiB Raw Blame History