Изучение UseCase Forge

UseCase Forge координирует прикладную работу с жизненным циклом: она может быть допущена или отклонена, поставлена в очередь, начата, отменена, завершена с ошибкой или успехом, наблюдаема и закрыта. Руководство начинается с минимального полезного UseCase и добавляет политики только при появлении конкретной операционной задачи.

Начните с задачи

Рассмотрим поиск по каталогу. Пользователь может вводить запросы быстрее, чем отвечает сеть, закрыть экран во время запроса или изменить строку так, что предыдущий результат потеряет смысл. Обычная асинхронная функция умеет загрузить данные, но не определяет, какой запрос следует начать, какой нужно отменить, что видит интерфейс во время работы и как корректно завершить функцию.

UseCase Forge делает эти решения явными:

действие пользователя или системы
        ↓ Command
политика входа решает, когда запрос может быть принят
        ↓ принятый Execution
политика выполнения сопоставляет его с уже запущенной работой
        ↓ Handler публикует State
Snapshot предоставляет State, фазу, результат и активную работу

Пакет полезен, когда операции нужны воспроизводимые правила жизненного цикла. Для работы без требований к допуску, конкуренции, отмене, наблюдению и диагностике прямой вызов метода остаётся более простым решением.

Пять основных терминов

Рекомендуемый порядок

1. Начало работы — установите ядро и выполните одну типизированную команду.
2. Основные понятия — разберите команду, выполнение, снимок, результат и группу.
3. Жизненный цикл — проследите путь принятой команды до финализации.
4. Политики — осознанно выберите поведение входа и выполнения.
5. Архитектура — изучите границы ответственности публичного API.

UseCase Forge не является DI-контейнером, репозиторием или заменой доменной модели. Он отвечает за координацию выполнения; бизнес-правила, хранение данных, навигация и представление остаются ответственностью приложения.