specdojo 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +280 -0
  3. package/README.md +143 -30
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/dashboard.js +140 -9
  8. package/dist/devcontainer-command.js +43 -0
  9. package/dist/devcontainer-scaffold.js +165 -0
  10. package/dist/exec-agent-config.js +107 -9
  11. package/dist/exec-agent-git-state.js +18 -0
  12. package/dist/exec-agent-protected-config.js +46 -8
  13. package/dist/exec-evidence.js +254 -11
  14. package/dist/exec-format.js +13 -4
  15. package/dist/exec-handoff.js +336 -0
  16. package/dist/exec-parent-validation.js +317 -43
  17. package/dist/exec-pipeline-state.js +74 -9
  18. package/dist/exec-plans.js +115 -113
  19. package/dist/exec-protection-handoff.js +43 -2
  20. package/dist/exec-provider-scaffold.js +247 -15
  21. package/dist/exec-register-resume.js +65 -19
  22. package/dist/exec-register.js +9 -3
  23. package/dist/exec-repo-integration.js +811 -0
  24. package/dist/exec-repo-trace.js +182 -0
  25. package/dist/exec-reporter.js +613 -132
  26. package/dist/exec-results.js +81 -56
  27. package/dist/exec-run-lock.js +110 -107
  28. package/dist/exec-run.js +1585 -356
  29. package/dist/exec-shared.js +7 -0
  30. package/dist/exec-slot-lock.js +242 -0
  31. package/dist/exec-task-repos.js +415 -0
  32. package/dist/exec-trial.js +51 -25
  33. package/dist/exec-worktree-command.js +87 -43
  34. package/dist/exec-worktree-ops.js +502 -57
  35. package/dist/exec-worktree.js +114 -27
  36. package/dist/exec.js +13 -6
  37. package/dist/grade-result.js +128 -0
  38. package/dist/grade.js +809 -72
  39. package/dist/init-command.js +443 -0
  40. package/dist/job.js +160 -10
  41. package/dist/orchestrator.js +213 -0
  42. package/dist/package-paths.js +19 -1
  43. package/dist/register-event-merge.js +169 -0
  44. package/dist/register-item.js +7 -1
  45. package/dist/register.js +294 -86
  46. package/dist/review-grade.js +252 -0
  47. package/dist/review-plan.js +111 -1
  48. package/dist/review-types.js +40 -1
  49. package/dist/routine.js +72 -5
  50. package/dist/schedule-build.js +2 -2
  51. package/dist/schedule.js +17 -4
  52. package/dist/specdojo-config.js +466 -20
  53. package/dist/specdojo-gitignore.js +135 -0
  54. package/dist/specdojo.js +8 -1
  55. package/dist/viewpoint-document-kinds-check.js +128 -0
  56. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  57. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  58. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  59. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  60. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  61. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  62. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  63. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  64. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  65. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  66. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  67. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  68. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  69. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  70. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  71. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  72. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
  73. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  74. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  75. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  76. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
  77. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  78. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  79. package/docs/ja/specdojo/guides/quick-start-guide.md +261 -32
  80. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  81. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  82. package/docs/ja/specdojo/guides/remote-host-development-guide.md +184 -0
  83. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  84. package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
  85. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  86. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  87. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  88. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  89. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  90. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  91. package/docs/ja/specdojo/index.md +2 -2
  92. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  93. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  94. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  95. package/docs/ja/specdojo/references/command-reference.md +336 -93
  96. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  97. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  98. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  99. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  100. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  101. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  102. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  103. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  104. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  105. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  106. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  107. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  108. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  109. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  110. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  111. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  112. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  113. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  114. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  115. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  116. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  117. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  118. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  119. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  120. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  121. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  122. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  123. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  124. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  125. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  126. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  127. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  128. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  129. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  130. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  131. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  132. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  133. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  134. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  135. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  136. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  137. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  138. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  139. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  140. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  141. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  142. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  143. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  144. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  145. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  146. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  147. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  148. package/package.json +16 -9
  149. package/templates/antigravity/README.md +60 -0
  150. package/templates/antigravity/agent-members-snippet.yaml +61 -0
  151. package/templates/antigravity/exec-defaults-snippet.yaml +39 -0
  152. package/templates/antigravity/orchestrator.md +157 -0
  153. package/templates/antigravity/settings.global.json +55 -0
  154. package/templates/claude/agents/claude-executor.md +14 -0
  155. package/templates/claude/agents/claude-reporter.md +16 -0
  156. package/templates/claude/agents/specdojo-orchestrator.md +164 -0
  157. package/templates/claude/settings.edit.json +27 -1
  158. package/templates/codex/README.md +5 -4
  159. package/templates/codex/agents/specdojo-orchestrator.toml +165 -0
  160. package/templates/codex/orchestrator.md +157 -0
  161. package/templates/copilot/README.md +7 -5
  162. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  163. package/templates/devcontainer/devcontainer.json +27 -0
  164. package/templates/devcontainer/emacs/init.el +88 -0
  165. package/templates/devcontainer/post-create.sh +62 -0
  166. package/templates/init-agent-members.yaml +200 -0
  167. package/templates/init-exec-defaults.yaml +72 -0
  168. package/templates/opencode/agents/specdojo-orchestrator.md +204 -0
  169. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  170. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -3,267 +3,179 @@ specdojo:
3
3
  id: specdojo:bps-rulebook
4
4
  type: rulebook
5
5
  status: draft
6
- recipe: undecided
6
+ target_format: markdown
7
+ recipe: specdojo:bps-recipe
7
8
  sample: specdojo:bps-sample
8
- template: undecided
9
+ template: specdojo:bps-template
9
10
  ---
10
11
 
11
- # 業務プロセス仕様書 作成ルール
12
+ # 業務プロセス仕様 作成ルール
12
13
 
13
- Business Process Specification (BPS) Documentation Rules
14
+ Business Process Specification (BPS) Documentation Rulebook
14
15
 
15
- 本ドキュメントは、業務分析・要求定義のために **業務プロセス仕様を統一形式で記述する標準ルール**です。
16
- 業務プロセス仕様は、概念データフローで定義された各プロセスについて、開始条件・手順・入出力・例外処理などを詳細に記述します。
16
+ 概念データフローで定義したプロセス領域のうち、共通の起点と業務成果を持つ一連の流れについて、トリガー、前提条件、入出力、処理、例外、検証条件を業務観点で定義するためのルールです。
17
17
 
18
18
  ## 1. 全体方針
19
19
 
20
- - 対象は「業務上の単位処理(プロセス)」であり、**概念レベルの手順+判断ポイント+入出力**を明確化する。
21
- - システムへの実装(例:物理テーブル名、SQL、UI操作、実装クラス/関数名)については記載しない(詳細は「9. 禁止事項」参照)。
22
- - 1ファイル = 1 プロセスとし、複雑な場合は子業務プロセスへ分解する。
20
+ - 一文書は、概念データフローの一つのプロセス領域に属し、共通の起点と業務成果を持つ一連の流れを扱います。同じ領域に起点または業務成果が異なる流れがある場合は、BPS を分けます。
21
+ - CDFD の個別プロセスは BPS の処理ステップとして具体化します。プロセス領域の境界、プロセス ID、主要な入出力、データストアの名称を変更する必要がある場合は、先に CDFD を更新します。
22
+ - 業務担当者が開始条件、判断、責任、完了条件を確認でき、設計者とテスト担当者が機能設計および受入シナリオの入力として利用できる粒度にします。
23
+ - ビジネスルール、業務イベント、状態定義、データ定義は対応する仕様を正本とします。BPS には、その流れで参照する条件と利用目的だけを記載します。
24
+ - 物理テーブル、SQL、クラス、関数、画面操作、詳細 API などの実装方式は扱いません。
25
+ - 複数のプロセス領域またはプロセスグループをまたぐ順序と引き渡し条件はユースケース別 CDFD を正本とし、BPS では自文書が担う流れの入口と出口だけを記載します。
23
26
 
24
- ## 2. 用語定義
27
+ ## 2. 位置づけと用語定義
25
28
 
26
- | 用語 | 定義 |
27
- | ------------ | ----------------------------------------------------------------------------------------------------------------- |
28
- | 業務プロセス | 業務イベントまたは条件を契機に起動し、明確な成果物/状態変化を生む処理単位 |
29
- | トリガー | プロセスを開始させるイベント |
30
- | 前提条件 | プロセス開始前に成立しているべき条件 |
31
- | 入力 | プロセスが参照/取得するデータ(概念レベル)。業務データ辞書の論理名で参照、idを付与する場合は用語集の用語idで参照 |
32
- | 処理 | 手順/判断の論理的なステップ。順序と分岐を含む |
33
- | 出力 | プロセスが生成/更新/通知するデータ・イベント・状態変化 |
34
- | 例外 | 異常/例外パス(入力不備・判定失敗・外部連携失敗等) |
29
+ | 用語 | 定義 |
30
+ | ------------ | ------------------------------------------------------------------------------------------------------------ |
31
+ | BPS | 一つのプロセス領域に属する一連の流れについて、開始から業務成果の確定までを記述する業務プロセス仕様 |
32
+ | プロセス領域 | 固有の業務目的、主な担当、起点イベントを持つ CDFD 上の責務のまとまり |
33
+ | 流れ | 共通の起点と業務成果を持つ、複数の処理ステップのまとまり |
34
+ | 処理ステップ | CDFD の個別プロセスを引き継ぎ、担当、入力、活動または判断、出力、完了条件を示す BPS 内の単位 |
35
+ | トリガー | 業務プロセスの開始を判定できる出来事。時刻到来、依頼受付、状態変化、業務イベントなど |
36
+ | 前提条件 | トリガー発生時に、処理を開始できるかを判定する条件 |
37
+ | 業務成果 | 処理の完了により確定する記録、状態変化、通知、判断結果、または次の業務への引き渡し |
38
+ | 主要例外 | 正常な業務成果または後続処理の起動を妨げ、停止、差戻し、代替経路、または人による判断を必要とする業務上の事象 |
39
+
40
+ BPS は CDFD が定めるプロセス領域と流れを詳細化し、BES が定める業務イベント、BR が定める判断・計算、STSD が定める状態と遷移を利用します。参照先の定義を BPS 内へ複製せず、このプロセスでいつ、何のために利用するかを明らかにします。
35
41
 
36
42
  ## 3. ファイル命名・ID規則
37
43
 
38
- - ファイル名: `bps-<番号>-<短い日本語名>.md` (例: `bps-0010-在庫不足検知.md`)
39
- - Frontmatter:
40
- - `id`: `bps-low-stock-detection` のように小文字ハイフン形式。
41
- - `title`: 「在庫不足検知」など。
42
- - 子業務プロセスへ分割する場合: `bps-low-stock-check`, `bps-low-stock-alert`などのidを付与し、子側で `part_of: [bps-low-stock-detection]` を指定します。
44
+ - ファイル名は `bps-<term>.md`、成果物 ID は拡張子を除いた `bps-<term>` とします。`<term>` は対象の流れまたは業務成果を表す英小文字・数字・ハイフンのスラッグです。
45
+ - product 成果物の ID にはプロジェクト ID や authority を付けません。例: ファイル名 `bps-order-candidate-generation.md`、ID `bps-order-candidate-generation`。
46
+ - 番号や一時的な組織名、実装名を `<term>` に含めません。同じ業務上の責務を保つ限り、処理順や担当組織が変わっても ID を維持します。
47
+ - 一つの BPS に複数の独立した起点または業務成果を混在させません。起点または成果が独立して変更・承認される場合は、別の `bps-<term>` に分けます。
48
+ - 処理ステップ ID は文書内で一意な `S-01` 形式、主要例外 ID は `E-01` 形式とします。CDFD のプロセス ID がある場合は、処理表の「CDFD プロセス」列で対応させます。
43
49
 
44
50
  ## 4. 推奨 Frontmatter 項目
45
51
 
46
- | 項目 | 説明 | 必須 |
47
- | ---------- | ------------------------------------- | ---- |
48
- | id | プロセスID (bps-xxx-xxxx) | ○ |
49
- | type | `domain` 固定 | ○ |
50
- | title | プロセス名 | ○ |
51
- | status | `draft`/`ready`/`deprecated` | ○ |
52
- | part_of | 親プロセスID(子プロセスの場合) | 任意 |
53
- | based_on | 根拠となる仕様ID(BES/BEL/BR/UIS 等) | 任意 |
54
- | supersedes | 置き換え関係(古仕様→新仕様) | 任意 |
55
-
56
- ## 5. 本文構成(標準テンプレ)
57
-
58
- 各 BPS ファイルは以下見出しを順番に並べる。
59
-
60
- 1. 概要
61
- 2. トリガー
62
- 3. 前提条件
63
- 4. 入力
64
- 5. 処理
65
- 6. 出力
66
- 7. 例外 / 異常系
67
- 8. メモ / 将来課題
68
-
69
- ## 6. 記述ガイド詳細
70
-
71
- ### 6.1 概要
72
-
73
- 短い一文+業務プロセスの5W1Hをビジネス用語で書く。
74
-
75
- ### 6.2 トリガー
76
-
77
- - 起点となる業務内容と業務イベント ID(bes-xxx-xxx)を列挙。
78
- - 例: 商品の在庫数が更新された: 在庫数更新イベント(bes-stock-amount-updated)
79
- - BEV(個別業務イベント仕様)が存在する場合は、イベントの「契約」(発行者/発生源/ペイロード/結果/主な購読先)は BES を参照し、BPS のトリガー/入力では **購読側(このプロセスが受ける)観点**で簡潔に記述します。
80
-
81
- ### 6.3 前提条件
82
-
83
- - 開始前に真であるべき条件を列挙。例: 「対象商品が販売中状態」「店舗が営業中」等。
84
-
85
- ### 6.4 入力
86
-
87
- - 業務データ辞書のエンティティ、論理名を列挙し、利用目的を簡潔に付記。
88
- - 例: エンティティ:在庫、項目:発注点、目的:発注判定基準
89
- - 必要に応じて用語集の用語ID(tm-xxx-xxx)を併記。
90
- - 外部システム IF の場合は IF 仕様の ID を引用。
91
- - イベントの付帯情報(ペイロード)は、BES があれば BES を正とし、BPS にはこのプロセスで参照する範囲を記述します。
92
-
93
- ### 6.5 処理
94
-
95
- 番号付き箇条書きで最小限のステップ。分岐は `if / else` ではなく日本語条件句。
96
-
97
- 例:
98
-
99
- 1. 定番商品以外は除外
100
- 2. 発注数量を計算(発注数量 = 注文毎の発注点 − 現在在庫数)
101
- 3. 発注数量 > 0 の場合、発注候補を生成
102
- 4. bes-order-candidate-generated「発注候補生成」イベントを発火
103
-
104
- もしくは、複雑処理については、TypeScriptの擬似コードでロジックを示す。具体的には、
52
+ Frontmatter の共通原則はドキュメントメタ情報標準、許可される項目と型は成果物 Frontmatter スキーマを正本とします。
105
53
 
106
- - 業務イベントを受けるハンドラとして書く
107
- - 「イベント → 入力読み取り → BR呼び出し → イベント発火」のフローとする
108
- - 商品を取得する や 発注候補生成イベントを発火する は、インフラ詳細に踏み込まず、概念レベルの名前だけに留める
54
+ | 項目 | 説明 | 必須 |
55
+ | ---------- | ------------------------------------------------------- | ---- |
56
+ | id | プロジェクト修飾なしの `bps-<term>` | ○ |
57
+ | type | 業務フロー・プロセス仕様を表す `flow` | ○ |
58
+ | status | `draft` / `ready` / `deprecated` | ○ |
59
+ | rulebook | `specdojo:bps-rulebook` | ○ |
60
+ | part_of | 一覧または親成果物との所属関係 | 任意 |
61
+ | based_on | 作成時に直接確認した、依存関係上許可される先行成果物 ID | 任意 |
62
+ | supersedes | 置き換える旧 BPS の ID | 任意 |
63
+ | relations | 要求の充足などを表す型付き参照 | 任意 |
109
64
 
110
- 例:
65
+ - SpecDojo が所有する項目は `specdojo:` 配下に置きます。文書名は Frontmatter ではなく H1 に記載します。
66
+ - `based_on` には、成果物カタログの `depends_on` の推移閉包に含まれ、実際に内容根拠として確認した ID だけを記載します。
67
+ - 作成中は `status: draft` とします。完成条件と承認を満たした後の `ready` への昇格は、プロジェクトの責任分担と運用に従います。
111
68
 
112
- ```ts
113
- // トリガー: bes-stock-amount-updated「在庫数更新」イベント
114
- type 在庫数更新イベント = {
115
- 商品ID: string;
116
- 新在庫数: number;
117
- };
69
+ ## 5. 本文要件
118
70
 
119
- function 在庫数更新イベントを処理する(イベント: 在庫数更新イベント) {
120
- const 商品 = 商品を取得する(イベント.商品ID); // 概念レベルでOK
121
- const 在庫 = 在庫を取得する(イベント.商品ID);
122
- if (!商品.定番商品フラグ) {
123
- return; // 定番以外は自動発注対象外
124
- }
71
+ 見出し順、表の列、記入欄の骨組みは Frontmatter で宣言した template を正本とします。BPS は、骨組みを埋めた結果として次の意味要件を満たさなければなりません。
125
72
 
126
- // 以下はサンプルでビジネスルールを直書き
127
- const 発注数量 = 商品.発注点 - 在庫.現在在庫数;
128
- if (発注数量 > 0) {
129
- const 発注候補 = {
130
- 商品ID: 商品.商品ID,
131
- 発注数量: 発注数量,
132
- };
133
- // 出力: bes-order-candidate-generated「発注候補生成」イベント発火
134
- 発注候補生成イベントを発火する(発注候補);
135
- }
136
- }
137
- ```
73
+ | 要件群 | 必須 | 目的と記載要件 |
74
+ | ------------------ | -------- | -------------------------------------------------------------------------------------------------------------- |
75
+ | 起点・目的・境界 | ○ | 対象の流れ、観測可能な起点、確定する業務成果、対象者、主担当、開始・終了、対象外を定義する |
76
+ | 開始可否 | ○ | トリガーの発生元・受領情報・開始条件と、開始前に確認する条件、不成立時の扱いを定義する |
77
+ | 入力と正本 | ○ | 入力情報、入手元、利用目的、必須性、業務上の正本を定義する |
78
+ | 処理と責任 | ○ | 処理ステップ、担当、活動または判断、入出力、完了条件、CDFD プロセスとの対応を定義する |
79
+ | 業務成果と引き渡し | ○ | 正常終了と条件付き終了の成果、受け手、確定条件、正本、後続処理を定義する |
80
+ | 主要例外 | ○ | 業務成果または後続処理を変える例外について、検出条件、停止範囲、担当、処置、再開条件または代替成果を定義する |
81
+ | 検証可能性 | ○ | 正常系・条件付き・例外系について、第三者が結果を判定できる入力条件、期待する業務成果、確認可能な記録を定義する |
82
+ | 未決論点の追跡 | 条件付き | 調査または意思決定が未了の論点、影響、区分、決定者、決定時期を記載する。未決事項がある場合だけ扱う |
138
83
 
139
- ### 6.6 出力
84
+ 処理は操作の羅列ではなく、各ステップの業務目的と完了条件を含めます。検証条件はテストケースの実装ではなく、業務成果を受け入れられる条件を定義します。
140
85
 
141
- - 新規生成: レコード/イベント/通知。
142
- - 更新: どの項目がどう変わるか(増減/ステータス変更)。
143
- - 削除(あれば)。
144
-
145
- ### 6.7 例外 / 異常系
146
-
147
- - 外部呼び出し失敗 / 入力欠損 / 矛盾(発注点 < 0)など。
148
- - 失敗時挙動(再試行回数 / 中断 / 警告ログ / オペレーション通知)を記述。
149
-
150
- ### 6.8 メモ / 将来課題
151
-
152
- 既知の改善余地(閾値動的化、並行処理最適化など)。
153
-
154
- ## 7. 命名・記述スタイル
155
-
156
- - プロセス名は「名詞+機能動詞」: 例 `在庫不足検知`, `自動発注候補生成`。
157
- - ステップは簡潔に。禁止: 冗長なスクリーン操作列(「ページを開く→スクロール→クリック」)。
158
- - 条件文は業務用語ベースで。「在庫数 − 予約数 < 発注点」などは式と意味を併記可。
159
- - 受動態より能動態(「システムは候補を生成する」)。
160
-
161
- ## 8. 階層分解ガイド
162
-
163
- | シグナル | 子業務プロセスへ分割検討 |
164
- | ---------------- | ------------------------ |
165
- | ステップ数が10超 | 冗長化・可読性低下 |
166
- | 分岐が3種類以上 | 条件別プロセス分離 |
167
- | 複数イベント混在 | イベント別に分割 |
168
- | 出力が多種(>5) | 目的別再編 |
169
-
170
- 親子関係は、子プロセス側で `part_of` を指定します(親プロセス側に子を列挙しない)。
171
-
172
- ## 9. 禁止事項
173
-
174
- | 項目 | 理由 |
175
- | ---------------------------- | ------------------------------ |
176
- | UI操作列の逐語的記述 | 可読性低下・設計変更に弱い |
177
- | 物理テーブル名・SQL全文 | 概念レベル逸脱(DB設計に記述) |
178
- | 画面レイアウト詳細 | 画面仕様へ委譲 |
179
- | 機能要件以外の雑多な会話ログ | メンテ不能 |
180
- | ビジネスルール重複記述 | 変更時不整合リスク |
181
- | 未定義略語乱用 | 用語集との整合欠如 |
182
-
183
- ## 10. よくある誤りと対策
184
-
185
- - 在庫不足判定ロジックをステップ内に長文記載 → BR 化して参照。
186
- - 画面遷移記述を羅列 → 「トリガー」「出力」に要約。
187
- - 外部 API エラー未記載 → 例外セクションで HTTP タイムアウト・再試行方針を明示。
188
-
189
- ## 11. サンプル(簡易)
190
-
191
- ````markdown
192
- ---
193
- id: bps-order-candidate-generation
194
- type: data
195
- title: 発注候補生成
196
- status: draft
197
- part_of: []
198
- based_on: [bes-stock-amount-updated]
199
- ---
86
+ ## 6. 記述ガイド
200
87
 
201
- ## 概要
88
+ ### 6.1. 導入文と概要
202
89
 
203
- 在庫数が発注点を下回ったかどうかを判定し、発注候補を生成する。
90
+ - 導入文は「在庫数更新を受け、補充が必要な商品について発注候補を確定する」のように、起点、対象、業務成果を一文で示します。
91
+ - 「概要」は、業務目的、対象者、対象範囲、対象外、主担当、開始点、終了点を箇条書きまたは表で示します。対象外には前後のプロセス、横断フロー、実装方式を明記します。
92
+ - CDFD のプロセス領域名と対象の流れを示し、同じ領域にある他の流れとの境界を説明します。領域の分割そのものは BPS で変更しません。
204
93
 
205
- ## トリガー
94
+ ### 6.2. トリガーと前提条件
206
95
 
207
- - 商品の在庫数が更新された: 在庫数更新イベント(bes-stock-amount-updated)
96
+ - トリガーは「必要になった」ではなく、発生時点を観測できる出来事で記述します。BES がある場合は業務イベント ID と名称を併記し、イベント契約は BES を正本とします。
97
+ - 複数のトリガーが同じ流れを起動する場合は、すべてが同じ業務成果へ収束することを確認します。成果が異なる場合は BPS を分けます。
98
+ - 前提条件は yes / no で判定できる文にし、不成立時に開始しない、差し戻す、または「例外・代替経路」のどれを適用するかを示します。
208
99
 
209
- ## 前提条件
100
+ 推奨するトリガー表は次の列で構成します。
210
101
 
211
- - 商品が販売可能状態
212
- - 発注点 > 0
102
+ | 列 | 記載内容 |
103
+ | -------------- | -------------------------------------- |
104
+ | トリガー ID | 文書内で一意な `T-01` 形式 |
105
+ | 出来事 | 発生時点を判定できる業務上の出来事 |
106
+ | 発生元 | 人、組織、外部主体、または業務イベント |
107
+ | 受領情報 | 開始判断に使用する情報 |
108
+ | 開始条件 | 処理開始を yes / no で判定できる条件 |
109
+ | 不成立時の扱い | 非起動、差戻し、または主要例外 ID |
213
110
 
214
- ## 入力
111
+ ### 6.3. 入力
215
112
 
216
- - 更新があった在庫(tm-inventory)
113
+ - 入力は業務上の論理名で記載し、入手元、利用目的、必須性、正本を示します。物理テーブル名、ファイル内部の列名、API の詳細項目へ展開しません。
114
+ - イベントの付帯情報は BES、データ項目の意味は BDD または CDSD、判断に使う条件は BR を正本とし、BPS ではこの流れで使う範囲を示します。
115
+ - 入力が欠けた場合に処理を開始できないか、既定値や代替情報を使えるかを前提条件または主要例外と対応させます。
217
116
 
218
- ## 処理
117
+ ### 6.4. 処理
219
118
 
220
- ### 処理(ステップ例)
119
+ - 正常な順序に沿って `S-01` から処理ステップを並べます。分岐は分岐条件と合流先または終了先を明示し、条件付きステップは必須性を示します。
120
+ - 一つのステップには、一人または一つの責任主体が完了を判断できる活動または判断を置きます。複数主体の承認や引き渡しはステップを分けます。
121
+ - 判断式や計算式の正本が BR にある場合は BR の ID と利用結果だけを記載し、ルール本文を複製しません。
122
+ - CDFD の個別プロセス ID がある場合は各ステップに対応付けます。一つの CDFD プロセスを複数ステップに分ける場合も、対応する ID を各行へ記載します。
221
123
 
222
- 1. 定番商品以外は除外
223
- 2. 発注数量を計算(発注数量 = 注文毎の発注点 − 現在在庫数)
224
- 3. 発注数量 > 0 の場合、発注候補を生成
225
- 4. bes-order-candidate-generated「発注候補生成」イベントを発火
124
+ 推奨する処理表は次の列で構成します。
226
125
 
227
- ### 処理(擬似コード例)
126
+ | 列 | 記載内容 |
127
+ | -------------- | -------------------------------------------------- |
128
+ | ステップ ID | 文書内で一意な `S-01` 形式 |
129
+ | CDFD プロセス | 対応する CDFD の個別プロセス ID |
130
+ | 担当 | 実施または判断の責任主体 |
131
+ | 入力 | このステップが使用する入力または直前ステップの成果 |
132
+ | 活動・判断 | 業務用語で表した活動、または参照する BR と判断結果 |
133
+ | 出力・完了条件 | 次のステップへ渡す成果と、完了を判定できる条件 |
134
+ | 例外 | 該当する主要例外 ID。なければ `-` |
228
135
 
229
- ```ts
230
- // 例外処理は省略
231
- // トリガー: bes-stock-amount-updated「在庫数更新」イベント
232
- type 在庫数更新イベント = {
233
- 商品ID: string;
234
- 新在庫数: number;
235
- };
136
+ ### 6.5. 出力
236
137
 
237
- function 在庫数更新イベントを処理する(イベント: 在庫数更新イベント) {
238
- const 商品 = 商品を取得する(イベント.商品ID);
239
- const 在庫 = 在庫を取得する(イベント.商品ID);
240
- if (!商品.定番商品フラグ) {
241
- return; // 定番以外は自動発注対象外
242
- }
138
+ - 出力は記録、状態変化、通知、判断結果、または次の業務への引き渡しとして記載し、受け手、確定条件、正本を示します。
139
+ - 状態変化がある場合は STSD の状態名と遷移を参照し、BPS で状態の意味や許可遷移を再定義しません。
140
+ - 業務イベントを発行する場合は BES の ID を示し、発行条件とこのプロセスの責任だけを記載します。イベントの項目定義や購読先は BES を正本とします。
243
141
 
244
- // 以下はサンプルでビジネスルールを直書き
245
- const 発注数量 = 商品.発注点 - 在庫.現在在庫数;
246
- if (発注数量 > 0) {
247
- const 発注候補 = {
248
- 商品ID: 商品.商品ID,
249
- 発注数量: 発注数量,
250
- };
251
- // 出力: bes-order-candidate-generated「発注候補生成」イベント発火
252
- 発注候補生成イベントを発火する(発注候補);
253
- }
254
- }
255
- ```
142
+ ### 6.6. 例外・代替経路
256
143
 
257
- ## 出力
144
+ - 主要例外は、業務成果または後続処理を変えるものに限定します。内部エラー、ログ文言、技術的な例外クラスを網羅しません。
145
+ - 表は「例外 ID」「対象ステップ」「検出条件」「停止範囲」「担当」「処置」「再開条件・代替成果」で構成します。
146
+ - 再試行回数などの運用値を BPS で決める場合は業務上の根拠を示します。技術的なリトライ方式や監視設定は運用設計または外部インターフェース仕様へ委ねます。
147
+ - 主要例外がない場合も章は残し、正常系、条件付き処理、入力不足、出力確定失敗を確認した範囲と、業務成果を変える例外がないという結論を記載します。
258
148
 
259
- - 発注候補生成イベント発火(bes-order-candidate-generated)
149
+ ### 6.7. 検証・受入観点
260
150
 
261
- ## 例外
151
+ - 正常系、条件付き処理、主要例外について、入力条件、期待する業務成果、確認可能な記録を対応付けます。
152
+ - 「正しく処理される」ではなく、「対象商品の発注候補が一件確定し、数量の根拠と判断に用いたルール ID を確認できる」のように判定可能な条件を記述します。
153
+ - 業務受入条件やテスト仕様に詳細を委ねる場合も、BPS 自体の完了条件を空にせず、後続文書が確認すべき業務成果を残します。
154
+
155
+ ### 6.8. 未決事項
156
+
157
+ - 調査で解消する情報不足は `_TODO_`、意思決定待ちは `_UNDECIDED_`、仮置きする前提は `_ASSUMPTION_` として区別します。
158
+ - 表は「論点」「影響する章・ステップ」「区分」「決定者」「決定時期」で構成し、本文中のラベルと対応させます。
159
+ - `ready` へ昇格する前に `_TODO_` を解消します。`_UNDECIDED_` を残す場合は、業務成果の受入可否に影響しないことと決定の追跡先を確認します。
262
160
 
263
- - 発注点未設定: ログ WARN, 商品スキップ
264
- - 外部API遅延(商品取得失敗: 3回リトライ後失敗記録
161
+ ### 6.9. 完成判定
265
162
 
266
- ## メモ
163
+ - Frontmatter に `id`、`type`、`status`、`rulebook` があり、ファイル名、ID、`type: flow` が本ルールと一致しています。
164
+ - 対象が一つのプロセス領域に属する一連の流れであり、起点、業務成果、対象外を説明できます。
165
+ - トリガー、前提条件、入力、全処理ステップ、出力、主要例外を開始から終了まで追跡でき、CDFD のプロセス ID と名称に矛盾がありません。
166
+ - 各処理ステップに担当、入力、活動または判断、出力、完了条件があり、分岐先と例外の対応を確認できます。
167
+ - BR、BES、BDD、CDSD、STSD などの参照先を正本として扱い、定義を複製していません。
168
+ - 正常系、条件付き処理、主要例外の受入条件が第三者に判定可能で、確認可能な記録または業務成果を示しています。
169
+ - 物理データ構造、詳細 API、画面操作、実装クラスなどの実装方式が混在していません。
170
+ - `_TODO_` が残っていません。`_UNDECIDED_` がある場合は「未決事項」に決定者と決定時期があります。
267
171
 
268
- 将来: 閾値を動的(曜日別)にする拡張検討。
269
- ````
172
+ ## 7. 禁止事項
173
+
174
+ - 複数のプロセス領域を一つの BPS に混在させたり、独立した起点または業務成果を「関連するから」という理由だけで一文書にまとめたりしません。
175
+ - CDFD のプロセス領域、プロセス ID、データストア名を BPS だけで追加、削除、改名しません。
176
+ - BR の判断式、BES のイベント契約、BDD・CDSD のデータ定義、STSD の状態定義・遷移表を複製しません。
177
+ - 処理ステップを画面のクリック順、CLI コマンド列、API 呼び出し順、クラスや関数の呼び出し順として記載しません。
178
+ - 物理テーブル、物理カラム、SQL、詳細 API 項目、実装クラス、ログ文言、秘密情報を記載しません。
179
+ - 担当、完了条件、分岐先、再開条件を空欄にしたり、「適切に処理する」「問題がなければ完了」のような判定不能な表現だけで済ませたりしません。
180
+ - 正常な非起動条件を主要例外として扱ったり、業務成果を変えない内部エラーを網羅的に列挙したりしません。
181
+ - 作成状況やレビュー状態を本文で管理しません。進捗と判断履歴は登録簿やレビュー結果で追跡します。
@@ -69,11 +69,11 @@ Business Rule (BR) Documentation Rules
69
69
 
70
70
  ## 6. 記述ガイド詳細
71
71
 
72
- ### 6.1 概要
72
+ ### 6.1. 概要
73
73
 
74
74
  短い一文で、何を判断/計算するルールかを業務用語で記述する。
75
75
 
76
- ### 6.2 入力
76
+ ### 6.2. 入力
77
77
 
78
78
  - 業務データ辞書のエンティティ・論理名を列挙し、利用目的を簡潔に付記。
79
79
  - 例: エンティティ:在庫、項目:在庫数・予約数、目的:不足判定の基準
@@ -81,7 +81,7 @@ Business Rule (BR) Documentation Rules
81
81
 
82
82
  - 入力は概念レベルで記述する(詳細は「9. 禁止事項」参照)。
83
83
 
84
- ### 6.3 ルール(判定/計算)
84
+ ### 6.3. ルール(判定/計算)
85
85
 
86
86
  - 箇条書きで条件式と意味をセットで記述する。
87
87
  - 数式や条件式は業務用語に沿って表現し、必要なら TypeScript 風の擬似コードで補足してもよい。
@@ -102,17 +102,17 @@ function 在庫不足判定(商品: 商品, 在庫: 在庫): boolean {
102
102
  }
103
103
  ```
104
104
 
105
- ### 6.4 出力
105
+ ### 6.4. 出力
106
106
 
107
107
  - 判定結果(真偽/カテゴリ/数値)を列挙。
108
108
  - 他プロセスが参照するための概念的な出力定義(例: 「不足フラグ」「優先度ランク」)。
109
109
 
110
- ### 6.5 例外 / 異常系
110
+ ### 6.5. 例外 / 異常系
111
111
 
112
112
  - 入力欠損・値の矛盾(発注点 < 0 等)・外部参照失敗など。
113
113
  - 失敗時挙動(スキップ/再試行/警告ログ/オペ通知)を記述。
114
114
 
115
- ### 6.6 メモ / 将来課題
115
+ ### 6.6. メモ / 将来課題
116
116
 
117
117
  既知の改善余地(閾値動的化、季節要因考慮など)。
118
118
 
@@ -147,41 +147,3 @@ function 在庫不足判定(商品: 商品, 在庫: 在庫): boolean {
147
147
  - 複雑なロジックを長文で記述 → サブルールへ分割し参照。
148
148
  - 物理データ項目を記載 → 概念データ辞書の論理名に置換。
149
149
  - BPSの手順を流用 → 本ドキュメントでは判断・計算のみを記述。
150
-
151
- ## 11. サンプル(簡易)
152
-
153
- ```markdown
154
- ---
155
- id: br-low-stock-judgment
156
- type: rule
157
- title: 在庫不足判定
158
- status: draft
159
- part_of: []
160
- based_on: []
161
- ---
162
-
163
- ## 概要
164
-
165
- 在庫数から予約数を差し引いた有効在庫が発注点を下回るか判定する。
166
-
167
- ## 入力
168
-
169
- - 在庫(在庫数・予約数)
170
- - 商品(発注点)
171
-
172
- ## ルール(判定/計算)
173
-
174
- 1. `(在庫数 − 予約数) < 発注点` → 不足
175
-
176
- ## 出力
177
-
178
- - 不足フラグ(boolean)
179
-
180
- ## 例外
181
-
182
- - 発注点未設定: ログ WARN, 商品スキップ
183
-
184
- ## メモ
185
-
186
- 将来: 閾値を曜日別に動的化
187
- ```
@@ -118,6 +118,7 @@ Conceptual Data Flow Diagram Process Group Documentation Rulebook
118
118
 
119
119
  - 全体概要の「データストア」と同じ「マスタ・構成データ」「トランザクションデータ」の節に分け、本グループが読み書きする行だけを掲載します。該当する行がない区分は節ごと省略します。
120
120
  - 表の列は「データストア」「読み書き」「本グループでの利用」とします。「読み書き」は「参照」「更新」「参照・更新」のいずれかとし、物の保管先を扱う場合は利用内容に現物の受け渡しであることを示します。
121
+ - 日本語名と概念の英語名が一対一に対応する場合は、`実行計画 / plan` のように `日本語名 / 英語名` の順で併記します。一対一の対応を確定できない場合は英語名を推測で補わず、日本語名だけを使用して用語集での確定を待ちます。
121
122
  - 名称と区分は全体概要から変更しません。新しいデータストアまたは区分変更が必要なら先に全体概要を変更し、本章だけへ追加しません。
122
123
  - プロセス領域の全箇条書きと個別プロセス主要入出力にあるデータストアを過不足なく含め、各データストアがどの領域またはプロセスで参照・更新されるかを利用内容で説明します。
123
124
  - 概念データフローを複数図に分けて同じデータストアを再掲する場合を除き、表の各行と図のデータストアノードを一対一に対応させ、名称を一致させます。
@@ -175,6 +176,7 @@ Conceptual Data Flow Diagram Process Group Documentation Rulebook
175
176
  - product 成果物の ID を `<project-id>:cdfd-<group>` にしたり、領域名を使った `cdfd-<domain>` を新規採用したりしません。
176
177
  - 文書内一意の `P-01` 形式を内部プロセス ID に使ったり、領域 ID と対応しないプロセス ID を付けたりしません。
177
178
  - 全体概要と異なるデータストア名・区分を使用したり、物理テーブル名、物理カラム名、SQL、実装クラス、詳細 API を概念フローへ記載したりしません。
179
+ - 日本語名と一対一に対応する概念の英語名の併記は、物理テーブル名、物理カラム名、実装クラスなどの実装名の記載には該当しません。
178
180
  - 状態名・意味を CDFD で定義したり、遷移元・遷移先・遷移条件の表や状態遷移図を複製したりしません。
179
181
  - 他グループの内部プロセスを展開したり、同一グループ内の領域間受け渡しをグループ外委譲として扱ったりしません。
180
182
  - 一覧、検索、状態参照、検証、dry-run など、独自の業務成果を持たない補助操作を独立プロセスにしません。
@@ -209,90 +209,3 @@ Frontmatter は共通スキーマに従います(参照: [docs/specdojo/schema
209
209
  | 移行ツールの実装コードや長大なSQLを本文に貼り付ける | 差分管理が破綻し、更新不整合を起こすため(参照リンクに寄せる) |
210
210
  | `dmd-index` と矛盾する共通方針(run_id/冪等性/検証種別)を記載する | ドキュメント間で判断基準が分裂するため |
211
211
  | 「関連ドキュメント」セクションを省略する | 導線が失われ、参照先が分散するため |
212
-
213
- ## 8. サンプル(最小・整合版)
214
-
215
- 注:以下はルール文書内の例示です。生成する `dmd-index` / `dmd-<term>` では `## 1...` から始まります。
216
-
217
- ### 8.1. `dmd-<term>`(個別SSOT:例)
218
-
219
- ```yaml
220
- ---
221
- id: dmd-order-data
222
- type: project
223
- title: データ移行設計: 受注データ
224
- status: draft
225
- based_on:
226
- - dmd-index
227
- - mip-index
228
- supersedes: []
229
- ---
230
-
231
- ```
232
-
233
- #### 1. 概要(order-data)
234
-
235
- 受注データを旧基盤から新基盤へ移行するための抽出・変換・投入・検証方法を定義する。
236
- 共通方針(run_id・冪等性・検証の最小セット)は `dmd-index` を正とする。
237
-
238
- #### 2. 対象データ詳細(テーブル/期間/抽出条件/概算件数)
239
-
240
- | 対象 | 期間/抽出条件 | 方式(フル/増分) | 増分基準(カラム/キー/基準時刻) | 概算件数 | 備考 |
241
- | ---------- | --------------- | ----------------- | -------------------------------- | --------- | ---------- |
242
- | orders | 2024-01-01 以降 | フル | - | 2,300,000 | 旧基盤のみ |
243
- | order_item | ordersに紐づく | フル | - | 8,900,000 | |
244
-
245
- #### 3. データマッピング
246
-
247
- | 旧データ | 新データ | 変換/補足 |
248
- | ------------------- | -------------------- | ------------------------------ |
249
- | orders.order_id | orders.id | 主キー維持(連番維持) |
250
- | orders.status | orders.state | コード変換(参照表に従う) |
251
- | order_item.order_id | order_items.order_id | orders投入後に投入(参照整合) |
252
-
253
- #### 4. 変換ルール
254
-
255
- - 状態コードは旧→新の変換表に従う
256
- - 日付は UTC に統一する
257
-
258
- #### 5. 除外ルール
259
-
260
- - 取消済みかつ 3 年経過のデータは除外(業務上不要、参照も不要)
261
-
262
- #### 6. 移行手順(手動/バッチ/ツール)
263
-
264
- | 手順 | 内容 | 入力 | 出力 | 実行単位(ジョブ/コマンド) | 備考 |
265
- | ---- | ---- | ---------------- | ------------------- | --------------------------- | ---------- |
266
- | 1 | 抽出 | 旧DB | 抽出ファイル(CSV) | job: export_orders | S3に配置 |
267
- | 2 | 変換 | 抽出ファイル | 変換済みファイル | job: transform_orders | 変換表参照 |
268
- | 3 | 投入 | 変換済みファイル | 新DB | job: load_orders | run_id付与 |
269
-
270
- #### 7. 性能/所要時間見積
271
-
272
- - 1,000,000 件あたり 45 分(並列度 4)
273
- - 目標:停止許容時間(`mip-index`)内に完了する
274
-
275
- #### 8. ログ/再実行性
276
-
277
- | 項目 | 方針 |
278
- | ------------ | ------------------------------------ |
279
- | 識別キー | run_id |
280
- | ログ保存先 | 移行ログ基盤(例:S3/logs) |
281
- | 冪等性方式 | run_id隔離(同一run_idは再投入不可) |
282
- | 再実行可否 | 別run_idで再実行可 |
283
- | データ無効化 | run_id単位で隔離/無効化フラグ |
284
-
285
- #### 9. 検証方法(件数照合/サンプル照合/重要値)
286
-
287
- | 検証種別 | 検証項目 | 方法 | 合格基準(差分0 / 許容差ε) | 証跡 |
288
- | ------------ | ----------------------- | --------------- | --------------------------- | ---------------- |
289
- | 件数照合 | orders件数 | 旧/新件数比較 | 差分0 | 照合レポート |
290
- | サンプル照合 | 重要顧客100件の受注明細 | 旧/新の明細突合 | 差分0 | 抜取検証ログ |
291
- | 重要値照合 | 売上合計(期間別) | 旧/新集計値比較 | 差分0 | 集計照合レポート |
292
-
293
- #### 10. 関連ドキュメント
294
-
295
- - `dmd-index`:データ移行設計の入口(共通方針/run_id/検証)
296
- - `mip-index`:移行計画(対象期間/停止許容時間/成功条件)
297
- - `mtp-index`:移行リハーサル(検証計画・証跡)
298
- - (必要に応じて)`cop-index`:当日切替(実行順序・判定点)