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
@@ -13,93 +13,114 @@ specdojo:
13
13
 
14
14
  # 代替案比較: 駄菓子屋きぬや 販売管理システム
15
15
 
16
- 本書は、販売・在庫・つけの記録を店主代表以外の店番でも継続できるようにするため、業務・システムの解決案を比較し、採択理由を残す最小の完成例である。
16
+ 販売・在庫・つけの記録を店主代表以外の店番でも継続できるよう、解決方式を比較し、試行対象と見直し条件を決める。
17
17
 
18
18
  ## 1. 比較目的と前提条件
19
19
 
20
- | 決定ID | 比較レイヤー | 決定すること | 決定しないこと |
21
- | ------ | ---------------------- | ------------------------------------- | ---------------------------------- |
22
- | D-01 | 業務・システム解決方式 | P-01〜P-03 をどの解決方式で改善するか | 個別製品、開発手法、作業管理ツール |
20
+ | 決定ID | 比較レイヤー | 決定すること | 決定しないこと |
21
+ | ------ | ---------------------- | ----------------------------------- | ---------------------------------- |
22
+ | D-01 | 業務・システム解決方式 | P-01〜P-03 を改善する方式と試行対象 | 個別製品、開発手法、作業管理ツール |
23
23
 
24
- 根拠資料は、販売・在庫・つけ管理を初期対象とする `specdojo:prj-scope-sample`、記録不統一、つけ残高確認、在庫過不足を課題とする `specdojo:prj-issues-and-approach-sample`、単一店舗、タブレット 1 台、有償サービス導入前の費用確認を条件とする `specdojo:prj-assumptions-constraints-dependencies-sample` である。
24
+ 根拠資料:
25
25
 
26
- 前提条件:
26
+ - [[specdojo:prj-scope-sample|プロジェクトスコープ]]: 初期対象は販売・在庫・つけと簡易一覧。EC・会計・仕入れ先連携・複数店舗は対象外。
27
+ - [[specdojo:prj-issues-and-approach-sample|プロジェクト課題と解決アプローチ]]: P-01 記録不統一、P-02 残高確認の負荷、P-03 在庫過不足。
28
+ - [[specdojo:prj-assumptions-constraints-dependencies-sample|前提・制約・依存関係]]: タブレット1台、現行手順に近い操作、費用承認、通信断時の方針決定。
27
29
 
28
- - 店主代表と家族利用者代表が、現行手順から大きく外れず利用できること。
29
- - 2 週間以内に店頭で試行でき、営業日の 90% 以上で記録を継続できること。
30
- - EC、本格会計、仕入れ先連携、複数店舗管理は扱わないこと。
31
- - 通信断時の運用を残し、つけ残高など既存ノートの情報を移行できること。
30
+ _ASSUMPTION_: 期間評価の目安は準備着手の承認から2週間とする(初期リリース日ではない)。支出・作業時間の上限と具体日は [[specdojo:pm-plan-sample|プロジェクト管理計画]] の U-01〜U-03 で決まるまで、未承認の支出・作業を始めない。
32
31
 
33
- 候補は製品名から先に選ばず、課題解決への道筋が異なる次のカテゴリから構成した。
32
+ | 候補カテゴリ | 候補に含める基準 |
33
+ | ------------------ | ---------------------------------------------------------------- |
34
+ | 非システム対応 | 紙の記録と手順だけで P-01〜P-03 を改善できる |
35
+ | 汎用デジタルツール | 専用システムを構築せず、タブレットで記録・検索・集計できる |
36
+ | 既存製品・サービス | 販売・在庫を既存機能で扱い、つけ管理を含む一式の運用を構成できる |
37
+ | 個別構築 | 店舗固有の手順と初期対象に合わせた最小機能を構築できる |
34
38
 
35
- | 候補カテゴリ | 候補に含める基準 |
36
- | ------------------ | ---------------------------------------------------------- |
37
- | 非システム対応 | 紙の記録と手順だけで P-01〜P-03 を改善できる |
38
- | 汎用デジタルツール | 専用システムを構築せず、タブレットで記録・検索・集計できる |
39
- | 既存製品・サービス | 販売・在庫・つけ管理の主要部分を既存機能で実現できる |
40
- | 個別構築 | 店舗固有の手順と初期対象に合わせた最小機能を構築できる |
41
-
42
- 本比較は購入 / 構築を含む解決方式を決めるもので、既存製品の個別銘柄は比較しない。既存製品案が残った場合に限り、機能、料金、データ移行、解約時の取り出しを別の製品比較で確認する。
39
+ ALT-02・ALT-03 は [Google スプレッドシート](https://support.google.com/docs/answer/6000292) と [Square](https://squareup.com/help/jp/ja/article/8331-set-up-inventory-tracking) の公式ヘルプ(確認日: 2026-11-13)で編集・書き出しと販売連動の在庫更新を確かめて加えた。市場代表・店舗適合の証明ではない。製品比較は既存サービス案が残った場合に別レイヤーで行う。
43
40
 
44
41
  ## 2. 比較対象案
45
42
 
46
- | 案ID | 案 | カテゴリ | 課題解決への道筋 | 主な構成要素 | 対象範囲 |
47
- | ------ | ------------------------------ | ------------------ | ---------------------------------------------------------------------- | -------------------------------------------------- | ------------------------ |
48
- | ALT-01 | 紙帳票と手順の標準化 | 非システム対応 | 販売・在庫・つけの帳票と確認時刻を統一し、店番交代時のばらつきを減らす | 統一帳票、操作手順、日次確認 | 現行の店頭業務 |
49
- | ALT-02 | 共有表計算による簡易管理 | 汎用デジタルツール | タブレットの共有表へ記録し、検索と集計を数式で補う | 販売・在庫・つけ台帳、入力規則、集計表 | 初期対象の記録と一覧 |
50
- | ALT-03 | 既存 POS・在庫管理サービス | 既存製品・サービス | 既存サービスの販売・在庫機能を利用し、不足するつけ管理を補完する | POS、在庫、顧客・つけの補助手段 | 初期対象の全部または一部 |
51
- | ALT-04 | 最小販売管理システムの個別構築 | 個別構築 | 店舗の記録項目と操作に合わせたタブレット用最小機能を構築する | 販売登録、在庫、つけ残高、簡易一覧、紙への切り戻し | 初期対象の全機能 |
43
+ ### 2.1. D-01: 業務・システム解決方式
44
+
45
+ 全案が初期対象の記録と一覧を扱い、日次確認・引き継ぎ(前段の A-03)を含む。ALT-01・ALT-04 は前段の A-02・A-01 に当たる。
46
+
47
+ | 案ID | 案 | カテゴリ | 課題解決への道筋 | 主な構成要素 |
48
+ | ------ | -------------------------------- | ------------------ | ---------------------------------------------------- | ------------------------------------ |
49
+ | ALT-01 | 紙帳票と手順の標準化 | 非システム対応 | 帳票と日次確認を統一し、店番交代時のばらつきを減らす | 統一帳票、操作メモ、手計算による確認 |
50
+ | ALT-02 | 共有表計算による簡易管理 | 汎用デジタルツール | 共有表への記録と数式集計で残高・在庫を確認する | 販売・在庫・つけ台帳、入力規則 |
51
+ | ALT-03 | 既存 POS・在庫管理サービスの利用 | 既存製品・サービス | 既存の販売・在庫機能とつけの補助手段で一式を構成する | POS、在庫、つけ補助台帳、照合 |
52
+ | ALT-04 | 最小販売管理システムの個別構築 | 個別構築 | 店舗の記録項目と操作に合わせて一元化する | 販売登録、在庫、つけ残高、簡易一覧 |
52
53
 
53
54
  ## 3. 評価軸と評価基準
54
55
 
55
- | 評価軸 | 重み | 判定基準 | 根拠となる課題・制約 |
56
- | ---------- | ---- | ------------------------------------------------ | -------------------------------- |
57
- | 効果 | 5 | P-01〜P-03 を横断して改善できるか | 記録不統一、残高確認、在庫過不足 |
58
- | コスト | 3 | 初期費用と継続費用を小規模店舗で負担できるか | 有償サービス導入前の費用確認 |
59
- | 期間 | 4 | 2 週間以内に店頭試行を開始できるか | 初期対象期間 |
60
- | 業務適合 | 5 | 販売・在庫・つけ管理と現行手順に合うか | 対象業務、利用者負荷 |
61
- | 操作性 | 5 | 店主代表と家族利用者代表が同じ手順で記録できるか | P-01、タブレット 1 台 |
62
- | データ移行 | 4 | 既存ノートのつけ残高を検証しながら移行できるか | P-02、移行漏れリスク |
63
- | 継続運用 | 4 | 通信断や障害時にも記録を失わず営業を続けられるか | 通信環境の前提 |
64
- | 保守性 | 3 | 項目変更、データ出力、障害対応を継続できるか | 小規模な運用体制 |
56
+ `High` / `Middle` / `Low` は採択に有利な順。材料がなければ「未判定」とし、中間評価で代用しない。
65
57
 
66
- 評価は `High` / `Middle` / `Low` とし、採択に有利なほど高くする。重みは優先順位を示すが、機械的な合計だけで決定しない。
58
+ | 評価軸 | 判定基準(High / Middle / Low) | 根拠となる課題・制約 |
59
+ | ------------------ | ------------------------------------------------------------------------------------------------------------ | ----------------------------- |
60
+ | 効果 | 記録統一・残高検索・在庫低下把握の3能力を同じ記録から提供 / 2能力 / 1能力以下 | P-01〜P-03 |
61
+ | コスト | 現金支出・作業時間がともに承認上限の80%以内 / ともに上限内だが一方が80%超 / 一方でも上限超。上限未決は未判定 | ACD-C02、U-01・U-02 |
62
+ | 期間 | 試行候補の準備が7日以内 / 8〜14日 / 14日超。上限承認後に見積もる | 2週間の目安、U-03 |
63
+ | リスク | 誤記録・停止・移行漏れの全経路で照合・回復を検証済み / 対策と確認条件があるが未検証 / 対策のない経路がある | P-01・P-02、ACD-A02・D03 |
64
+ | 業務適合 | 両利用者が必須タスクを支援なしで完了 / 支援付きで完了 / 一つでも完了不能(操作性を含む) | P-01、現行手順とタブレット1台 |
65
+ | 技術実現性 | 端末・移行・外部依存の成立を確認済み / 実現経路はあるが検証待ち / 成立しない依存がある | ACD-D01〜D04 |
66
+ | データ移行・可逆性 | 元ノートとの全件照合と取り出し・紙への復元を検証済み / 方法を定義し検証待ち / 残高・履歴を復元する方法がない | P-02、既存ノート |
67
+ | 運用・保守性 | 引き継ぎ・項目変更・回復を後任が単独で完了 / 手順はあるが支援を要する / 担当・手順を用意できない | P-01、小規模体制 |
68
+
69
+ 重み付け・加重合計は用いない。効果・業務適合が `Low` の案は主方式から外し、残りを効果、業務適合、リスクの順で比べて試行対象を選ぶ。正式採用は全軸が `Middle` 以上、未判定なし、受入・試用条件の合格を要する。総合評価はこのゲートの充足状況で示す。
67
70
 
68
71
  ## 4. 比較結果と採択理由
69
72
 
70
- | 案ID | 効果 | コスト | 期間 | 業務適合 | 操作性 | データ移行 | 継続運用 | 保守性 | 総合評価 | 判定 |
71
- | ------ | ------ | ------ | ------ | -------- | ------ | ---------- | -------- | ------ | -------- | -------- |
72
- | ALT-01 | Low | High | High | Middle | High | Low | High | Middle | Middle | 一部採択 |
73
- | ALT-02 | Middle | High | High | Middle | Low | Middle | Middle | Low | Middle | 非採択 |
74
- | ALT-03 | Middle | Low | High | Low | Middle | Low | Low | High | Low | 非採択 |
75
- | ALT-04 | High | Middle | Middle | High | High | Middle | Middle | Middle | High | 採択 |
73
+ ### 4.1. D-01: 業務・システム解決方式
74
+
75
+ 結果は学習用の架空記録。業務適合は両利用者の販売・在庫・残高確認の計6タスクで判定した。
76
76
 
77
- ALT-04 を採択し、ALT-01 の紙帳票を通信断・障害時の切り戻し手段として取り込む。販売・在庫・つけを一つの手順に合わせ、利用者負荷を抑えながら P-01〜P-03 を横断できるためである。個別構築の期間と保守負荷を抑えるため、初期機能をスコープ記載の対象へ限定する。
77
+ | 案ID | 効果 | コスト | 期間 | リスク | 業務適合 | 技術実現性 | データ移行・可逆性 | 運用・保守性 | 総合評価 | 判定 |
78
+ | ------ | ------ | ------ | ------ | ------ | -------- | ---------- | ------------------ | ------------ | ------------------ | -------- |
79
+ | ALT-01 | Low | 未判定 | 未判定 | Middle | High | Middle | Middle | Middle | 主方式の条件未達 | 一部採択 |
80
+ | ALT-02 | Middle | 未判定 | 未判定 | Middle | Low | Middle | Middle | 未判定 | 主方式の条件未達 | 非採択 |
81
+ | ALT-03 | 未判定 | 未判定 | 未判定 | Low | 未判定 | Middle | 未判定 | 未判定 | 材料不足 | 保留 |
82
+ | ALT-04 | High | 未判定 | 未判定 | Middle | High | Middle | Middle | Middle | 正式採用ゲート待ち | 比較試行 |
78
83
 
79
- ALT-02 はセル操作と数式保守が店主代表の負担になり、誤入力時の検証も難しいため採択しない。ALT-03 はつけ管理への適合、費用、通信断、データ取り出しを製品単位で確認できておらず、現時点では採択しない。費用上限が確定し、初期対象を一つの既存製品で満たせる候補が見つかった場合は、ALT-03 の製品比較を行う。
84
+ | 案ID | 評価根拠と採否理由 | 再評価に必要な材料 |
85
+ | ------ | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
86
+ | ALT-01 | 記録統一だけを提供し、検索・在庫低下把握は手集計。6/6を自力完了 | 検索・集計を改善し効果を2能力以上にできた場合 |
87
+ | ALT-02 | 2能力を提供。1タスクを完了できず業務適合 `Low`。後任は数式修正を単独で完了できなかったが、手順と支援の有効性が未確認で保守性は未判定 | 入力・保守手順と支援担当を用意し、両利用者と後任が完了できた場合 |
88
+ | ALT-03 | つけ補助台帳との不一致に対策がない。効果・適合、料金は未確認 | 費用上限確定後、つけ・照合・取り出しを含む具体候補を確認した場合 |
89
+ | ALT-04 | 設計上3能力を提供し、操作模型で6/6を自力完了。保守は開発担当の支援を要する | 上限・日程承認後の実機・受入・試用の結果 |
80
90
 
81
- ### 4.1. 技術的実現性と影響
91
+ ### 4.2. 技術的実現性と影響
82
92
 
83
- | 案ID | 技術的実現性 | 主な影響 |
84
- | ------ | ------------------------------------------ | -------------------------------------------------------- |
85
- | ALT-01 | 現行帳票を統一して直ちに開始できる | 検索・集計・残高検証は手作業のまま残る |
86
- | ALT-02 | 既存の表計算機能で試行できる | 入力規則、数式、アクセス権の保守が必要になる |
87
- | ALT-03 | 候補製品の試用と適合確認が必要になる | 月額費用、通信依存、データ移行・解約手順が生じる |
88
- | ALT-04 | タブレット向け最小機能を段階的に構築できる | 受入確認、データ移行、障害時の紙運用を整備する必要がある |
93
+ | 案ID | 技術的実現性・外部依存 | 正本・移行・停止時の扱い |
94
+ | ------ | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
95
+ | ALT-01 | 現行の紙を使える | 統一帳票を正本とし、既存残高を照合して転記する(未検証) |
96
+ | ALT-02 | 端末 OS、共有権限、利用条件は実機確認待ち | 共有表を正本とする。停止時は全記録を書き出して紙へ復元する(未検証) |
97
+ | ALT-03 | つけ補完、端末・接続、契約は未確認 | 正本境界・照合を製品比較で定めるまで採用しない。商品情報の出力だけで撤退可能とみなさない |
98
+ | ALT-04 | ACD-D01〜D04 の確認が残る | システム記録を正本とし、ノート残高を全件照合して移行する。停止時は出力して紙へ復元する(未検証)。構造・実装は後続設計へ |
99
+
100
+ ### 4.3. 比較試行の完了条件
101
+
102
+ - 入力と範囲: ALT-04 と ALT-01 に同じ架空の販売10件、入荷・在庫確認、つけ残高5件を用いる。
103
+ - 完了条件: 全件一致・欠落重複0件・両利用者の必須タスク完了で机上評価を更新する。期間・上限内に未達を解消できなければ中止または範囲縮小を判断する。通信断・紙への切り戻しは ACD-D03 の方針が決まるまで実運用しない。
104
+ - 正式採用と記録先: [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]] の初期受入と2週間の試用継続条件を満たすこと。案 ID・条件 ID・対象版・結果を試行記録 `kinuya-trial-log`(未同梱の架空記録)に残す。
89
105
 
90
106
  ## 5. リスクとトレードオフ
91
107
 
92
- | 区分 | 内容 | 軽減策 |
93
- | ------------ | ---------------------------------------------------------- | ----------------------------------------------------------- |
94
- | トレードオフ | 個別構築を選ぶため、既存サービスより設計・保守作業が増える | 初期対象を販売・在庫・つけと簡易一覧に限定する |
95
- | トレードオフ | 初期は高度な分析と外部連携を扱わない | 記録継続を確認した後の候補として残す |
96
- | リスク | タブレット操作または障害によって営業中の記録が止まる | 統一した紙帳票へ切り戻し、復旧後に二重確認して転記する |
97
- | リスク | 既存ノートからつけ残高を誤って移行する | 店主代表が顧客ごとの残高を照合し、`PO` が移行完了を承認する |
108
+ | 区分・対象 | 内容 | 軽減策・担当・完了条件 |
109
+ | -------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
110
+ | トレードオフ・ALT-01 | 検索・集計の手作業を受容する | `BA` が確認時間を試行記録へ残す |
111
+ | リスク・ALT-02 | 誤入力・数式破損で残高を誤る | `DEV` が入力制限と復元手順を用意し、`QE` が復元後の一致を確かめるまで再検討しない |
112
+ | リスク・ALT-03 | つけ補助台帳との不一致、取り出し不能 | `DEV` が全記録出力を確認し、`QE` が差分0件と紙への復元を確かめるまで製品選定を保留する |
113
+ | トレードオフ・ALT-04 | 設計・保守負荷を受容し、高度分析・外部連携を延期 | `PM` が作業と保守を見積もり、上限内・担当合意済みを準備着手の条件とする |
114
+ | リスク・全案 | 記録停止・移行漏れでつけ残高を失う | `DEV` が照合手順と ALT-01 の帳票控えの別保管を用意し、`QE` が復元後の元ノート全件で残高差分0件を確かめる |
98
115
 
99
116
  ## 6. 決定と見直し
100
117
 
101
- - ALT-04 の最小販売管理システムを採択し、ALT-01 の紙帳票を切り戻し手段として一部採択する。
102
- - 最終判断は `PO` が行い、`BA` は業務適合、`ARC` は実現性、`DEV` は試行、`QE` は移行と継続運用の検証を支援する。
103
- - 2 週間の試行で営業日の 90% 以上に記録できない場合は、操作手順、初期機能、紙運用の比重を再評価する。
104
- - 費用上限内で初期対象を満たす既存製品が確認できた場合は、料金、つけ管理、通信断、データ移行・解約条件を同じ軸で比較する。
105
- - 方針変更は、理由、影響範囲、移行・撤退方法とともに変更記録へ残す。
118
+ D-01 は ALT-04 を優先試行対象とし、ALT-01 の統一帳票を切り戻し候補として一部採択する(理由は「比較結果と採択理由」)。方式の選択と実運用の承認は分け、最終判断は `PO` が行う。
119
+
120
+ | 見直し契機 | 再評価 |
121
+ | --------------------------------------------- | -------------------------------------------------------- |
122
+ | 試行・受入の不合格、2週間の試用継続条件の未達 | 縮小・延期・停止を判断する |
123
+ | 移行漏れ、端末・通信障害、保守担当不在の兆候 | 対象案のリスク評価と軽減策を見直す |
124
+ | 承認上限、範囲、利用者・端末、外部依存の変更 | 該当カテゴリの全案を再比較する。特定製品を自動採用しない |
125
+
126
+ 判断理由・影響範囲・移行と撤退の方法は決定記録に残す。
@@ -14,49 +14,46 @@ specdojo:
14
14
 
15
15
  ## 1. 判定対象と適用範囲
16
16
 
17
- 本書は、店頭販売、在庫、つけ管理の最小運用について、初期リリースの受入、運用開始後の短期的な定着、中長期の店舗運営への効果を判定する完成例である。EC、複数店舗管理、本格会計連携は対象外とする。
17
+ 店頭販売、在庫、つけ管理の最小運用を対象とし、EC、複数店舗管理、本格会計連携、費用低減は対象外とする。初期リリースの受入は SC-01 と AC-01〜AC-04 のすべてを必須とし、SC-02〜SC-06 は合否に含めない。確認者の「両代表」は店主代表と家族利用者代表を指す。
18
18
 
19
- 初期リリースの受入可否は SC-01 と AC-01〜AC-04 のすべてを必須条件として判断する。SC-02〜SC-06 はリリース後に評価し、初期受入の合否には含めない。
20
-
21
- 本例では、費用低減を業務価値や成功条件に含めない。SC-03 の操作負担は人の追加作業時間として判定し、導入費用や現金支出とは混同しない。
22
-
23
- | 業務価値 ID | 業務価値 | 主な判定段階 |
24
- | ----------- | -------------------------------------------------------------------------------------- | ------------------ |
25
- | BV-01 | 店主代表と家族利用者代表が、迷わず同じ手順で販売・在庫・つけ残高を記録・確認できる | 初期リリース |
26
- | BV-02 | 店主代表と家族利用者代表が、日々の記録を負担なく継続できる | 運用開始後の短期 |
27
- | BV-03 | 販売・在庫・つけの記録を仕入れ判断と引き継ぎに活用し、店主不在時も店舗運営を継続できる | 運用開始後の中長期 |
19
+ | 業務価値 ID | 業務価値 | 主な判定段階 |
20
+ | ----------- | -------------------------------------------------------- | ------------ |
21
+ | BV-01 | 店主と家族が同じ手順で販売・在庫・つけを記録・確認できる | 初期リリース |
22
+ | BV-02 | 日々の記録を負担なく継続できる | 短期 |
23
+ | BV-03 | 記録を仕入れと引き継ぎに使い、店主不在でも運営できる | 中長期 |
28
24
 
29
25
  ## 2. 成功基準
30
26
 
31
- | ID | 対応する業務価値 | 条件 | 判定基準 | 測定方法 | 判定時期 | 確認者 |
32
- | ----- | ---------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------ | ------------------------ |
33
- | SC-01 | BV-01 | 主要操作を迷わず完了できる | 店主代表と家族利用者代表が、販売記録、在庫確認、つけ残高確認の必須タスクをすべて完了し、重大な行き詰まりがない | 操作説明なしで代表シナリオを実施し、完了、所要時間、質問、支援、誤操作を記録する | 初期リリース受入時 | 店主代表、家族利用者代表 |
34
- | SC-02 | BV-02 | 日々の記録を継続できる | 初期運用の営業日の90%以上で、販売・在庫・つけの記録が残っている | 営業日ごとに3種の記録有無を確認し、営業日数を母数として集計する | 運用開始後2週間 | 店主代表 |
35
- | SC-03 | BV-02 | 記録・確認の負担を許容範囲に保てる | 1営業日の販売・在庫・つけの記録・確認にかかる追加操作時間が合計10分以内である | 初期運用期間に記録・確認の所要時間を営業日ごとに測定する | 運用開始後2週間 | 店主代表 |
36
- | SC-04 | BV-03 | 人気商品の欠品を減らせる | 対象商品の月間欠品回数が、運用開始前1か月のベースラインから50%以上減少する | 対象商品を固定し、運用前後の欠品発生を日次記録から月単位で比較する | 運用開始後6か月 | 店主代表 |
37
- | SC-05 | BV-03 | 在庫の無駄を減らせる | 廃棄・値引き・長期滞留による在庫の無駄が、運用開始前の年間換算値から20%以上減少する | 数量と金額を月次集計し、12か月実績を同じ定義のベースラインと比較する | 運用開始後12か月 | 店主代表 |
38
- | SC-06 | BV-03 | 店主不在時も店舗運営を継続できる | 店主不在の店番日の90%以上で、家族利用者代表が販売・在庫・つけの必須記録と引き継ぎを完了できる | 店主不在の店番日を母数として、必須記録と引き継ぎ結果を確認する | 運用開始後6か月 | 店主代表、家族利用者代表 |
27
+ | ID | 対応する業務価値 | 条件 | 判定基準 | 測定方法 | 判定時期 | 確認者 |
28
+ | ----- | ---------------- | -------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------- | ------------------ | -------- |
29
+ | SC-01 | BV-01 | 主要操作を迷わず完了できる | 販売記録・在庫確認・つけ残高確認を両代表が完了する | 説明なしで代表シナリオを行い、所要時間・質問・支援・誤操作を記録 | 初期リリース受入時 | 両代表 |
30
+ | SC-02 | BV-02 | 記録を継続できる | 営業日の90%以上で販売・在庫・つけの記録が残る | 3種の記録有無を営業日ごとに集計 | 運用開始後2週間 | 店主代表 |
31
+ | SC-03 | BV-02 | 負担が小さい | 1営業日の追加操作時間が合計10分以内 | 記録・確認の所要時間を営業日ごとに測定 | 運用開始後2週間 | 店主代表 |
32
+ | SC-04 | BV-03 | 人気商品の欠品を減らせる | 対象商品の月間欠品回数が運用前1か月比で50%以上減る | 日次記録の欠品を月単位で比較 | 運用開始後6か月 | 店主代表 |
33
+ | SC-05 | BV-03 | 在庫の無駄を減らせる | 廃棄・値引き・長期滞留が年間換算で運用前から20%以上減る | 数量と金額の12か月実績を同じ定義のベースラインと比較 | 運用開始後12か月 | 店主代表 |
34
+ | SC-06 | BV-03 | 店主不在でも運営できる | 不在の店番日の90%以上で必須記録と引き継ぎを完了 | 不在日ごとに記録と引き継ぎを確認 | 運用開始後6か月 | 両代表 |
39
35
 
40
36
  ## 3. 受入条件
41
37
 
42
- | ID | 対応する業務価値 | 種別 | 条件 | 合格基準 | 証跡 | 確認者 | 承認者 |
43
- | ----- | ---------------- | ---------- | -------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------ | -------- |
44
- | AC-01 | BV-01 | 利用者視点 | 販売を記録できる | 商品、数量、支払方法を入力して販売を確定すると、販売記録が1件作成される | 販売記録、確認日、確認者、操作結果 | 店主代表、家族利用者代表 | 店主代表 |
45
- | AC-02 | BV-01 | 利用者視点 | 在庫とつけ残高を確認できる | 商品を指定して在庫数を確認でき、常連顧客を指定してつけ残高を確認できる | 在庫一覧、つけ残高確認結果 | 店主代表、家族利用者代表 | 店主代表 |
46
- | AC-03 | BV-01 | 利用者視点 | 主要操作で重大な行き詰まりがない | SC-01 の代表シナリオで、利用者が自力で回復できず必須タスクを継続できない事象が0件である | タスク一覧、所要時間、質問、支援、誤操作 | 店主代表、家族利用者代表 | 店主代表 |
47
- | AC-04 | BV-01〜BV-03 | 技術的受入 | 受入対象と確認結果を追跡できる | スコープ、成功基準、受入条件、操作メモが矛盾せず、各確認結果に条件 ID、確認日、確認者を記録できる | 文書照合記録、受入確認記録 | 開発担当 | 店主代表 |
38
+ | ID | 対応する業務価値 | 種別 | 条件 | 合格基準 | 証跡 | 確認者 | 承認者 |
39
+ | ----- | ---------------- | ---------- | -------------------------------- | --------------------------------------------------------------------------- | -------------------------- | -------- | -------- |
40
+ | AC-01 | BV-01 | 利用者視点 | 販売を記録できる | 商品・数量・支払方法を確定すると販売記録が1件できる | 販売記録、操作結果 | 両代表 | 店主代表 |
41
+ | AC-02 | BV-01 | 利用者視点 | 在庫とつけ残高を確認できる | 商品の在庫数と常連顧客のつけ残高を表示できる | 在庫一覧、つけ残高画面 | 両代表 | 店主代表 |
42
+ | AC-03 | BV-01 | 利用者視点 | 主要操作で重大な行き詰まりがない | SC-01 の代表シナリオで自力で回復できない事象が0件 | SC-01 の測定記録 | 両代表 | 店主代表 |
43
+ | AC-04 | BV-01〜BV-03 | 技術的受入 | 確認結果を追跡できる | スコープ・本書・操作メモが矛盾せず、結果ごとに条件 ID・確認日・確認者が残る | 文書照合記録、受入確認記録 | 開発担当 | 店主代表 |
48
44
 
49
45
  ## 4. 判定手順と証跡
50
46
 
51
- 1. 店主代表と家族利用者代表が SC-01 と AC-01〜AC-03 の代表シナリオを実施し、条件 ID、確認日、操作結果、必要な支援を記録する。
52
- 2. 開発担当が AC-04 の文書整合と証跡を確認する。
53
- 3. 未達の条件がある場合は、利用者への影響、是正内容、担当、再確認する条件 ID、再確認日を受入確認記録へ追記する。
54
- 4. 店主代表が SC-01 と AC-01〜AC-04 の結果を確認し、初期リリースの受入可否を判断する。
55
- 5. 運用開始後は、店主代表が SC-02〜SC-06 を所定の時期に判定し、未達の場合は運用または改善方針を見直す。
47
+ 確認者・承認者は各表に従い、結果は受入確認記録へ残す。
48
+
49
+ 1. 初期リリース受入時に SC-01・AC-01〜AC-03 の代表シナリオと AC-04 の文書照合を行う。
50
+ 2. 未達なら影響、是正内容、再確認の条件 ID と日を追記して再確認する。
51
+ 3. 承認者が必須条件の結果を照合し、受入可否を判断する。
52
+ 4. 運用開始後は SC-02〜SC-06 を判定時期に判定し、未達なら運用か改善方針を見直す。
56
53
 
57
54
  ## 5. 例外条件と未解決事項
58
55
 
59
- | 論点 | 扱い | 解決期限 / 判断タイミング | 責任者 |
60
- | ---------------------- | ----------------------------------------------------------------------- | ------------------------- | ------------------ |
61
- | 人気商品の対象範囲 | _UNDECIDED_: 欠品回数を測定する対象商品と除外条件を固定する | ベースライン測定開始前 | 店主代表 |
62
- | オフライン時の記録方法 | _UNDECIDED_: 初期受入の対象外とし、運用方針を決定後に受入条件を追加する | 初期運用開始前 | 店主代表、開発担当 |
56
+ | 論点 | 判定への影響 | 当面の扱い |
57
+ | ---------------------- | ------------------------------ | ----------------------------------------------------------------- |
58
+ | 人気商品の対象範囲 | SC-04 の測定。初期受入は進める | _UNDECIDED_: ベースライン測定開始前に対象商品と除外条件を固定する |
59
+ | オフライン時の記録方法 | 初期受入の対象外 | _UNDECIDED_: 初期運用開始前に運用方針を決め、受入条件を追加する |
@@ -6,33 +6,60 @@ specdojo:
6
6
  rulebook: specdojo:sf-index-rulebook
7
7
  ---
8
8
 
9
- # [システム化機能一覧 / 全体構成](../rulebooks/sf-rulebook.md) サンプル
9
+ # 駄菓子屋きぬや システム化機能一覧(全体構成)
10
10
 
11
- ## 1. 目的と適用範囲
11
+ 本書は、駄菓子屋きぬや販売管理システムが店頭のタブレットで実現する機能の全体構成と一覧を定義する。各機能を業務プロセス領域と画面へ対応付け、機能分割・テスト対象の洗い出しと、個別機能仕様への入口として使う。
12
12
 
13
- 本書は、システムで実現する機能の全体構成と一覧を定義するための最小サンプルである。
13
+ ## 1. 目的と対象範囲
14
14
 
15
- ## 2. 入力情報
15
+ 店番が交代しても同じ手順で記録を続けるため([[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針)、販売・在庫・つけ・締めでシステムが担う記録と確認の範囲を確定する。店主代表はスコープと人間に残す判断、DEV は機能分割と実装範囲、QE はテスト対象の洗い出しに使い、業務からの漏れと機能の重なりを一覧で判断する。
16
16
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/sf-index-rulebook.md`
17
+ | 区分 | 範囲 |
18
+ | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
19
+ | 対象 | 単一店舗の店頭タブレットで行う販売・つけ・在庫・締めの記録と確認。業務プロセス領域 `P-02`〜`P-10` のうち、システムが記録・算出・提示する部分 |
20
+ | 対象外 | 仕入先への発注(`P-01`)、補充・つけ上限・売価の最終判断、キャッシュレス決済、本格会計、EC、複数店舗、個別機能の入出力・振る舞いの詳細 |
20
21
 
21
- ## 3. 記述内容
22
+ 一覧に載せた全機能を初期リリースに含むとはみなさない(導入順序は「未決事項」の `Q-03`)。本一覧でオフライン販売を保証しない。
22
23
 
23
- - 主な内容: 機能ID、機能名、概要、関連プロセス、関連仕様ID など
24
- - 必須観点: 対象、条件、判定基準、責任者
24
+ ## 2. 機能構成
25
25
 
26
- ## 4. 最小記述例
26
+ 業務プロセス領域の区分は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] に従う。入荷の記録(`P-02`)は在庫数量を更新する処理のため、仕入ではなく在庫の領域に含める。
27
27
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ------------------------------------------------------------ | ------------------------------------ |
30
- | ドキュメント | [システム化機能一覧 / 全体構成](../rulebooks/sf-rulebook.md) | 最小サンプル |
31
- | 目的 | システムで実現する機能の全体構成と一覧を定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 機能ID、機能名、概要、関連プロセス、関連仕様ID など | 要点のみ記載 |
28
+ | 機能領域 | 略号 | 業務プロセス領域 | システムの責務 | 人間に残す判断 |
29
+ | -------- | ----- | ---------------------- | -------------------------------------------------------------------- | ------------------------------------ |
30
+ | 販売 | `POS` | `P-03` | 現金販売の明細・請求額・釣銭を提示し、販売を記録して在庫へ渡す | 取引の中止 |
31
+ | つけ | `CRD` | `P-04`・`P-07`・`P-08` | 常連客とつけ上限を登録し、つけ販売と精算を記録して残高を提示する | つけ上限の設定、上限超過時の販売可否 |
32
+ | 在庫 | `INV` | `P-02`・`P-05`・`P-06` | 入荷と販売を在庫へ反映し、補充基準を下回った商品と依頼数量を提示する | 補充依頼の承認 |
33
+ | 締め | `CLS` | `P-09`・`P-10` | 当日の販売・入荷・在庫・つけを突き合わせ、差異と月次の集計を提示する | 締めの確定、売価・補充基準の見直し |
33
34
 
34
- ## 5. 未解決事項
35
+ 仕入計画(`P-01`)はシステム化しない。仕入先とのシステム連携を初期リリースの対象外としたため、店主代表が補充依頼を基に発注する。
35
36
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
37
+ ## 3. システム化機能一覧
38
+
39
+ | 機能 ID | 機能名 | 概要 | 業務プロセス仕様 | 画面 | 個別仕様 |
40
+ | ----------- | ------------ | -------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------- | ---------------------------------------- |
41
+ | `SF-POS-01` | 店頭商品販売 | 商品と数量から請求額・釣銭を提示し、現金の受領確認を受けて販売を記録する | `P-03` / `bps-sales-order-flow` | [[specdojo:uis-sample\|販売登録画面]] | [[specdojo:sf-sample\|商品販売機能仕様]] |
42
+ | `SF-CRD-01` | つけ販売 | つけ上限と残高を確認して、つけでの販売を記録し、更新後の残高を提示する | `P-04` / `bps-credit-sale` | `uis-credit-sale` | 一覧行で要約 |
43
+ | `SF-CRD-02` | 常連客登録 | 常連客の識別情報とつけ上限を登録・変更し、つけ販売の可否判定に使えるようにする | `P-07` / `bps-customer-registration` | `uis-customer` | 一覧行で要約 |
44
+ | `SF-CRD-03` | つけ精算 | 支払額を受け付けてつけ残高を減らし、精算後の残高を提示する | `P-08` / `bps-credit-settlement` | `uis-credit-sale` | 一覧行で要約 |
45
+ | `SF-INV-01` | 在庫確認 | 販売と入荷を在庫数量へ反映し、商品ごとの現在庫を提示する | `P-05` / `bps-inventory-check` | `uis-inventory` | `sf-inventory`(作成候補、`Q-03`) |
46
+ | `SF-INV-02` | 入荷記録 | 検品済みの商品と数量を入荷として記録し、在庫確認へ渡す | `P-02` / `bps-receiving` | `uis-inventory` | 一覧行で要約 |
47
+ | `SF-INV-03` | 補充依頼支援 | 補充基準を下回った商品と、発注単位に合わせた依頼数量を提示し、承認された依頼を記録する | `P-06` / [[specdojo:bps-sample\|補充依頼確定]] | `uis-inventory` | 一覧行で要約 |
48
+ | `SF-CLS-01` | 日次締め照合 | 当日の販売・入荷・在庫・つけの記録を突き合わせ、差異を提示して締めの確定を記録する | `P-09` / `bps-daily-closing` | `uis-closing` | 一覧行で要約 |
49
+ | `SF-CLS-02` | 月次集計報告 | 月次の売上・欠品回数・つけ残高を集計し、見直しの判断材料として提示する | `P-10` / `bps-monthly-review` | `uis-closing` | 一覧行で要約 |
50
+
51
+ - 画面は機能ごとに行を分ける。`uis-credit-sale` はつけ販売とつけ精算、`uis-inventory` は在庫の 3 機能、`uis-closing` は日次締めと月次集計にまたがる。
52
+ - `SF-POS-01`・`SF-CRD-01` の払出数量と `SF-INV-02` の入荷数量は `SF-INV-01` へ渡し、在庫の算出・反映は在庫確認が担う。在庫未反映・結果不明を販売完了とは通知しない(回復条件は [[specdojo:sf-sample|商品販売機能仕様]] を正とする)。
53
+ - 「人間に残す判断」は機能として数えず、システムは判断材料と結果を記録する。上限超過の扱いは `Q-02`。
54
+ - 個別仕様は店頭商品販売だけが完成例で、在庫確認は作成候補(`Q-03`)、その他は一覧行の要約を正とする。
55
+ - 通常利用の接点は GUI とし、販売管理 CLI は含めない。
56
+
57
+ ## 4. 未決事項
58
+
59
+ リンクのない仕様 ID は本例に未同梱の架空文書である。
60
+
61
+ | ID | 論点 | 影響と当面の扱い |
62
+ | ------ | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
63
+ | `Q-01` | _TODO_: 補充依頼確定以外の BPS と販売登録画面以外の画面仕様が未作成で、全9機能の業務・接点の対応は領域単位の暫定である | 各 BPS・画面の作成時に概要と処理ステップを照合する。照合までは当該機能の責務を確定扱いにせず、設計着手を保留する |
64
+ | `Q-02` | _UNDECIDED_: つけ上限を超える販売を店主代表の承認で許すか、システムで拒否するか | `SF-CRD-01` の責務境界が確定しない。決まるまで上限超過経路の設計・受入を保留する |
65
+ | `Q-03` | _TODO_: 個別仕様の成果物カタログ登録と導入順序が未確認。`sf-inventory` は候補で、補充依頼支援・月次集計の初期導入は未決 | 登録前の個別仕様は作成せず一覧行の要約を正とする。初期と後続の範囲が分かれるまで導入範囲を確定しない |
@@ -2,37 +2,125 @@
2
2
  specdojo:
3
3
  id: specdojo:sf-sample
4
4
  type: requirement
5
- status: draft
5
+ status: ready
6
6
  rulebook: specdojo:sf-rulebook
7
7
  ---
8
8
 
9
- # [システム化機能一覧 / 個別](../rulebooks/sf-rulebook.md) サンプル
9
+ # 駄菓子屋きぬや 商品販売機能仕様
10
10
 
11
- ## 1. 目的と適用範囲
11
+ ## 1. 目的と概要
12
12
 
13
- 本書は、個別のシステム化機能の概要・関連仕様を定義するための最小サンプルである。
13
+ 店主代表と家族利用者代表が、店頭のタブレットから現金販売を記録し、請求額・釣銭と在庫への反映結果を同じ取引で確認できるようにする。ノートへの転記漏れと暗算の誤りを減らし、店番が交代しても記録を続けられるようにする。これは [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針に対応する。
14
14
 
15
- ## 2. 入力情報
15
+ 上位のシステム化機能一覧は `sf-index`(未作成)で、対応エントリは機能 ID `SF-POS-01`「店頭商品販売」とする。一覧への登録時に対応を確定する(「未決事項」の `Q-01`)。
16
16
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/sf-rulebook.md`
17
+ | 区分 | 範囲 |
18
+ | ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
19
+ | 対象 | 単一店舗の現金販売。明細の登録・修正、税額・請求額・釣銭の提示、販売記録の確定、在庫反映結果の確認、レシート発行要求、確定前の中止 |
20
+ | 対象外 | つけ販売(`P-04`)、補充判断(`P-06`)、キャッシュレス決済、確定後の返品・値引訂正、EC・複数店舗 |
20
21
 
21
- ## 3. 記述内容
22
+ 店番中の店主代表・家族利用者代表が利用し、設計と受入試験では本書の要件と受入条件を入力にする。
22
23
 
23
- - 主な内容: 機能概要、関連プロセス、関連画面、関連IF、関連ルール など
24
- - 必須観点: 対象、条件、判定基準、責任者
24
+ ## 2. 業務プロセス・画面との対応
25
25
 
26
- ## 4. 最小記述例
26
+ 業務境界は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の店頭販売 `P-03` と在庫確認 `P-05` に対応する。詳細 BPS `bps-sales-order-flow` は未作成のため、領域単位で対応付ける(`Q-01`)。
27
27
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | --------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | [システム化機能一覧 / 個別](../rulebooks/sf-rulebook.md) | 最小サンプル |
31
- | 目的 | 個別のシステム化機能の概要・関連仕様を定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 機能概要、関連プロセス、関連画面、関連IF、関連ルール など | 要点のみ記載 |
28
+ | 根拠領域 | 本機能の責務 | 対応要件・入出力 |
29
+ | --------------- | -------------------------------------------------------------- | ----------------------------------- |
30
+ | `P-03` 店頭販売 | 購入商品と数量を受け、明細と請求額を提示する | `FR-01`・`FR-02`、購入明細・請求額 |
31
+ | `P-03` 店頭販売 | 現金の受領確認を受け、販売を記録して完了可否を返す | `FR-03`、預かり金・販売記録 |
32
+ | `P-05` 在庫確認 | 払出数量を渡し、反映結果を会計結果へ対応付ける。在庫算出は委譲 | `FR-03`、販売確定情報・在庫反映結果 |
33
+ | `P-03` 店頭販売 | 確定前の取引中止を受け、未確定の明細を破棄する | `FR-04`、取引中止結果 |
33
34
 
34
- ## 5. 未解決事項
35
+ | 接点 | トリガー・受け渡し | 責務境界 |
36
+ | -------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------- |
37
+ | [[specdojo:uis-sample\|販売登録画面]] | 商品追加・数量修正・会計確定・中止を受け、明細・金額・結果を返す | 表示・入力形式・遷移は UIS、会計の確定可否は本機能 |
38
+ | 在庫確認機能 `sf-inventory` | 払出数量を渡し、反映済み・未反映・結果不明の区別を受ける | 在庫更新は連携先。未反映・結果不明を販売完了と通知しない |
39
+ | レシート出力 `ifx-cmd-receipt-printer` | 確定した販売の印字内容を渡し、印刷結果を受ける | 印刷失敗は販売確定と区別する |
35
40
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
41
+ 利用接点は GUI とし、CLI による会計は対象外とする。
42
+
43
+ ## 3. 入出力と前提条件
44
+
45
+ ### 3.1. 入出力
46
+
47
+ | 区分 | 論理情報 | 入手元 / 提供先 | 必須性・確定条件 | 正本仕様 | 対応要件 |
48
+ | ---- | -------------------------------------- | --------------------------------------- | -------------------------------------- | ----------------------------------------------------- | ---------------- |
49
+ | 入力 | 商品識別子、販売数量、明細の修正・削除 | 店番担当 / 明細登録 | 登録・修正時に必須 | 販売登録画面、[[specdojo:bdd-sample\|業務データ辞書]] | `FR-01` |
50
+ | 入力 | 販売単価、税区分、販売可能な在庫数量 | 商品台帳・在庫確認機能 / 会計確認 | 会計前に確認できること | 業務データ辞書、`br-tax-calculation`、`sf-inventory` | `FR-01`・`FR-02` |
51
+ | 入力 | 預かり金額、現金の受領確認 | 店番担当 / 会計確定 | 確定時に必須 | 販売登録画面 | `FR-02`・`FR-03` |
52
+ | 入力 | 在庫反映結果、保存済みの販売と処理結果 | 在庫確認機能・販売記録 / 確定・再開判定 | 確定要求時と結果照合時に必須 | `sf-inventory`、`ifx-api-store-sales` | `FR-03` |
53
+ | 出力 | 購入明細、税額、請求額、釣銭 | 本機能 / 店番担当・来店客 | 明細・預かり金の変更に追従する | 販売登録画面、`br-tax-calculation` | `FR-01`・`FR-02` |
54
+ | 出力 | 売上記録・売上明細、販売確定情報 | 本機能 / 販売記録・在庫確認機能 | 確定要求ごとに一度だけ記録・反映する | 業務データ辞書、`sf-inventory` | `FR-03` |
55
+ | 出力 | 会計結果、停止理由、中止結果、印字内容 | 本機能 / 店番担当・レシート出力 | 完了・保留・中止と印刷成否を識別できる | 販売登録画面、`ifx-cmd-receipt-printer` | `FR-03`・`FR-04` |
56
+
57
+ データ項目・型・コード値は業務データ辞書を正本とし、本書へ転記しない。
58
+
59
+ ### 3.2. 前提条件と事後条件
60
+
61
+ - 着手条件: 店番担当が販売権限で利用でき、商品台帳と店舗内の記録先へ接続できること。進行中の取引があれば継続し、別の取引を重ねない。
62
+ - 事後条件: 正常完了は `FR-03`、中止は `FR-04`、保留・失敗は「例外・回復条件」に従う。印刷成否は会計結果と分けて判定する。
63
+
64
+ ## 4. 処理要件・機能振る舞い
65
+
66
+ ### 4.1. 通常処理
67
+
68
+ | 要件 ID | 開始条件 | 処理の責務・確定する結果 | 判断の正本 |
69
+ | ------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
70
+ | `FR-01` | 商品・数量を受けた | 商品と在庫を照合して明細を更新する。未登録商品・販売不可の数量は理由を返し、既存明細を維持する | 販売登録画面の入力条件 |
71
+ | `FR-02` | 有効な明細がある | 税額・請求額を提示し、預かり金から釣銭を求める。明細が空、または預かり金が不足する間は確定を受け付けない | `br-tax-calculation`、販売登録画面の会計条件 |
72
+ | `FR-03` | 現金の受領を確認し、会計確定を要求した | 販売時の単価・数量を売上記録へ残し、在庫反映結果を照合してから販売完了を返し、レシート発行を要求する。再送には元の結果を返す | 業務データ辞書、`sf-inventory`、`ifx-api-store-sales` |
73
+ | `FR-04` | 確定前に取引中止の確認を受けた | 未確定の明細を破棄する。確定中・結果不明の取引は照合へ引き渡し、取消済みと扱わない | 販売登録画面、`stsd-sales-transaction` |
74
+
75
+ 商品の販売済みへの遷移は [[specdojo:stsd-sample|商品 ステータス定義]] を参照する。販売完了の通知は釣銭・商品の手渡しとは別であり、システムは顧客受領を推測しない。
76
+
77
+ ### 4.2. 例外・回復条件
78
+
79
+ | 条件 | 通知と保持する情報 | 回復・再開条件 |
80
+ | ---------------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
81
+ | 未登録商品、数量不正、在庫不足 | 対象商品と理由を通知する。拒否した変更を明細・記録・在庫に反映しない | 商品または数量を修正し、`FR-01` で再照合する |
82
+ | 明細なし、預かり金不足・入力不正 | 確定不可と理由を返し、有効な明細を維持する | 明細追加または預かり金の補正後に `FR-02` から確認する |
83
+ | 保存・在庫反映の失敗、応答途絶で結果不明 | 完了を通知せず、取引・停止位置・反映状況を保持する。自動で別取引を作らない | OPS が記録と在庫を照合し、確定済みなら結果を再提示、未完了なら未反映部分だけを再開する。照合まで再確定・中止を許可しない |
84
+ | 会計完了後の印刷失敗 | 会計完了と印刷未完了を分けて通知し、販売記録と印字内容を保持する | プリンタ回復後に同じ販売を再印刷する。売上・在庫を再更新しない |
85
+
86
+ ## 5. 非機能・技術制約
87
+
88
+ | 観点 | 制約と適用範囲 | 正本・判定方法 |
89
+ | ------------------ | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
90
+ | 利用構成・外部依存 | 単一店舗・タブレット1台で店舗内の記録先へ接続して使う。未接続時の新規確定は保証しない | [[specdojo:sample-authoring-standard\|共通サンプル文脈]]、`V-05` |
91
+ | 完全性 | 完了を表示した販売は記録と在庫反映を照合できる。再送でも二重売上・二重払出を起こさない | `FR-03`、`V-04`・`V-05` |
92
+ | 性能・使いやすさ | 店番中の登録と会計確認を続けられる。応答時間の受入値は実端末の測定後に決める | `Q-02`、`V-08` |
93
+ | 権限・秘匿 | 販売権限のない主体は確定できない。顧客情報を必須にせず、認証情報を画面・レシート・証跡へ出さない | `opr-pos-operation`、`V-07` |
94
+ | 契約・互換性 | 画面・記録先・在庫連携・印刷先の schema・版・再送契約が一致するまで統合受入を保留する | `Q-01`。物理構造と公開契約は連携仕様・schema を正本とする |
95
+
96
+ ## 6. 操作手順・コマンド参照
97
+
98
+ | 参照先 | 種類 | 参照目的 |
99
+ | ------------------------------------- | -------- | ---------------------------------------------------------- |
100
+ | [[specdojo:uis-sample\|販売登録画面]] | 画面仕様 | 商品登録・修正、預かり金確認、確定・中止の操作と入力形式 |
101
+ | `opr-pos-operation` | 運用手順 | 店番交代時の確認、利用権限の設定、印刷失敗時の再印刷 |
102
+ | `opr-sales-recovery` | 回復手順 | 結果不明の取引の照合、部分失敗の再開、代替運用への切替判断 |
103
+
104
+ 一次対応は店番担当が行い、結果不明・記録不一致・再印刷不能は OPS へ引き渡す。OPS は契約不一致・不具合を ARC・DEV へ、営業継続への影響を PO へ報告する。
105
+
106
+ ## 7. 検証・受入観点
107
+
108
+ データは架空の商品・取引を使い、証跡には処理前後の記録・在庫・表示を残す。
109
+
110
+ | 観点 ID | 対象要件 | 対象条件 | 観測する期待結果 | 検証方法・証跡 | 確認ロール |
111
+ | ------- | ---------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------ |
112
+ | `V-01` | `FR-01`・`FR-02` | 追加・数量変更・削除。数量は UIS の許容下限・上限とその外側、在庫と同数・超過 | 許容時だけ明細と金額が更新される。それ以外は理由を返し、既存明細を維持する | 結合試験、入出力比較 | DEV・QE |
113
+ | `V-02` | `FR-02`・`FR-03` | 請求額108円の明細に、預かり金107円・108円・200円を与える | 107円は確定不可、108円は釣銭0円、200円は釣銭92円。完了時は売上記録と在庫反映を確認できる | 結合試験、金額表示・記録照合 | QE・BA |
114
+ | `V-03` | `FR-02`・`FR-04` | 空明細で確定、非数値の預かり金で確定、有効明細を確定前に中止 | 前二者は理由付きで拒否、後者は明細を破棄する。いずれも売上記録・在庫払出を作らない | 結合試験、処理前後の記録 | QE |
115
+ | `V-04` | `FR-03` | 確定成功後に同じ要求を再送し、その後商品台帳の単価を変える | 売上と払出は各1回分で元の結果を返す。過去の売上明細の単価は変わらない | 結合試験、件数・在庫差分・明細照合 | DEV・QE |
116
+ | `V-05` | `FR-03`・`FR-04` | 保存前、販売記録後・在庫反映前、在庫反映後・応答前に障害を起こす | 完了を推測せず停止位置と反映状況が残り、照合前の再確定・中止を拒否する。回復後は売上・払出が各1回分で一致する | 障害注入、保留表示・回復記録 | ARC・QE・OPS |
117
+ | `V-06` | `FR-03` | 会計完了後に印刷失敗し、回復後に再印刷する | 印刷未完了の通知と控えが残り、再印刷しても売上件数と在庫が変わらない | 外部連携試験、印刷結果・記録比較 | QE・OPS |
118
+ | `V-07` | 権限・秘匿 | 販売権限なしで確定要求する。顧客情報なしで現金販売する | 無権限の確定は拒否される。権限ありは顧客情報なしで完了し、出力に認証情報が含まれない | 権限試験、画面・レシート・証跡確認 | QE・OPS |
119
+ | `V-08` | 性能・使いやすさ | 実店舗と同じ端末で店主代表・家族利用者代表が登録・修正・会計・中止を行う | プロジェクト概要の作業完遂・行き詰まりの基準を満たす。応答時間は `Q-02` で決めた受入値と比べる | 利用者受入、観察・計測記録 | UX・QE・PO |
120
+
121
+ ## 8. 未決事項
122
+
123
+ | 論点 | 影響と当面の扱い |
124
+ | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
125
+ | `Q-01` `_UNDECIDED_`: `sf-index` の対応、BPS の詳細対応、税計算、取引状態、在庫・印刷・記録先の連携契約が未整備 | 設計境界・税額・再送時の一意性を保証できない。確定までは未照合部分を確定した設計入力に使わず、確定後に「業務プロセス・画面との対応」と `FR-03` を照合する |
126
+ | `Q-02` `_UNDECIDED_`: 応答時間の受入値と、接続不能・部分失敗時の代替運用が未合意 | `V-05`・`V-08` を判定できず、営業停止や紙からの二重転記のおそれがある。オフライン販売を足す場合は対象範囲と受入条件を見直す |