specdojo 0.6.0 → 0.8.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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -33,16 +33,16 @@ specdojo:
33
33
 
34
34
  ### 3.1. 仕入計画(P-01)
35
35
 
36
- 在庫グループからの補充依頼を商品台帳の発注条件へ合わせ、店主代表が承認した発注内容を仕入先と後続の入荷検品へ引き渡す。
36
+ 在庫グループが発注単位に合わせて確定した補充依頼に商品台帳の仕入先を割り当て、店主代表が承認した発注内容を仕入先と後続の入荷検品へ引き渡す。
37
37
 
38
38
  - **主要入力**: 在庫からの補充依頼、商品台帳の仕入先・発注単位
39
39
  - **主要出力**: 仕入先への発注、仕入記録の発注内容
40
40
  - **データストア**: 商品台帳、仕入記録
41
41
 
42
- | プロセス ID | プロセス | 業務目的 | 主な担当 | 起動条件 | 完了条件 | 必須性 |
43
- | ----------- | -------------- | -------------------------------------------------------------------- | -------- | -------------------------------- | -------------------------------------------------------------------- | ------ |
44
- | `P-01-01` | 発注内容確定 | 補充対象と数量を発注単位に合わせ、仕入先へ提示できる発注内容にする。 | 店主代表 | 在庫グループから補充依頼を受けた | 仕入先、商品、数量、発注単位が承認対象の発注内容として確定している。 | 必須 |
45
- | `P-01-02` | 発注記録・送付 | 承認済みの発注内容を記録し、仕入先へ発注する。 | 店主代表 | 店主代表が発注内容を承認した | 承認済み発注内容を仕入記録へ記録し、仕入先への送付を確認している。 | 必須 |
42
+ | プロセス ID | プロセス | 業務目的 | 主な担当 | 起動条件 | 完了条件 | 必須性 |
43
+ | ----------- | -------------- | -------------------------------------------------------------------------- | -------- | -------------------------------- | -------------------------------------------------------------------- | ------ |
44
+ | `P-01-01` | 発注内容確定 | 補充依頼の商品・数量へ仕入先を割り当て、仕入先へ提示できる発注内容にする。 | 店主代表 | 在庫グループから補充依頼を受けた | 仕入先、商品、数量、発注単位が承認対象の発注内容として確定している。 | 必須 |
45
+ | `P-01-02` | 発注記録・送付 | 承認済みの発注内容を記録し、仕入先へ発注する。 | 店主代表 | 店主代表が発注内容を承認した | 承認済み発注内容を仕入記録へ記録し、仕入先への送付を確認している。 | 必須 |
46
46
 
47
47
  ### 3.2. 入荷検品(P-02)
48
48
 
@@ -66,9 +66,9 @@ specdojo:
66
66
 
67
67
  ### 4.1. マスタ・構成データ
68
68
 
69
- | データストア | 読み書き | 本グループでの利用 |
70
- | ------------ | -------- | -------------------------------- |
71
- | 商品台帳 | 参照 | 仕入先、発注単位を発注判断に使う |
69
+ | データストア | 読み書き | 本グループでの利用 |
70
+ | ------------ | -------- | -------------------------------------------------- |
71
+ | 商品台帳 | 参照 | 仕入先の割り当てと発注単位での発注内容の記載に使う |
72
72
 
73
73
  ### 4.2. トランザクションデータ
74
74
 
@@ -84,99 +84,172 @@ specdojo:
84
84
 
85
85
  ### 5.1. 仕入計画(P-01)
86
86
 
87
- ```mermaid
88
- flowchart LR
89
- classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
90
- classDef event fill:#fff3e0,stroke:#fb8c00,color:#000
91
- classDef storeMaster fill:#a5d6a7,stroke:#1b5e20,color:#000
92
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
93
- classDef actor fill:#f5f7fa,stroke:#607d8b,color:#000
94
-
95
- 在庫グループ["📦 在庫グループ"]
96
- 仕入先["🏭 仕入先"]
97
- 補充依頼受領{{"⚡ 補充依頼を受けた"}}
98
- 発注内容承認{{"⚡ 発注内容が承認された"}}
99
- 発注内容確定("🧮 発注内容確定<br>P-01-01")
100
- 発注記録送付("📝 発注記録・送付<br>P-01-02")
101
- 商品台帳[("📐 商品台帳")]
102
- 仕入記録[("📒 仕入記録")]
103
-
104
- 在庫グループ -->|"補充依頼"| 補充依頼受領
105
- 補充依頼受領 -->|"起動条件"| 発注内容確定
106
- 商品台帳 -->|"仕入先・発注単位"| 発注内容確定
107
- 発注内容確定 -->|"承認対象の発注内容"| 発注内容承認
108
- 発注内容承認 -->|"起動条件"| 発注記録送付
109
- 発注記録送付 -->|"発注内容"| 仕入記録
110
- 発注記録送付 -->|"発注"| 仕入先
111
-
112
- class 発注内容確定,発注記録送付 process
113
- class 補充依頼受領,発注内容承認 event
114
- class 商品台帳 storeMaster
115
- class 仕入記録 storeTransaction
116
- class 在庫グループ,仕入先 actor
87
+ ```d2
88
+ direction: down
89
+
90
+ classes: {
91
+ process: {
92
+ shape: rectangle
93
+ style: {
94
+ border-radius: 8
95
+ fill: "#e3f2fd"
96
+ stroke: "#1e88e5"
97
+ font-color: "#000000"
98
+ }
99
+ }
100
+ event: {
101
+ shape: hexagon
102
+ style: {
103
+ fill: "#fff3e0"
104
+ stroke: "#fb8c00"
105
+ font-color: "#000000"
106
+ }
107
+ }
108
+ store_master: {
109
+ shape: cylinder
110
+ style: {
111
+ fill: "#e8f5e9"
112
+ stroke: "#43a047"
113
+ font-color: "#000000"
114
+ }
115
+ }
116
+ store_transaction: {
117
+ shape: cylinder
118
+ style: {
119
+ fill: "#c8e6c9"
120
+ stroke: "#2e7d32"
121
+ font-color: "#000000"
122
+ }
123
+ }
124
+ actor: {
125
+ shape: rectangle
126
+ style: {
127
+ fill: "#f5f7fa"
128
+ stroke: "#607d8b"
129
+ font-color: "#000000"
130
+ }
131
+ }
132
+ }
133
+
134
+ inventory_group: "📦 在庫グループ" { class: actor }
135
+ supplier: "🏭 仕入先" { class: actor }
136
+ request_received: "⚡ 補充依頼を受けた" { class: event }
137
+ order_approved: "⚡ 発注内容が承認された" { class: event }
138
+ order_determination: "🧮 発注内容確定\nP-01-01" { class: process }
139
+ order_record_send: "📝 発注記録・送付\nP-01-02" { class: process }
140
+ product_master: "📐 商品台帳" { class: store_master }
141
+ purchase_record: "📒 仕入記録" { class: store_transaction }
142
+
143
+ inventory_group -> request_received: "補充依頼"
144
+ request_received -> order_determination: "起動条件"
145
+ product_master -> order_determination: "仕入先・発注単位"
146
+ order_determination -> order_approved: "承認対象の発注内容"
147
+ order_approved -> order_record_send: "起動条件"
148
+ order_record_send -> purchase_record: "発注内容"
149
+ order_record_send -> supplier: "発注"
117
150
  ```
118
151
 
119
- 凡例の形状・色・絵文字は全体概要の「凡例(本プロダクト共通)」を参照する。`-->` は情報の流れであり、本図は物の流れを扱わない。在庫グループは本グループ外の入力元で、内部プロセスを省略している。`P-01-02` が仕入記録へ保存した発注内容は、入荷検品の図にある同名データストアから参照する。
152
+ 凡例は全体概要の「凡例(本プロダクト共通)」を参照する。`->` は情報の流れであり、本図は物の流れを対象外とする。在庫グループは本グループ外の入力元で、内部プロセスを省略している。`P-01-02` が仕入記録へ保存した発注内容は、入荷検品の図にある同名データストアから参照する。
120
153
 
121
154
  ### 5.2. 入荷検品(P-02)
122
155
 
123
- ```mermaid
124
- flowchart LR
125
- classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
126
- classDef event fill:#fff3e0,stroke:#fb8c00,color:#000
127
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
128
- classDef actor fill:#f5f7fa,stroke:#607d8b,color:#000
129
-
130
- 仕入先["🏭 仕入先"]
131
- 商品納品{{"⚡ 商品が納品された"}}
132
- 発注照合完了{{"⚡ 発注内容との照合が完了した"}}
133
- 検品完了{{"⚡ 検品が完了した"}}
134
- 受入品あり{{"⚡ 記録更新後に受入品がある"}}
135
- 受入不可{{"⚡ 数量違い・品質不良が判明した"}}
136
- 仕入記録確定済み{{"⚡ 仕入記録が確定された"}}
137
- 入荷受入("📥 入荷受入<br>P-02-01")
138
- 入荷検品("🔍 入荷検品<br>P-02-02")
139
- 仕入記録確定("📝 仕入記録確定<br>P-02-03")
140
- 売場補充("📦 売場補充<br>P-02-04")
141
- 返品引渡し("↩️ 返品引渡し<br>P-02-05")
142
- 仕入記録[("📒 仕入記録")]
143
- 在庫記録[("📒 在庫記録")]
144
- 売場棚(["🏬 売場棚"])
145
-
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
- class 入荷受入,入荷検品,仕入記録確定,売場補充,返品引渡し process
173
- class 商品納品,発注照合完了,検品完了,受入品あり,受入不可,仕入記録確定済み event
174
- class 仕入記録,在庫記録 storeTransaction
175
- class 売場棚 storeTransaction
176
- class 仕入先 actor
156
+ ```d2
157
+ direction: down
158
+
159
+ classes: {
160
+ process: {
161
+ shape: rectangle
162
+ style: {
163
+ border-radius: 8
164
+ fill: "#e3f2fd"
165
+ stroke: "#1e88e5"
166
+ font-color: "#000000"
167
+ }
168
+ }
169
+ event: {
170
+ shape: hexagon
171
+ style: {
172
+ fill: "#fff3e0"
173
+ stroke: "#fb8c00"
174
+ font-color: "#000000"
175
+ }
176
+ }
177
+ store_transaction: {
178
+ shape: cylinder
179
+ style: {
180
+ fill: "#c8e6c9"
181
+ stroke: "#2e7d32"
182
+ font-color: "#000000"
183
+ }
184
+ }
185
+ physical_store: {
186
+ shape: rectangle
187
+ style: {
188
+ border-radius: 20
189
+ fill: "#c8e6c9"
190
+ stroke: "#2e7d32"
191
+ font-color: "#000000"
192
+ }
193
+ }
194
+ actor: {
195
+ shape: rectangle
196
+ style: {
197
+ fill: "#f5f7fa"
198
+ stroke: "#607d8b"
199
+ font-color: "#000000"
200
+ }
201
+ }
202
+ material_flow: {
203
+ style: {
204
+ stroke-width: 3
205
+ }
206
+ }
207
+ }
208
+
209
+ supplier: "🏭 仕入先" { class: actor }
210
+ goods_delivered: "⚡ 商品が納品された" { class: event }
211
+ order_matched: "⚡ 発注内容との照合が完了した" { class: event }
212
+ inspection_done: "⚡ 検品が完了した" { class: event }
213
+ accepted_goods_exist: "⚡ 記録更新後に受入品がある" { class: event }
214
+ rejected_goods_found: "⚡ 数量違い・品質不良が判明した" { class: event }
215
+ record_confirmed: "⚡ 仕入記録が確定された" { class: event }
216
+ receiving: "📥 入荷受入\nP-02-01" { class: process }
217
+ inspection: "🔍 入荷検品\nP-02-02" { class: process }
218
+ record_confirmation: "📝 仕入記録確定\nP-02-03" { class: process }
219
+ shelf_replenishment: "📦 売場補充\nP-02-04" { class: process }
220
+ return_handover: "↩️ 返品引渡し\nP-02-05" { class: process }
221
+ purchase_record: "📒 仕入記録" { class: store_transaction }
222
+ inventory_record: "📒 在庫記録" { class: store_transaction }
223
+ display_shelf: "🏬 売場棚" { class: physical_store }
224
+
225
+ supplier -> goods_delivered: "納品情報"
226
+ supplier -> receiving: "納品商品" { class: material_flow }
227
+ goods_delivered -> receiving: "起動条件"
228
+ receiving <- purchase_record: "発注内容"
229
+ receiving -> order_matched: "照合済みの納品"
230
+ receiving -> purchase_record: "受入日時・数量"
231
+ receiving -> inspection: "検品対象商品" { class: material_flow }
232
+ order_matched -> inspection: "起動条件"
233
+
234
+ inspection -> inspection_done: "検品結果"
235
+ inspection_done -> record_confirmation: "起動条件"
236
+ record_confirmation -> purchase_record: "仕入内容・検品結果"
237
+ record_confirmation -> inventory_record: "入荷数量"
238
+ record_confirmation -> record_confirmed: "確定結果"
239
+ record_confirmed -> accepted_goods_exist: "受入品あり"
240
+ accepted_goods_exist -> shelf_replenishment: "起動条件"
241
+ inspection -> shelf_replenishment: "受入品" { class: material_flow }
242
+ shelf_replenishment -> display_shelf: "売場商品" { class: material_flow }
243
+
244
+ record_confirmed -> rejected_goods_found: "不一致・不良あり"
245
+ rejected_goods_found -> return_handover: "起動条件"
246
+ inspection -> return_handover: "返品対象商品" { class: material_flow }
247
+ return_handover -> purchase_record: "返品情報"
248
+ supplier <- return_handover: "返品連絡"
249
+ supplier <- return_handover: "返品商品" { class: material_flow }
177
250
  ```
178
251
 
179
- 凡例の形状・色・絵文字は全体概要の「凡例(本プロダクト共通)」を参照する。`-->` は情報、`==>` は商品の流れを表す。仕入記録は仕入計画の図と同じデータストアである。仕入グループは仕入記録の確定と同じプロセスで受入品の入荷数量を在庫記録へ直接反映する。返品対象がなければ `P-02-05` は起動せず、受入品がなければ `P-02-04` は起動しない。仕入記録の確定後、受入品があれば売場補充、返品対象があれば返品引渡しを行い、該当する条件付き経路をすべて完了することでグループが正常完了する。
252
+ 凡例は全体概要の「凡例(本プロダクト共通)」を参照する。`->`(戻りは `<-`)の通常線は情報、`material_flow` class の太線は商品の流れを表す。仕入記録は仕入計画の図と同じデータストアである。仕入グループは仕入記録の確定と同じプロセスで受入品の入荷数量を在庫記録へ直接反映する。返品対象がなければ `P-02-05` は起動せず、受入品がなければ `P-02-04` は起動しない。仕入記録の確定後、受入品があれば売場補充、返品対象があれば返品引渡しを行い、該当する条件付き経路をすべて完了することでグループが正常完了する。
180
253
 
181
254
  ## 6. 個別プロセス主要入出力
182
255
 
@@ -214,11 +287,11 @@ flowchart LR
214
287
 
215
288
  ### 8.1. 主要例外
216
289
 
217
- | 例外 ID | 対象プロセス | 検出条件 | 停止範囲 | 本グループでの扱い | 継続・再開条件 |
218
- | --------- | ------------ | ------------------------------------------------------------ | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
219
- | `E-01-01` | `P-01-02` | 発注送付後に仕入先から受注不可の回答を受けた | 当該発注の入荷受入と、確定数量の仕入先への再送 | 発注内容を未確定として店主代表へ戻し、在庫グループへ再検討が必要な数量を引き渡す | 店主代表が代替仕入先または数量を承認した後、`P-01-01` から再開する |
220
- | `E-02-01` | `P-02-01` | 納品情報から対応する発注内容を一意に特定できない | 当該商品の入荷検品、記録更新、売場補充、返品 | 商品を検品へ渡さず、納品情報と候補となる発注内容を店主代表へ提示する | 店主代表が対応する発注を確定した後、`P-02-01` から再開する |
221
- | `E-02-02` | `P-02-03` | 仕入記録の更新結果を読み返して検品結果との一致を確認できない | 当該商品の在庫記録更新、売場補充、返品引渡し | 未確定の仕入記録と検品済み商品を分けて保持し、一致を確認できるまで `P-02-03` の更新と読み返しを再試行する | 一致確認後は `P-02-03` で在庫記録を更新し、受入品は `P-02-04`、返品対象は `P-02-05` へ進む |
290
+ | 例外 ID | 対象プロセス | 検出条件 | 停止範囲 | 本グループでの扱い | 継続・再開条件 |
291
+ | --------- | ------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
292
+ | `E-01-01` | `P-01-02` | 発注送付後に仕入先から受注不可の回答を受けた | 当該発注の入荷受入と、確定数量の仕入先への再送 | 発注内容を未確定として店主代表へ戻し、在庫グループへ再検討が必要な数量を引き渡す | 店主代表が代替仕入先または数量を承認した後、`P-01-01` から再開する |
293
+ | `E-02-01` | `P-02-01` | 納品情報から対応する発注内容を一意に特定できない | 当該商品の入荷検品、記録更新、売場補充、返品 | 商品を検品へ渡さず、納品情報と候補となる発注内容を店主代表へ提示する | 店主代表が対応する発注を確定した後、`P-02-01` から再開する |
294
+ | `E-02-02` | `P-02-03` | 仕入記録の検品結果との一致、または在庫記録の入荷数量の反映を読み返しで確認できない | 当該商品の未反映の記録更新、売場補充、返品引渡し | 未確定の記録と検品済み商品を分けて保持し、仕入記録と在庫記録の双方を確認できるまで `P-02-03` の更新と読み返しを再試行する | 仕入記録の一致と在庫記録の入荷数量を確認した後、受入品は `P-02-04`、返品対象は `P-02-05` へ進む |
222
295
 
223
296
  ### 8.2. グループ外への委譲
224
297
 
@@ -11,136 +11,169 @@ specdojo:
11
11
 
12
12
  # 概念データフロー図(ユースケース別): 欠品から補充まで
13
13
 
14
- 本書は、[[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] のケース `C-02`「欠品から補充まで」について、在庫、仕入、販売の順序と、グループ間の引き渡し条件を定める概念仕様である。product 成果物として作成する場合の ID は `cdfd-uc-replenishment` とする。
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
- - ケースは `C-02`「欠品から補充まで」であり、在庫の補充判断、仕入への依頼、発注・入荷を経た売場補充、販売による売場商品の引き受けまでの責任境界を扱う。
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
- ### 3.1. 在庫(P-05〜P-06)
37
-
38
- 補充基準を下回った商品を特定して補充対象と数量を確定し、店主代表の承認を得た補充依頼を仕入へ渡す。
29
+ ほかのケースも通る領域の内部は、次の役割表の参照先をそれぞれ唯一の正本とし、本書では各グループを 1 つの代表ノードにして受け渡しの線だけを描く。
39
30
 
40
- - **主要入力**: 商品台帳の補充基準・発注単位、在庫記録の在庫数量
41
- - **主要出力**: 補充対象の商品・数量・補充判断
42
- - **データストア**: 商品台帳、在庫記録
31
+ ### 3.1. 在庫(P-05〜P-06)
43
32
 
44
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
45
- | ---- | ---------------- | -------------- | ---------------------------------------------------------------------------- | ---------------- |
46
- | 1 | 在庫 | `P-05`〜`P-06` | 補充基準を下回った商品について補充対象と数量を確定し、仕入へ補充依頼を渡す。 | `cdfd-inventory` |
33
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
34
+ | ---- | ---------------------- | -------------- | -------------------------------------------------------------------------------------------------- | ---------------- |
35
+ | 1 | 在庫 | `P-05`〜`P-06` | 商品台帳で補充対象を特定し、発注単位に合う数量を確定して、店主代表が承認した補充依頼を仕入へ渡す。 | `cdfd-inventory` |
47
36
 
48
37
  ### 3.2. 仕入(P-01〜P-02)
49
38
 
50
- 補充依頼を受けて発注・入荷を行い、受入結果と入荷数量を記録して受入品を売場へ渡す。
51
-
52
- - **主要入力**: 補充対象の商品・数量・補充判断
53
- - **主要出力**: 受入品、入荷数量、受入結果、売場への配置
54
- - **データストア**: 仕入記録、在庫記録、売場棚
55
-
56
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
57
- | ---- | ---------------- | -------------- | ---------------------------------------------------------------- | ----------------- |
58
- | 2 | 仕入 | `P-01`〜`P-02` | 補充依頼を受け、受入結果と入荷数量を記録し、受入品を売場へ渡す。 | `cdfd-purchasing` |
39
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
40
+ | ---- | ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------ | ----------------- |
41
+ | 2 | 仕入 | `P-01`〜`P-02` | 補充依頼を受けて発注・入荷を行い、受入結果と入荷数量を記録し、記録と一致する受入品を売場棚へ配置する。 | `cdfd-purchasing` |
59
42
 
60
43
  ### 3.3. 販売(P-03〜P-04)
61
44
 
62
- 売場棚へ配置された受入品を販売対象として引き受け、店頭販売で利用できる状態にする。
63
-
64
- - **主要入力**: 受入品、入荷数量、受入結果、売場への配置
65
- - **主要出力**: 販売対象として引き受けた売場商品
66
- - **データストア**: 売場棚
67
-
68
- | 順序 | プロセスグループ | 含む領域 | 横断上の役割 | 参照先 |
69
- | ---- | ---------------- | -------------- | ---------------------------------------------------- | ------------ |
70
- | 3 | 販売 | `P-03`〜`P-04` | 売場棚へ配置された受入品を販売対象として引き受ける。 | `cdfd-sales` |
45
+ | 順序 | プロセスグループ・区分 | 含む領域 | 横断上の役割 | 参照先 |
46
+ | ---- | ---------------------- | -------------- | ------------------------------------------------------------------------------------------ | ------------ |
47
+ | 3 | 販売 | `P-03`〜`P-04` | 売場棚へ配置された受入品を、確定した入荷数量・受入結果と照合し、販売対象として引き受ける。 | `cdfd-sales` |
71
48
 
72
49
  ## 4. データストア
73
50
 
74
- 全体概要の「データストア」から、`H-01`・`H-02` で引き渡す情報または引き渡し条件の判定に使う行だけを同じ名称・区分で示す。各行は概念データフローの同名ノードと対応する。
51
+ 全体概要からこのケースで参照・更新する正本だけを同じ名称・区分で示す。
75
52
 
76
53
  ### 4.1. マスタ・構成データ
77
54
 
78
- | データストア | 関連引き渡し | 横断上の利用 |
79
- | ------------ | ------------ | ---------------------------------- |
80
- | 商品台帳 | `H-01` | 補充基準と発注単位の判定根拠にする |
55
+ | データストア | 関連する参加単位 | 横断上の利用 |
56
+ | ------------ | ---------------- | ---------------------------------------------- |
57
+ | 商品台帳 | 在庫 | 補充基準と発注単位を参照し、補充対象を特定する |
81
58
 
82
59
  ### 4.2. トランザクションデータ
83
60
 
84
- | データストア | 関連引き渡し | 横断上の利用 |
85
- | ------------ | -------------- | ------------------------------------------------ |
86
- | 在庫記録 | `H-01`、`H-02` | 補充対象の判定と入荷数量の引き渡しを確認する |
87
- | 仕入記録 | `H-02` | 発注・受入結果が確定したことを確認する |
88
- | 売場棚 | `H-02` | 受入品の現物が販売グループへ渡ったことを確認する |
61
+ | データストア | 関連する参加単位 | 横断上の利用 |
62
+ | ------------ | ---------------- | ------------------------------------------------------------------------ |
63
+ | 在庫記録 | 在庫、仕入 | 在庫が補充判断のため在庫数量を参照し、仕入が販売へ渡す入荷数量を反映する |
64
+ | 仕入記録 | 仕入 | 発注・受入結果を記録する |
65
+ | 売場棚 | 仕入、販売 | 受入品を配置し、販売が売場商品を引き受ける(物理保管) |
89
66
 
90
67
  ## 5. 概念データフロー
91
68
 
92
- 開始イベントから在庫、仕入、販売へ進む正常系と、`H-01`・`H-02` の成立条件を一図で示す。各角丸長方形は一つのプロセスグループを表す。
93
-
94
- ```mermaid
95
- flowchart LR
96
- classDef process fill:#e3f2fd,stroke:#1e88e5,color:#000
97
- classDef event fill:#fff3e0,stroke:#fb8c00,color:#000
98
- classDef storeMaster fill:#a5d6a7,stroke:#1b5e20,color:#000
99
- classDef storeTransaction fill:#e8f5e9,stroke:#43a047,color:#000
100
-
101
- 補充基準割れ{{"⚡ 在庫が補充基準を下回った"}}
102
- 在庫("📦 在庫<br>P-05〜P-06")
103
- 補充依頼成立{{"⚡ H-01 補充対象・数量・承認がそろった"}}
104
- 仕入("🚚 仕入<br>P-01〜P-02")
105
- 売場引渡成立{{"⚡ H-02 記録と受入品が一致し売場へ配置された"}}
106
- 販売("🛒 販売<br>P-03〜P-04")
107
- 販売引受完了{{"⚡ 販売が売場商品を扱える"}}
108
- 商品台帳[("📐 商品台帳")]
109
- 在庫記録[("📒 在庫記録")]
110
- 仕入記録[("📒 仕入記録")]
111
- 売場棚(["🏬 売場棚"])
112
-
113
- 補充基準割れ -->|"起動条件"| 在庫
114
- 商品台帳 -->|"補充基準・発注単位"| 在庫
115
- 在庫記録 -->|"在庫数量"| 在庫
116
- 在庫 -->|"H-01 補充依頼"| 補充依頼成立
117
- 補充依頼成立 -->|"起動条件"| 仕入
118
- 仕入 -->|"発注・受入結果"| 仕入記録
119
- 仕入 -->|"入荷数量"| 在庫記録
120
- 仕入 ==>|"受入品"| 売場棚
121
- 仕入 -->|"H-02 入荷数量・受入結果"| 売場引渡成立
122
- 売場引渡成立 -->|"起動条件"| 販売
123
- 売場棚 ==>|"売場商品"| 販売
124
- 販売 -->|"完了条件"| 販売引受完了
125
-
126
- class 在庫,仕入,販売 process
127
- class 補充基準割れ,補充依頼成立,売場引渡成立,販売引受完了 event
128
- class 商品台帳 storeMaster
129
- class 在庫記録,仕入記録,売場棚 storeTransaction
69
+ ### 5.1. 欠品から売場補充まで
70
+
71
+ 在庫が承認済みの補充依頼を仕入へ渡し、仕入が入荷数量・受入結果を記録して、販売が売場商品を引き受ける。
72
+
73
+ ```d2
74
+ direction: down
75
+
76
+ classes: {
77
+ process: {
78
+ shape: rectangle
79
+ style: {
80
+ border-radius: 8
81
+ fill: "#e3f2fd"
82
+ stroke: "#1e88e5"
83
+ font-color: "#000000"
84
+ }
85
+ }
86
+ event: {
87
+ shape: hexagon
88
+ style: {
89
+ fill: "#fff3e0"
90
+ stroke: "#fb8c00"
91
+ font-color: "#000000"
92
+ }
93
+ }
94
+ store_master: {
95
+ shape: cylinder
96
+ style: {
97
+ fill: "#e8f5e9"
98
+ stroke: "#43a047"
99
+ font-color: "#000000"
100
+ }
101
+ }
102
+ store_transaction: {
103
+ shape: cylinder
104
+ style: {
105
+ fill: "#c8e6c9"
106
+ stroke: "#2e7d32"
107
+ font-color: "#000000"
108
+ }
109
+ }
110
+ physical_store: {
111
+ shape: rectangle
112
+ style: {
113
+ border-radius: 20
114
+ fill: "#c8e6c9"
115
+ stroke: "#2e7d32"
116
+ font-color: "#000000"
117
+ }
118
+ }
119
+ material_flow: {
120
+ style: {
121
+ stroke-width: 3
122
+ }
123
+ }
124
+ }
125
+
126
+ start: "⚡ 在庫が補充基準を\n下回った" { class: event }
127
+ inventory: "📦 在庫\nP-05〜P-06" { class: process }
128
+ purchasing: "🚚 仕入\nP-01〜P-02" { class: process }
129
+ sales: "🛒 販売\nP-03〜P-04" { class: process }
130
+ end: "⚡ 販売が売場商品を\n扱える" { class: event }
131
+ item_master: "📐 商品台帳" { class: store_master }
132
+ inventory_record: "📒 在庫記録" { class: store_transaction }
133
+ purchase_record: "📒 仕入記録" { class: store_transaction }
134
+ display_shelf: "🏬 売場棚" { class: physical_store }
135
+
136
+ start -> inventory: "起動条件"
137
+ item_master -> inventory: "補充基準・発注単位"
138
+ inventory_record -> inventory: "在庫数量"
139
+ inventory -> purchasing: "補充依頼(商品・数量・承認)"
140
+ purchasing -> purchase_record: "発注・受入結果"
141
+ inventory_record <- purchasing: "入荷数量"
142
+ purchasing -> display_shelf: "受入品" { class: material_flow }
143
+ purchasing -> sales: "入荷数量・受入結果"
144
+ display_shelf -> sales: "売場商品" { class: material_flow }
145
+ sales -> end: "販売対象の引受結果"
130
146
  ```
131
147
 
132
- 凡例の形状・色・絵文字は全体概要の「凡例(本プロダクト共通)」を参照する。`-->` は情報、`==>` は商品の流れを表す。各グループ内部の在庫計算、補充判断、発注、入荷検品、売場補充、店頭販売は省略し、三つの代表ノードだけを置く。商品台帳と在庫記録は `H-01`、仕入記録と売場棚は `H-02` の成立を確認する正本として必要なため図へ置いている。
148
+ 凡例は [[specdojo:cdfd-overview-sample|全体概要]] の「凡例(本プロダクト共通)」を参照し、通常線は情報、太線は商品の流れに用いる。在庫記録は補充判断と入荷数量確認の双方の正本とし、商品台帳は補充対象・数量の根拠、仕入記録と売場棚は受入結果と現物の照合のために置く。各グループ内部は役割表の参照先へ委ね、次の図でも在庫・仕入・販売の代表ノードを共有する。
149
+
150
+ ### 5.2. 例外時の戻り
151
+
152
+ 補充依頼の不足は仕入から在庫へ、受入結果や売場配置の不一致は販売から仕入へ返し、補完・再判断後の情報を再提示する。
133
153
 
134
- ## 6. 引き渡し
154
+ ```d2
155
+ direction: down
135
156
 
136
- | 引き渡し ID | 送り元グループ | 受け側グループ | 引き渡す情報 | 引き渡し条件 | 戻す条件 |
137
- | ----------- | -------------- | -------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
138
- | `H-01` | 在庫 | 仕入 | 補充対象の商品、数量、補充判断 | 商品を商品台帳で一意に特定でき、補充数量が発注単位で示され、店主代表が補充判断を承認している。 | 商品を特定できない、数量がない、発注単位に合わない、または承認を確認できない。 |
139
- | `H-02` | 仕入 | 販売 | 受入品、入荷数量、受入結果、売場への配置 | 入荷数量と受入結果が記録され、受入品と記録が一致し、受入品が売場棚へ配置されている。 | 記録と受入品が一致しない、受入結果が確定していない、または売場棚に受入品がない。 |
157
+ classes: {
158
+ process: {
159
+ shape: rectangle
160
+ style: {
161
+ border-radius: 8
162
+ fill: "#e3f2fd"
163
+ stroke: "#1e88e5"
164
+ font-color: "#000000"
165
+ }
166
+ }
167
+ }
140
168
 
141
- ## 7. 例外時の戻り先
169
+ inventory: "📦 在庫\nP-05〜P-06" { class: process }
170
+ purchasing: "🚚 仕入\nP-01〜P-02" { class: process }
171
+ sales: "🛒 販売\nP-03〜P-04" { class: process }
172
+
173
+ inventory <- purchasing: "不足項目・商品候補・現在庫・補充基準"
174
+ inventory -> purchasing: "修正・再承認済みの補充依頼"
175
+ purchasing <- sales: "数量の差異・未確定の受入結果・配置状況"
176
+ purchasing -> sales: "照合・配置確認済みの入荷数量・受入結果"
177
+ ```
142
178
 
143
- | 対象引き渡し | 条件不成立 | 戻り先グループ | 戻す情報 | 再開条件 |
144
- | ------------ | ------------------------------------------------------------------------------------------------ | -------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
145
- | `H-01` | 商品を一意に特定できない、数量または発注単位が不足している、または店主代表の承認を確認できない。 | 在庫 | 不足項目、商品候補、現在庫、補充基準 | 商品と発注単位に合う数量を確定し、店主代表が修正後の補充依頼を承認して `H-01` を再提示した。 |
146
- | `H-02` | 入荷数量・受入結果と受入品が一致しない、受入結果が未確定、または受入品が売場棚にない。 | 仕入 | 記録と受入品の差異、未確定の受入結果、売場棚への配置状況 | 記録と受入品が一致し、受入結果の確定と売場棚への配置を確認して `H-02` を再提示した。 |
179
+ 凡例は [[specdojo:cdfd-overview-sample|全体概要]] を参照し、本図は本ケースでグループ間を戻る補充依頼の不足と受入結果・売場配置の不一致を漏れなく示す。通常の図と同じ代表ノードを使い、通常線で情報の戻りと再提示を描く。データストアと物の流れは通常の図、各グループ内部の例外は役割表の参照先へ委ね、内部の再試行は描かない。