specdojo 0.6.0 → 0.7.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.
- package/CHANGELOG.md +40 -0
- package/README.md +2 -2
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +1 -0
- package/dist/commands/orchestrator.js +10 -1
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +4 -3
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/parent-validation.js +7 -0
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-generation.js +6 -2
- package/dist/exec/register-resume.js +28 -0
- package/dist/exec/run/lifecycle-commands.js +85 -16
- package/dist/exec/run/register-command.js +6 -0
- package/dist/exec/run/schedule-mode.js +22 -2
- package/dist/exec/run/schedule-prepare.js +42 -1
- package/dist/exec/run/schedule-task.js +3 -0
- package/dist/exec/worktree-ops-commit.js +1 -13
- package/dist/exec/worktree-ops-lifecycle.js +40 -36
- package/dist/register/register.js +31 -23
- package/dist/shared/git.js +7 -0
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +14 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -8
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
- package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
- package/docs/ja/specdojo/references/command-reference.md +69 -37
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +5 -2
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
|
@@ -11,136 +11,167 @@ specdojo:
|
|
|
11
11
|
|
|
12
12
|
# 概念データフロー図(ユースケース別): 欠品から補充まで
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
本書は、駄菓子屋きぬやの [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] のケース `C-02`「欠品から補充まで」について、在庫・仕入・販売を通る流れと、受け渡す情報・商品を示す。product 成果物として作成する場合の ID は `cdfd-uc-replenishment` とする。
|
|
15
15
|
|
|
16
16
|
## 1. 目的
|
|
17
17
|
|
|
18
|
-
|
|
19
|
-
- 開発担当は、在庫・仕入・販売の境界で受け渡す補充依頼、入荷数量、売場商品を後続設計の入力として利用する。
|
|
20
|
-
- 同行レビュー担当は、ケース `C-02` の参加グループ、引き渡し、戻り経路に重複・欠落がなく、各グループの内部処理を再掲していないことを確認する。
|
|
18
|
+
欠品した商品を補充し、売場で販売できるようにするために、在庫の補充判断から仕入を経て販売が商品を引き受けるまでの流れを示す。
|
|
21
19
|
|
|
22
20
|
## 2. 適用範囲
|
|
23
21
|
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
- 正常系は在庫(`P-05`〜`P-06`)→ 仕入(`P-01`〜`P-02`)→ 販売(`P-03`〜`P-04`)の三グループを横断する。単一店舗の店主代表と店番担当を対象組織とし、仕入先は各グループ内部の外部主体として本書では展開しない。
|
|
27
|
-
- システム境界は、補充依頼、発注・受入結果、入荷数量の記録確認と、売場商品の引き渡しまでである。画面操作、保存方式、仕入先との通信方式は対象外とする。
|
|
28
|
-
- 在庫計算と補充判断の内部は `cdfd-inventory`、発注と入荷検品の内部は `cdfd-purchasing`、店頭販売の内部は `cdfd-sales` を正本とし、本書では内部プロセスと内部例外を再掲しない。
|
|
29
|
-
- 商品の状態名・成立条件・遷移元・遷移先・イベント・遷移条件は `stsd-product` を正本とし、本書では定義しない。
|
|
30
|
-
- 店主代表、店番担当、システムの責任分担は [[specdojo:prj-overview-sample|プロジェクト概要]] に従う。補充数量、発注、受入可否の最終判断は店主代表が担い、システムは記録と照合を支援する。
|
|
22
|
+
- **対象**: 単一店舗の `C-02`「欠品から補充まで」として、在庫が補充基準を下回ってから在庫(`P-05`〜`P-06`)→ 仕入(`P-01`〜`P-02`)→ 販売(`P-03`〜`P-04`)を経て、受入品を売場棚へ配置し、販売が商品を扱えるまでを対象とする。
|
|
23
|
+
- **対象外**: 在庫計算・補充判断・発注・入荷検品・店頭販売の内部は `cdfd-inventory`・`cdfd-purchasing`・`cdfd-sales`、商品の状態定義・遷移は `stsd-product` へ委ね、補助操作・画面・保存方式・仕入先との通信は扱わず、店主代表・店番担当・システムの責任分担は [[specdojo:cdfd-overview-sample|全体概要]] を参照する。
|
|
31
24
|
|
|
32
25
|
## 3. プロセス領域
|
|
33
26
|
|
|
34
|
-
ケース `C-02`
|
|
27
|
+
ケース `C-02` は在庫、仕入、販売の三グループをこの順に横断する。領域の分割・名称は全体概要を正本とし、本章は各グループの役割、図は受け渡しの正本とする。
|
|
35
28
|
|
|
36
29
|
### 3.1. 在庫(P-05〜P-06)
|
|
37
30
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
-
|
|
41
|
-
- **主要出力**: 補充対象の商品・数量・補充判断
|
|
42
|
-
- **データストア**: 商品台帳、在庫記録
|
|
43
|
-
|
|
44
|
-
| 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
|
|
45
|
-
| ---- | ---------------- | -------------- | ---------------------------------------------------------------------------- | ---------------- |
|
|
46
|
-
| 1 | 在庫 | `P-05`〜`P-06` | 補充基準を下回った商品について補充対象と数量を確定し、仕入へ補充依頼を渡す。 | `cdfd-inventory` |
|
|
31
|
+
| 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
|
|
32
|
+
| ---- | ---------------------- | -------------- | -------------------------------------------------------------------------------------------------- | ---------------- |
|
|
33
|
+
| 1 | 在庫 | `P-05`〜`P-06` | 商品台帳で補充対象を特定し、発注単位に合う数量を確定して、店主代表が承認した補充依頼を仕入へ渡す。 | `cdfd-inventory` |
|
|
47
34
|
|
|
48
35
|
### 3.2. 仕入(P-01〜P-02)
|
|
49
36
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
-
|
|
53
|
-
- **主要出力**: 受入品、入荷数量、受入結果、売場への配置
|
|
54
|
-
- **データストア**: 仕入記録、在庫記録、売場棚
|
|
55
|
-
|
|
56
|
-
| 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
|
|
57
|
-
| ---- | ---------------- | -------------- | ---------------------------------------------------------------- | ----------------- |
|
|
58
|
-
| 2 | 仕入 | `P-01`〜`P-02` | 補充依頼を受け、受入結果と入荷数量を記録し、受入品を売場へ渡す。 | `cdfd-purchasing` |
|
|
37
|
+
| 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
|
|
38
|
+
| ---- | ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------ | ----------------- |
|
|
39
|
+
| 2 | 仕入 | `P-01`〜`P-02` | 補充依頼を受けて発注・入荷を行い、受入結果と入荷数量を記録し、記録と一致する受入品を売場棚へ配置する。 | `cdfd-purchasing` |
|
|
59
40
|
|
|
60
41
|
### 3.3. 販売(P-03〜P-04)
|
|
61
42
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
-
|
|
65
|
-
- **主要出力**: 販売対象として引き受けた売場商品
|
|
66
|
-
- **データストア**: 売場棚
|
|
67
|
-
|
|
68
|
-
| 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
|
|
69
|
-
| ---- | ---------------- | -------------- | ---------------------------------------------------- | ------------ |
|
|
70
|
-
| 3 | 販売 | `P-03`〜`P-04` | 売場棚へ配置された受入品を販売対象として引き受ける。 | `cdfd-sales` |
|
|
43
|
+
| 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
|
|
44
|
+
| ---- | ---------------------- | -------------- | ------------------------------------------------------------------------------------------ | ------------ |
|
|
45
|
+
| 3 | 販売 | `P-03`〜`P-04` | 売場棚へ配置された受入品を、確定した入荷数量・受入結果と照合し、販売対象として引き受ける。 | `cdfd-sales` |
|
|
71
46
|
|
|
72
47
|
## 4. データストア
|
|
73
48
|
|
|
74
|
-
|
|
49
|
+
全体概要からこのケースで参照・更新する正本だけを同じ名称・区分で示す。
|
|
75
50
|
|
|
76
51
|
### 4.1. マスタ・構成データ
|
|
77
52
|
|
|
78
|
-
| データストア |
|
|
79
|
-
| ------------ |
|
|
80
|
-
| 商品台帳 |
|
|
53
|
+
| データストア | 関連する参加単位 | 横断上の利用 |
|
|
54
|
+
| ------------ | ---------------- | ---------------------------------------------- |
|
|
55
|
+
| 商品台帳 | 在庫 | 補充基準と発注単位を参照し、補充対象を特定する |
|
|
81
56
|
|
|
82
57
|
### 4.2. トランザクションデータ
|
|
83
58
|
|
|
84
|
-
| データストア |
|
|
85
|
-
| ------------ |
|
|
86
|
-
| 在庫記録 |
|
|
87
|
-
| 仕入記録 |
|
|
88
|
-
| 売場棚 |
|
|
59
|
+
| データストア | 関連する参加単位 | 横断上の利用 |
|
|
60
|
+
| ------------ | ---------------- | ------------------------------------------------------ |
|
|
61
|
+
| 在庫記録 | 在庫、仕入 | 在庫数量を参照して補充対象を判断し、入荷数量を反映する |
|
|
62
|
+
| 仕入記録 | 仕入 | 発注・受入結果を記録する |
|
|
63
|
+
| 売場棚 | 仕入、販売 | 受入品を配置し、販売が売場商品を引き受ける(物理保管) |
|
|
89
64
|
|
|
90
65
|
## 5. 概念データフロー
|
|
91
66
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
67
|
+
### 5.1. 欠品から売場補充まで
|
|
68
|
+
|
|
69
|
+
在庫が承認済みの補充依頼を仕入へ渡し、仕入が入荷数量・受入結果を記録して、販売が売場商品を引き受ける。
|
|
70
|
+
|
|
71
|
+
```d2
|
|
72
|
+
direction: down
|
|
73
|
+
|
|
74
|
+
classes: {
|
|
75
|
+
process: {
|
|
76
|
+
shape: rectangle
|
|
77
|
+
style: {
|
|
78
|
+
border-radius: 8
|
|
79
|
+
fill: "#e3f2fd"
|
|
80
|
+
stroke: "#1e88e5"
|
|
81
|
+
font-color: "#000000"
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
event: {
|
|
85
|
+
shape: hexagon
|
|
86
|
+
style: {
|
|
87
|
+
fill: "#fff3e0"
|
|
88
|
+
stroke: "#fb8c00"
|
|
89
|
+
font-color: "#000000"
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
store_master: {
|
|
93
|
+
shape: cylinder
|
|
94
|
+
style: {
|
|
95
|
+
fill: "#e8f5e9"
|
|
96
|
+
stroke: "#43a047"
|
|
97
|
+
font-color: "#000000"
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
store_transaction: {
|
|
101
|
+
shape: cylinder
|
|
102
|
+
style: {
|
|
103
|
+
fill: "#c8e6c9"
|
|
104
|
+
stroke: "#2e7d32"
|
|
105
|
+
font-color: "#000000"
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
physical_store: {
|
|
109
|
+
shape: rectangle
|
|
110
|
+
style: {
|
|
111
|
+
border-radius: 20
|
|
112
|
+
fill: "#c8e6c9"
|
|
113
|
+
stroke: "#2e7d32"
|
|
114
|
+
font-color: "#000000"
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
material_flow: {
|
|
118
|
+
style: {
|
|
119
|
+
stroke-width: 3
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
start: "⚡ 在庫が補充基準を\n下回った" { class: event }
|
|
125
|
+
inventory: "📦 在庫\nP-05〜P-06" { class: process }
|
|
126
|
+
purchasing: "🚚 仕入\nP-01〜P-02" { class: process }
|
|
127
|
+
sales: "🛒 販売\nP-03〜P-04" { class: process }
|
|
128
|
+
end: "⚡ 販売が売場商品を\n扱える" { class: event }
|
|
129
|
+
item_master: "📐 商品台帳" { class: store_master }
|
|
130
|
+
inventory_record: "📒 在庫記録" { class: store_transaction }
|
|
131
|
+
purchase_record: "📒 仕入記録" { class: store_transaction }
|
|
132
|
+
display_shelf: "🏬 売場棚" { class: physical_store }
|
|
133
|
+
|
|
134
|
+
start -> inventory: "起動条件"
|
|
135
|
+
item_master -> inventory: "補充基準・発注単位"
|
|
136
|
+
inventory_record -> inventory: "在庫数量"
|
|
137
|
+
inventory -> purchasing: "補充依頼(商品・数量・承認)"
|
|
138
|
+
purchasing -> purchase_record: "発注・受入結果"
|
|
139
|
+
inventory_record <- purchasing: "入荷数量"
|
|
140
|
+
purchasing -> display_shelf: "受入品" { class: material_flow }
|
|
141
|
+
purchasing -> sales: "入荷数量・受入結果"
|
|
142
|
+
display_shelf -> sales: "売場商品" { class: material_flow }
|
|
143
|
+
sales -> end: "販売対象の引受結果"
|
|
130
144
|
```
|
|
131
145
|
|
|
132
|
-
|
|
146
|
+
凡例は [[specdojo:cdfd-overview-sample|全体概要]] の「凡例(本プロダクト共通)」を参照し、通常線は情報、太線は商品の流れに用いる。各グループ内部は省略し、次の図でも在庫・仕入・販売の代表ノードを共有する。
|
|
147
|
+
|
|
148
|
+
### 5.2. 例外時の戻り
|
|
149
|
+
|
|
150
|
+
補充依頼の不足は仕入から在庫へ、受入結果や売場配置の不一致は販売から仕入へ返し、補完・再判断後の情報を再提示する。
|
|
133
151
|
|
|
134
|
-
|
|
152
|
+
```d2
|
|
153
|
+
direction: down
|
|
135
154
|
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
155
|
+
classes: {
|
|
156
|
+
process: {
|
|
157
|
+
shape: rectangle
|
|
158
|
+
style: {
|
|
159
|
+
border-radius: 8
|
|
160
|
+
fill: "#e3f2fd"
|
|
161
|
+
stroke: "#1e88e5"
|
|
162
|
+
font-color: "#000000"
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
}
|
|
140
166
|
|
|
141
|
-
|
|
167
|
+
inventory: "📦 在庫\nP-05〜P-06" { class: process }
|
|
168
|
+
purchasing: "🚚 仕入\nP-01〜P-02" { class: process }
|
|
169
|
+
sales: "🛒 販売\nP-03〜P-04" { class: process }
|
|
170
|
+
|
|
171
|
+
inventory <- purchasing: "不足項目・商品候補・現在庫・補充基準"
|
|
172
|
+
inventory -> purchasing: "修正・再承認済みの補充依頼"
|
|
173
|
+
purchasing <- sales: "数量の差異・未確定の受入結果・配置状況"
|
|
174
|
+
purchasing -> sales: "照合・配置確認済みの入荷数量・受入結果"
|
|
175
|
+
```
|
|
142
176
|
|
|
143
|
-
|
|
144
|
-
| ------------ | ------------------------------------------------------------------------------------------------ | -------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
|
|
145
|
-
| `H-01` | 商品を一意に特定できない、数量または発注単位が不足している、または店主代表の承認を確認できない。 | 在庫 | 不足項目、商品候補、現在庫、補充基準 | 商品と発注単位に合う数量を確定し、店主代表が修正後の補充依頼を承認して `H-01` を再提示した。 |
|
|
146
|
-
| `H-02` | 入荷数量・受入結果と受入品が一致しない、受入結果が未確定、または受入品が売場棚にない。 | 仕入 | 記録と受入品の差異、未確定の受入結果、売場棚への配置状況 | 記録と受入品が一致し、受入結果の確定と売場棚への配置を確認して `H-02` を再提示した。 |
|
|
177
|
+
凡例は [[specdojo:cdfd-overview-sample|全体概要]] を参照し、本図は通常線による情報の戻りと再提示を示す。商品と発注単位に合う数量を再確定する在庫の判断、受入結果の確定と現物照合・売場配置を確認する仕入の判断が重要なため図を追加し、データストアと物の流れ、内部の再試行は省略する。
|
|
@@ -19,33 +19,23 @@ _TODO_: 対象の業務または運用が何を扱うかを一文で定義する
|
|
|
19
19
|
|
|
20
20
|
## 1. 目的
|
|
21
21
|
|
|
22
|
-
_TODO_:
|
|
23
|
-
|
|
24
|
-
- _ROLE_ は、_TODO_: 対象範囲と領域分割を承認する、詳細化する、設計入力として使う、重複・欠落を確認する、のように利用結果を判定できる形で書く。
|
|
25
|
-
- _ROLE_ は、_TODO_
|
|
26
|
-
- _ROLE_ は、_TODO_
|
|
22
|
+
_TARGET_NAME_ の業務または運用の全体像として、_TODO_: プロセス領域のまとまりと、それらが読み書きするデータの関係を 1〜2 文で示す。
|
|
27
23
|
|
|
28
24
|
## 2. 適用範囲
|
|
29
25
|
|
|
30
26
|
- 対象は、_TODO_: 開始点、終了点、対象業務、組織またはシステム境界を書く。
|
|
31
|
-
- 本書が扱うのは、プロセス領域の分割と、領域間・データストア間の受け渡しまでである。各領域の内部(_TODO_:
|
|
27
|
+
- 本書が扱うのは、プロセス領域の分割と、領域間・データストア間の受け渡しまでである。各領域の内部(_TODO_: 操作手順、更新内容、処理の分岐、状態を変える処理と起点イベント、例外時の復旧手順など)は対象外とし、選択した方式の詳細 CDFD で詳細化する。状態の定義と遷移はステータス定義(Status Definition: STSD、`specdojo:stsd-rulebook`)を正本とし、詳細 CDFD は参照に留める。
|
|
32
28
|
- _TODO_: 一覧、検索、状態参照、検証などの補助操作を列挙し、独立した業務フローに含めず各領域を支える操作として扱うことを書く。
|
|
33
29
|
- 人間と AI Agent の責任分担は、_TODO_: 対応する方針文書があれば `[[_AUTHORITY_:prj-overview|プロジェクト概要]]` のように参照し、なければ「承認・完了判断は人間が担い、作成・評価は人が担うほか AI Agent へ委譲できる」のように原則を一文で書く。
|
|
34
30
|
|
|
35
31
|
## 3. プロセス領域
|
|
36
32
|
|
|
37
|
-
業務は _AREA_COUNT_
|
|
33
|
+
業務は _AREA_COUNT_ のプロセス領域を _GROUP_COUNT_ のプロセスグループまたは区分にまとめる。領域の定義は本書の表、受け渡しは本書の図、領域内部は選択した方式の詳細 CDFD を正本とする。
|
|
38
34
|
|
|
39
|
-
<!--
|
|
35
|
+
<!-- 今の方式ではプロセスグループ、系統の関係を描く方式では区分ごとに 3.n の節を繰り返す。8 以下とし、各節は領域表だけにする。PDCA(Plan、Do、Check、Action、全体など)は任意の列として追加できる。 -->
|
|
40
36
|
|
|
41
37
|
### 3.1. _PROCESS_GROUP_NAME_(_PROCESS_AREA_ID_〜_PROCESS_AREA_ID_)
|
|
42
38
|
|
|
43
|
-
_TODO_: グループの役割と、グループ内の領域がどう連携するかを 1〜3 文で要約する。
|
|
44
|
-
|
|
45
|
-
- **主要入力**: _TODO_: 他グループからの要求、外部主体からの入力、参照するデータストアの内容を名詞で列挙する。
|
|
46
|
-
- **主要出力**: _TODO_: 更新・生成するデータストアの内容、他グループへの要求を名詞で列挙する。
|
|
47
|
-
- **データストア**: _TODO_: 「データストア」と同じ名称で、参照・更新するデータストアを列挙する。
|
|
48
|
-
|
|
49
39
|
<!-- prettier-ignore -->
|
|
50
40
|
| 領域 ID | プロセス領域 | 業務目的 | 主な担当 | 起点イベント |
|
|
51
41
|
| --- | --- | --- | --- | --- |
|
|
@@ -54,12 +44,6 @@ _TODO_: グループの役割と、グループ内の領域がどう連携する
|
|
|
54
44
|
|
|
55
45
|
### 3.2. _PROCESS_GROUP_NAME_(_PROCESS_AREA_ID_)
|
|
56
46
|
|
|
57
|
-
_TODO_
|
|
58
|
-
|
|
59
|
-
- **主要入力**: _TODO_
|
|
60
|
-
- **主要出力**: _TODO_
|
|
61
|
-
- **データストア**: _TODO_
|
|
62
|
-
|
|
63
47
|
<!-- prettier-ignore -->
|
|
64
48
|
| 領域 ID | プロセス領域 | 業務目的 | 主な担当 | 起点イベント |
|
|
65
49
|
| --- | --- | --- | --- | --- |
|
|
@@ -89,37 +73,66 @@ _TODO_: 区分の意味、パスの略記(例: `<project-id>` が指す範囲
|
|
|
89
73
|
|
|
90
74
|
## 5. 概念データフロー(概要)
|
|
91
75
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
<!--
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
76
|
+
_TODO_: 採用する構成方式(今の方式、または系統の関係を描く方式)と、この章で示す関係を 1〜2 文で書く。
|
|
77
|
+
|
|
78
|
+
<!-- 以下は今の方式の 1 図の雛形。16 ノードを超える場合はデータストアの区分または使い方の流れで節に分ける。系統の関係を描く方式では区分を代表ノードにし、データの種類で分けた図の間で位置をそろえ、受け渡しの線のない区分は省く。各区分はいずれかの図に必ず出す。調整役(Orchestrator)はデータの図に置かず、必要なら指示の図を別に置く。調整役は直接読み書きするストアだけにつなぎ、CLI 経由の読み書きはデータの図の該当区分から描く。区分間の実行要求は名詞のラベルで描いてよい。全図で名称を統一し、同じストアの再掲を認める。 -->
|
|
79
|
+
|
|
80
|
+
<!-- 複数図の場合は、例えば「5.1. PDCA のプロセスとデータの関係」「5.2. プロセスを実行する設定・構成情報の流れ」「5.3. Orchestrator による PDCA の調整」のように業務の言葉で題を付け、各節に図と読み取れることを 1 文で置く。 -->
|
|
81
|
+
|
|
82
|
+
_TODO_: 図の題を業務の言葉で書く。
|
|
83
|
+
|
|
84
|
+
```d2
|
|
85
|
+
direction: down
|
|
86
|
+
|
|
87
|
+
classes: {
|
|
88
|
+
process: {
|
|
89
|
+
shape: rectangle
|
|
90
|
+
style: {
|
|
91
|
+
border-radius: 8
|
|
92
|
+
fill: "#e3f2fd"
|
|
93
|
+
stroke: "#1e88e5"
|
|
94
|
+
font-color: "#000000"
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
store_master: {
|
|
98
|
+
shape: cylinder
|
|
99
|
+
style: {
|
|
100
|
+
fill: "#e8f5e9"
|
|
101
|
+
stroke: "#43a047"
|
|
102
|
+
font-color: "#000000"
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
store_transaction: {
|
|
106
|
+
shape: cylinder
|
|
107
|
+
style: {
|
|
108
|
+
fill: "#c8e6c9"
|
|
109
|
+
stroke: "#2e7d32"
|
|
110
|
+
font-color: "#000000"
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
process_group: "_PROCESS_GROUP_NAME_\n_PROCESS_AREA_ID_〜_PROCESS_AREA_ID_" {
|
|
116
|
+
class: process
|
|
117
|
+
}
|
|
118
|
+
master_store: "_DATA_STORE_NAME_" {
|
|
119
|
+
class: store_master
|
|
120
|
+
}
|
|
121
|
+
transaction_store: "_DATA_STORE_NAME_" {
|
|
122
|
+
class: store_transaction
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
master_store -> process_group: "_INPUT_LABEL_"
|
|
126
|
+
process_group -> transaction_store: "_OUTPUT_LABEL_"
|
|
113
127
|
```
|
|
114
128
|
|
|
115
|
-
|
|
129
|
+
_TODO_: この図から読み取れる業務上の関係を 1 文で書く。作図の約束は凡例にまとめる。
|
|
116
130
|
|
|
117
131
|
## 6. 詳細 CDFD 一覧
|
|
118
132
|
|
|
119
|
-
|
|
133
|
+
_TODO_: 採用した方式の詳細化先を簡潔に示す。状態の定義と遷移は STSD を正本とし、詳細 CDFD は参照に留める。
|
|
120
134
|
|
|
121
|
-
|
|
122
|
-
- ユースケース別 CDFD は、複数のプロセスグループをまたぐ順序と引き渡し条件だけを定める。グループ内部のプロセスは再掲せず、プロセスグループ別 CDFD を参照する。単一のグループに閉じる業務はユースケース別 CDFD を作らない。
|
|
135
|
+
<!-- 今の方式では、以下の 2 表を使う。プロセスグループ別 CDFD はグループ内部のプロセス・起点イベント・例外・復旧・ストアの読み書きを定め、ユースケース別 CDFD は複数グループ間の順序と引き渡し条件だけを定める。系統の関係を描く方式では、6.1 の表を省略するか移行期・非推奨の記録とし、6.2 の表を各系統の流れを領域単位で詳細化する一覧に置き換える。列はケース ID、ユースケース(系統名)、業務目的、対象系統・領域、ユースケース別 CDFD とする。 -->
|
|
123
136
|
|
|
124
137
|
### 6.1. プロセスグループ別 CDFD
|
|
125
138
|
|
|
@@ -131,7 +144,7 @@ flowchart LR
|
|
|
131
144
|
|
|
132
145
|
### 6.2. ユースケース別 CDFD
|
|
133
146
|
|
|
134
|
-
_TODO_:
|
|
147
|
+
_TODO_: 今の方式では、複数グループを横断する順序と引き渡し条件を扱う旨を書く。系統の関係を描く方式では、各系統の入口・引き渡し・終了のイベントとストアの読み書きを領域単位で定める旨を書く。
|
|
135
148
|
|
|
136
149
|
<!-- prettier-ignore -->
|
|
137
150
|
| ケース ID | ユースケース | 業務目的 | 横断するプロセスグループ | ユースケース別 CDFD |
|
|
@@ -142,51 +155,116 @@ _TODO_: 複数のプロセスグループを横断し、順序と引き渡し条
|
|
|
142
155
|
|
|
143
156
|
<!-- 詳細 CDFD が複数存在し、共通のノード形状・色・絵文字を使う場合に設ける。単一の CDFD しかない場合は章ごと削除し、以降の章番号を詰める。 -->
|
|
144
157
|
|
|
145
|
-
本プロダクトの全 CDFD
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
158
|
+
本プロダクトの全 CDFD が共通して参照するノード形状・色・絵文字の対応を示す。個々の CDFD は、以下の定義を再掲せず、本章への参照に留める。
|
|
159
|
+
|
|
160
|
+
図の記法には D2([[specdojo:cdfd-d2-rulebook|D2 記法ルール]])を採用し、`direction: down` で縦に配置する。矢印は情報または実行要求の受け渡しであり、実行順や毎回の通過を意味しない。更新の線は更新前の参照を含む。`->`(戻りは `<-`)の通常線は情報、`material_flow` class の太線は物の流れを表す。配置制御用の非表示の線は受け渡しを表さない。
|
|
161
|
+
|
|
162
|
+
_TODO_: 外部主体と起点イベントを図に置くか省くか、およびその理由を書く。複数の代表ノードは上から下へ読める順に並べ、戻りの線は `<-` で書く。並びを固定する非表示の線を使う場合は、直前に「配置制御用(受け渡しではない)」とコメントする。
|
|
163
|
+
|
|
164
|
+
```d2
|
|
165
|
+
direction: down
|
|
166
|
+
|
|
167
|
+
classes: {
|
|
168
|
+
process: {
|
|
169
|
+
shape: rectangle
|
|
170
|
+
style: {
|
|
171
|
+
border-radius: 8
|
|
172
|
+
fill: "#e3f2fd"
|
|
173
|
+
stroke: "#1e88e5"
|
|
174
|
+
font-color: "#000000"
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
event: {
|
|
178
|
+
shape: hexagon
|
|
179
|
+
style: {
|
|
180
|
+
fill: "#fff3e0"
|
|
181
|
+
stroke: "#fb8c00"
|
|
182
|
+
font-color: "#000000"
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
store_master: {
|
|
186
|
+
shape: cylinder
|
|
187
|
+
style: {
|
|
188
|
+
fill: "#e8f5e9"
|
|
189
|
+
stroke: "#43a047"
|
|
190
|
+
font-color: "#000000"
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
store_transaction: {
|
|
194
|
+
shape: cylinder
|
|
195
|
+
style: {
|
|
196
|
+
fill: "#c8e6c9"
|
|
197
|
+
stroke: "#2e7d32"
|
|
198
|
+
font-color: "#000000"
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
physical_store: {
|
|
202
|
+
shape: rectangle
|
|
203
|
+
style: {
|
|
204
|
+
border-radius: 20
|
|
205
|
+
fill: "#c8e6c9"
|
|
206
|
+
stroke: "#2e7d32"
|
|
207
|
+
font-color: "#000000"
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
actor: {
|
|
211
|
+
shape: rectangle
|
|
212
|
+
style: {
|
|
213
|
+
fill: "#f5f7fa"
|
|
214
|
+
stroke: "#607d8b"
|
|
215
|
+
font-color: "#000000"
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
material_flow: {
|
|
219
|
+
style: {
|
|
220
|
+
stroke-width: 3
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
actor_node: "🧑 外部主体" {
|
|
226
|
+
class: actor
|
|
227
|
+
}
|
|
228
|
+
event_node: "⚡ 起点イベント" {
|
|
229
|
+
class: event
|
|
230
|
+
}
|
|
231
|
+
process_node: "⚙️ プロセス/プロセスグループ/区分" {
|
|
232
|
+
class: process
|
|
233
|
+
}
|
|
234
|
+
master_store: "🗄️ マスタ・構成データ" {
|
|
235
|
+
class: store_master
|
|
236
|
+
}
|
|
237
|
+
transaction_store: "🗄️ トランザクションデータ" {
|
|
238
|
+
class: store_transaction
|
|
239
|
+
}
|
|
240
|
+
physical_store_node: "🏬 物理保管" {
|
|
241
|
+
class: physical_store
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
actor_node -> process_node: "情報の流れ"
|
|
245
|
+
event_node -> process_node: "起動条件"
|
|
246
|
+
process_node -> master_store: "参照・更新"
|
|
247
|
+
process_node -> transaction_store: "更新"
|
|
248
|
+
process_node -> physical_store_node: "物の流れ" {
|
|
249
|
+
class: material_flow
|
|
250
|
+
}
|
|
173
251
|
```
|
|
174
252
|
|
|
175
253
|
<!-- prettier-ignore -->
|
|
176
254
|
| 概念 | 形状 | 色 | 絵文字例 |
|
|
177
255
|
| --- | --- | --- | --- |
|
|
178
|
-
|
|
|
179
|
-
| 起点イベント |
|
|
180
|
-
| データストア(マスタ・構成データ) |
|
|
181
|
-
| データストア(トランザクションデータ) |
|
|
182
|
-
| 物理保管 |
|
|
183
|
-
| 外部主体 |
|
|
184
|
-
| 情報の流れ |
|
|
185
|
-
| 物の流れ |
|
|
256
|
+
| プロセス/プロセスグループ/区分 | 角丸四角形(`style.border-radius: 8`) | 青(`#e3f2fd` / `#1e88e5`) | 業務内容が伝わる絵文字(例: ⚙️) |
|
|
257
|
+
| 起点イベント | 六角形(`shape: hexagon`) | 橙(`#fff3e0` / `#fb8c00`) | 出来事が伝わる絵文字(例: 🚦) |
|
|
258
|
+
| データストア(マスタ・構成データ) | 円柱(`shape: cylinder`) | 薄い緑(`#e8f5e9` / `#43a047`) | 保管物が伝わる絵文字(例: 📐) |
|
|
259
|
+
| データストア(トランザクションデータ) | 円柱(`shape: cylinder`) | 中間の緑(`#c8e6c9` / `#2e7d32`) | 保管物が伝わる絵文字(例: 📒) |
|
|
260
|
+
| 物理保管 | 大角丸四角形(`style.border-radius: 20`) | 中間の緑(トランザクションデータと同じ) | 保管場所が伝わる絵文字(例: 🏬) |
|
|
261
|
+
| 外部主体 | 四角形(`shape: rectangle`) | グレー(`#f5f7fa` / `#607d8b`) | 主体が伝わる絵文字(例: 👤) |
|
|
262
|
+
| 情報の流れ | ラベル付き通常線 `->`(戻りは `<-`) | — | — |
|
|
263
|
+
| 物の流れ | ラベル付き太線 `->`(`material_flow` class) | — | — |
|
|
186
264
|
|
|
187
265
|
データストアの色分けは、大分類「データストア」の中の業務上のサブ分類を表す。マスタ・構成データは、他のプロセスから参照される比較的安定した基準情報を指す。トランザクションデータは、業務活動に伴い都度更新される記録を指す。物理保管は現物の保管先であり、いずれの区分にも属さないため、便宜上トランザクションデータと同じ色を用いる。
|
|
188
266
|
|
|
189
|
-
ノード形状・線種そのものの記法は
|
|
267
|
+
ノード形状・線種そのものの記法は [[specdojo:cdfd-d2-rulebook|D2 記法ルール]] に従う。本章は、その記法に基づき _TARGET_NAME_ が実際に採用する色・絵文字の割り当てを固定する。
|
|
190
268
|
|
|
191
269
|
<!-- 未決事項がある場合のみ、以下の章を追加する。ない場合は章ごと削除する。本文中の未確定箇所には _UNDECIDED_ を付け、表の論点と対応させる。
|
|
192
270
|
|