Playbook: зона внимания ↔ панель shell ↔ SDK

Статус: чертёж v1.
Связь: ADR 0021 (семантика), ADR 0017 (несколько окон / поверхности), ADR 0025 (контракты), 0010 (overlay).
Проверка среза: vertical-slice-attention-capabilities-v1.

Зачем

Чтобы после фразы «эта поверхность в PFD» был следующий шаг без догадок: какой id панели, где дефолт зоны в рантайме, что переопределяет workspace.toml.

Три слоя (не смешивать)

Слой	Что это	Где живёт
Семантика зоны	«Где в модели внимания» (PFD / Forward / …)	PrimaryAttentionZoneId в UiSurfaceCapabilityDescriptor, константы AttentionZoneCanonicalIds
Панель shell	Стабильный ключ панели в сетке / доке	HostAttentionPanelId ↔ AttentionPanelCanonicalIds / AttentionPanelIds
Презентация	Видимость, размер, вкладки	TOML overlay (0010), Axaml

Топология презентации (одно окно с колонками vs несколько окон/мониторов) в коде задаётся отдельно от id зоны: AttentionLayoutSurfaceKind (сейчас только MainWindowDockedGrid); на MainWindowViewModel — ActiveAttentionLayoutSurface. Свойства IsPfdColumnVisible / IsMfdColumnVisible относятся только к этой топологии.

Колонки MainGrid ≠ содержимое зоны. Свойства вроде «видна колонка под якорь PFD/MFD» в VM описывают разметку главного окна (есть ли место под левую/правую колонку в одном MainGrid). Какая панель сейчас привязана к зоне pfd / mfd / forward — это слой карты AttentionZonePanelRuntime и TOML, а не то же имя, что у колонки сплиттера.

Колонки — не единственная форма раскладки. Три семантики (PFD / лобовое / MFD) на одном мониторе часто складываются в три колонки одного окна; при мультимониторе или нескольких top-level те же зоны могут жить в отдельных окнах или на разных дисплеях — семантика зон сохраняется, меняется только геометрия презентации (ADR 0021 §13 «Мультиоконность и мультимонитор», ADR 0017). Пример целевой схемы на двух мониторах: первый — PFD + лобовое, второй — MFD (см. 0017 §«Два монитора»). Playbook про колонки описывает текущий путь «главное окно → MainGrid»; роутинг зон по окнам — предмет 0017 и будущей реализации, не замена таблицы панель→зона выше.

Дефолтная карта панель → зона

Источник в коде: AttentionZonePanelRuntime.BuildDefaultMap() (после загрузки workspace накладываются переопределения из attention_zone_panels).

Панель (AttentionPanelIds)	Дефолтная зона (канонический id)	Примечание
solution_explorer	pfd	контекст workspace слева
chat_panel	mfd
git	mfd
terminal_dock	mfd
editor	forward	лобовое
editor_hud	hud	слой над редактором, не отдельная колонка

EICAS как канал оповещений в этой таблице не как отдельная строка-панель — см. ADR 0021.

Что делать при добавлении UI surface

1. Выбрать канонический id зоны (AttentionZoneCanonicalIds) для ментальной модели.
2. Если поверхность = конкретная панель дока: задать HostAttentionPanelId тем же строковым id, что в таблице выше (или добавить новый id в AttentionPanelCanonicalIds, AttentionPanelIds, дефолт в AttentionZonePanelRuntime).
3. Заполнить оба поля (PrimaryAttentionZoneId + HostAttentionPanelId) — тогда при BuildMap() проверка CapabilityAttentionConsistency сравнит с текущей картой рантайма и выведет предупреждение в Debug при рассинхроне.
4. Для переопределения места панели пользователем — только TOML (attention_zone_panels), не подмена семантики в SDK.

Чего этот playbook не делает

• Не задаёт пиксели и не заменяет разметку Axaml.
• Не заставляет вешать зону на команды без привязки к панели.