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.
Files changed (60) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +2 -2
  3. package/dist/commands/agent.js +33 -0
  4. package/dist/commands/init.js +1 -0
  5. package/dist/commands/orchestrator.js +10 -1
  6. package/dist/devcontainer/command.js +18 -0
  7. package/dist/devcontainer/host-script.js +21 -0
  8. package/dist/devcontainer/scaffold.js +4 -3
  9. package/dist/exec/antigravity-session.js +154 -0
  10. package/dist/exec/parent-validation.js +7 -0
  11. package/dist/exec/plan-markdownlint.js +89 -0
  12. package/dist/exec/plans-generation.js +6 -2
  13. package/dist/exec/register-resume.js +28 -0
  14. package/dist/exec/run/lifecycle-commands.js +85 -16
  15. package/dist/exec/run/register-command.js +6 -0
  16. package/dist/exec/run/schedule-mode.js +22 -2
  17. package/dist/exec/run/schedule-prepare.js +42 -1
  18. package/dist/exec/run/schedule-task.js +3 -0
  19. package/dist/exec/worktree-ops-commit.js +1 -13
  20. package/dist/exec/worktree-ops-lifecycle.js +40 -36
  21. package/dist/register/register.js +31 -23
  22. package/dist/shared/git.js +7 -0
  23. package/dist/shared/provider-scaffold.js +2 -0
  24. package/dist/shared/specdojo-gitignore.js +1 -0
  25. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  26. package/docs/ja/specdojo/guides/docs-editing-guide.md +36 -0
  27. package/docs/ja/specdojo/guides/exec-config-guide.md +14 -12
  28. package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -8
  29. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  30. package/docs/ja/specdojo/guides/quick-start-guide.md +597 -871
  31. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
  32. package/docs/ja/specdojo/guides/remote-host-development-guide.md +31 -4
  33. package/docs/ja/specdojo/guides/schedule-operation-guide.md +14 -0
  34. package/docs/ja/specdojo/guides/use-case-guide.md +537 -77
  35. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  36. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +96 -122
  37. package/docs/ja/specdojo/references/command-reference.md +69 -37
  38. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  39. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  40. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  41. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  42. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +108 -103
  43. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  44. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +128 -97
  45. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  46. package/docs/ja/specdojo/templates/cdfd-uc-template.md +127 -90
  47. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  48. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  49. package/package.json +5 -2
  50. package/templates/antigravity/README.md +19 -46
  51. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  52. package/templates/antigravity/settings.edit.json +73 -0
  53. package/templates/antigravity/settings.orchestrator.json +15 -0
  54. package/templates/antigravity/settings.report.json +7 -0
  55. package/templates/antigravity/settings.review.json +7 -0
  56. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  57. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  58. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  59. package/templates/init-agent-members.yaml +1 -0
  60. package/templates/init-exec-defaults.yaml +1 -1
@@ -0,0 +1,367 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:cdfd-d2-rulebook
4
+ type: rulebook
5
+ deliverable_type: flow
6
+ status: draft
7
+ target_format: markdown
8
+ recipe: not-needed
9
+ sample: not-needed
10
+ template: not-needed
11
+ based_on:
12
+ - specdojo:rulebook-authoring-standard
13
+ ---
14
+
15
+ # D2 を用いた概念データフロー図 作成ルール
16
+
17
+ Conceptual Data Flow Diagram Notation Rulebook for D2
18
+
19
+ D2 の構文で CDFD のプロセス、イベント、データストア、外部主体、情報・物の流れを一貫して表すための記法ルールです。`specdojo:cdfd-overview-rulebook`、`specdojo:cdfd-rulebook`、`specdojo:cdfd-uc-rulebook` の `includes` から適用される共通部品です。対象プロダクトの `cdfd-overview` に「凡例(本プロダクト共通)」がある場合はその割り当てを正本とし、共通凡例がない場合は本 rulebook の形状・線種と既定の色・絵文字方針に従います。
20
+
21
+ ## 1. 全体方針
22
+
23
+ - D2 を使用し、方向は全体概要・詳細 CDFD を問わず `direction: down` を基本とします。配置のエンジンは文書サイトの既定と同じ ELK を前提とします。CDFD の矢印は情報・物・実行要求の受け渡しを表し、ユースケース別など包含元が明示した場合だけ業務上の順序も表します。プロセスは上から Orchestrator・Plan・Do・Check・Action の順(Onboarding がある図では Onboarding を Orchestrator の上)に並べます。並び順に逆らう戻りの矢印は `b -> a` ではなく `a <- b` と書き、ELK に並びを決めさせないようにします(矢印の向きは `b` から `a` のまま、配置上で `a` を上に保ちます)。`direction: right` は、横長での表現が適している場合に選択できます。以下では、プロセスグループ別とユースケース別を合わせて「詳細 CDFD」と呼びます。
24
+
25
+ - 図が読みにくくなる原因は方向ではなく規模です。ノード数が多く一画面で関係を追いにくい場合は、方向を変えるのではなく、「凡例と可読性」の分割方針に従って図を分けます。分割の観点(全体概要はデータストアの区分、プロセスグループ別 CDFD は業務の性質が近いプロセス)とノード数の目安は包含元の rulebook が定めます。
26
+ - 全体概要とユースケース別 CDFD では、一つのプロセスグループを一つの代表ノードで表し、グループ内の領域や処理へ展開しません。ただし、ユースケース別 CDFD の包含元が系統の詳細をプロセス領域単位で描くと定めた場合は、その単位に従います。プロセスグループ別 CDFD では、一つのプロセスを一つのプロセスノードで表します。
27
+ - 一つの記号へ一つの意味を割り当て、ノード形状だけでプロセス、イベント、データストア、外部主体を区別できるようにします。
28
+
29
+ - 情報の流れと物の流れは線種(線の太さ)で区別し、すべてのエッジへ内容を表す名詞形のラベルを付けます。
30
+ - 図の目的は業務上の合意であり、装飾や実装構造の再現ではありません。ノード形状で意味を区別することを基本とし、色は形状だけでは判別しにくい場合の視認性向上に、プロセス/イベント/データストア/外部主体という概念の大分類単位で付けます。色は `classes` で大分類ごとに定義して `class` で当て、ノード単位の `style` 個別指定は禁止します。業務上の区別が必要な場合は、大分類内を同系統色の濃淡・彩度で分けられます。物理名、詳細な操作は使用しません。
31
+
32
+ | 概念 | D2 表現 | 表示例 |
33
+ | -------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
34
+ | プロセス | 角丸四角形(`shape: rectangle`、`style.border-radius: 8`) | `sales_record: "P-01-01 販売記録\n(担当: 店員)" { class: process }` |
35
+ | プロセスグループ | 角丸四角形(`shape: rectangle`、`style.border-radius: 8`)(代表ノード) | `sales: "販売\nP-01〜P-02" { class: process }` |
36
+ | サブグラフ | コンテナ `{ ... }`(関連プロセスを囲む視覚上のまとまり。グループの表現には使わない) | `sales_area: "販売領域" { ... }` |
37
+ | データストア | 円柱(`shape: cylinder`) | `sales_ledger: "販売記録簿" { class: store }` |
38
+ | 物理保管 | 大角丸四角形(`shape: rectangle`、`style.border-radius: 20`)(現物の保管先。トランザクションデータと同じ色を使う) | `display_shelf: "売場棚" { class: physical_store }` |
39
+ | 外部主体 | 四角形(`shape: rectangle`) | `customer: "顧客" { class: actor }` |
40
+ | イベント | 六角形(`shape: hexagon`) | `purchase_request: "顧客が商品の購入を要求した" { class: event }` |
41
+ | 情報・実行要求の流れ | ラベル付き有向エッジ `->`(戻りの矢印は `<-`) | `sales_record -> sales_ledger: "販売情報"` |
42
+ | 物の流れ | ラベル付き太線エッジ `->`(太線の class を適用) | `display_shelf -> sales_record: "商品" { class: material_flow }` |
43
+
44
+ ## 2. 位置づけと用語定義
45
+
46
+ | 用語 | 定義 |
47
+ | ------------ | ----------------------------------------------------------------------------- |
48
+ | ノード ID | D2 コード内で要素を参照する識別子。短い英単語または英数字スネークケースを使う |
49
+ | 表示ラベル | 図上で読み手に見せる名称。業務用語と領域 ID を必要に応じて併記する |
50
+ | エッジラベル | 移動する情報・物、またはイベントから伝わる起動条件の名称 |
51
+ | コンテナ | 関連するプロセスを囲む視覚上のまとまり。プロセスグループの表現には使わない |
52
+
53
+ - ノード ID には日本語文字や記号を避け、`sales_record` や `sales_ledger` のような英数字・スネークケースを基本とします。
54
+ - 表示ラベルは `"..."` で指定し、改行が必要な場合は `\n` を使います。
55
+ - 担当を表示する場合は、プロセスの表示ラベル末尾へ `\n(担当: ロール)` を付けます。
56
+ - イベントは「〜された」「〜が到来した」「〜を要求した」など、発生を判断できる短い文にします。
57
+
58
+ ## 3. ファイル命名・ID規則
59
+
60
+ - 本 rulebook は独立した成果物を生成せず、`cdfd-*.md` 内の D2 コードブロック(` ```d2 `)へ適用します。
61
+ - D2 コードブロックに独立した文書 ID は付けず、包含する CDFD の ID とプロセス ID で追跡します。
62
+ - ノード ID は一つのコードブロック内で一意にし、同じ対象には表と図で同じ領域 ID または名称を使用します。
63
+ - 複数図に分ける場合は、包含する CDFD 本文の見出しで図の観点を識別します。
64
+
65
+ ## 4. 推奨 Frontmatter 項目
66
+
67
+ - 本 rulebook は `specdojo:cdfd-overview-rulebook`、`specdojo:cdfd-rulebook`、`specdojo:cdfd-uc-rulebook` の `includes` から適用されるため、成果物 Frontmatter に記法 rulebook を重複記載しません。
68
+ - 成果物の `rulebook` は、図種別に応じて構造を定義する上記いずれかの主 CDFD rulebook を指定します。例えばプロセスグループ別 CDFD は `rulebook: specdojo:cdfd-rulebook` とします。
69
+ - 記法だけを別ファイルで適用する運用は行わず、主 CDFD rulebook と組み合わせます。
70
+
71
+ プロセスグループ別 CDFD の記載例:
72
+
73
+ ```yaml
74
+ specdojo:
75
+ id: cdfd-purchasing
76
+ type: flow
77
+ status: draft
78
+ rulebook: specdojo:cdfd-rulebook
79
+ ```
80
+
81
+ ## 5. 本文構成(標準テンプレ)
82
+
83
+ D2 コードブロック内は、次の順序を基本とします。必須の判定は図種別で異なります。全体概要ではプロセスグループの代表ノード、データストア、情報の流れを必須とし、イベントはプロセス領域の表に記載して図に描きません。プロセスグループ別 CDFD では個別プロセス、イベント、データストア、情報・物の流れを必須とします。ユースケース別 CDFD では通常の流れ全体を通して、包含元の単位に従うプロセスノード、開始・終了のイベント、情報・物の流れを必須とします。分割図や任意の戻りの図への開始・終了の再掲は不要です。渡す情報・物は線のラベルで表し、引き渡し条件のイベントは置きません。データストアは対象ケースで参照・更新するものだけを置きます。外部主体と物理保管はいずれの図種別でも存在する場合だけ置きます。全図で図直後の注記を必須とし、共通凡例の有無に応じて参照先または本 rulebook の既定凡例を使う旨を示します。
84
+
85
+ | 順序 | 区分 | 必須 | 内容 |
86
+ | ---- | -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
87
+ | 1 | 方向宣言 | ○ | `direction: down`(基本)または `direction: right` |
88
+ | 2 | `classes` 定義 | ○ | 概念の大分類ごとに形状・スタイルを定義した `classes: { ... }` ブロック |
89
+ | 3 | プロセスノード | ○ | 全体概要はグループ代表ノード、ユースケース別は包含元の単位、プロセスグループ別は個々のプロセス |
90
+ | 4 | イベント | 条件付き | プロセスグループ別では開始契機、ユースケース別では通常の流れ全体の開始・終了の出来事(引き渡し条件のイベントは置かない)。全体概要では描かない |
91
+ | 5 | 外部主体 | 任意 | 対象範囲外の入力元・出力先 |
92
+ | 6 | データストア | 条件付き | 読み書きする主要な情報の保管先。ユースケース別では対象ケースで参照・更新するものだけ置く |
93
+ | 7 | 物理保管 | 条件付き | 現物の保管先が情報・物の受け渡しまたは境界の理解に必要な場合だけ置く |
94
+ | 8 | 情報・物の流れ | ○ | ラベル付きエッジ(物の流れには `material_flow` class を指定) |
95
+ | 9 | 図直後の注記 | ○ | 共通凡例がある場合はその参照、ない場合は本 rulebook の既定凡例に従う旨、使用線種、省略事項、共有ノード |
96
+
97
+ ## 6. 記述ガイド
98
+
99
+ ### 6.1. ノードとコンテナ
100
+
101
+ - プロセスは角丸四角形、外部主体は四角形、イベントは六角形、データストアは円柱で表します。現物の保管先を図へ置く場合は物理保管として大角丸四角形(`style.border-radius: 20`)を使い、プロセス、外部主体、データストアの代替にはしません。
102
+ - プロセス名は「販売記録」「計画展開」のように、何を扱う処理か分かる短い名詞句にします。
103
+ - 全体概要では一プロセスグループを一つの代表ノードとして表し、表示ラベルにグループ名と含む領域 ID の範囲を記載します。グループ内の領域や処理を別ノードとして追加しません。
104
+ - プロセスグループ別 CDFD ではグループ内の主要プロセスを個別ノードにし、全体概要の代表ノードをプロセスとして重複配置しません。
105
+ - ユースケース別 CDFD では包含元が定める参加単位を正常系の通過順に配置し、その内部プロセスは描きません。開始・終了のイベントは一ノード一出来事の短い文とし、長ければ原文を保って改行します。引き渡し条件のイベントは置かず、受け渡す情報・物を線のラベルで表します。
106
+ - コンテナ(`container: { ... }`)はプロセスグループ別 CDFD で関連プロセスを視覚的にまとめる場合にだけ使用できます。プロセスグループの表現や代表ノードの代替には使いません。
107
+
108
+ ```d2
109
+ direction: down
110
+
111
+ classes: {
112
+ process: {
113
+ shape: rectangle
114
+ style.border-radius: 8
115
+ }
116
+ event: {
117
+ shape: hexagon
118
+ }
119
+ store: {
120
+ shape: cylinder
121
+ }
122
+ actor: {
123
+ shape: rectangle
124
+ }
125
+ }
126
+
127
+ sales_area: "販売領域" {
128
+ sales_record: "P-01-01 販売記録\n(担当: 店員)" {
129
+ class: process
130
+ }
131
+ }
132
+ purchase_request: "顧客が商品の購入を要求した" {
133
+ class: event
134
+ }
135
+ customer: "顧客" {
136
+ class: actor
137
+ }
138
+ sales_ledger: "販売記録簿" {
139
+ class: store
140
+ }
141
+ ```
142
+
143
+ ### 6.2. 絵文字アイコン(任意)
144
+
145
+ 絵文字は人間の視認性向上には有効ですが、表示差や幅崩れが起きる環境もあるため、次のルールで運用します。
146
+
147
+ - 絵文字は任意です(なくても成立します)。
148
+ - 絵文字は表示ラベルのみに付け、ノード ID には付けません。
149
+ - 1ノードにつき1個までとし、表示ラベルの先頭に付けます。
150
+ - 絵文字だけに頼らず、必ずプロセス名・データストア名などのテキストも併記します。
151
+
152
+ ```d2
153
+ direction: down
154
+
155
+ classes: {
156
+ process: {
157
+ shape: rectangle
158
+ style.border-radius: 8
159
+ }
160
+ event: {
161
+ shape: hexagon
162
+ }
163
+ store: {
164
+ shape: cylinder
165
+ }
166
+ actor: {
167
+ shape: rectangle
168
+ }
169
+ }
170
+
171
+ sales_area: "販売領域" {
172
+ sales_record: "📋 P-01-01 販売記録\n(担当: 店員)" {
173
+ class: process
174
+ }
175
+ }
176
+ purchase_request: "⚡ 顧客が商品の購入を要求した" {
177
+ class: event
178
+ }
179
+ customer: "🏢 顧客" {
180
+ class: actor
181
+ }
182
+ sales_ledger: "🗄️ 販売記録簿" {
183
+ class: store
184
+ }
185
+ ```
186
+
187
+ 禁止例(絵文字がノード ID に付いている、または表示ラベルに無い):
188
+
189
+ ```text
190
+ direction: down
191
+ 📋sales_record: "販売記録"
192
+ ```
193
+
194
+ ### 6.3. エッジ
195
+
196
+ - 情報は通常エッジ `->`、物は太線のエッジ(`material_flow` class を適用)を使用します。イベントからプロセスへのエッジも `purchase_request -> sales_record: "販売開始条件"` のようにラベルを付けます。
197
+ - エッジラベルは「販売情報」「在庫数量」「実行結果」のような名詞形にし、「処理する」など動作だけの語を使用しません。
198
+ - 一つのエッジに異なる責務の情報を詰め込まず、受け手が別ならエッジを分けます。
199
+ - プロセスは上から Orchestrator・Plan・Do・Check・Action の順(Onboarding がある図では Onboarding を Orchestrator の上)に並べます。並び順に逆らう戻りの矢印(Orchestrator への応答、Action から Plan への再計画要求、上流のデータストアへの更新など)は `b -> a` ではなく `a <- b` と書き、ELK に並びを決めさせないようにします(矢印の向きは `b` から `a` のまま、配置上で `a` を上に保ちます)。
200
+ - プロセスどうしの受け渡しがなく `a <- b` では並び順を決められない図(プロセスが同一行に横に並んでしまう場合など)では、並び順を固定するために透明度 0 の線(`style.opacity: 0`、ラベルなし。例: `onboarding -> orchestrator -> plan -> do_exec -> check -> action: {style.opacity: 0}`)を使って構いません。その線は業務上の受け渡しではないため、直前に受け渡しではないことを示すコメント(例: `# 配置制御用(受け渡しではない)`)を必ず記述します。
201
+
202
+ ```d2
203
+ direction: down
204
+
205
+ classes: {
206
+ process: {
207
+ shape: rectangle
208
+ style.border-radius: 8
209
+ }
210
+ event: {
211
+ shape: hexagon
212
+ }
213
+ store: {
214
+ shape: cylinder
215
+ }
216
+ actor: {
217
+ shape: rectangle
218
+ }
219
+ }
220
+
221
+ customer: "顧客" {
222
+ class: actor
223
+ }
224
+ purchase_request: "顧客が商品の購入を要求した" {
225
+ class: event
226
+ }
227
+ sales_record: "P-01-01 販売記録" {
228
+ class: process
229
+ }
230
+ sales_ledger: "販売記録簿" {
231
+ class: store
232
+ }
233
+
234
+ customer -> purchase_request: "購入依頼"
235
+ purchase_request -> sales_record: "販売開始条件"
236
+ sales_record -> sales_ledger: "販売情報"
237
+ ```
238
+
239
+ ### 6.4. 凡例と可読性
240
+
241
+ - 各図の直後に凡例の適用元を注記します。対象プロダクトの `cdfd-overview` に「凡例(本プロダクト共通)」がある場合はその章を参照し、ない場合は「ノード形状・線種・色・絵文字は `specdojo:cdfd-d2-rulebook` の既定凡例に従う」と記述します。いずれの場合も、図で使用した線種、図から省略した入出力と理由、別図と共有するノードを併記します。
242
+ - 共通凡例がある場合、ノード形状、色、絵文字のプロダクト固有の割り当ては共通凡例を正本とし、図ごとに再掲しません。共通凡例にない割り当ては使用しません。共通凡例がない場合は、本 rulebook の対応表と「見栄えを整える最小限スタイル」を既定凡例とし、図ごとの独自割り当てを追加しません。
243
+ - 物の流れを使わない場合は「`->` は情報・実行要求の流れ。本図は物の流れを対象外とする」と記述します。
244
+
245
+ - 図を分ける観点とノード数の目安は包含元の rulebook に従います(全体概要はトランザクションデータの図とマスタ・構成データの図、プロセスグループ別 CDFD は業務の性質が近いプロセス単位、ユースケース別 CDFD は連続する業務の範囲)。分けた図の間で同じプロセス ID・名称を維持します。ユースケース別 CDFD では、共有する参加単位・データストアの名称と領域 ID で接続を追跡し、引き渡し ID は付けません。
246
+ - ノードの表示ラベルは1行あたり全角20字(半角40字)程度を目安にし、超える場合は `\n` で改行して2行程度に収めます。エッジラベルは改行に頼らず短い名詞句に収めます。
247
+
248
+ ### 6.5. 見栄えを整える最小限スタイル(任意)
249
+
250
+ - ノード形状による意味区別を優先し、色は形状だけでは見分けにくい場合の補助として使います。
251
+ - 色を付ける場合は `classes` のみを使用し、ノード単位の `style` による個別指定はしません。
252
+
253
+ - 色は必ずプロセス/イベント/データストア/外部主体という概念の大分類単位で色相(Hue)を統一し、異なる大分類の間で色相を混同しません。
254
+ - 大分類の中に業務上意味のあるサブ分類がある場合(例: データストアにおけるマスタ・構成データとトランザクションデータの違い)は、大分類の色相を保ったまま、濃淡・彩度を変えた同系統色でサブ分類を塗り分けられます。サブ分類の色分けを行う場合は、本プロダクト共通の凡例にサブ分類の名称と対応する色を定義し、「凡例と可読性」の方針で参照します。
255
+ - サブ分類の色分けは、業務上の判断(変更頻度、更新契機、参照される側か更新される側かなど)で区別できる場合にだけ使います。区別基準を説明できないサブ分類の塗り分けはしません。
256
+ - 色を使わなくても意味が読み取れる図では、無理に色を付けません。
257
+
258
+ ```d2
259
+ direction: down
260
+
261
+ classes: {
262
+ process: {
263
+ shape: rectangle
264
+ style: {
265
+ border-radius: 8
266
+ fill: "#e3f2fd"
267
+ stroke: "#1e88e5"
268
+ font-color: "#000000"
269
+ }
270
+ }
271
+ event: {
272
+ shape: hexagon
273
+ style: {
274
+ fill: "#fff3e0"
275
+ stroke: "#fb8c00"
276
+ font-color: "#000000"
277
+ }
278
+ }
279
+ store: {
280
+ shape: cylinder
281
+ style: {
282
+ fill: "#c8e6c9"
283
+ stroke: "#2e7d32"
284
+ font-color: "#000000"
285
+ }
286
+ }
287
+ actor: {
288
+ shape: rectangle
289
+ style: {
290
+ fill: "#f5f7fa"
291
+ stroke: "#607d8b"
292
+ font-color: "#000000"
293
+ }
294
+ }
295
+ }
296
+
297
+ customer: "顧客" {
298
+ class: actor
299
+ }
300
+ purchase_request: "顧客が商品の購入を要求した" {
301
+ class: event
302
+ }
303
+ sales_record: "P-01-01 販売記録\n(担当: 店員)" {
304
+ class: process
305
+ }
306
+ sales_ledger: "販売記録簿" {
307
+ class: store
308
+ }
309
+
310
+ customer -> purchase_request: "購入依頼"
311
+ purchase_request -> sales_record: "販売開始条件"
312
+ sales_record -> sales_ledger: "販売情報"
313
+ ```
314
+
315
+ 大分類「データストア」の中でマスタ・構成データとトランザクションデータを同系統色(緑系の濃淡)で塗り分ける例:
316
+
317
+ ```d2
318
+ direction: down
319
+
320
+ classes: {
321
+ store_master: {
322
+ shape: cylinder
323
+ style: {
324
+ fill: "#e8f5e9"
325
+ stroke: "#43a047"
326
+ font-color: "#000000"
327
+ }
328
+ }
329
+ store_transaction: {
330
+ shape: cylinder
331
+ style: {
332
+ fill: "#c8e6c9"
333
+ stroke: "#2e7d32"
334
+ font-color: "#000000"
335
+ }
336
+ }
337
+ physical_store: {
338
+ shape: rectangle
339
+ style: {
340
+ border-radius: 20
341
+ fill: "#c8e6c9"
342
+ stroke: "#2e7d32"
343
+ font-color: "#000000"
344
+ }
345
+ }
346
+ }
347
+
348
+ item_master: "商品マスタ" {
349
+ class: store_master
350
+ }
351
+ sales_ledger: "販売記録簿" {
352
+ class: store_transaction
353
+ }
354
+ ```
355
+
356
+ 凡例には「円柱(薄い緑 `#e8f5e9` / `#43a047`)はマスタ・構成データ、円柱(中間の緑 `#c8e6c9` / `#2e7d32`)はトランザクションデータ、大角丸四角形(トランザクションデータと同色 `#c8e6c9` / `#2e7d32`)は物理保管」のように、大分類の形状の意味に加えてサブ分類の色の意味を明記します。
357
+
358
+ ## 7. 禁止事項
359
+
360
+ - ラベルのないエッジ(並び順固定用の透明度 0 の線を除く)、同じ線種へ情報と物の両方の意味を持たせたエッジを記載しません。
361
+ - プロセスとデータストア、イベントと外部主体など、異なる概念へ同じノード形状を使用しません。
362
+ - 全体概要にプロセスグループ内の領域や処理を複数ノードで展開したり、プロセスグループをコンテナで表したり、プロセスグループ別 CDFD に他グループの内部処理を作り込んだりしません。
363
+ - 物理テーブル、物理カラム、実装クラス、関数、詳細 API、コマンドオプションをノードやエッジへ記載しません。
364
+ - 独自形状の追加、根拠のないノード単位の色付け、ノード単位の `style` による個別指定は行いません。色は概念の大分類単位、または大分類内の同系統色によるサブ分類単位の `classes` としてのみ使用します。
365
+ - 大分類間で色相を混同する、または区別基準を説明できないままサブ分類の色を増やすことはしません。
366
+ - 起点も到達先も説明できないノード、自己ループだけで完結するプロセス、読み手が解釈できない略語を残しません。
367
+ - 外部ファイルのインポート(import)、および layers・scenarios・steps による複数ページ出力を使いません(1 ブロック 1 SVG 出力の描画仕様に従います)。
@@ -35,7 +35,7 @@ Mermaid の `flowchart` 構文で CDFD のプロセス、イベント、デー
35
35
  | プロセスグループ | 角丸長方形 `("...")`(全体概要・ユースケース別 CDFD の代表ノード) | `販売("販売<br>P-01〜P-02")` |
36
36
  | サブグラフ | `subgraph ... end`(関連プロセスを囲む視覚上のまとまり。グループの表現には使わない) | `subgraph 販売領域["販売領域"]` |
37
37
  | データストア | 円柱 `[(...)]` | `販売記録簿[("販売記録簿")]` |
38
- | 物理保管 | スタジアム形 `(["..."])`(現物の保管先。データストアと同系統色を使う) | `売場棚(["売場棚"])` |
38
+ | 物理保管 | スタジアム形 `(["..."])`(現物の保管先。トランザクションデータと同じ色を使う) | `売場棚(["売場棚"])` |
39
39
  | 外部主体 | 四角 `[...]` | `顧客["顧客"]` |
40
40
  | イベント | 六角形 `{{...}}` | `購入要求{{"顧客が商品の購入を要求した"}}` |
41
41
  | 情報・実行要求の流れ | ラベル付き `-->\|"..."\|` | `販売記録 -->\|"販売情報"\| 販売記録簿` |
@@ -175,7 +175,7 @@ flowchart LR
175
175
  flowchart LR
176
176
  classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
177
177
  classDef event fill:#fff3e0,stroke:#fb8c00,color:#000
178
- classDef store fill:#e8f5e9,stroke:#43a047,color:#000
178
+ classDef store fill:#c8e6c9,stroke:#2e7d32,color:#000
179
179
  classDef actor fill:#f5f7fa,stroke:#607d8b,color:#000
180
180
 
181
181
  顧客["顧客"]
@@ -197,8 +197,9 @@ flowchart LR
197
197
 
198
198
  ```mermaid
199
199
  flowchart LR
200
- classDef storeMaster fill:#a5d6a7,stroke:#1b5e20,color:#000
201
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
200
+ classDef storeMaster fill:#e8f5e9,stroke:#43a047,color:#000
201
+ classDef storeTransaction fill:#c8e6c9,stroke:#2e7d32,color:#000
202
+ classDef physicalStore fill:#c8e6c9,stroke:#2e7d32,color:#000
202
203
 
203
204
  商品マスタ[("商品マスタ")]
204
205
  販売記録簿[("販売記録簿")]
@@ -207,7 +208,7 @@ flowchart LR
207
208
  class 販売記録簿 storeTransaction
208
209
  ```
209
210
 
210
- 凡例には「円柱(濃い緑)はマスタ・構成データ、円柱(薄い緑)はトランザクションデータ」のように、大分類の形状の意味に加えてサブ分類の色の意味を明記します。
211
+ 凡例には「円柱(薄い緑 `#e8f5e9` / `#43a047`)はマスタ・構成データ、円柱(中間の緑 `#c8e6c9` / `#2e7d32`)はトランザクションデータ、スタジアム形(トランザクションデータと同色 `#c8e6c9` / `#2e7d32`)は物理保管」のように、大分類の形状の意味に加えてサブ分類の色の意味を明記します。
211
212
 
212
213
  ## 7. 禁止事項
213
214