houseplan-card/docs/specs/044-filter-grouping-policy.md

ТЗ #44 — Явные фильтры и группировка устройств

• Issue: https://github.com/Matysh/houseplan-card/issues/44
• Приоритет: P2
• Статус ТЗ: policy proposal ready for owner review
• Связано: device inbox #29, field registry #33

Цель

Убрать скрытые настройки, влияющие на discovery. Каждый ключ либо получает поддерживаемый advanced UI и documented default, либо мигрирует в фиксированное product rule.

Решение v1

Оба текущих ключа остаются поддерживаемыми и становятся видимыми в Advanced разделе inbox:

group_lights

• default true;
• label: «Объединять несколько светильников комнаты»;
• preview показывает, какие bindings будут группой/отдельными marker;
• переключение не применяется до Save и не удаляет explicit markers;
• existing light-group marker сохраняет lifecycle; конфликт bindings preview.

exclude_integrations

• default — текущий EXCLUDED_DOMAINS/product list;
• UI — searchable multi-select интеграций, реально присутствующих в registry, плюс reset to recommended defaults;
• изменение влияет только на automatic candidates/seed, не скрывает explicit live marker и не удаляет tombstone;
• reason в inbox — «Исключена интеграция X».

Название storage key exclude_integrations сохраняется для compatibility; семантика и default фиксируются в registry #33.

Исследование перед включением Save

Локальный config-audit считает значения/отклонения от defaults без вывода ids. Synthetic fixtures моделируют реальные классы: group lights, parent device, service/bridge, explicit override, tombstone. Если audit показывает, что ключ невозможно объяснить без вредного поведения, owner может отдельным решением перевести его в fixed rule до реализации UI.

UX/transaction

Preview diff: новые/скрытые/grouped candidates counts и конкретный список в локальной session. Apply пишет settings один раз, rebuild devices и создаёт named undo/config snapshot. Cancel no-op. Два клиента используют config rev.

Приёмка

• ни один runtime discovery key не скрыт от пользователя/registry;
• defaults совпадают frontend, backend, docs и fixtures;
• explicit marker никогда не исчезает из-за filter change;
• preview объясняет каждую изменившуюся binding;
• old config даёт прежний result до user action.