Добавьте DevTools непосредственно в проверяемое приложение, а не только в другой пакет рабочего пространства.

dev_dependencies:
  usecase_forge_devtools: ^0.1.0-dev.3

Получите зависимости и перезапустите приложение вместе с DevTools. Вызывать initialize() в приложении не требуется.

Предположим, SaveDocument использует идентификатор документа как executionKey и отклоняет новый Command, пока связанная работа активна.

registerCommand<SaveDocument>(
  _save,
  instructions: const UseCaseInstructionOverrides(
    processing: UseCaseProcessingInstructionOverrides(
      existingExecutionPolicy: UseCaseExistingExecutionPolicy.rejectNew,
    ),
  ),
);

Запустите сборку для разработки, отправьте два сохранения одного документа до завершения первого и не закрывайте UseCase при открытии DevTools.

Откройте вкладку UseCase Forge и выберите нужный UseCase. Читайте жизненный цикл по порядку:

1. подтвердите точный тип Command и executionKey;
2. проверьте, дошла ли вторая Execution Entry до Admission или Pending;
3. изучите события отклонения, прежде чем связывать проблему со временем работы обработчика;
4. найдите причину activeConflict и политику rejectNew;
5. убедитесь, что первый Execution продолжает работу независимо.

Отклонённый Command не попадает в конечную историю, потому что обработка не начиналась. Это часть контракта, а не потеря диагностических данных.

Используйте идентификатор Execution, чтобы связать позиции, изменения Snapshot, события отмены, маршрут ошибки и конечную Execution Entry. Тип Command и ключ группы объясняют связь операций; отдельную попытку идентифицирует только Execution ID.

Технические метаданные жизненного цикла доступны автоматически. Прикладные значения остаются скрытыми, пока UseCase явно не предоставит ограниченные данные, совместимые с JSON.

import 'package:usecase_forge/diagnostics.dart';

final class DocumentUseCase extends UseCase<DocumentState>
    with UseCaseDiagnosticsDataProvider {
  @override
  String get useCaseDiagnosticLabel => 'Document editor';

  @override
  Object? encodeUseCaseDiagnosticValue(
    UseCaseDiagnosticValueKind kind,
    Object? value,
  ) {
    if (kind == UseCaseDiagnosticValueKind.state && value is DocumentState) {
      return {'dirty': value.isDirty, 'revision': value.revision};
    }
    return null;
  }
}

Не раскрывайте содержимое документа, учётные данные, персональные сведения, неограниченные трассировки стека или полное содержимое сетевых сообщений. null оставляет значение скрытым.

Полезное заключение называет наблюдаемые данные и владельца решения:

Второй SaveDocument отклонён с причиной activeConflict. Оба Command имели одинаковый точный тип и ключ документа. Зарегистрированная политика rejectNew сохранила первый активный Execution. Обработчик сохранения не получил второй Command.

После этого определите, соответствует ли продукту rejectNew, restart или coexist. DevTools доказывает, что произошло, но не выбирает политику продукта.