houseplan-card/docs/specs/030-dialog-information-architecture.md

ТЗ #30 — Информационная архитектура длинных диалогов

• Issue: https://github.com/Matysh/houseplan-card/issues/30
• Приоритет: P1
• Статус ТЗ: ready for review
• Ограничение: только UI/form-state; stored model и hp-dialog contract не меняются

Цель

Разделить независимые пользовательские задачи в Space, Device и General Settings dialogs, сохранив единый draft и стабильный footer.

Адаптивный паттерн

• >= 720px доступной ширины dialog: вертикальная side navigation слева, активная section справа.
• < 720px: один последовательный список <details>/accordion, открыт ровно один раздел; заголовки остаются видимыми в body.
• Горизонтальные tabs с обрезанием/скроллом не используются.
• Выбранная section локальна dialog session и не сохраняется в config.
• При validation error интерфейс открывает нужную section, фокусирует поле и связывает сообщение через aria-describedby.

Разделы

Диалог	Разделы
Пространство	Основа; Комнаты и подписи; Внешний вид; Окружение
Устройство	Привязка; Действие; Состояние и свет; Внешний вид; Информация и файлы
Общие настройки	Цвета; Окружение; Обслуживание; О продукте

Lifecycle actions Hide/Delete остаются в footer device dialog и не прячутся в section. Save/Cancel принадлежат всему draft, а не текущей section.

Условная видимость

• controls/is_light/radius — только для on/off-capable binding либо явного opt-in; сохранённые значения не стираются при временном скрытии section;
• climate temperature — только при climate capability;
• vacuum — только для vacuum device;
• state/display preview — скрыт у полностью virtual marker, но appearance остаётся;
• integration provenance и files — только при наличии данных/поддержки;
• смена binding пересчитывает visibility, не сбрасывая unrelated draft fields.

Архитектура

Каждый dialog получает typed draft model и массив section descriptors {id,label,visible,hasError,render}. Навигационный компонент не знает schema и не пишет config. Это согласуется с поэтапной декомпозицией #34.

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

• переключение section сохраняет все несохранённые поля;
• error routing, first/restore focus, Esc и nested dialogs;
• desktop/mobile, длинные ru/en labels, virtual/climate/vacuum matrices;
• footer не меняет ширину/позицию и не получает горизонтальный scroll;
• save старого config без правки даёт эквивалентный payload и визуал.