要求IDのtraceability

要求IDのtraceability A data-flow diagram generated by Archify. 01 / 仕様 02 / 採番と登録 03 / 実装で結ぶ 04 / 検出 05 / 判断 feature仕様 · 受け入れ条件 · 01 / 仕様 feature仕様 受け入れ条件 要求ID · REQ-AREA-NNN · 02 / 採番と登録 要求ID REQ-AREA-NNN 要求台帳 · 状態と関連のみ · 02 / 採番と登録 要求台帳 状態と関連のみ 実装とtest · @req marker · 03 / 実装で結ぶ 実装とtest @req marker drift検出 · req:check · 04 / 検出 drift検出 req:check 人が判断 · 止めて報告する · 05 / 判断 人が判断 止めて報告する 採番する 受け入れ条件 登録する 状態 markerで結ぶ 実装参照 実測 現在の実装 期待値 宣言した状態 drift 未解決 Legend primary data policy / PII data store data flow

採番の規約

  • • 登録済み仕様の受け入れ条件はすべて採番する
  • • 未採番の受け入れ条件を追加しない
  • • 既存codeから逆生成した要求を採番しない

結び方

  • • 実装とtestを同じ `@req` markerで結ぶ
  • • 台帳は状態と関連だけを持ち、要求文を複製しない
  • • 適用済みmigrationを編集してmarkerを置かない

driftが出たら

  • • 整合を取らず停止して人へ報告する
  • • 仕様を書き換えてcodeへ合わせない
  • • statusを下げたり弱いkindへ移して消さない