specdojo 0.8.0 → 0.9.1

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 (292) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +77 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/orchestrator.js +5 -77
  9. package/dist/commands/where.js +25 -0
  10. package/dist/dashboard/dashboard.js +5 -3
  11. package/dist/dashboard/routines.js +4 -7
  12. package/dist/dashboard/shared.js +2 -2
  13. package/dist/dashboard/timeline.js +14 -14
  14. package/dist/deliverable/trash.js +2 -1
  15. package/dist/docs/index-command.js +2 -2
  16. package/dist/docs/yaml-business-tables.js +243 -0
  17. package/dist/docs/yaml-interface-tables.js +106 -0
  18. package/dist/docs/yaml-pages-command.js +5 -3
  19. package/dist/docs/yaml-pages.js +146 -3
  20. package/dist/docs/yaml-table-shared.js +70 -0
  21. package/dist/docs/yaml-tables.js +39 -0
  22. package/dist/exec/agent-config.js +9 -0
  23. package/dist/exec/agent-protected-config.js +2 -0
  24. package/dist/exec/commands.js +31 -18
  25. package/dist/exec/events.js +34 -14
  26. package/dist/exec/evidence.js +13 -3
  27. package/dist/exec/opencode-permissions.js +117 -0
  28. package/dist/exec/parent-validation.js +56 -3
  29. package/dist/exec/plans-core.js +21 -2
  30. package/dist/exec/plans-generation.js +6 -7
  31. package/dist/exec/post-integration.js +162 -0
  32. package/dist/exec/queue-command.js +166 -0
  33. package/dist/exec/queue.js +285 -0
  34. package/dist/exec/register-foreign-wait.js +82 -0
  35. package/dist/exec/repo-integration-sync.js +17 -5
  36. package/dist/exec/repo-trace.js +2 -1
  37. package/dist/exec/reporter.js +2 -2
  38. package/dist/exec/results.js +24 -4
  39. package/dist/exec/review-kata.js +4 -1
  40. package/dist/exec/run/agent-pipeline.js +3 -2
  41. package/dist/exec/run/agent.js +12 -6
  42. package/dist/exec/run/change-scope.js +365 -0
  43. package/dist/exec/run/deferred-cleanup.js +31 -0
  44. package/dist/exec/run/in-place.js +5 -2
  45. package/dist/exec/run/job-lock.js +66 -0
  46. package/dist/exec/run/job-sequence.js +137 -0
  47. package/dist/exec/run/job.js +56 -19
  48. package/dist/exec/run/lifecycle-commands.js +1 -1
  49. package/dist/exec/run/lock.js +22 -1
  50. package/dist/exec/run/register-command.js +8 -5
  51. package/dist/exec/run/register-mode.js +68 -8
  52. package/dist/exec/run/register-resume.js +68 -14
  53. package/dist/exec/run/register-state.js +13 -8
  54. package/dist/exec/run/register-worktree.js +140 -125
  55. package/dist/exec/run/schedule-mode.js +75 -14
  56. package/dist/exec/run/schedule-prepare.js +3 -0
  57. package/dist/exec/run/schedule-task.js +88 -38
  58. package/dist/exec/run/shared.js +5 -0
  59. package/dist/exec/schedule/schedule.js +116 -4
  60. package/dist/exec/shared.js +2 -2
  61. package/dist/exec/smoke.js +190 -0
  62. package/dist/exec/strategy.js +13 -3
  63. package/dist/exec/task-repos.js +19 -4
  64. package/dist/exec/task-view.js +6 -4
  65. package/dist/exec/trial-commands.js +5 -2
  66. package/dist/exec/trial-core.js +6 -1
  67. package/dist/exec/validation-metrics.js +181 -0
  68. package/dist/exec/worktree-cleanup-lock.js +26 -0
  69. package/dist/exec/worktree-command.js +12 -2
  70. package/dist/exec/worktree-ops-commit.js +2 -2
  71. package/dist/exec/worktree.js +13 -2
  72. package/dist/grade/command-apply.js +3 -3
  73. package/dist/grade/command-inspect.js +5 -3
  74. package/dist/grade/command-plan.js +1 -1
  75. package/dist/grade/command-run.js +5 -1
  76. package/dist/grade/run.js +64 -8
  77. package/dist/job/definition.js +84 -8
  78. package/dist/job/job.js +79 -23
  79. package/dist/register/authoring-sources.js +22 -16
  80. package/dist/register/maintenance-commands.js +2 -2
  81. package/dist/register/register.js +31 -7
  82. package/dist/register/renumber.js +1 -3
  83. package/dist/routine/definition.js +9 -0
  84. package/dist/routine/routine.js +137 -43
  85. package/dist/routine/status.js +62 -0
  86. package/dist/schedule/schedule.js +38 -39
  87. package/dist/shared/agent-types.js +5 -0
  88. package/dist/shared/cross-process-lock.js +9 -1
  89. package/dist/shared/dist-freshness.js +8 -2
  90. package/dist/shared/git-environment.js +2 -1
  91. package/dist/shared/git.js +44 -1
  92. package/dist/shared/lefthook-scaffold.js +3 -0
  93. package/dist/shared/local-config.js +244 -0
  94. package/dist/shared/specdojo-config.js +34 -20
  95. package/dist/shared/specdojo-gitignore.js +1 -0
  96. package/dist/shared/text.js +17 -1
  97. package/dist/shared/where-alias.js +13 -0
  98. package/dist/specdojo.js +4 -0
  99. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  100. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  101. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  102. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  103. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
  104. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  105. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  106. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  107. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  108. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  109. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  110. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  111. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  112. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  113. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  114. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  115. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  116. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  117. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  118. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  119. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  120. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  121. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  122. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  123. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  124. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  125. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  126. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  127. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  128. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  129. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  130. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  131. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  132. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  133. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  134. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  135. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  136. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  137. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  138. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  139. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  140. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  141. package/docs/ja/specdojo/references/command-reference.md +258 -118
  142. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  143. package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
  144. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  145. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  146. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  147. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  148. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  149. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  150. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  151. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  152. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  153. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  154. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  155. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  156. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  157. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  158. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  159. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  160. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  161. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  162. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  163. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  164. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  165. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  166. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  167. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  168. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  169. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  170. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  171. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  172. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  173. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  174. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  175. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  176. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  177. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  178. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  179. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  180. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  181. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  182. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  183. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  184. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  185. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  186. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  187. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  188. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  189. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  190. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  191. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  192. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  193. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  194. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  195. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  196. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  197. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  198. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  199. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  200. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  201. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  202. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  203. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  204. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  205. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  206. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  207. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  208. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  209. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  210. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  211. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  212. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  213. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  214. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  215. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  216. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  217. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  218. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  219. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  220. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  221. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  222. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  223. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  224. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  225. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  226. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  227. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  228. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  229. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  230. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  234. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  235. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  236. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  237. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  238. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  239. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  240. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  241. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  242. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  243. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  244. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  245. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  246. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  247. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  248. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  249. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  250. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  251. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  252. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  253. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  254. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  255. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  256. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  257. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  258. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  259. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  260. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  261. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  262. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  263. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  264. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  265. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  266. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  267. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  268. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  269. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  270. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  271. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  272. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  273. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  274. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  275. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  276. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  277. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  278. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  279. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  280. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  281. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  282. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  283. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  284. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  285. package/package.json +9 -6
  286. package/templates/antigravity/orchestrator.md +4 -1
  287. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  288. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  289. package/templates/codex/orchestrator.md +4 -1
  290. package/templates/init-exec-defaults.yaml +13 -0
  291. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  292. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -10,129 +10,117 @@ specdojo:
10
10
 
11
11
  ## 1. 目的と概要
12
12
 
13
- 店主代表と家族利用者代表が、店頭のタブレットから現金販売を記録し、請求額・釣銭と在庫への反映結果を同じ取引で確認できるようにする。ノートへの転記漏れと暗算の誤りを減らし、店番が交代しても販売・在庫の記録を継続する。これは [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針と、日々の記録を定着させる目標に対応する。
13
+ 店主代表と家族利用者代表が、店頭のタブレットから現金販売を記録し、請求額・釣銭と在庫への反映結果を同じ取引で確認できるようにする。ノートへの転記漏れと暗算の誤りを減らし、店番が交代しても記録を続けられるようにする。これは [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針に対応する。
14
14
 
15
- 上位のシステム化機能一覧は `sf-index`(仮置き)とし、一覧上の対応エントリは機能 ID `SF-POS-01`、機能名「店頭商品販売」とする。一覧ハブの作成・照合は BA が担い、一覧への本登録時に対応関係を確定する(未決事項 `Q-01` で追跡)。本書は個別機能の完成記述の例であり、実案件での承認済み仕様を示すものではない。
15
+ 上位のシステム化機能一覧は `sf-index`(未作成)で、対応エントリは機能 ID `SF-POS-01`「店頭商品販売」とする。一覧への登録時に対応を確定する(「未決事項」の `Q-01`)。
16
16
 
17
- | 区分 | 範囲 |
18
- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
19
- | 対象 | 単一店舗の現金販売。商品・数量の登録と修正、税額・請求額・釣銭の提示、販売記録の確定、在庫反映結果の確認、レシート発行要求、確定前の取引中止 |
20
- | 対象外 | つけ販売と精算、キャッシュレス決済、確定後の返品・値引訂正、補充判断・物理的補充、EC・複数店舗。つけ販売は業務領域 `P-04`、補充判断は `P-06` へ委譲する |
17
+ | 区分 | 範囲 |
18
+ | ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
19
+ | 対象 | 単一店舗の現金販売。明細の登録・修正、税額・請求額・釣銭の提示、販売記録の確定、在庫反映結果の確認、レシート発行要求、確定前の中止 |
20
+ | 対象外 | つけ販売(`P-04`)、補充判断(`P-06`)、キャッシュレス決済、確定後の返品・値引訂正、EC・複数店舗 |
21
21
 
22
- 利用者は店主代表・家族利用者代表、設計入力として読む者は ARC・DEV、受入条件を確認する者は QE である。BA は業務境界、UX は表示と誤操作からの回復、OPS は障害時の照合方法を確認する。役割と兼務の正本は [[specdojo:pm-organization-sample|組織定義]] と [[specdojo:pm-roles-sample|ロール定義]] とする。
23
-
24
- 公開対象は店舗内の運用者と開発・レビュー担当であり、実顧客の情報や認証情報は含めない。人間の PO(店主代表)がスコープ・受入条件・公開可否を最終判断する。
22
+ 店番中の店主代表・家族利用者代表が利用し、設計と受入試験では本書の要件と受入条件を入力にする。
25
23
 
26
24
  ## 2. 業務プロセス・画面との対応
27
25
 
28
- 業務境界は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の店頭販売 `P-03` と在庫確認 `P-05` に対応する。詳細 BPS `bps-sales-order-flow` は未作成のため、次表は領域単位の対応とし、処理ステップ ID の照合は未決事項 `Q-01` で追跡する。
26
+ 業務境界は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の店頭販売 `P-03` と在庫確認 `P-05` に対応する。詳細 BPS `bps-sales-order-flow` は未作成のため、領域単位で対応付ける(`Q-01`)。
29
27
 
30
- | 根拠領域 | 本機能の責務 | 対応要件・入出力 |
31
- | --------------- | ---------------------------------------------------------------------------------------- | -------------------------------------------- |
32
- | `P-03` 店頭販売 | 購入商品と数量を受け、会計に使う明細と請求額を提示する | `FR-01`・`FR-02`、商品情報・購入明細・請求額 |
33
- | `P-03` 店頭販売 | 現金の受領確認を受け、販売を記録して完了可否を返す | `FR-03`、預かり金・販売記録・会計結果 |
34
- | `P-05` 在庫確認 | 販売による払出数量を渡し、反映結果を会計結果へ対応付ける。在庫の算出・補充要否は委譲する | `FR-03`、販売確定情報・在庫反映結果 |
35
- | `P-03` 店頭販売 | 確定前の取引中止を受け、未確定の明細を破棄する | `FR-04`、取引中止結果 |
28
+ | 根拠領域 | 本機能の責務 | 対応要件・入出力 |
29
+ | --------------- | -------------------------------------------------------------- | ----------------------------------- |
30
+ | `P-03` 店頭販売 | 購入商品と数量を受け、明細と請求額を提示する | `FR-01`・`FR-02`、購入明細・請求額 |
31
+ | `P-03` 店頭販売 | 現金の受領確認を受け、販売を記録して完了可否を返す | `FR-03`、預かり金・販売記録 |
32
+ | `P-05` 在庫確認 | 払出数量を渡し、反映結果を会計結果へ対応付ける。在庫算出は委譲 | `FR-03`、販売確定情報・在庫反映結果 |
33
+ | `P-03` 店頭販売 | 確定前の取引中止を受け、未確定の明細を破棄する | `FR-04`、取引中止結果 |
36
34
 
37
- | 接点 | トリガー・受け渡し | 責務境界 |
38
- | -------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
39
- | [[specdojo:uis-sample\|販売登録画面]] | 商品追加・数量修正・会計確定・取引中止を受け、明細・金額・結果を返す | 表示配置・入力形式・画面遷移は UIS、会計の確定可否は本機能が担う |
40
- | 在庫確認機能 `sf-inventory` | 販売を識別する情報と払出数量を渡し、反映済み・未反映・結果不明の区別を受ける | 在庫更新は連携先、本機能は未反映・結果不明を販売完了と通知しない |
41
- | レシート出力 `ifx-cmd-receipt-printer` | 確定した販売の印字内容を渡し、印刷結果を受ける | 印刷失敗は販売確定と区別する。起動契約・再印刷手順は連携仕様と運用手順へ委ねる |
35
+ | 接点 | トリガー・受け渡し | 責務境界 |
36
+ | -------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------- |
37
+ | [[specdojo:uis-sample\|販売登録画面]] | 商品追加・数量修正・会計確定・中止を受け、明細・金額・結果を返す | 表示・入力形式・遷移は UIS、会計の確定可否は本機能 |
38
+ | 在庫確認機能 `sf-inventory` | 払出数量を渡し、反映済み・未反映・結果不明の区別を受ける | 在庫更新は連携先。未反映・結果不明を販売完了と通知しない |
39
+ | レシート出力 `ifx-cmd-receipt-printer` | 確定した販売の印字内容を渡し、印刷結果を受ける | 印刷失敗は販売確定と区別する |
42
40
 
43
- 利用接点は GUI とし、CLI による会計は対象外とする。未作成の在庫連携・印刷契約は `Q-01` で詳細化する。
41
+ 利用接点は GUI とし、CLI による会計は対象外とする。
44
42
 
45
43
  ## 3. 入出力と前提条件
46
44
 
47
45
  ### 3.1. 入出力
48
46
 
49
- | 区分 | 論理情報 | 入手元 / 提供先 | 必須性・確定条件 | 正本仕様 | 対応要件 |
50
- | ---- | -------------------------------------------- | ------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------ | ---------------- |
51
- | 入力 | 商品識別子、販売数量、明細の修正・削除要求 | 店番担当 / 明細登録 | 登録・修正時に必須 | [[specdojo:uis-sample\|販売登録画面]]、[[specdojo:bdd-sample\|業務データ辞書]] | `FR-01` |
52
- | 入力 | 商品名、販売単価、税区分、販売可能な在庫数量 | 商品台帳・在庫確認機能 / 明細登録・会計確認 | 会計前に確認できること | [[specdojo:bdd-sample\|業務データ辞書]]、`br-tax-calculation`、`sf-inventory` | `FR-01`・`FR-02` |
53
- | 入力 | 預かり金額、現金の受領確認 | 店番担当 / 会計確定 | 現金販売の確定時に必須 | [[specdojo:uis-sample\|販売登録画面]] | `FR-02`・`FR-03` |
54
- | 入力 | 在庫反映結果、保存済みの販売と処理結果 | 在庫確認機能・販売記録 / 確定・再開判定 | 確定要求時と結果照合時に必須 | `sf-inventory`、`ifx-api-store-sales` | `FR-03` |
55
- | 出力 | 購入明細、税額、請求額、釣銭 | 本機能 / 店番担当・来店客 | 明細変更と預かり金の変更に対応する金額 | [[specdojo:uis-sample\|販売登録画面]]、`br-tax-calculation` | `FR-01`・`FR-02` |
56
- | 出力 | 売上記録・売上明細、販売確定情報 | 本機能 / 販売記録・在庫確認機能 | 受領確認と確定要求に対応して一度だけ記録・反映する | [[specdojo:bdd-sample\|業務データ辞書]]、`sf-inventory` | `FR-03` |
57
- | 出力 | 会計結果、停止理由、取引中止結果、印字内容 | 本機能 / 店番担当・レシート出力 | 完了・保留・中止と印刷成否を識別できること | [[specdojo:uis-sample\|販売登録画面]]、`ifx-cmd-receipt-printer` | `FR-03`・`FR-04` |
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` |
58
56
 
59
- 売上記録と明細の管理単位は業務データ辞書を正本とし、データ項目・型・コード値を本書へ転記しない。未作成の税計算・連携契約と物理データの schema・版の確定は `Q-01` の対象とする。
57
+ データ項目・型・コード値は業務データ辞書を正本とし、本書へ転記しない。
60
58
 
61
59
  ### 3.2. 前提条件と事後条件
62
60
 
63
- - 着手条件: 店番担当が販売権限で利用でき、商品台帳と店舗内の記録先へ接続できること。進行中の取引があればその取引を継続し、別の取引を重ねて開始しない。
64
- - 事後条件: 正常完了時の記録・反映の保証は「通常処理」の `FR-03`、確定前の中止は `FR-04`、保留・失敗時の保持と回復条件は「例外・回復条件」に従う。印刷成否は会計結果と分けて判定する。
61
+ - 着手条件: 店番担当が販売権限で利用でき、商品台帳と店舗内の記録先へ接続できること。進行中の取引があれば継続し、別の取引を重ねない。
62
+ - 事後条件: 正常完了は `FR-03`、中止は `FR-04`、保留・失敗は「例外・回復条件」に従う。印刷成否は会計結果と分けて判定する。
65
63
 
66
64
  ## 4. 処理要件・機能振る舞い
67
65
 
68
66
  ### 4.1. 通常処理
69
67
 
70
- | 要件 ID | 開始条件 | 処理の責務・確定する結果 | 判断の正本 |
71
- | ------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
72
- | `FR-01` | 販売取引で商品・数量を受けた | 商品と在庫を照合し、明細の追加・修正・削除に応じて表示を更新する。未登録商品や販売不可の数量は理由を返し、既存明細を維持する | [[specdojo:uis-sample\|販売登録画面]] の入力条件 |
73
- | `FR-02` | 有効な明細がある | 税計算の結果から税額・請求額を提示し、預かり金から釣銭を求める。明細が空、または預かり金が不足している間は確定を受け付けない | `br-tax-calculation`、販売登録画面の会計条件 |
74
- | `FR-03` | 店番担当が現金の受領を確認し、会計確定を要求した | 販売時の単価・数量を売上記録へ残し、在庫反映結果を照合する。両方を確認した後に販売完了を返し、レシート発行を要求する。完了済みの要求の再送では元の結果を返す | [[specdojo:bdd-sample\|業務データ辞書]]、`sf-inventory`、`ifx-api-store-sales` |
75
- | `FR-04` | 確定前に取引中止の確認を受けた | 未確定の明細を破棄し、中止結果を返す。確定中・結果不明の取引は照合へ引き渡し、取消済みと扱わない | 販売登録画面、`stsd-sales-transaction` |
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` |
76
74
 
77
- 商品の販売済みへの遷移は [[specdojo:stsd-sample|商品 ステータス定義]] を参照する。画面上の販売完了通知と、店番担当による釣銭・商品の手渡しは別であり、システムは顧客受領を推測しない。取引自体の状態・遷移は `stsd-sales-transaction` で詳細化する(`Q-01`)。
75
+ 商品の販売済みへの遷移は [[specdojo:stsd-sample|商品 ステータス定義]] を参照する。販売完了の通知は釣銭・商品の手渡しとは別であり、システムは顧客受領を推測しない。
78
76
 
79
77
  ### 4.2. 例外・回復条件
80
78
 
81
- | 条件 | 通知と保持する情報 | 回復・再開条件 |
82
- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
83
- | 未登録商品、数量不正、在庫不足 | 対象商品と不成立の条件を通知する。拒否した変更を明細・販売記録・在庫に反映しない | 店番担当が商品または数量を修正し、`FR-01` で再照合する |
84
- | 明細なし、預かり金不足・入力不正 | 確定不可と理由を返し、有効な明細を維持する | 明細追加または預かり金の補正後に `FR-02` から確認する |
85
- | 保存・在庫反映が失敗、または応答が途絶え結果不明 | 完了通知を出さず、取引と停止位置、保存・反映状況を保持する。入力済みの情報を回復に使い、自動で別取引を作らない | OPS が同じ取引の販売記録と在庫を照合する。確定済みなら結果を再提示し、未完了なら未反映部分だけを再開する。照合できるまで再確定・中止を許可しない |
86
- | 会計完了後の印刷失敗 | 会計完了と印刷未完了を分けて通知し、確定済みの販売記録と印字内容を保持する | 店番担当がプリンタの回復後に同じ販売の再印刷を要求する。売上・在庫を再更新しない |
79
+ | 条件 | 通知と保持する情報 | 回復・再開条件 |
80
+ | ---------------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
81
+ | 未登録商品、数量不正、在庫不足 | 対象商品と理由を通知する。拒否した変更を明細・記録・在庫に反映しない | 商品または数量を修正し、`FR-01` で再照合する |
82
+ | 明細なし、預かり金不足・入力不正 | 確定不可と理由を返し、有効な明細を維持する | 明細追加または預かり金の補正後に `FR-02` から確認する |
83
+ | 保存・在庫反映の失敗、応答途絶で結果不明 | 完了を通知せず、取引・停止位置・反映状況を保持する。自動で別取引を作らない | OPS が記録と在庫を照合し、確定済みなら結果を再提示、未完了なら未反映部分だけを再開する。照合まで再確定・中止を許可しない |
84
+ | 会計完了後の印刷失敗 | 会計完了と印刷未完了を分けて通知し、販売記録と印字内容を保持する | プリンタ回復後に同じ販売を再印刷する。売上・在庫を再更新しない |
87
85
 
88
86
  ## 5. 非機能・技術制約
89
87
 
90
- | 観点 | 制約と適用範囲 | 正本・判定方法 |
91
- | ------------------ | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
92
- | 利用構成・外部依存 | 単一店舗・タブレット1台で、店舗内の記録先へ接続して利用する。未接続時に新規販売を確定する保証は含めない | [[specdojo:sample-authoring-standard\|共通サンプル文脈]]。通信切断時の保持・保留は `V-05`、代替運用の判断は `Q-02` |
93
- | 完全性 | 完了を表示した販売は、記録と在庫反映を照合できる。同じ要求の再送でも二重売上・二重払出を発生させない | `FR-03`、在庫連携・再送契約は `Q-01`。`V-04`・`V-05` で記録件数と在庫差分を比較する |
94
- | 性能・使いやすさ | 店番中の明細登録と会計確認が継続できること。応答時間の受入値は実端末測定後に決め、未承認の固定値を保証しない | `Q-02`。[[specdojo:prj-overview-sample\|プロジェクト概要]] の作業完遂・行き詰まりの指標を `V-08` で確認する |
95
- | 権限・秘匿 | 販売権限のない主体は確定できない。現金販売では顧客情報を必須入力にせず、認証情報を画面・レシート・検証証跡へ出力しない | `opr-pos-operation`、販売登録画面。`V-07` で権限と出力を確認する |
96
- | 契約・互換性 | 画面、記録先、在庫連携、印刷先の契約を ARC が照合する。schema・版・再送契約の不一致があれば統合受入を保留する | `Q-01`。業務データ辞書は論理定義、物理構造と公開契約は連携仕様・schema を正本とする |
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 を正本とする |
97
95
 
98
96
  ## 6. 操作手順・コマンド参照
99
97
 
100
- | 参照先 | 種類 | 参照目的 |
101
- | ------------------------------------- | -------- | -------------------------------------------------------------------------------- |
102
- | [[specdojo:uis-sample\|販売登録画面]] | 画面仕様 | 商品登録・修正、預かり金確認、確定・中止の操作と入力形式 |
103
- | `opr-pos-operation` | 運用手順 | 店番交代時の確認、利用権限の設定、釣銭・商品の手渡し、印刷失敗時の再印刷 |
104
- | `opr-sales-recovery` | 回復手順 | 取引結果不明時の記録・在庫の照合、部分失敗の再開、障害記録と代替運用への切替判断 |
105
-
106
- 一次対応は店番担当が行い、会計結果不明・記録不一致・再印刷不能は OPS に引き渡す。OPS は `opr-sales-recovery` で照合し、契約不一致・不具合なら ARC・DEV、営業継続への影響なら PM・PO へ報告する。未作成の運用手順は `Q-02` の承認条件とする。
98
+ | 参照先 | 種類 | 参照目的 |
99
+ | ------------------------------------- | -------- | ---------------------------------------------------------- |
100
+ | [[specdojo:uis-sample\|販売登録画面]] | 画面仕様 | 商品登録・修正、預かり金確認、確定・中止の操作と入力形式 |
101
+ | `opr-pos-operation` | 運用手順 | 店番交代時の確認、利用権限の設定、印刷失敗時の再印刷 |
102
+ | `opr-sales-recovery` | 回復手順 | 結果不明の取引の照合、部分失敗の再開、代替運用への切替判断 |
107
103
 
108
- 仕様変更時は BA が業務対応、ARC・DEV が入出力・在庫連携・schema・画面への影響、QE が受入条件、OPS が運用手順への影響を確認する。PM は要件単位と受入条件を成果物カタログ・Schedule に接続し、進捗は実行結果、課題・変更判断は PJR・レビュー記録で追跡する。
104
+ 一次対応は店番担当が行い、結果不明・記録不一致・再印刷不能は OPS へ引き渡す。OPS は契約不一致・不具合を ARC・DEV へ、営業継続への影響を PO へ報告する。
109
105
 
110
106
  ## 7. 検証・受入観点
111
107
 
112
- ### 7.1. 機能の受入条件
113
-
114
- 以下は試験の判定基準であり、実施済み・合格済みを表さない。データは架空の商品・取引を使い、証跡には比較前後の記録、在庫、表示結果を残す。
115
-
116
- | 観点 ID | 対象要件 | 対象条件 | 観測する期待結果 | 検証方法・証跡 | 確認ロール |
117
- | ------- | ---------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------ |
118
- | `V-01` | `FR-01`・`FR-02` | 登録済み商品を追加・数量変更・削除する。数量は UIS の許容下限・上限とその外側、在庫と同数・超過で確認する | 許容時だけ明細と金額が更新される。未登録・不正・在庫超過は理由を返し、既存明細を維持する | 結合試験、入出力比較 | DEV・QE |
119
- | `V-02` | `FR-02`・`FR-03` | 税計算結果が請求額108円の明細に、預かり金107円・108円・200円を与える | 107円では確定不可、108円では釣銭0円、200円では釣銭92円となる。完了時は売上記録と在庫反映を確認できる | 結合試験、金額表示・記録照合 | QE・BA |
120
- | `V-03` | `FR-02`・`FR-04` | 空明細で確定、非数値の預かり金で確定、有効明細を確定前に中止する | 前二者は理由付きで拒否し、後者は未確定明細を破棄する。いずれも売上記録・在庫払出を作らない | 結合試験、処理前後の記録 | QE |
121
- | `V-04` | `FR-03` | 確定成功後に同じ要求を再送し、その後商品台帳の単価を変更する | 売上と払出は各1回分で、元の会計結果を返す。過去の売上明細の販売単価は変更されない | 結合試験、件数・在庫差分・明細照合 | DEV・QE |
122
- | `V-05` | `FR-03`・`FR-04` | 保存前、販売記録後・在庫反映前、在庫反映後・応答前に障害を発生させる | 完了を推測せず、停止位置と反映状況が残る。照合前の再確定・中止は拒否する。回復後は売上・払出が各1回分で一致する | 障害注入、保留表示・回復記録 | ARC・QE・OPS |
123
- | `V-06` | `FR-03` | 会計完了後に印刷失敗し、回復後に再印刷する | 印刷未完了の通知と控えが残る。同じ販売を印刷でき、売上件数と在庫が変わらない | 外部連携試験、印刷結果・記録比較 | QE・OPS |
124
- | `V-07` | 権限・秘匿 | 販売権限なしで確定要求する。現金販売を顧客情報なしで実施する | 無権限の確定は拒否される。権限ありの現金販売は顧客情報なしで完了し、出力に認証情報が含まれない | 権限試験、画面・レシート・証跡確認 | QE・OPS |
125
- | `V-08` | 性能・使いやすさ | 実店舗と同じ端末で店主代表・家族利用者代表が登録・修正・会計・中止を行う | プロジェクト概要の作業完遂・重大な行き詰まりの基準を満たす。応答時間は `Q-02` で合意した条件・受入値と比較する | 利用者受入、観察・計測記録 | UX・QE・PO |
126
-
127
- ### 7.2. 文書の完成判定と承認
128
-
129
- 文書検査は利用リポジトリの package・hook 設定に従い、Markdown 整形、Markdown lint、Frontmatter・参照検査の対象・コマンド・結果を実行記録に残す。適用検査のエラーがなく、主要要件と受入条件が対応し、カタログの完了条件を確認できることを文書の完成条件とする。
108
+ データは架空の商品・取引を使い、証跡には処理前後の記録・在庫・表示を残す。
130
109
 
131
- BA・ARC・DEV・QE・OPS は各合意対象と未充足条件をレビュー記録へ残す。PO は未決事項・未解決指摘と公開範囲を確認し、承認・保留・差し戻しを記録する。`Q-01`・`Q-02` の承認条件が未充足の間は `draft` を維持する。文書検査の成功、作業タスクの完了、機能受入、製品リリースはそれぞれ別に判断する。
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 |
132
120
 
133
121
  ## 8. 未決事項
134
122
 
135
- | 論点 ID・区分 | 論点・影響とリスク | 担当 / 判断者 | 判断時点 | 次アクション・追跡先 | 承認を保留する条件 |
136
- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
137
- | `Q-01`・`_UNDECIDED_` | 上位一覧 sf-index の対応、BPS の詳細対応、税計算、取引状態、在庫・印刷・画面と記録先の連携契約が未整備。未照合では設計境界・税額・再送時の一意性を保証できず、結合試験が手戻りになる | BA・ARC が整理、DEV・QE が検証可能性を確認 / PO | コンポーネント・連携設計の確定前 | BA が上位一覧 `sf-index` の `SF-POS-01` と `bps-sales-order-flow` を照合し、ARC が `br-tax-calculation`・`stsd-sales-transaction`・`sf-inventory`・`ifx-api-store-sales`・`ifx-cmd-receipt-printer` と schema・版を特定する。PM が PJR 候補 `PJR-SALES-CONTRACT` を起票し、カタログ・Schedule の設計依存へ反映する | 詳細対応と契約正本が未特定、または `FR-03` と再送・回復契約が不一致であれば承認しない。未確定部分は設計入力に使っても確定扱いにしない |
138
- | `Q-02`・`_UNDECIDED_` | 応答時間の受入値と、接続不能・部分失敗時の照合・代替運用が未合意。営業停止や紙からの二重転記のリスクがある | UX・QE が測定、OPS が回復案を整理 / 負担と継続判断は PO | 利用者受入試験の設計前 | QE が端末・商品件数・取引件数をそろえて計測し、OPS が `opr-pos-operation`・`opr-sales-recovery` を作成する。PM が PJR 候補 `PJR-SALES-RECOVERY` で PO への報告と判断結果を追跡し、受入・運用準備タスクへ反映する | 応答値・運用手順に合意がなく `V-05`・`V-08` を判定できなければ承認しない。オフライン販売を追加する場合はスコープ・契約・受入条件の変更として審査する |
123
+ | 論点 | 影響と当面の扱い |
124
+ | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
125
+ | `Q-01` `_UNDECIDED_`: `sf-index` の対応、BPS の詳細対応、税計算、取引状態、在庫・印刷・記録先の連携契約が未整備 | 設計境界・税額・再送時の一意性を保証できない。確定までは未照合部分を確定した設計入力に使わず、確定後に「業務プロセス・画面との対応」と `FR-03` を照合する |
126
+ | `Q-02` `_UNDECIDED_`: 応答時間の受入値と、接続不能・部分失敗時の代替運用が未合意 | `V-05`・`V-08` を判定できず、営業停止や紙からの二重転記のおそれがある。オフライン販売を足す場合は対象範囲と受入条件を見直す |
@@ -17,108 +17,89 @@ specdojo:
17
17
 
18
18
  ## 1. 概要
19
19
 
20
- 店主代表と家族利用者代表(店番担当)が、店頭の現物商品・紙台帳・店舗タブレット内の電子ファイルの置き場所と処分基準を同じ根拠で判断できるよう、仕入・販売・在庫・締めに関わる保管場所一覧を定義する。検品前の入荷品と販売可能な商品の混在や、本部との照合に使う販売記録の控えと入力途中セッションファイルの誤削除を防ぐことを目的とする。
20
+ 店主代表と店番担当が、現物・紙台帳・タブレット内のファイルをどこに置き、いつ消してよいかを同じ根拠で判断できるようにする。検品前の入荷品と販売可能な商品の混在や、販売記録の控え・入力途中のセッションファイルの誤削除を防ぐ。
21
21
 
22
- ロールの割り当ては [[specdojo:pm-members-sample|メンバー定義]] に従う。BA(開発担当)が日常の保管・清掃・処分の境界を整理し、店主代表が兼ねる OPS の専門支援(店頭運用・障害時の引き継ぎ)を取り込む。DEV(開発担当)が概念データストアおよび CLI の保存パスと整合させ、ARC(技術メンター)が構成に助言する。QE(同行レビュー担当)が検証手順と受入条件を確認し、PM(開発担当)が未決事項を管理台帳へつなぎ、店主代表が PO として保管方針と公開可否を最終判断する。店番の現場操作は店主代表と家族利用者代表(UX)が行う。
23
-
24
- ### 1.1. 対象範囲と隣接仕様との分担
25
-
26
- 対象範囲は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要): 駄菓子屋きぬや販売管理]] の仕入・販売・在庫・締め領域で用いる物理保管場所および店舗タブレットのローカル保存領域とする。仕入記録は現行の仕入ノートを対象に含める。在庫記録は現行が店主の記憶で保管場所を持たないため一覧に載せず、システム化後の保管先を「確認事項と変更影響」で追跡する。
27
-
28
- | 隣接仕様・正本 | 本書(`sld-sample`)との分担 |
29
- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
30
- | [[specdojo:cdsd-sample\|概念データストア定義(駄菓子屋きぬやの販売と締め)]] | CDSD は管理単位(商品台帳・販売記録・日次販売集計・日次締め記録・月次報告)と正本区分・更新責務を定義する。本書はそれらの現物・ファイルが置かれる場所、共有範囲、寿命、削除可否を定義する |
31
- | [[specdojo:stsd-sample\|商品のステータス定義]] | STSD は納品から販売・返品までの状態と遷移条件を定義する。本書は状態ごとの現物の保管場所と処分の境界を定義する |
32
- | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] | BDD は商品・売上記録・売上明細の項目定義を正本とする。本書は項目構造を再掲せず、ファイル単位の保管場所と保持期間を定義する |
33
- | [[specdojo:clis-sample\|駄菓子屋きぬや 販売管理 CLI 仕様]] | CLIS はコマンド構文と入出力ファイル(`config/`、`.session/`、`data/sales/`、`receipts/`)の作成・停止条件を定義する。本書はそれらの寿命、削除可否、消失・障害時の復旧経路を定義する |
22
+ 対象範囲は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要): 駄菓子屋きぬや販売管理]] の仕入・販売・在庫・締め領域の物理保管場所と、店舗タブレットのローカル保存領域とする。仕入記録は現行の仕入ノートを含める。在庫記録は今は店主の記憶で保管場所がないため、「確認事項と変更影響」で追跡する。
34
23
 
35
24
  ## 2. 保管場所一覧
36
25
 
37
26
  ### 2.1. 店舗内・母屋の物理保管場所
38
27
 
39
- | 保管場所 | 置くもの | 関連プロセス・操作 | 共有の有無 | 寿命・管理頻度 | 削除・処分の可否と条件 |
40
- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
41
- | 検品場所(店舗奥の荷受台) | 入荷済み・検品済み(配置・分離前)の商品、納品伝票、納品時の外箱 | 入荷受入、入荷検品 | 店舗内共有(荷受担当と店番担当が確認) | 入荷当日の検品・配置完了まで(原則当日中) | `条件付き処分可`。商品は破棄しない。検品結果を仕入ノートへ記録し、商品を売場棚または返品保管箱へ移した後に外箱を解体処分し、納品伝票を店頭台帳保管棚へ移す |
42
- | 売場棚(店頭陳列棚・平台) | 販売可能な商品、棚札 | 売場配置、店頭販売、開店前の賞味期限確認 | 店舗内公開(来店客・店番担当が常時参照) | 販売または撤去まで(毎朝の開店前点検) | `処分不可`。期限切れ・破損品は売場で捨てず撤去品保留箱へ移す。棚札は取扱終了時に店主代表が確認した後のみ外す |
43
- | 返品保管箱(バックヤード下段・赤ラベル) | 検品で数量違い・品質不良と判定した受入不可の商品 | 入荷検品、仕入先への返品 | 店舗内共有(売場と分離) | 仕入先への引渡しまで(週次の返品回収日) | `条件付き処分可`。仕入先へ引き渡し、返品日と数量を仕入ノートへ記録した後に限り空にする。店舗で廃棄しない |
44
- | 撤去品保留箱(バックヤード下段・黄ラベル) | `_ASSUMPTION_`: 売場から撤去した期限切れ・破損品。STSD に対応する状態がない | 開店前の賞味期限確認、廃棄確定 | 店舗内共有(売場・返品保管箱と分離) | 撤去した当日の日次締めまで(日次締めで廃棄を確定) | `条件付き処分可`。店主代表が廃棄を確定し、廃棄数を当日の日次締め記録の在庫差異欄へ記入した後に廃棄する |
45
- | レジ釣銭準備箱・手提げ金庫 | 釣銭準備金、当日の現金売上 | 開店準備、店頭販売、日次締め | 店舗内共有(営業中は店番担当、閉店後は施錠) | 営業開始から日次締め確定まで(毎日閉店時に精算) | `処分不可`。日次締めで店主代表が現金実査と販売額の一致を確認した後、売上金を母屋金庫へ移す |
46
- | 仮メモ挟み(レジ横) | 営業中に書いた仮領収メモ・つけ販売の仮メモ | 店頭販売、日次締め | 店舗内共有(店番担当のみ。来店客から見えない位置) | 書いた当日の日次締めまで | `条件付き処分可`。日次締めで販売ノートの販売明細欄・顧客・つけ台帳へ転記済みと店主代表が確認したメモに限り破棄する。未転記のメモは翌日へ持ち越す |
47
- | 店頭台帳保管棚(施錠キャビネット) | 当年度の商品台帳、顧客・つけ台帳、仕入ノート、納品伝票綴り、販売ノート(販売明細欄・日次締め欄)、月次報告 | 入荷検品、つけ販売、日次締め、月次見直し | 店舗内共有(店主代表・家族利用者代表のみ閲覧。来店客から見えない施錠棚) | 当年度分のみ置き、年度末に旧年度分を母屋書庫へ移す | `処分不可`。取引・未収金・仕入の正本記録のため破棄しない |
48
- | 母屋書庫(施錠書棚) | 店頭台帳保管棚から移した旧年度の台帳・ノート・伝票・月次報告 | 年度末の移管、過去の照合・訂正確認 | 母屋内共有(店主代表が施錠管理し、家族利用者代表は店主代表の了承を得て閲覧) | 保持期間は未決(「確認事項と変更影響」)。決定まで全年度を保管する | `処分不可`。保持期間の決定後も、満了分の処分は PO が対象年度を確認して承認した場合に限る |
49
- | 母屋金庫 | 日次締め後の売上金 | 日次締め、仕入代金の支払 | 母屋内(店主代表のみ開閉) | 仕入代金の支払または金融機関への入金まで | `処分不可`。持ち出す際は店主代表が金額と用途を販売ノートの日次締め欄へ記入する |
50
- | 外部退避媒体(`_UNDECIDED_`: SD カードまたは USB メモリ。保管先は手提げ金庫または母屋金庫) | `config/store-config.yaml` と `data/sales/` の日次複製 | 日次締め後の退避、消失・破損時の復元 | 店主代表のみ | 保持世代数は未決。決定まで全世代を保持する | `処分不可`。世代数の決定まで上書き・消去しない |
28
+ | 保管場所 | 置くもの | 関連プロセス・操作 | 共有の有無 | 寿命・管理頻度 | 削除・処分の可否と条件 |
29
+ | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
30
+ | 検品場所(店舗奥の荷受台) | 配置前の入荷品、納品伝票、外箱 | 入荷受入、入荷検品 | 店舗内共有 | 入荷当日の配置完了まで | `条件付き処分可`。検品結果を仕入ノートへ記録し、商品を売場棚か返品保管箱へ移してから外箱を処分する。伝票は店頭台帳保管棚へ移す |
31
+ | 売場棚(陳列棚・平台) | 販売可能な商品、棚札 | 売場配置、店頭販売、開店前の期限確認 | 店舗内公開 | 販売・撤去まで(毎朝点検) | `処分不可`。期限切れ・破損品は撤去品保留箱へ移す。棚札は取扱終了を店主代表が確かめてから外す |
32
+ | 返品保管箱(バックヤード下段・赤ラベル) | 検品で受入不可とした商品 | 入荷検品、仕入先への返品 | 店舗内共有(売場と分離) | 仕入先への引渡しまで(週次の回収日) | `条件付き処分可`。仕入先へ引き渡し、返品日と数量を仕入ノートへ記録してから空にする。店舗で廃棄しない |
33
+ | 撤去品保留箱(バックヤード下段・黄ラベル) | `_ASSUMPTION_`: 売場から撤去した期限切れ・破損品 | 開店前の期限確認、廃棄確定 | 店舗内共有(売場・返品保管箱と分離) | 撤去した日の日次締めまで | `条件付き処分可`。店主代表が廃棄を確定し、廃棄数を日次締め記録の在庫差異欄へ記入してから廃棄する |
34
+ | レジ釣銭準備箱・手提げ金庫 | 釣銭準備金、当日の現金売上 | 開店準備、店頭販売、日次締め | 店舗内共有(閉店後は施錠) | 日次締めまで | `処分不可`。日次締めで店主代表が現金と販売額の一致を確かめ、売上金を母屋金庫へ移す |
35
+ | 仮メモ挟み(レジ横) | 仮領収メモ、つけ販売の仮メモ | 店頭販売、日次締め | 店番担当のみ(客から見えない位置) | 書いた日の日次締めまで | `条件付き処分可`。販売ノートと顧客・つけ台帳への転記を店主代表が確かめたメモだけ破棄する |
36
+ | 店頭台帳保管棚(施錠キャビネット) | 当年度の商品台帳、顧客・つけ台帳、仕入ノート、納品伝票綴り、販売ノート(販売明細欄・日次締め欄)、月次報告 | 入荷検品、つけ販売、日次締め、月次見直し | 店主代表・家族利用者代表のみ(施錠) | 当年度分。年度末に母屋書庫へ移す | `処分不可`。取引・未収金・仕入の正本記録 |
37
+ | 母屋書庫(施錠書棚) | 旧年度の台帳・ノート・伝票・月次報告 | 年度末の移管、過去の照合 | 店主代表が施錠管理(家族利用者代表は了承を得て閲覧) | 保持期間は未決。決まるまで全年度 | `処分不可`。満了分の処分も PO の承認を要する |
38
+ | 母屋金庫 | 日次締め後の売上金 | 日次締め、仕入代金の支払 | 店主代表のみ | 支払・入金まで | `処分不可`。持ち出すときは金額と用途を販売ノートの日次締め欄へ記入する |
39
+ | 外部退避媒体(`_UNDECIDED_`: SD カードか USB メモリ。手提げ金庫か母屋金庫) | `config/store-config.yaml` と `data/sales/` の日次複製 | 日次締め後の退避、消失時の復元 | 店主代表のみ | 保持世代数は未決。決まるまで全世代 | `処分不可`。上書き・消去しない |
51
40
 
52
41
  ### 2.2. 店舗タブレット内の論理保管場所
53
42
 
54
- | 保管場所 | 置くもの | 関連プロセス・操作 | 共有の有無 | 寿命・管理頻度 | 削除・処分の可否と条件 |
55
- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
56
- | 店舗設定ファイル(`config/store-config.yaml`) | 店舗・税計算・本部接続の条件 | 全 `sales` コマンドの設定解決 | 共有なし(端末ローカル。変更時と日次締め後に外部退避媒体へ複製) | 店舗運用期間中(設定変更時のみ更新) | `削除不可`。欠落すると CLI は既定設定で動き続け、店舗・税計算・本部接続の条件が既定値に変わる。破損時は「店舗設定不正」で停止する。変更は DEV が旧ファイルを退避してから行い、PO が店舗条件を確認する |
57
- | 取引セッション(`.session/current-tx.json`) | 進行中の取引の明細と確定状態 | `sales start`、`add`、`total`、`complete`、`cancel` | 共有なし(端末ローカルの実行中状態) | 取引開始から会計完了・確定前取消まで。会計が未解決なら CLI が保持する | `条件付き削除可`。会計完了・確定前取消で CLI が終了させる場合に限る。手動削除はしない(残存時は「場面別の対処と復旧手順」) |
58
- | 販売記録の控え(`data/sales/TX-YYYYMMDD-NNNN.json`) | 会計要求した現金販売の販売実績と本部の受付結果(受付済み・未受付・結果不明)。つけ販売は CLIS の対象外で、販売ノートの販売明細欄に紙で記録する | `sales complete`、本部受付との照合、日次締め | 共有なし(端末ローカル。日次締め後に外部退避媒体へ複製) | 保持期間は未決(「確認事項と変更影響」)。決定まで全件を端末と外部退避媒体に保持する | `削除不可`。本部受付との照合根拠であり、販売記録の正本の保存先が CDSD で未決のため。容量不足でも削除せず DEV・PO へ相談する |
59
- | 日次販売集計(`_ASSUMPTION_`: `data/summary/`) | 対象日・基準時点ごとの販売件数・請求合計・支払方法別内訳(派生情報)。集計元は現金販売が受付済みの `data/sales/`、つけ販売が販売ノートの販売明細欄 | 日次締め、販売訂正後の再集計 | 共有なし(端末ローカル) | 閉店後に作成し、対象日の販売訂正時に作り直す | `条件付き削除可`。再生成手順(予定 `specdojo:cop-sales-reconciliation`)の整備後で、対象日の日次締め記録が参照した値を再現できる場合に限る。整備前は削除しない |
60
- | レシート控え(`receipts/receipt-YYYYMMDD-NNNN.txt`) | 確定済み会計のレシート | `sales complete`、未印字時の確認・再印刷 | 共有なし(端末ローカル) | 月次締め確定まで | `条件付き削除可`。月次締め確定後で、未印字・照合中の取引がない場合に限る。CLIS に削除後の再出力手段はないため、削除後の照合は `data/sales/` の記録で行う |
61
- | 一時作業領域(`_ASSUMPTION_`: `tmp/`) | 保守作業の一時ファイル | DEV の保守作業 | 共有なし(端末ローカル) | 保守作業の終了まで | `削除可`。CLI と保守作業が動いていないことを確認して削除する。必要になれば作業の再実行で再作成される |
43
+ | 保管場所 | 置くもの | 関連プロセス・操作 | 共有の有無 | 寿命・管理頻度 | 削除・処分の可否と条件 |
44
+ | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------------- | -------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
45
+ | 店舗設定ファイル(`config/store-config.yaml`) | 店舗・税計算・本部接続の条件 | 全 `sales` コマンドの設定解決 | 共有なし(端末ローカル。外部退避媒体へ複製) | 店舗運用期間中 | `削除不可`。欠落すると CLI は既定設定で動き、条件が変わる。変更は DEV が旧ファイルを退避してから行い、PO が条件を確かめる |
46
+ | 取引セッション(`.session/current-tx.json`) | 進行中の取引の明細と確定状態 | `sales start`、`add`、`total`、`complete`、`cancel` | 共有なし(端末ローカル) | 取引開始から会計完了・確定前取消まで | `条件付き削除可`。CLI が終了させる場合に限る。手で消さない |
47
+ | 販売記録の控え(`data/sales/TX-YYYYMMDD-NNNN.json`) | 現金販売の販売実績と本部の受付結果(受付済み・未受付・結果不明)。つけ販売は販売ノートに紙で記録 | `sales complete`、本部受付との照合、日次締め | 共有なし(端末ローカル。外部退避媒体へ複製) | 保持期間は未決。決まるまで全件 | `削除不可`。本部受付との照合根拠で、正本の保存先も未決 |
48
+ | 日次販売集計(`_ASSUMPTION_`: `data/summary/`) | 日ごとの販売件数・請求合計・支払方法別内訳(派生情報) | 日次締め、販売訂正後の再集計 | 共有なし(端末ローカル) | 閉店後に作成し、販売訂正時に作り直す | `条件付き削除可`。再生成手順(予定 `specdojo:cop-sales-reconciliation`)が整い、日次締め記録の参照値を再現できる場合に限る |
49
+ | レシート控え(`receipts/receipt-YYYYMMDD-NNNN.txt`) | 確定済み会計のレシート | `sales complete`、未印字時の再印刷 | 共有なし(端末ローカル) | 月次締め確定まで | `条件付き削除可`。月次締め確定後で、未印字・照合中の取引がない場合に限る。再出力できないため、削除後の照合は `data/sales/` で行う |
50
+ | 一時作業領域(`_ASSUMPTION_`: `tmp/`) | 保守作業の一時ファイル | DEV の保守作業 | 共有なし(端末ローカル) | 保守作業の終了まで | `削除可`。CLI と保守作業が止まっていれば消してよい |
62
51
 
63
52
  ## 3. 削除・退避・復旧の判断基準
64
53
 
65
- ### 3.1. 削除・処分可否の3区分と運用判断
54
+ ### 3.1. 区分ごとの扱い
66
55
 
67
- | 区分 | 該当する保管場所 | 運用者(OPS・DEV)の判断基準と代替措置 |
68
- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
69
- | `削除不可` / `処分不可` | 売場棚、レジ釣銭準備箱・手提げ金庫、店頭台帳保管棚、母屋書庫、母屋金庫、外部退避媒体、`config/store-config.yaml`、`data/sales/` | 清掃や容量整理で消さない。商品は撤去品保留箱へ、旧年度の紙記録は母屋書庫へ、売上金は母屋金庫へ移す。電子記録の整理は保持期間の決定まで行わない |
70
- | `条件付き削除可` / `条件付き処分可` | 検品場所、返品保管箱、撤去品保留箱、仮メモ挟み、`.session/current-tx.json`、`data/summary/`、`receipts/` | 一覧に書いた削除前条件(記録への反映・転記、PO の確定、CLI による終了、再生成手順の整備、月次締め確定)をすべて満たした場合だけ処分・削除する |
71
- | `削除可` | `tmp/` | 保守作業の終了後に削除してよい |
56
+ - `削除不可` / `処分不可`: 清掃や容量整理で消さず、一覧に書いた移し先へ移す。電子記録は保持期間が決まるまで整理しない。
57
+ - `条件付き削除可` / `条件付き処分可`: 「保管場所一覧」の条件をすべて満たした場合だけ消す。満たせなければ残して持ち越す。
58
+ - `削除可`: 使用中の作業がなければ消す。
72
59
 
73
60
  ### 3.2. 場面別の対処と復旧手順
74
61
 
75
- | 場面 | 確認と対処手順 | 担当・エスカレーション先 |
76
- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
77
- | 会計要求前に再起動し、取引が残っている | `sales total` で残った明細を確認し、同じ取引を続けるか `sales cancel` で取り消す。`.session/current-tx.json` を手で削除しない | 店番担当。解消しなければ DEV |
78
- | 会計要求後に再起動・応答欠落し、本部の受付結果が分からない | 取消、ファイル削除、新規取引での再登録をしない。PO が本部受付と `data/sales/` の記録を照合し、受付済みなら同じ取引を回復、未受付と確認できた場合だけ送信を再開する。照合・回復手順は未整備のため、確認できない取引は保留する | OPS が会計を止めて PO・DEV へ連絡。PO が保留・回復を判断 |
79
- | `data/summary/` を誤って削除した | 再生成手順の整備後は、対象日・基準時点を指定して集計元から `data/summary/` へ出力し直す。整備前は、受付済みの `data/sales/` の現金販売(結果不明は除く)と販売ノートの販売明細欄のつけ販売を合わせて手動集計し、日次締め記録の参照値と照合する。照合者・照合日・一致結果は日次締め記録の確認結果欄へ書き、本部の受付結果とは別の証跡として残す | OPS(店主代表)が再集計、QE が一致を確認。不一致なら PO が締めを再判断 |
80
- | `config/store-config.yaml` が消失・破損した | 会計を止める。DEV が外部退避媒体の最新世代を復元し、PO が店舗・税計算・本部接続の条件を確認する。CLI が「店舗設定不正」なしで起動し、表示条件が PO の確認値と一致すれば再開する。退避がない場合、DEV は設定の構造の正本 `kinuya-store-config-schema`(CLIS の未同梱の架空参照名)が提供されているときに限りそれに従い再作成する。提供されていなければ再作成せず会計を止めたまま PO へ報告する。どちらも PO の確認まで再開しない | OPS → DEV(復元)・PO(条件確認) |
81
- | `data/sales/` が消失・破損した | 新規会計を止める。DEV が外部退避媒体の最新世代を復元し、退避後の取引を PO が販売ノート・レシート控え・本部受付と照合して欠落を特定する。QE が取引番号の連続と日次締め記録の件数を照合する。退避がなければ推測で再作成せず、照合できない日は締めを保留する | OPS → DEV(復元)・PO(照合と締め判断)・QE(一致確認) |
82
- | 売場で期限切れ・破損品を見つけた | 売場で捨てず撤去品保留箱へ移す。日次締めで店主代表が廃棄を確定し、廃棄数を在庫差異欄へ記入してから廃棄する | 店番担当(発見・移動)→ PO(廃棄確定) |
83
- | タブレットの空き容量が不足した | `tmp/` と条件を満たした `receipts/` だけを削除する。`data/sales/` と `data/summary/` は削除しない | OPS(削除)、DEV・PO(保持期間決定までの容量確保) |
62
+ | 場面 | 確認と対処 | 担当・連絡先 |
63
+ | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
64
+ | 会計要求前に再起動し、取引が残っている | `sales total` で明細を確かめ、続けるか `sales cancel` で取り消す | 店番担当。解消しなければ DEV |
65
+ | 会計要求後に再起動・応答欠落し、本部の受付結果が分からない | 取消・ファイル削除・再登録をしない。PO が本部受付と `data/sales/` を照合し、受付済みなら同じ取引を回復し、未受付と確かめた場合だけ送信を再開する。照合・回復手順が整うまで、確かめられない取引は保留する | OPS が会計を止めて PO・DEV へ連絡。PO が判断 |
66
+ | `data/summary/` を誤って削除した | 再生成手順が整うまでは、受付済みの `data/sales/` の現金販売(結果不明を除く)と販売ノートのつけ販売を手で集計し、日次締め記録の参照値と照合する。照合者・照合日・結果は本部の受付結果と別に日次締め記録へ書く | OPS(店主代表)が再集計、QE が一致を確認。不一致なら PO が締めを再判断 |
67
+ | `config/store-config.yaml` が消失・破損した | 会計を止める。DEV が外部退避媒体の最新世代を復元する。退避がなければ、構造の正本 `kinuya-store-config-schema`(CLIS の未同梱の参照名)がある場合に限り作り直し、なければ PO へ報告する。PO が条件を確かめるまで再開しない | OPS → DEV(復元)・PO(条件確認) |
68
+ | `data/sales/` が消失・破損した | 新規会計を止める。DEV が最新世代を復元し、退避後の取引を PO が販売ノート・レシート控え・本部受付と照合し、QE が取引番号の連続と日次締め記録の件数を照合する。退避がなければ推測で作り直さず、照合できない日の締めを保留する | OPS → DEV(復元)・PO(照合と締め)・QE(一致確認) |
69
+ | 売場で期限切れ・破損品を見つけた | 売場で捨てず撤去品保留箱へ移す | 店番担当(移動)→ PO(廃棄確定) |
70
+ | タブレットの空き容量が不足した | `tmp/` と条件を満たした `receipts/` だけを消す | OPS(削除)、DEV・PO(保持期間が決まるまでの容量確保) |
84
71
 
85
72
  ## 4. 関連仕様・実装配置との対応と検証
86
73
 
87
- ### 4.1. 概念データストア・関連仕様との対応
74
+ ### 4.1. 隣接仕様との分担と対応
88
75
 
89
- | 保管場所 | 対応する概念データストア・関連仕様 | 整合確認のポイント |
90
- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
91
- | 検品場所、売場棚、返品保管箱 | [[specdojo:stsd-sample\|商品のステータス定義]] の入荷済み(`received`)・検品済み(`inspected`)は検品場所、販売可能(`sellable`)は売場棚、返品待ち(`return-pending`)は返品保管箱 | 販売可能な商品だけが売場棚にあり、受入不可品が売場に混在しないこと |
92
- | 撤去品保留箱 | STSD に対応状態なし(変更要求候補) | 来店客へ渡す前に売場から撤去した未販売の期限切れ・破損品を、返品待ち(`return-pending`)と混同しないこと |
93
- | 店頭台帳保管棚、母屋書庫 | [[specdojo:cdsd-sample\|概念データストア定義(駄菓子屋きぬやの販売と締め)]] の商品台帳・販売記録・日次締め記録・月次報告、[[specdojo:cdfd-overview-sample\|概念データフロー図(全体概要)]] の仕入記録(仕入ノート)と顧客・つけ台帳 | 紙の正本が年度で二か所に分かれても欠落せず、顧客・つけ台帳が施錠保管されること |
94
- | `config/store-config.yaml`、`.session/current-tx.json`、`receipts/` | [[specdojo:clis-sample\|駄菓子屋きぬや 販売管理 CLI 仕様]] の入力情報・出力と副作用 | 欠落・破損時の CLI の挙動と本書の削除可否・復旧経路が矛盾しないこと |
95
- | `data/sales/` | CLIS の販売実績のローカル控え、CDSD の販売記録 | CDSD の販売記録に当たるのは会計確定・受付確認済みの取引だけで、結果不明の取引は照合待ちとして区別されること |
96
- | `data/summary/` | CDSD の日次販売集計(派生情報・保存形式未確定) | 仮置きのパスであることと、集計元が現金販売は受付確認済みの `data/sales/`、つけ販売は販売ノートの販売明細欄であることが明示されていること |
76
+ | 隣接仕様 | 定義するものと対応する保管場所 |
77
+ | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
78
+ | [[specdojo:cdsd-sample\|概念データストア定義(駄菓子屋きぬやの販売と締め)]] | 管理単位と正本区分・更新責務。商品台帳・販売記録・日次締め記録・月次報告は店頭台帳保管棚と母屋書庫、販売記録は `data/sales/`(結果不明の取引は照合待ち)、日次販売集計(保存形式未確定)は `data/summary/` |
79
+ | [[specdojo:cdfd-overview-sample\|概念データフロー図(全体概要)]] | 仕入記録(仕入ノート)と顧客・つけ台帳は店頭台帳保管棚と母屋書庫 |
80
+ | [[specdojo:stsd-sample\|商品のステータス定義]] | 商品の状態と遷移。入荷済み(`received`)・検品済み(`inspected`)は検品場所、販売可能(`sellable`)は売場棚、返品待ち(`return-pending`)は返品保管箱。撤去品保留箱に当たる状態はない |
81
+ | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] | 商品・売上記録・売上明細の項目。本書は項目を再掲しない |
82
+ | [[specdojo:clis-sample\|駄菓子屋きぬや 販売管理 CLI 仕様]] | コマンドと入出力ファイル(`config/`、`.session/`、`data/sales/`、`receipts/`)の作成・停止条件 |
97
83
 
98
84
  ### 4.2. 検証手順と受入条件
99
85
 
100
- | 検証観点(ロール) | 確認内容・手順 | 合格条件 |
101
- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
102
- | `[ARC・DEV]` 実装配置・CLI 仕様との一致 | タブレット内の各パスと役割を [[specdojo:clis-sample\|駄菓子屋きぬや 販売管理 CLI 仕様]] と照合する | CLIS にないパスに `_ASSUMPTION_` が付き、進行中セッションと販売記録の控えが別ファイルであること |
103
- | `[DEV・QE]` 設定ファイル欠落・破損 | 検証用端末で `config/store-config.yaml` を外して `sales start` を実行し、次に破損させて実行する | 欠落時は既定設定で起動し、破損時は「店舗設定不正」(終了コード `4`)で停止する。どちらも削除可否の記述と矛盾しない |
104
- | `[DEV・QE]` 受付結果不明の取引 | 本部の応答を欠落させて `sales complete` を実行し、続けて `sales cancel` を試す | `.session/current-tx.json` と `data/sales/` に結果不明として残り、取消は終了コード `2` で拒否される |
105
- | `[OPS・QE]` 日次集計の再集計 | CDSD の照合例のうち現金販売108円を受付済みの `data/sales/` に、つけ販売216円を販売ノートの販売明細欄に用意し、結果不明の現金取引1件を加える。`data/summary/` を消して「場面別の対処と復旧手順」に従い作り直す | 販売2件・請求合計324円で元の売上IDの集合と一致し、結果不明の取引を含まない。照合の証跡が本部の受付結果と別に日次締め記録へ残る |
106
- | `[BA]` 業務要求・データストアの網羅 | CDSD の5管理単位、全体概要の仕入記録・在庫記録、STSD の全状態と本書の一覧を照合する | 保管場所のない記録・状態が「確認事項と変更影響」で追跡されていること |
107
- | `[OPS]` 削除可否・復旧判断の実効性 | 「保管場所一覧」と「削除・退避・復旧の判断基準」を用い、清掃・障害復旧・容量整理・返品の判断を模擬する | 店主代表と店番担当が、消してよい場所、削除前条件、消失時の復旧経路と連絡先を迷わず判断できること |
108
- | `[QE]` 文書品質・整合性検証 | 標準6列・必須章、章見出しの末尾ピリオド、wikilink の解決を確認し、整形・lint を実行する | `npx prettier --write`、`npm run lint:md`、`npm run lint:fm` がエラー0件で通過すること |
86
+ | 観点 | 手順 | 合格条件 |
87
+ | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
88
+ | CLI 仕様との一致 | タブレット内の各パスと役割を CLIS と照合する | CLIS にないパスに `_ASSUMPTION_` が付き、取引セッションと販売記録の控えが別ファイルである |
89
+ | 設定ファイルの欠落・破損 | 検証用端末で `config/store-config.yaml` を外して `sales start` を実行し、次に壊して実行する | 欠落時は既定設定で起動し、破損時は「店舗設定不正」(終了コード `4`)で停止する |
90
+ | 受付結果不明の取引 | 本部の応答を欠落させて `sales complete` を実行し、続けて `sales cancel` を試す | `.session/current-tx.json` と `data/sales/` に結果不明として残り、取消は終了コード `2` で拒否される |
91
+ | 日次集計の再集計 | CDSD の照合例の現金販売108円を受付済みの `data/sales/` に、つけ販売216円を販売ノートに用意し、結果不明の現金取引1件を加える。`data/summary/` を消して場面別の対処で作り直す | 販売2件・請求合計324円で元の売上IDの集合と一致し、結果不明の取引を含まない |
92
+ | 記録・状態の網羅 | CDSD の5管理単位、全体概要の仕入記録・在庫記録、STSD の全状態を一覧と照合する | 保管場所のない記録・状態が「確認事項と変更影響」にある。紙の正本が年度で二か所に分かれても欠落せず、受入不可品・撤去品が売場や返品待ちと混ざらない |
93
+ | 削除・復旧判断の実効性 | 清掃・障害復旧・容量整理・返品の判断を本書で模擬する | 消してよい場所、削除前の条件、復旧の経路と連絡先を迷わず判断できる |
109
94
 
110
95
  ## 5. 確認事項と変更影響
111
96
 
112
- | 論点 | 管理台帳の区分 | 現在の判断・影響 | 担当・判断時期・次の行動 | 追跡先候補 |
113
- | ------------------------------------------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
114
- | 外部退避媒体の種類・保管先・保持世代数 | 決定事項(`decision`) | `_UNDECIDED_`: 媒体(SD カード・USB メモリ)と保管先(手提げ金庫・母屋金庫)と世代数が未定。決定まで全世代を保持する | OPS・DEV が候補と複製手順を整理し、運用開始前に PO が決める | `specdojo:pjr-sales-backup` |
115
- | 販売記録の正本保存先と電子・紙記録の保持期間 | 決定事項(`decision`) | `_UNDECIDED_`: CDSD でシステム化後の保存・保持方式が未決。決定まで `data/sales/` と母屋書庫の記録を処分しない | ARC が正本保持の案、OPS が容量・保管の影響を整理し、運用開始前に PO が決める | `specdojo:pjr-sales-storage` |
116
- | 日次集計の保存先と再生成手順が未整備 | 課題(`issue`) | `data/summary/` は仮置きで、再生成手順がないため削除後に自動で戻せない | OPS・DEV が `specdojo:cop-sales-reconciliation` を店頭試用の開始前までに整備し、QE が再集計の受入条件を確認する。整備までは手動再集計で扱い、試用開始の判断時に未整備なら PM が期限を見直して PO へ諮る | `specdojo:pjr-sales-storage` |
117
- | 本部との受付照会・重複排除・回復の契約が未整備 | リスク(`risk`) | CLIS の照合・回復手順が未確定で、結果不明の取引を誤って取消・再登録すると二重登録や照合根拠の消失が起こり得る | ARC・DEV が連携契約と回復手順を整え、QE が受付済み・未受付・応答欠落の期待結果を確認する。運用開始前に PO が保留運用を確認する | `specdojo:pjr-hq-sales-contract` |
118
- | 仕入記録・在庫記録のシステム化後の保管先 | 決定事項(`decision`) | `_UNDECIDED_`: 仕入記録は仕入ノート、在庫記録は保管場所なし(店主の記憶)。決定時に「保管場所一覧」へ行を追加する | BA が業務要件を整理し、ARC・DEV が保存先案を示して、在庫管理の設計着手前に PO が決める | `specdojo:pjr-purchase-inventory-storage` |
119
- | 撤去品保留箱に対応する商品状態が STSD にない | 変更要求(`change-request`) | 来店客へ渡す前に売場から撤去した未販売の期限切れ・破損品の状態と遷移が未定義。本書の撤去品保留箱は仮置き | BA が STSD への状態追加案を作り、OPS が廃棄手順を確認して、在庫管理の設計着手前に PO が承認する。承認まで本書の仮置きで運用する | `specdojo:pjr-stsd-removed-goods` |
120
- | 紙の台帳・締め記録をタブレットへ完全移行する場合 | 変更要求(`change-request`) | 店頭台帳保管棚・母屋書庫の正本区分、`data/` 配下の構成、外部退避の対象、日次集計の再集計元、本部照合に使う紙記録、「検証手順と受入条件」の検証項目が変わる | BA が CDSD の正本区分を、ARC・DEV が保存パスと再集計手順を、OPS が退避・照合手順を、QE が受入条件を改訂する。PO が移行前に承認する | `specdojo:pjr-paper-to-tablet` |
121
-
122
- PM は各行を区分どおりの管理台帳の種別で登録し、担当と判断時期を Schedule へ接続する。
123
-
124
- 公開および `status: ready` への昇格前に、BA・ARC・DEV・OPS・QE が受入条件を確認し、人間の PO(店主代表)が顧客情報の施錠保管と上表の未決事項の扱いを承認する。照合・回復契約と日次集計の再生成手順が整備されるまで、受付結果不明の取引の回復と日次集計の自動再生成は保留中の手順として扱い、それらに依存する運用開始を承認しない。agent は `status: draft` を維持する。
97
+ | 論点 | 影響と当面の扱い |
98
+ | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
99
+ | `_UNDECIDED_`: 外部退避媒体の種類・保管先・保持世代数 | 決まるまで全世代を保持する |
100
+ | `_UNDECIDED_`: 販売記録の正本保存先と電子・紙記録の保持期間(CDSD で未決) | 決まるまで `data/sales/` と母屋書庫の記録を処分しない |
101
+ | 日次集計の再生成手順(`specdojo:cop-sales-reconciliation`)が未整備 | 整うまで `data/summary/` を削除できない |
102
+ | 本部との受付照会・重複排除・回復の契約が未整備 | 誤った取消・再登録で二重登録や照合根拠の消失が起こる。回復と日次集計の自動再生成に依存する運用は始めない |
103
+ | `_UNDECIDED_`: 仕入記録・在庫記録のシステム化後の保管先 | 在庫記録は今は保管場所がない。決まったら「保管場所一覧」へ行を足す |
104
+ | 撤去品保留箱に当たる商品状態が STSD にない | 撤去品保留箱は仮置きで運用する。STSD に状態が足されたら対応を見直す |
105
+ | 紙の台帳・締め記録をタブレットへ完全移行する場合 | 正本区分、`data/` の構成、外部退避の対象、日次集計の再集計元、本部照合に使う記録、検証項目が変わる |