Перейти к основному содержимому

Definition Of Ready И Definition Of Done

Назначение​

Этот документ фиксирует общие правила готовности постановок и завершенности изменений. Остальные правила и шаблоны должны ссылаться на него, а не повторять полный список заново.

Общий Definition Of Ready​

Работа не готова к реализации, если не определены:

  • цель и scope;
  • actor model, permission model и scope rules;
  • входы, выходы и модели данных;
  • source of truth и затрагиваемые сервисы;
  • алгоритм на уровне конкретных действий;
  • ожидание согласованности/атомарности (что фиксируется в одном согласованном изменении);
  • side effects и dependencies;
  • failure modes и edge cases;
  • acceptance criteria;
  • observability и audit expectations.

Правило Для Acceptance Criteria​

Acceptance criteria описывают функционально проверяемое поведение (наблюдаемый результат, состояние, контракт, side effects). Латентностные/длительностные цели (p50/p95/p99, «< N мс», пропускная способность, SLO) в AC не включаются — их место в README сервиса (раздел «SLO/SLA») и в «Freshness SLA» команд/фактов.

Общий Definition Of Done​

Изменение считается завершенным только если:

  • код и документация согласованы;
  • обновлены связанные contracts, runbooks, dashboards и ADR, где это нужно;
  • тесты покрывают риск изменения на адекватном уровне;
  • observability добавлена и проверена;
  • compatibility, migration, rollout и reconciliation notes добавлены для risky changes;
  • assumptions и остаточные ограничения зафиксированы явно.

Дополнение Для Контрактов​

  • request/response или event models документированы;
  • compatibility rules заполнены;
  • security и masking rules описаны;
  • связанная реализация или сгенерированный API-клиент обновлены (критерий завершённости изменения, не часть содержания постановки).

Дополнение Для Frontend​

  • описаны loading/empty/error/forbidden states;
  • определены guards, validation, API dependencies и invalidation behavior;
  • критичные user actions покрыты тестами и telemetry.

Дополнение Для Background/Integration Flows​

  • описаны retry, deduplication, poison message handling и manual recovery;
  • указаны checkpoints, replay behavior и reconciliation path.

Обратные ссылки​

Автоссылки: где используется этот документ.