specdojo 0.7.0 → 0.9.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 (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -0,0 +1,116 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:cdt-sample
4
+ type: data
5
+ status: ready
6
+ rulebook: specdojo:cdt-rulebook
7
+ supersedes:
8
+ - specdojo:cld-sample
9
+ ---
10
+
11
+ # 商品区分
12
+
13
+ 駄菓子屋の店主代表と家族利用者代表が、商品の棚割り・仕入れ方針・棚札を同じ基準で選ぶための分類を定義する。
14
+
15
+ ## 1. 概要
16
+
17
+ - 業務目的: 商品の種類と仕入れ方針を分け、季節商品を定番商品と同じ基準で補充する誤りや、棚札の表記ゆれを防ぐ。
18
+ - 対象エンティティ: 商品(`product`)。商品の管理単位と識別は [[specdojo:bdd-sample|業務データ辞書(駄菓子屋の販売管理)]] に合わせる。
19
+ - 適用範囲: 店舗の商品台帳と棚札で使う「商品区分」「取扱区分」「棚札タグ」。商品区分と取扱区分はそれぞれ一つを選び、棚札タグは必要な場合だけ複数付けられる。
20
+ - 主担当ロール: BA が判断境界を整理し、PO を担う店主代表が区分の意味と各商品の分類を決める。家族利用者代表は仕入れや店番で参照し、QE は境界事例を確認する。
21
+ - 責務の境界: これらは実装前の店舗運営上の分類であり、業務データ辞書に未定義の属性を実装済みとは扱わない。税区分・保管温度・賞味期限は商品ごとに確認し、本分類だけから税率や保管方法を決定しない。
22
+
23
+ ## 2. 分類定義
24
+
25
+ ### 2.1. 商品区分
26
+
27
+ | 定義項目 | 内容 |
28
+ | ---------------- | ---------------------------------------------------------------------------------- |
29
+ | 対象エンティティ | 商品(`product`) |
30
+ | 分類定義名 | 商品区分(`product_type`) |
31
+ | 種別 | 業務分類 |
32
+ | 正本参照(SSOT) | なし(スタンドアロン定義)。本書の「商品区分の選定」を正本とする |
33
+ | 説明 | 店主代表が商品の主な用途で棚割りを決める区分。冷蔵の要否や販売する季節では分けない |
34
+
35
+ ### 2.2. 取扱区分
36
+
37
+ | 定義項目 | 内容 |
38
+ | ---------------- | -------------------------------------------------------------------------------------------------- |
39
+ | 対象エンティティ | 商品(`product`) |
40
+ | 分類定義名 | 取扱区分(`handling_type`) |
41
+ | 種別 | 業務分類 |
42
+ | 正本参照(SSOT) | なし(スタンドアロン定義)。本書の「取扱区分の選定」を正本とする |
43
+ | 説明 | 店主代表が継続補充・期間限定・試験導入のどの方針で仕入れるかを決める区分。商品の種類とは独立に選ぶ |
44
+
45
+ ### 2.3. 棚札タグ
46
+
47
+ | 定義項目 | 内容 |
48
+ | ---------------- | ------------------------------------------------------------------------------------------------------------ |
49
+ | 対象エンティティ | 商品(`product`) |
50
+ | 分類定義名 | 棚札タグ(`shelf_tags`) |
51
+ | 種別 | 動的分類 |
52
+ | 正本参照(SSOT) | 店主代表が保管する紙の商品台帳の「棚札タグ管理欄」。追加・変更・廃止は本書の「棚札タグの管理」に従う |
53
+ | 説明 | 売場で注目してほしい特徴を示す任意の分類。店主代表が運用中に増減でき、商品区分や取扱区分の代わりには使わない |
54
+
55
+ この三つの属性名は商品台帳の分類軸を識別するための呼称であり、データ構造は定義しない。商品区分・取扱区分には実装やスキーマによる許容値の定義がなく、本書が業務上の正本を担う。棚札タグの現行値は商品台帳で管理し、本書には固定の値一覧を置かない。
56
+
57
+ ## 3. 値の業務的意味と使い分け
58
+
59
+ ### 3.1. 商品区分の選定
60
+
61
+ | 値 | 分類名 | 表示名 | 説明・成立条件 |
62
+ | ------- | ------ | ------ | ------------------------------------------------------------------------------------------------------------------ |
63
+ | `snack` | お菓子 | お菓子 | 食べることを主な用途とする駄菓子・菓子類。飲む商品は `drink` とし、包装の絵柄や冷蔵の有無では区分を変えない |
64
+ | `toy` | 玩具 | 玩具 | 遊ぶことを主な用途とする非食品。シール・こま・花火などを含む。食べる商品に景品が付くことだけを理由に玩具とはしない |
65
+ | `drink` | 飲料 | 飲料 | 飲むことを主な用途とする清涼飲料・瓶ジュース類。常温で販売する飲料も含み、冷蔵した菓子を含めない |
66
+
67
+ 菓子と玩具が一体の商品は、商品説明と売場での案内から主な用途を店主代表が確認する。用途を一つに決められない場合は、家族利用者代表が推測で区分を付けず、店主代表が扱いを決めるまで棚割りを保留する。既存の三分類に当てはまらない商品も、便宜的にいずれかへ入れず、分類の追加要否を確認する。
68
+
69
+ ### 3.2. 取扱区分の選定
70
+
71
+ | 値 | 分類名 | 表示名 | 説明・成立条件 |
72
+ | -------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------- |
73
+ | `staple` | 定番商品 | ★定番 | 店主代表が通年で棚に置き、継続して補充すると決めた商品。発注点を設定する対象。売れ行きが良いだけでは自動で定番にしない |
74
+ | `seasonal` | 季節商品 | 季節限定 | 店主代表が販売期間を定め、その期間内だけ仕入れる商品。期間終了時は追加仕入れを止め、残品の扱いを店主代表が決める |
75
+ | `experimental` | 試験商品 | お試し | 継続取扱の判断材料を集めるために初回導入する商品。入荷後30日間の売れ行きを確認して、店主代表が継続方針を決める |
76
+
77
+ #### 3.2.1. 条件が重なる場合
78
+
79
+ 1. 販売期間を限定している商品は、新規導入でも `seasonal` を優先する。期間を延ばす場合も、通年補充の決定がなければ `staple` にしない。
80
+ 2. 期間限定ではなく、継続取扱が未決定の新商品は `experimental` とする。入荷後30日を過ぎただけでは `staple` に変えず、判断待ちの間は追加仕入れを保留する。
81
+ 3. 店主代表が通年補充を決定した時点で `staple` とする。商品の新旧や販売量だけでは選ばない。
82
+
83
+ #### 3.2.2. 区分を変更する場合
84
+
85
+ - 店主代表は変更理由と適用日を商品台帳に残し、家族利用者代表に新しい補充方針を伝える。商品IDは変えない。取扱区分の変更適用日までに、店番担当(店主代表または家族利用者代表)は店頭の棚札表示(表示名: `★定番` / `季節限定` / `お試し`)を新しい取扱区分に合わせて貼り替える。
86
+ - `experimental` から `staple` に変更する場合は発注点の設定を確認する。未設定をゼロと読み替えて補充判断を進めない。
87
+ - 継続取扱をやめる場合は、無理に別区分へ移さず追加仕入れを止める。取扱終了は商品の種類ではなく販売対象の管理として扱い、過去の記録を残す。
88
+
89
+ ### 3.3. 棚札タグの管理
90
+
91
+ | 管理項目 | 規約 |
92
+ | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
93
+ | 管理元 | 紙の商品台帳の棚札タグ管理欄を正本とし、棚札へ同じ名称を転記する。棚札だけに新しいタグを作らない |
94
+ | 作成・変更権限 | 店主代表が追加・改名・アーカイブを決める。家族利用者代表は登録済みの有効なタグを商品へ付け外しでき、新設や統合が必要な場合は店主代表へ依頼する |
95
+ | 命名規約 | 来店客が特徴を理解できる短い日本語名とし、商品名・人物名を使わない。同義のタグは新設せず既存名に揃える。「定番」「季節限定」「お試し」は取扱区分の表示と混同するため使わない |
96
+ | 改名・統合 | 同じ意味の改名は既存の参照を引き継ぎ、商品台帳と棚札を揃える。意味を変える場合は別タグを作り、旧タグを同じ意味だったように書き換えない |
97
+ | 削除・アーカイブ | 商品や過去の記録から参照されたタグは削除せずアーカイブする。以後の新規付与を止め、既存の参照と当時の意味は確認できるよう残す。未使用の誤登録だけ削除できる |
98
+
99
+ 例えば「小分け」は少量ずつ分けて渡せる商品への棚札表現として店主代表が登録できるが、必須のタグではない。タグが付いていなくても商品区分・取扱区分の選定には影響しない。
100
+
101
+ ### 3.4. 判断境界の具体例
102
+
103
+ | 場面 | 選定結果・次の判断 | 境界の根拠 |
104
+ | -------------------------------------------- | ------------------------ | ---------------------------------------------------------------- |
105
+ | 通年補充する瓶ジュースを常温棚で売る | `drink` / `staple` | 飲む用途と通年補充の方針で選ぶ。保管温度は商品ごとに確認する |
106
+ | 夏季だけ販売する花火を初めて仕入れる | `toy` / `seasonal` | 非食品で遊ぶ用途。新規導入でも期間限定が優先される |
107
+ | 継続取扱を決めていない新しい駄菓子を導入する | `snack` / `experimental` | 食べる用途。入荷後30日間の確認を経て店主代表が継続方針を判断する |
108
+
109
+ ## 4. 関連仕様との関係
110
+
111
+ | 関連仕様 | 分類との関係・変更時に確認すること |
112
+ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
113
+ | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] | 商品(`product`)と発注点(`reorder_point`)を参照する。本書の分類属性やタグの管理構造は同辞書に未定義。システム化する際は辞書へ構造を定義し、許容値を実装・スキーマに持たせる場合は本書の正本参照方式を切り替える |
114
+ | [[specdojo:gl-sample\|用語集 在庫・調達]] | 「定番商品」と「発注点」の語義を参照する。定番の成立条件を変える場合は、通年で棚に置く方針および発注点の利用対象と矛盾しないか確認する |
115
+ | [[specdojo:br-sample\|在庫不足判定]] | 定番商品で発注点に基づく不足判定を行う際に参照する。計算式と入力不備の扱いは同ルールに委ねる。季節・試験商品の追加仕入れは店主代表が取扱方針に沿って判断する |
116
+ | [[specdojo:uis-sample\|販売登録画面 画面仕様]] | 販売する商品の識別と会計操作を参照する。本書は商品分類の編集画面や税率の算出を定義しない。分類の変更を会計へ反映する場合は、商品ごとの税区分との関係を別途確認する |
@@ -2,37 +2,10 @@
2
2
  specdojo:
3
3
  id: specdojo:cld-sample
4
4
  type: data
5
- status: draft
5
+ status: deprecated
6
6
  rulebook: specdojo:cld-rulebook
7
7
  ---
8
8
 
9
- # [業務データ辞書 / 分類定義](../rulebooks/cld-rulebook.md) サンプル
9
+ # 分類一覧(CLD)サンプル(非推奨)
10
10
 
11
- ## 1. 目的と適用範囲
12
-
13
- 本書は、業務上の分類(カテゴリ、種別、区分など)を一覧で定義するための最小サンプルである。
14
-
15
- ## 2. 入力情報
16
-
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/cld-rulebook.md`
20
-
21
- ## 3. 記述内容
22
-
23
- - 主な内容: 分類定義名、種別、分類名、説明など
24
- - 必須観点: 対象、条件、判定基準、責任者
25
-
26
- ## 4. 最小記述例
27
-
28
- | 項目 | 値 | 備考 |
29
- | ------------ | --------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | [業務データ辞書 / 分類定義](../rulebooks/cld-rulebook.md) | 最小サンプル |
31
- | 目的 | 業務上の分類(カテゴリ、種別、区分など)を一覧で定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 分類定義名、種別、分類名、説明など | 要点のみ記載 |
33
-
34
- ## 5. 未解決事項
35
-
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
11
+ この sample は非推奨です。後継の完成例は [[specdojo:cdt-sample|CDT サンプル]] を参照してください。
@@ -0,0 +1,125 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:clis-sample
4
+ type: ui
5
+ status: draft
6
+ rulebook: specdojo:clis-rulebook
7
+ part_of: []
8
+ based_on: []
9
+ ---
10
+
11
+ # 駄菓子屋きぬや 販売管理 CLI 仕様
12
+
13
+ ## 1. 概要
14
+
15
+ 店番担当が現金販売を記録し、釣銭とレシートを渡すための CLI コマンド群である。会計と印字の結果を区別して残し、店番の交代時に未完了の取引を引き継げるようにする。
16
+
17
+ ## 2. 利用目的と対象ユーザー
18
+
19
+ | 対象者 | 解決する課題・達成する結果 | 確認・合意する内容 |
20
+ | -------------------------- | ------------------------------------------ | ------------------------------------------------ |
21
+ | 店主代表 | 暗算や転記に頼らず売上を記録する | 会計の確定条件、取消できる範囲、障害時の照合結果 |
22
+ | 家族利用者代表 | 店主不在でも同じ手順で会計する | 会計までの操作、保留時に店主へ渡す情報 |
23
+ | 開発担当・同行レビュー担当 | 正常・警告・異常を識別し、二重会計を避ける | 入出力の正本、保存される記録、回復後の期待結果 |
24
+
25
+ 対象は単一店舗・現金販売の開始、明細追加、金額確認、会計確定、確定前の取消とする。確定後の返品・訂正は店主代表の照合手順へ引き渡し、つけ販売、キャッシュレス決済、仕入れ、在庫調整は対象外とする。
26
+
27
+ _ASSUMPTION_: 店舗端末1台を人が操作する学習用 CLI とし、商品マスタの取得と売上登録に本部 API を使う。自動会計・無人運転や通信不能時の販売継続は扱わない。
28
+
29
+ ## 3. 操作の流れ
30
+
31
+ 1. **取引を開始する**: 店番担当(店主代表か家族利用者代表)が `sales start` を実行し、表示された取引番号を以後の照合に使う。
32
+ 2. **明細をそろえる**: `sales add` で商品コードと数量を指定し、結果を現物と照合する。誤登録は確定前に `sales cancel` で取引全体を取り消す。
33
+ 3. **金額を提示する**: `sales total` で明細・税額・請求額を確認し、来店客と合意してから現金を受け取る。
34
+ 4. **会計を確定する**: `sales complete` の対話で預かり金額を入力し、会計確定の通知を見て釣銭を渡す。印字未完了の警告は会計の取消とみなさない。
35
+ 5. **結果を引き継ぐ**: 未印字・結果不明・保存失敗があれば、取引番号と保持された記録を店主代表へ渡す。
36
+
37
+ 会計要求前の中断は、同じ取引を `sales total` で確認して続けるか取り消す。会計要求後の中断は、新しい取引で登録し直さず、「代表的な表示と利用者の次の手」に従って確定状態を照合する。
38
+
39
+ ## 4. 操作とコマンド参照
40
+
41
+ 構文・引数・オプションの正本は `kinuya-cli-reference`(未同梱の架空参照名)とする。
42
+
43
+ | 操作 | 対象コマンド | 正本リファレンス |
44
+ | ---------------------- | ---------------- | ------------------------------------- |
45
+ | 取引開始 | `sales start` | `kinuya-cli-reference#sales-start` |
46
+ | 明細追加 | `sales add` | `kinuya-cli-reference#sales-add` |
47
+ | 明細・合計確認 | `sales total` | `kinuya-cli-reference#sales-total` |
48
+ | 会計確定 | `sales complete` | `kinuya-cli-reference#sales-complete` |
49
+ | 確定前の取引全体の取消 | `sales cancel` | `kinuya-cli-reference#sales-cancel` |
50
+
51
+ ## 5. 入力と出力の要点
52
+
53
+ 「本書」は独立したデータ契約を設けない表示・対話を示す。印字の契約例は学習用の [[specdojo:ifx-cmd-sample|レシート印刷コマンド連携仕様]] を参照する。
54
+
55
+ ### 5.1. 入力情報
56
+
57
+ | コマンド | 種類 | 対象 | 役割 | 正本の参照 | ない/壊れている/届かないときの扱い |
58
+ | --------------------------------------------------- | ---------------------- | -------------------------- | ---------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------- |
59
+ | `sales start`・`add`・`total`・`complete` | ファイル | `config/store-config.yaml` | 店舗・税計算・本部接続の条件 | `kinuya-store-config-schema` | 欠落時は既定設定で進む。破損時は「店舗設定不正」 |
60
+ | `sales add`・`complete` | 環境変数 | `KINUYA_API_KEY` | 本部 API の認証(値は出さない) | `kinuya-cli-reference` の「認証設定」 | 未設定は「認証設定不足」。認証拒否は各 API の拒否 |
61
+ | `sales add` | 外部 API の応答 | 本部商品マスタ | 商品名・販売単価・税区分を取得する | `ifx-api-kinuya-products.yaml` | 「商品マスタ取得失敗」で明細を追加しない。未登録は「商品コード未登録」 |
62
+ | `sales start`・`add`・`total`・`complete`・`cancel` | ファイル | `.session/current-tx.json` | 同じ取引の明細と確定状態を引き継ぐ | `kinuya-session-schema` | `start` は欠落時に作成し、既存なら「取引二重開始」。他は欠落を「取引未開始」。破損は「取引記録破損」 |
63
+ | `sales complete` | 対話での入力 | 預かり金額 | 受領額と請求額の照合 | 本書 | 不足・不正は再入力。中断は「預かり金入力中断」 |
64
+ | `sales complete` | 外部 API の応答 | 本部売上登録の受付結果 | 同じ取引の登録結果を確認する | `ifx-api-kinuya-sales.yaml` | 「売上登録失敗」。結果不明を完了扱いにしない |
65
+ | `sales complete` | 外部コマンドの実行結果 | `receipt-print` の印字結果 | 印字されたかの判断 | レシート印刷コマンド連携仕様 | 「印字未完了」の警告で会計を維持する |
66
+
67
+ ### 5.2. 出力情報
68
+
69
+ | コマンド | 種類 | 対象 | 役割 | 正本の参照 |
70
+ | ------------------------------------------ | -------------------- | ------------------------------------ | ------------------------------------------------------ | ------------------------------ |
71
+ | `sales start`・`add`・`total`・`cancel` | 標準出力 | 開始・追加・集計・取消の通知 | 対象取引、明細、請求額、取消済みの確認 | 本書 |
72
+ | `sales complete` | 標準出力 | 会計確定サマリー | 請求額・預かり金・釣銭と会計確定の確認 | 本書 |
73
+ | 全コマンド | 標準エラー | 再入力の案内・警告・停止理由 | 原因と保持記録から次の手を選ぶ | 本書 |
74
+ | `sales start`・`add`・`complete`・`cancel` | 作る/変えるファイル | `.session/current-tx.json` | 取引を保存し、会計完了か取消で終える。保存後に通知する | `kinuya-session-schema` |
75
+ | `sales add` | 外部 API への送信 | 本部商品マスタへの照会 | 商品の取得。マスタは更新しない | `ifx-api-kinuya-products.yaml` |
76
+ | `sales complete` | 外部 API への送信 | 本部売上登録 | 同じ取引の販売実績を渡す | `ifx-api-kinuya-sales.yaml` |
77
+ | `sales complete` | 作る/変えるファイル | `data/sales/TX-YYYYMMDD-NNNN.json` | 販売実績と送信結果の控え。照合に使う | `kinuya-sales-record-schema` |
78
+ | `sales complete` | 作る/変えるファイル | `receipts/receipt-YYYYMMDD-NNNN.txt` | レシートの保存。再印刷に使う | `kinuya-receipt-format-schema` |
79
+ | `sales complete` | 外部コマンドの起動 | `receipt-print` | 保存済みレシートの印字を依頼する | レシート印刷コマンド連携仕様 |
80
+
81
+ ## 6. 終了コードとエラー表示・利用者の次の手
82
+
83
+ ### 6.1. 終了時の判断
84
+
85
+ 値の正本は `kinuya-cli-reference` の「終了コード」とする。外部印刷コマンドの終了コードは販売 CLI 全体へ伝播しない。
86
+
87
+ | 終了コード | 区分 | 利用者が確認する結果 |
88
+ | ---------- | ------------------ | ------------------------------------------------------ |
89
+ | `0` | 正常終了・警告継続 | 操作結果。印字警告を含み、レシート発行済みとは限らない |
90
+ | `1` | 入力の誤り・中断 | 入力の訂正・再開。会計要求前の明細は保持される |
91
+ | `2` | 取引状態の不整合 | 既存取引と確定状態。新規取引でのやり直しを先にしない |
92
+ | `3` | 本部 API の失敗 | 接続・認証と受付結果。結果不明を未登録と断定しない |
93
+ | `4` | 設定・保存先の障害 | 開発担当による環境復旧と保存状態の照合 |
94
+
95
+ ### 6.2. 代表的な表示と利用者の次の手
96
+
97
+ | 事象・条件 | 終了コード | 表示要点 | 利用者の次の手・回復の確認 |
98
+ | ---------------------------------------------------- | --------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
99
+ | 取引開始・明細追加・確認・取消の成功 | `0` | 対象取引、操作結果 | 現物と照合し、次の操作へ進む |
100
+ | 会計確定・印字完了 | `0` | 会計確定、釣銭、印字完了 | 取引番号とレシートを照合して渡す |
101
+ | 店舗設定不正 | `4` | 設定ファイル、不正の理由 | 開発担当が訂正し、店主代表が店舗条件を確認する。設定の削除で回避しない |
102
+ | 認証設定不足 | `1` | `KINUYA_API_KEY` の未設定(値は出さない) | 開発担当が設定し、元の操作を再試行する |
103
+ | 商品コード未登録・数量不正 | `1` | 対象の値、訂正の理由 | 直して追加し、明細に1回だけ反映されたことを確認する |
104
+ | 商品マスタ取得失敗 | `3` | 対象商品、失敗の別、追加未実施 | 接続を確認し、拒否なら開発担当へ権限確認を依頼する。復旧後に同じ取引へ追加する |
105
+ | 預かり金額不足・入力不正 | 入力待ちのため未終了 | 不足額または訂正の案内 | 同じ対話で再入力する。本部へはまだ送らない |
106
+ | 預かり金入力中断 | `1` | 会計未要求、明細保持 | `sales total` で明細を確認し、会計を再開するか取り消す |
107
+ | 取引未開始・取引二重開始 | `2` | 未開始または既存取引番号 | 未開始なら `sales start`。二重開始なら既存取引を確認し、会計が未解決なら取り消さない |
108
+ | 明細なし | `2` | 会計対象なし | 商品を追加するか取り消す。販売完了と数えない |
109
+ | 取引記録破損・確定後の取消要求 | `2` | 対象取引、続けられない理由 | 店主代表と開発担当が本部受付と保存記録を照合する。ファイル削除や `sales cancel` で初期化しない |
110
+ | 売上登録失敗 | `3` | 失敗の別、取引番号、受付結果不明の有無 | 店主代表が本部受付と控えを照合する。受付済みなら同じ取引を回復し、未受付と確認できた場合だけ再送する。確認できなければ保留する |
111
+ | 印字未完了 | `0`(会計は確定済み) | 警告、未印字/結果不明の別、控えの場所 | 紙面を確認し、開発担当の復旧後に保存済みレシートだけを再印刷する。売上は再送しない |
112
+ | 取引セッション保存失敗 | `4` | 対象取引、反映されなかった操作 | 開始・追加・取消は反映されず、成功も通知しない。開発担当の復旧後、店番担当が `sales total` で明細を確認して同じ操作をやり直す |
113
+ | 売上・レシートの保存失敗、会計後のセッション終了失敗 | `4` | 対象パス、取引番号、保存できた範囲 | 開発担当が復旧し、店主代表が本部受付と保持記録を照合する。会計を再実行しない |
114
+
115
+ _ASSUMPTION_: 会計確定は、本部受付と販売実績の保存を確認してから通知する。会計要求後の停止・応答欠落は照合待ちとして保持する。
116
+
117
+ ## 7. メモ / 将来課題
118
+
119
+ | 論点 | 影響と当面の扱い |
120
+ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
121
+ | 上位の操作体系が未作成 | `kinuya-clis-index` と CLI 用のシステム化機能がなく、`part_of`・`based_on` は未接続。GUI の機能仕様を根拠に流用しない |
122
+ | 構文・設定・記録の正本 | `kinuya-cli-reference` と各 schema は未同梱の架空参照名 |
123
+ | 本部との契約・障害回復 | `ifx-api-kinuya-*.yaml` は未同梱。受付照会・重複排除・保存失敗後の回復が決まるまで、結果不明の取引は自動再送せず、当該経路の受入を保留する |
124
+ | 印字経路の実機確認 | 印字結果不明・二重印字は実機で未確認。確かめるまで再印刷は保存済みレシートに限る |
125
+ | 将来の拡張候補 | オフライン同期 `sales sync`、連続スキャン `sales scan`、キャッシュレス決済は現行の回復操作に使わない |
@@ -3,36 +3,142 @@ specdojo:
3
3
  id: specdojo:cnd-sample
4
4
  type: architecture
5
5
  status: draft
6
- rulebook: specdojo:cnd-mermaid-rulebook
6
+ rulebook: specdojo:cnd-rulebook
7
+ part_of: []
8
+ based_on: []
9
+ supersedes: []
7
10
  ---
8
11
 
9
- # [C4コンテナ図](../rulebooks/cnd-rulebook.md) サンプル
12
+ # 駄菓子屋きぬや 販売管理システム C4コンテナ図
10
13
 
11
- ## 1. 目的と適用範囲
14
+ ## 1. 概要
12
15
 
13
- 本書は、対象システムを主要実行/配備単位に分割し、利用者・外部システム・データストアとの関係を定義するための最小サンプルである。
16
+ ノートと店主の記憶に頼る販売記録は、家族が店番を代わると記録漏れや確認の手間が生じる。[[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針を受け、店主代表と家族利用者代表が同じ手順で現金販売を記録し、販売結果とレシート発行状況を引き継ぐための構成を示す。入力、永続記録、物理印字の境界を定義し、配備設計と結合検証へ渡す。
14
17
 
15
- ## 2. 入力情報
18
+ 単一店舗・タブレット1台を対象とする学習用の完成例である。在庫・つけ管理への拡張、EC、本格会計、仕入れ先との連携、キャッシュレス決済は本図の対象外とする。構文・データ項目・物理ホストの設計は各詳細仕様へ委ねる。
16
19
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/cnd-mermaid-rulebook.md`
20
+ 上位図 `cxd-kinuya-sales-web` は未同梱であり、`based_on` は未接続とする。[[specdojo:cxd-sample|販売管理 CLI のコンテキスト図]] と [[specdojo:clis-sample|販売管理 CLI 仕様]] は本部 API を利用する別の学習用構成で、本図のタブレット画面と店舗側保存の直接の設計根拠にはしない。
20
21
 
21
- ## 3. 記述内容
22
+ ARC が構成案を担当し、BA は両利用者と販売・引き継ぎの場面、DEV は実行単位と接続、QE は観測結果、OPS は店舗への配備と運用条件を確認する。PO を担う店主代表が対象範囲と残るリスクを判断する。実行・配備と接続の仮定は「Container(コンテナ)」と「Relationship(関係・連携契約)」に示し、店舗で合意した実構成とは扱わない。
22
23
 
23
- - 主な内容: Webアプリ、API、バッチ、DB、メッセージ基盤など
24
- - 必須観点: 対象、条件、判定基準、責任者
24
+ ## 2. C4コンテナ図(Mermaid)
25
25
 
26
- ## 4. 最小記述例
26
+ ```mermaid
27
+ flowchart LR
28
+ 店主代表["👤 店主代表"]
29
+ 家族利用者代表["👤 家族利用者代表"]
27
30
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | --------------------------------------------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | [C4コンテナ図](../rulebooks/cnd-rulebook.md) | 最小サンプル |
31
- | 目的 | 対象システムを主要実行/配備単位に分割し、利用者・外部システム・データストアとの関係を定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | Webアプリ、API、バッチ、DB、メッセージ基盤など | 要点のみ記載 |
31
+ subgraph 境界["駄菓子屋きぬや 販売管理システム"]
32
+ 販売画面("販売画面<br>(タブレットのブラウザ)")
33
+ 販売処理("販売処理サービス")
34
+ 販売記録[("販売記録ストア")]
35
+ end
33
36
 
34
- ## 5. 未解決事項
37
+ 印刷基盤["レシート印刷基盤"]
35
38
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
39
+ 店主代表 -->|"現金販売の入力・結果確認"| 販売画面
40
+ 家族利用者代表 -->|"現金販売の入力・引き継ぎ確認"| 販売画面
41
+ 販売画面 -->|"販売記録依頼・結果取得"| 販売処理
42
+ 販売処理 -->|"商品参照・販売と控えの保存"| 販売記録
43
+ 販売処理 -->|"印字依頼・結果取得"| 印刷基盤
44
+
45
+ classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
46
+ classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
47
+ classDef external fill:#e9ecef,stroke:#495057,color:#000;
48
+ class 店主代表,家族利用者代表 person;
49
+ class 販売画面,販売処理,販売記録 system;
50
+ class 印刷基盤 external;
51
+ style 境界 fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
52
+ ```
53
+
54
+ 矢印は主たる利用・依頼・参照の向きで、返される結果も同じ関係に含む。来店客への商品の引き渡しと現金授受は店番担当が行い、来店客は画面を直接操作しないため Person に含めない。
55
+
56
+ ## 3. 要素と境界の定義
57
+
58
+ ### 3.1. 対象システムとシステム境界
59
+
60
+ 境界内は販売操作の受付、金額計算、商品参照、販売と控えの保存、会計・印字結果の表示を担う。物理印字と機器制御はレシート印刷基盤へ、現金授受と保留取引の判断は店番担当・店主代表へ委ねる。ネットワークや機器を所有する範囲と、この責務の境界を混同しない。
61
+
62
+ ### 3.2. Person(人・ロール)
63
+
64
+ | Person(図中ラベル) | 利用目的・接点 | 判断・確認の責務 |
65
+ | -------------------- | ------------------------------------------------ | ------------------------------------------------------------------ |
66
+ | 店主代表 | 販売画面で販売を記録し、保留取引を確認する | 現金と記録を照合し、結果不明や確定後の訂正を判断する |
67
+ | 家族利用者代表 | 同じ販売画面で店番を引き継ぎ、購入明細を入力する | 商品、請求額、釣銭、印字状態を確認し、未解決の取引を店主代表へ渡す |
68
+
69
+ 開発担当と同行レビュー担当は設計・検証に関わるが、通常の店頭操作の Person には含めない。
70
+
71
+ ### 3.3. Container(コンテナ)
72
+
73
+ | コンテナ(図中ラベル) | 責務 | 技術区分・実行配備の前提 |
74
+ | -------------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
75
+ | 販売画面(タブレットのブラウザ) | 明細・預かり金の入力を受け、会計と印字の結果を表示する | ブラウザアプリ。表示中の明細だけを販売成立の根拠にしない。構築した画面資材をタブレットから利用する |
76
+ | 販売処理サービス | 金額を計算し、販売記録と控えを保存して印字を依頼する | _ASSUMPTION_: 店舗側で動くサービス。画面からは HTTP で利用し、ストアへはファイル入出力、印刷基盤へは外部コマンドで接続する |
77
+
78
+ 販売画面と販売処理サービスは異なる実行単位である。商品検索・金額計算・保存はサービス内部の責務であり、本図では別コンテナに分割しない。具体的な言語・ライブラリ・バージョンは選定しない。
79
+
80
+ ### 3.4. Data Store(データストア)
81
+
82
+ | ストア(図中ラベル) | 保持する情報・正本 | アクセスと生成物の境界 |
83
+ | -------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
84
+ | 販売記録ストア | 商品情報、販売実績、レシート控え、印字結果の記録。販売と印字の照合に使う店舗側の記録 | _ASSUMPTION_: 販売処理サービスが読み書きするファイル群。画面と印刷基盤は直接更新しない。控えは販売実績から作る派生物で、控えの再印刷を販売の再登録としない |
85
+
86
+ 商品情報の更新・取込経路とバックアップは本例では設計していない。既存ノートの移行、他システムと共有する DB・schema、本部 API との統合はこの案に含めない。保存場所・アクセス条件は `kinuya-infra-design`、記録構造は `kinuya-record-schema` へ引き継ぐ。
87
+
88
+ ### 3.5. External Software System(外部システム)
89
+
90
+ | 外部システム(図中ラベル) | 利用条件・責任分界 | 不在・障害時の影響 |
91
+ | -------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
92
+ | レシート印刷基盤 | 保存済み控えの印字時だけ使用する店舗側の外部コマンド・ドライバ。プリンタ制御と物理印字を担う | 未印字または印字結果不明になり得る。印字失敗だけで販売記録を取り消さず、店番担当が控えと紙面を照合する |
93
+
94
+ 印刷基盤は販売処理サービスと同じ実行環境に置く案だが、管理する責務が異なるため境界外とする。外部決済・会計サービスへの接続は本図にはない。
95
+
96
+ ### 3.6. Relationship(関係・連携契約)
97
+
98
+ 正本欄の参照名は、本例の詳細設計へ渡す未同梱の架空文書名である。
99
+
100
+ | 関係 ID | 起点 → 終点 | 図中ラベル | 方式・条件と情報の要点 | 詳細の正本 |
101
+ | -------- | --------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------- | ------------------------------- |
102
+ | `REL-01` | 店主代表 → 販売画面(タブレットのブラウザ) | 現金販売の入力・結果確認 | タブレットでの操作。明細・預かり金を入力し、会計・印字結果を確認する | `kinuya-sales-screen` |
103
+ | `REL-02` | 家族利用者代表 → 販売画面(タブレットのブラウザ) | 現金販売の入力・引き継ぎ確認 | 同じ画面を交代して利用。未解決の取引と記録を確認する | `kinuya-sales-screen` |
104
+ | `REL-03` | 販売画面(タブレットのブラウザ) → 販売処理サービス | 販売記録依頼・結果取得 | _ASSUMPTION_: 店内 HTTP。明細と会計要求を渡し、取引の記録・印字状態を受け取る | `kinuya-sales-api` |
105
+ | `REL-04` | 販売処理サービス → 販売記録ストア | 商品参照・販売と控えの保存 | _ASSUMPTION_: ローカルファイル入出力。商品を参照し、販売と控え・印字状態を保存する | `kinuya-record-schema` |
106
+ | `REL-05` | 販売処理サービス → レシート印刷基盤 | 印字依頼・結果取得 | _ASSUMPTION_: 外部コマンド。保存した控えを渡して印字結果を受け取る | `kinuya-print-command-contract` |
107
+
108
+ ## 4. 技術前提・制約と検証観点
109
+
110
+ ### 4.1. 技術前提・制約
111
+
112
+ - _ASSUMPTION_: 販売成立はサービス側で販売実績の保存を確認して判断する。画面の表示更新、販売の保存、物理印字は別の結果として扱う。
113
+ - 画面資材を構築・配布する工程と、営業中に `REL-03`〜`REL-05` を通る工程を区別する。営業中の構築ツール起動は想定しない。
114
+ - 応答欠落では受付済みの可能性があるため、自動再送や画面での再入力によって二重販売を作らない契約が必要である。オフライン同期・再試行・排他制御の保証は本図では置かない。
115
+ - 店舗側サービスとファイル保存先への到達性を通常販売の前提とする。通信不能時の販売継続、HTTP の認証・保護、印刷コマンドの機器アクセス権は未確定であり、「メモ / 将来課題」で判断までの利用制限を扱う。
116
+
117
+ ### 4.2. コンテナ間・外部依存の検証対象
118
+
119
+ 以下は検証設計へ渡す期待結果であり、実装・実機で確認済みの保証ではない。QE は同じ取引を画面、保存実績、控え、紙面で照合する。各行の条件をすべて満たせば Pass、違反があれば Fail とし、観測方法や回復契約が未整備なら未判定として受入を保留する。
120
+
121
+ | 確認区分 | 対象関係・境界 | 観測する結果 | 主確認ロール |
122
+ | ------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ |
123
+ | 正常販売と引き継ぎ | `REL-01`〜`REL-04` | 両利用者が同じ購入明細を入力すると、参照した商品・単価に基づく請求額と保存実績が一致する。交代後も同じ取引の成立・印字状態を確認できる | BA / QE |
124
+ | 正常印字 | `REL-05` | 保存済み控えと紙面の取引・明細・請求額が一致し、画面で販売成立と印字完了を別々に識別できる | QE / DEV |
125
+ | 通信の応答欠落 | `REL-03` | 保存後に応答を失っても未受付・完了と断定せず、対象取引と照合待ちを表示する。同じ販売を自動再送せず、店主代表へ取引を引き継げる | QE / ARC |
126
+ | 保存先の障害 | `REL-04` | 読取不能時は商品を取得できたと扱わない。書込不能・中断時は販売成立を通知せず、対象取引と保存できた範囲を識別する。途中保存の照合・回復方式は課題へ渡す | QE / DEV |
127
+ | 印刷基盤の不在・結果不明 | `REL-05` | 未導入は未印字、送信後の時間切れは結果不明として通知し、販売成立と控えを維持する。店番担当が紙面を照合し、控えの手動再印刷で販売実績が増えない | QE / DEV |
128
+
129
+ 文書検査は [[specdojo:cnd-rulebook|C4コンテナ図作成ルール]] の「検証・承認前の確認」に従い、`<対象.md>` を `docs/ja/specdojo/samples/cnd-sample.md` として実行する。QE は終了コード、全図の検査結果、生成 SVG の文字・矢印・境界の目視結果をレビューへ残す。内容面では、境界を含む全要素の定義と `REL-01`〜`REL-05` の端点・ラベルが図と表で一致すれば Pass とし、欠落・余剰・不一致は Fail とする。
130
+
131
+ ## 5. メモ / 将来課題
132
+
133
+ | 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
134
+ | ---------------------- | ------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
135
+ | 上位図・配備案との照合 | 上位図と実配置が未確認。`based_on` は未接続 | ARC | `kinuya:pjr-a001-sales-placement` へ引き継ぐ。配備設計着手前に `cxd-kinuya-sales-web` と `kinuya-infra-design` でタブレット・店舗側サービス・印刷基盤の境界と配置を照合し、DEV / OPS が店舗での実行可能性を確認、PO が採用案を判断する |
136
+ | 入出力と記録の正本 | `REL-01`〜`REL-05`。画面、API、記録、印刷の契約が未同梱 | DEV | `kinuya:pjr-a002-sales-contracts` へ引き継ぐ。結合実装着手前に `kinuya-sales-screen`、`kinuya-sales-api`、`kinuya-record-schema`、`kinuya-print-command-contract` を整備し、ARC が各端点の責務と図の整合を確認すれば完了。構文・設定値・記録項目は各正本に置く |
137
+ | 応答欠落・保存中断 | `REL-03`・`REL-04`。取引識別、重複排除、照会、途中記録の扱いが未確定 | ARC | `kinuya:pjr-a003-sales-recovery` へ引き継ぐ。契約整備後、受入開始前に DEV と照合・回復方式を定め、QE が受付済み・未受付・不明の期待結果を検証設計へ反映する。PO の判断までは結果不明の取引を自動再送せず、当該経路の受入を保留する |
138
+ | 運用と接続条件 | 商品情報の更新、バックアップ、HTTP の保護、機器接続、通信不能時の店頭対応 | OPS | `kinuya:pjr-a004-sales-operations` へ引き継ぐ。店舗試行前に ARC / DEV と `kinuya-infra-design`・`kinuya-sales-operations` を整え、復元・接続不能・二重印字の確認結果を示す。BA が店番担当の引き継ぎを確認し、PO が営業への影響を許容するまで実運用を開始しない |
139
+
140
+ 表の文書名と課題 ID は未同梱の架空の引き継ぎ先である。PM は各作業を上表の判断時点までに計画し、PO の採用・保留・差し戻しを `kinuya:pjr-a005-sales-approval` に集約する。本例では未決事項が残り、構成案として `draft` を維持する。
141
+
142
+ 承認前に ARC は上位境界と詳細契約の照合結果、QE は文書検査・描画確認と結合対象の判定、BA は両利用者の正常販売・保留時の引き継ぎの確認結果、OPS は配備・復旧条件をそろえる。PO が残る仮定の影響と後続作業の制限を含めて承認を記録した後、人間が `ready` への昇格を判断する。OPS は承認対象と公開対象の一致を確認する。文書の承認と店舗での実運用開始はそれぞれ判断する。
143
+
144
+ 構成・接続の変更時の窓口は ARC とする。ARC が上位図、`cpd-kinuya-sales-service`、`kinuya-infra-design` と本図を照合し、DEV が関係表の詳細契約、QE が該当する検証対象を追従させる。PM は課題と承認記録を更新し、QE は変更した Mermaid を正本として「検証・承認前の確認」の検査・SVG 再生成を行う。PO の再判断後、OPS が承認済みの版を公開する。