ADR-UI-008. Управление состоянием

1. Контекст и постановка задачи

Состоянием надо управлять на трёх уровнях:

• локальное — внутри компонента (текущий шаг, открытость блока, прогресс);
• страничное — общее для нескольких компонентов одной страницы;
• разделяемое — нужное нескольким частям приложения (профиль, конфиг).

Нужен единый способ — без смеси signals / BehaviorSubject / глобального store.

2. Драйверы решения

1. Минимум абстракций — требований к undo/time-travel/оффлайну нет; глобальный store избыточен.
2. Явный поток данных — компонент → сервис → API; без неявных глобальных «магнитов».
3. Нативные средства Angular — signals + computed() + toSignal() покрывают почти всё.
4. Локальность — состояние живёт там, где используется; удаление фичи удаляет её состояние.

3. Рассмотренные варианты

• A. Глобальный store (NgRx / elf) — универсально, но избыточно; лишняя зависимость.
• B. Signals + injectable-сервисы — локальное в сигналах компонента; разделяемое — в providedIn:'root'-сервисе с сигналами.
• C. RxJS Subjects во всём — проигрывает signals по эргономике в шаблонах и computed.

4. Решение

Выбран Вариант B: signals + injectable-сервисы.

4.1. Уровни состояния

4.2. Компонентное состояние

• signal() / computed() внутри компонента; изменения только через set() / update() (не мутируем объект).
• Производное — через computed(), не копией в нескольких сигналах.

4.3. Страничное состояние

• Нетривиальная страница имеет per-page service, зарегистрированный в providers страницы (живёт ровно пока активна страница).
• Внутри — сигналы; компонент и под-компоненты читают один экземпляр через inject(...).
• Данные из API кладутся в сигнал сервиса (или компонент подписывается через takeUntilDestroyed() и кладёт в свой сигнал).

4.4. Разделяемое состояние

• Только для данных, реально нужных нескольким частям (профиль, конфиг).
• @Injectable({ providedIn: 'root' }) в src/app/services/.
• Контракт — сигналы для чтения (asReadonly()) + методы для записи. Прямая запись в сигнал извне запрещена (private signal + публичный readonly).

4.5. Подписки и Observable

• Угасание потоков — takeUntilDestroyed() + DestroyRef (без until-destroy, ADR-UI-001).
• Observable → Signal — toSignal(stream$), по возможности с явным initialValue.

4.6. Чего не делаем

• Глобальный store (NgRx/elf и аналоги).
• Запись через мутацию — только set/update.
• Скрытые синглтоны (static-поля, модули-синглтоны как имитация store) — разделяемое всегда в инжектируемом сервисе.
• Локальный store на странице через RxJS Subject — замена: per-page service с сигналами.

5. Положительные следствия

• Один способ работы со состоянием — меньше развилок для разработчика и ИИ.
• Сигналы интегрированы с Angular (change detection, шаблоны, computed) без лишних операторов.
• Удаление страницы/фичи механически удаляет её состояние.

6. Отрицательные следствия и компромиссы

• Нет time-travel / Redux DevTools — при появлении требований к сложной отладке заведём отдельный ADR на store.
• Оптимистичные обновления/откат реализуются вручную в сервисе.

7. Проверка

• В коде нет импортов глобального store.
• Компоненты с локальным состоянием используют сигналы (нет состояния в полях класса вне сигналов и форм).
• Разделяемое состояние читается через inject(<Service>).<signal>() и пишется только методами сервиса.

8. Открытые вопросы / отложено

• Глобальный store — пересмотрим при требованиях к time-travel / оффлайну / синхронизации вкладок.
• Кэширование данных между страницами (справочники) — пока per-page; общий уровень — отдельным ADR.

9. Связанные артефакты

• ADR_UI_001_Stack — signals + сервисы, без store.
• ADR_UI_009_Forms — форма как источник значений-сигналов.