specdojo 0.8.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 (284) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +64 -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/where.js +25 -0
  9. package/dist/dashboard/dashboard.js +5 -3
  10. package/dist/dashboard/routines.js +4 -7
  11. package/dist/dashboard/timeline.js +14 -14
  12. package/dist/docs/index-command.js +2 -2
  13. package/dist/docs/yaml-business-tables.js +243 -0
  14. package/dist/docs/yaml-interface-tables.js +106 -0
  15. package/dist/docs/yaml-pages-command.js +5 -3
  16. package/dist/docs/yaml-pages.js +146 -3
  17. package/dist/docs/yaml-table-shared.js +70 -0
  18. package/dist/docs/yaml-tables.js +39 -0
  19. package/dist/exec/agent-config.js +9 -0
  20. package/dist/exec/agent-protected-config.js +2 -0
  21. package/dist/exec/commands.js +31 -18
  22. package/dist/exec/events.js +34 -14
  23. package/dist/exec/evidence.js +13 -3
  24. package/dist/exec/parent-validation.js +56 -3
  25. package/dist/exec/plans-core.js +21 -2
  26. package/dist/exec/plans-generation.js +6 -7
  27. package/dist/exec/post-integration.js +162 -0
  28. package/dist/exec/queue-command.js +166 -0
  29. package/dist/exec/queue.js +285 -0
  30. package/dist/exec/register-foreign-wait.js +84 -0
  31. package/dist/exec/repo-integration-sync.js +17 -5
  32. package/dist/exec/reporter.js +2 -2
  33. package/dist/exec/results.js +24 -4
  34. package/dist/exec/review-kata.js +4 -1
  35. package/dist/exec/run/agent-pipeline.js +3 -2
  36. package/dist/exec/run/agent.js +12 -6
  37. package/dist/exec/run/change-scope.js +365 -0
  38. package/dist/exec/run/deferred-cleanup.js +31 -0
  39. package/dist/exec/run/in-place.js +4 -1
  40. package/dist/exec/run/job-lock.js +66 -0
  41. package/dist/exec/run/job-sequence.js +137 -0
  42. package/dist/exec/run/job.js +56 -19
  43. package/dist/exec/run/lifecycle-commands.js +1 -1
  44. package/dist/exec/run/lock.js +22 -1
  45. package/dist/exec/run/register-command.js +8 -5
  46. package/dist/exec/run/register-mode.js +68 -8
  47. package/dist/exec/run/register-resume.js +68 -14
  48. package/dist/exec/run/register-state.js +13 -8
  49. package/dist/exec/run/register-worktree.js +140 -125
  50. package/dist/exec/run/schedule-mode.js +75 -14
  51. package/dist/exec/run/schedule-prepare.js +3 -0
  52. package/dist/exec/run/schedule-task.js +88 -38
  53. package/dist/exec/run/shared.js +5 -0
  54. package/dist/exec/schedule/schedule.js +116 -4
  55. package/dist/exec/shared.js +1 -1
  56. package/dist/exec/smoke.js +190 -0
  57. package/dist/exec/strategy.js +13 -3
  58. package/dist/exec/task-view.js +6 -4
  59. package/dist/exec/trial-commands.js +5 -2
  60. package/dist/exec/trial-core.js +6 -1
  61. package/dist/exec/validation-metrics.js +181 -0
  62. package/dist/exec/worktree-cleanup-lock.js +26 -0
  63. package/dist/exec/worktree-command.js +9 -1
  64. package/dist/exec/worktree-ops-commit.js +2 -2
  65. package/dist/exec/worktree.js +13 -2
  66. package/dist/grade/command-apply.js +3 -3
  67. package/dist/grade/command-inspect.js +5 -3
  68. package/dist/grade/command-plan.js +1 -1
  69. package/dist/grade/command-run.js +5 -1
  70. package/dist/grade/run.js +64 -8
  71. package/dist/job/definition.js +84 -8
  72. package/dist/job/job.js +79 -23
  73. package/dist/register/authoring-sources.js +22 -16
  74. package/dist/register/maintenance-commands.js +2 -2
  75. package/dist/register/register.js +31 -7
  76. package/dist/routine/definition.js +9 -0
  77. package/dist/routine/routine.js +137 -43
  78. package/dist/routine/status.js +62 -0
  79. package/dist/schedule/schedule.js +38 -39
  80. package/dist/shared/agent-types.js +5 -0
  81. package/dist/shared/cross-process-lock.js +9 -1
  82. package/dist/shared/dist-freshness.js +8 -2
  83. package/dist/shared/git-environment.js +2 -1
  84. package/dist/shared/git.js +44 -1
  85. package/dist/shared/lefthook-scaffold.js +3 -0
  86. package/dist/shared/local-config.js +244 -0
  87. package/dist/shared/specdojo-config.js +34 -20
  88. package/dist/shared/specdojo-gitignore.js +1 -0
  89. package/dist/shared/text.js +9 -1
  90. package/dist/shared/where-alias.js +13 -0
  91. package/dist/specdojo.js +4 -0
  92. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  93. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  94. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  95. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  96. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  97. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  98. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  99. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  100. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  101. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  102. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  103. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  104. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  105. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  106. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  107. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  108. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  109. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  110. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  111. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  112. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  113. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  114. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  115. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  116. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  117. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  118. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  119. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  120. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  121. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  122. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  123. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  124. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  125. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  126. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  127. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  128. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  129. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  130. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  131. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  132. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  133. package/docs/ja/specdojo/references/command-reference.md +257 -117
  134. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  135. package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
  136. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  137. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  138. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  139. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  140. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  141. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  142. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  143. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  144. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  145. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  146. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  147. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  148. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  149. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  150. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  151. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  152. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  153. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  154. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  155. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  156. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  157. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  158. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  159. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  160. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  161. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  162. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  163. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  164. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  165. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  166. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  167. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  168. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  169. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  170. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  171. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  172. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  173. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  174. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  175. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  176. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  177. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  178. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  179. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  180. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  181. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  182. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  183. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  184. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  185. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  186. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  187. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  188. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  189. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  190. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  191. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  192. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  193. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  194. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  195. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  196. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  197. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  198. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  199. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  200. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  201. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  202. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  203. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  204. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  205. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  206. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  207. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  208. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  209. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  210. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  211. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  212. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  213. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  214. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  215. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  216. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  217. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  218. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  219. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  220. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  221. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  222. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  223. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  224. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  225. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  226. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  227. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  228. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  229. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  230. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  231. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  232. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  233. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  234. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  235. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  236. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  237. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  238. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  239. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  240. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  241. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  242. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  243. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  244. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  245. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  246. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  247. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  248. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  249. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  250. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  251. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  252. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  253. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  254. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  255. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  256. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  257. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  258. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  259. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  260. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  261. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  262. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  263. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  264. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  265. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  266. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  267. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  268. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  269. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  270. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  271. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  272. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  273. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  274. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  275. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  276. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  277. package/package.json +9 -6
  278. package/templates/antigravity/orchestrator.md +4 -1
  279. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  280. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  281. package/templates/codex/orchestrator.md +4 -1
  282. package/templates/init-exec-defaults.yaml +13 -0
  283. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  284. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -8,84 +8,72 @@ specdojo:
8
8
 
9
9
  # 補充依頼確定
10
10
 
11
- 在庫が補充基準を下回ったことを受け、店主代表が補充対象と依頼数量を判断し、仕入グループへ渡す補充依頼を確定する。
11
+ 在庫の補充基準割れを受け、店主代表が補充対象と依頼数量を決め、確定した補充依頼を仕入グループへ渡す。
12
12
 
13
13
  ## 1. 概要
14
14
 
15
- - 業務目的: 人気商品の欠品を減らすため、現在庫と商品ごとの補充基準から仕入れが必要な商品と依頼数量を確定する。
15
+ - 業務目的: 単一店舗で人気商品の欠品を減らす。
16
16
  - プロセス領域: 在庫グループの補充判断(`P-06`)
17
- - 対象者: 店主代表は補充判断を承認し、開発担当と同行レビュー担当は判断条件と業務成果を後続設計・レビューに利用する。
17
+ - 対象者: 店主代表(判断)、開発担当と同行レビュー担当(後続設計・レビュー)
18
18
  - 主担当: 店主代表
19
- - 開始点: 販売または入荷を反映した現在庫が確定し、補充基準割れを検出した時点
20
- - 終了点: 補充依頼が仕入グループへ引き渡され、参照可能になった時点、または補充不要が記録された時点
21
- - 対象外: 仕入先の決定、発注内容の承認・送付、入荷検品、売場補充
22
-
23
- 本書は単一店舗の日常的な補充判断を扱う。発注から入荷、売場補充までのグループ横断順序は `cdfd-uc-replenishment`、仕入グループ内の処理は `cdfd-purchasing` を正本とする。
19
+ - 開始点: `T-01` の受領時点
20
+ - 終了点: 「出力」のいずれかが確定した時点
21
+ - 対象外: 仕入先の決定、発注の承認・送付、入荷検品、売場補充。グループ横断の順序は `cdfd-uc-replenishment`、仕入グループ内は `cdfd-purchasing` が正本
24
22
 
25
23
  ## 2. トリガー
26
24
 
27
- | トリガー ID | 出来事 | 発生元 | 受領情報 | 開始条件 | 不成立時の扱い |
28
- | ----------- | -------------------------- | ---------------- | -------------------------------- | ------------------------------------------------------ | -------------- |
29
- | `T-01` | 現在庫が補充基準を下回った | 在庫確認プロセス | 商品、現在庫、補充基準、確認時刻 | 在庫確認プロセスから対象商品と現在庫が引き渡されている | 起動しない |
30
-
31
- トリガーは在庫確認プロセスの判定結果であり、在庫記録の物理的な更新方式には依存しない。
25
+ | トリガー ID | 出来事 | 発生元 | 受領情報 | 開始条件 | 不成立時の扱い |
26
+ | ----------- | -------------------------- | ---------------- | -------------------------------- | -------------------------- | -------------- |
27
+ | `T-01` | 現在庫が補充基準を下回った | 在庫確認プロセス | 商品、現在庫、補充基準、確認時刻 | 対象商品と現在庫を受領済み | 起動しない |
32
28
 
33
29
  ## 3. 前提条件
34
30
 
35
- - 店主代表が補充要否と依頼数量を最終判断できる。家族利用者代表が検出した場合も、補充依頼の確定は店主代表が行う。
36
- - 数量に関する用語の関係は以下の通りとする。
37
- - 補充基準: 補充が必要か判定するための閾値。現在庫がこれを下回ると補充要となる。
38
- - 補充必要数: `br-reorder-point` が判定する、補充に必要な数量。算出方法は `br-reorder-point` を正本とする。
39
- - 依頼数量: 補充必要数を発注単位に合わせて調整し、仕入グループへ依頼する最終的な数量。
40
- - 発注単位: 仕入先が指定する、発注可能な最小の数量単位。
31
+ - 店主代表が補充要否と依頼数量を判断できる(家族利用者代表の検出時も確定は店主代表)。判断できない間は起動せず、トリガーを保留する。
32
+ - 依頼数量は、`br-reorder-point` が判定する補充必要数を発注単位(仕入先が定める最小の発注数量)に合わせた数量とする。
41
33
 
42
34
  ## 4. 入力
43
35
 
44
- | 入力 | 入手元 | 利用目的 | 必須 | 正本 |
45
- | ------------ | ------------------ | ------------------------------------------------ | ---- | ------------------ |
46
- | 対象商品 | 商品台帳 | 販売状態、継続取扱、補充基準、発注単位を確認する | ○ | 商品台帳 |
47
- | 現在庫 | 在庫記録 | 補充基準との差と補充必要数を確認する | ○ | 在庫記録 |
48
- | 未完了依頼 | 補充依頼 | 同じ商品への重複依頼を防ぐ | ○ | 補充依頼 |
49
- | 補充判断基準 | `br-reorder-point` | 補充要否と補充必要数を同じ規則で判定する | ○ | `br-reorder-point` |
50
-
51
- 商品台帳、在庫記録、補充依頼は論理的な正本名であり、保存先や物理項目は本書では定めない。
36
+ | 入力 | 入手元 | 利用目的 | 必須 | 正本 |
37
+ | ------------ | ------------------ | -------------------------------------- | ---- | ------------------ |
38
+ | 対象商品 | 商品台帳 | 販売状態、継続取扱、補充基準、発注単位 | ○ | 商品台帳 |
39
+ | 現在庫 | 在庫記録 | 補充基準との差と補充必要数 | ○ | 在庫記録 |
40
+ | 未完了依頼 | 補充依頼 | 同じ商品への重複依頼の防止 | ○ | 補充依頼 |
41
+ | 補充判断基準 | `br-reorder-point` | 要否と補充必要数の判定規則 | ○ | `br-reorder-point` |
52
42
 
53
43
  ## 5. 処理
54
44
 
55
- | ステップ ID | CDFD プロセス | 担当 | 入力 | 活動・判断 | 出力・完了条件 | 例外 |
56
- | ----------- | ------------- | -------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -------------- |
57
- | `S-01` | `P-06` | 店主代表 | 対象商品、現在庫 | 販売状態、継続取扱、発注単位を確認し、補充判断の対象可否を決める | 補充判断の対象または補充不要のいずれかが理由付きで確定している | `E-01` |
58
- | `S-02` | `P-06` | 店主代表 | 現在庫、補充基準、未完了依頼、発注単位 | `br-reorder-point` により補充要否と補充必要数を判定し、発注単位に合わせて依頼数量を算出する。未完了依頼との重複も確認する | 補充要否、依頼数量、重複有無を確認できる | `E-02`, `E-04` |
59
- | `S-03` | `P-06` | 店主代表 | 補充要の判定結果 | 補充対象と依頼数量を確認し、判断根拠を添えて補充依頼を承認(確定)する | 商品、依頼数量、判断根拠、承認者、承認時刻を持つ補充依頼が確定している | `E-03` |
60
- | `S-04` | `P-06` | 店主代表 | 確定した補充依頼 | 仕入グループへ確定した補充依頼を引き渡す(共有する) | 補充依頼が仕入グループへ引き渡され、参照可能な状態になる | `E-03` |
45
+ | ステップ ID | CDFD プロセス | 担当 | 入力 | 活動・判断 | 出力・完了条件 | 例外 |
46
+ | ----------- | ------------- | -------- | ---------------------------- | ------------------------------------------------------------------- | -------------------------------------------- | -------------- |
47
+ | `S-01` | `P-06` | 店主代表 | 対象商品、現在庫 | 販売状態と継続取扱から補充判断の対象かを決める | 対象または補充不要が理由付きで確定 | `E-01` |
48
+ | `S-02` | `P-06` | 店主代表 | 対象商品、現在庫、未完了依頼 | `br-reorder-point` で判定時点の要否と依頼数量を決め、重複を確認する | 補充要否、依頼数量、重複有無が確定 | `E-02`、`E-04` |
49
+ | `S-03` | `P-06` | 店主代表 | 補充要の判定結果 | 判断根拠を添えて補充依頼を承認する | 商品、数量、根拠、承認者、承認時刻付きで確定 | `E-03` |
50
+ | `S-04` | `P-06` | 店主代表 | 確定した補充依頼 | 仕入グループへ引き渡す | 仕入グループが参照できる | `E-05` |
61
51
 
62
- `S-01` または `S-02` で補充不要と判断した場合は `S-03` と `S-04` を起動せず、対象商品、判断根拠、確認時刻を補充不要記録として確定して終了する。
52
+ 補充不要と判断した場合は `S-03` と `S-04` を行わず、補充不要記録を確定して終了する。
63
53
 
64
54
  ## 6. 出力
65
55
 
66
- | 出力 | 受け手 | 確定条件 | 正本 | 後続処理 |
67
- | ------------ | ------------ | ---------------------------------------------------------------------- | -------- | ------------------------------ |
68
- | 補充依頼 | 仕入グループ | 商品、依頼数量、判断根拠、店主代表の承認、承認時刻を確認できる | 補充依頼 | `P-01-01` 発注内容確定 |
69
- | 補充不要記録 | 店主代表 | 対象商品、補充不要理由、確認時刻を確認でき、補充依頼が作成されていない | 在庫記録 | 次回の販売または入荷後に再判定 |
70
-
71
- 補充依頼は `cdfd-uc-replenishment` の引き渡し `H-01` で仕入グループへ渡す情報に対応する。
56
+ | 出力 | 受け手 | 確定条件 | 正本 | 後続処理 |
57
+ | ------------ | ------------ | ------------------------------------------ | -------- | ---------------------------------- |
58
+ | 補充依頼 | 仕入グループ | `S-03` の完了条件を満たす | 補充依頼 | `H-01` で `P-01-01` 発注内容確定へ |
59
+ | 補充不要記録 | 店主代表 | 対象商品、理由、確認時刻があり、依頼がない | 在庫記録 | 次回の販売・入荷後に再判定 |
60
+ | 重複不要記録 | 店主代表 | 対象商品、既存依頼、理由、確認時刻がある | 補充依頼 | 既存依頼の処理を続ける |
72
61
 
73
62
  ## 7. 例外・代替経路
74
63
 
75
- | 例外 ID | 対象ステップ | 検出条件 | 停止範囲 | 担当 | 処置 | 再開条件・代替成果 |
76
- | ------- | -------------- | ------------------------------------------------------------ | -------------------- | -------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------- |
77
- | `E-01` | `S-01` | 商品、現在庫、補充基準、発注単位のいずれかが不明 | 補充要否の判定以降 | 店主代表 | 不足項目と対象商品を記録し、商品台帳または在庫記録の確認を依頼する | 不足項目が補完され、同じ発注単位で確認できた後に `S-01` から再開する |
78
- | `E-02` | `S-02` | 同じ商品に未完了の補充依頼がある | 新しい補充依頼の確定 | 店主代表 | 既存依頼へ依頼数量を反映するか、新規依頼を作らないかを判断して記録する | 既存依頼を更新して再承認するか、重複不要の記録を代替成果として終了する |
79
- | `E-03` | `S-03`、`S-04` | 判断根拠を記録できない、または仕入グループへ引き渡しできない | 補充依頼の引き渡し | 店主代表 | 補充依頼を非確定・未受領状態のまま保留し、状況を記録する | 判断根拠を確認するか引き渡し可能になった後に再開する |
80
- | `E-04` | `S-02` | 未完了依頼を取得できない | 補充要否の判定以降 | 店主代表 | 処理を中断し、未完了依頼の取得失敗を記録する | 未完了依頼が取得可能になった後に `S-02` から再開する |
64
+ | 例外 ID | 対象ステップ | 検出条件 | 停止範囲 | 担当 | 処置 | 再開条件・代替成果 |
65
+ | ------- | ------------ | -------------------------- | -------------- | -------- | ---------------------------------------------- | -------------------------------- |
66
+ | `E-01` | `S-01` | 「入力」の必須項目が不明 | `S-01` 以降 | 店主代表 | 不足項目、対象商品、確認依頼先を保留記録に残す | 補完後に `S-01` から再開 |
67
+ | `E-02` | `S-02` | 同じ商品に未完了依頼がある | 新規依頼の確定 | 店主代表 | 既存依頼へ数量を反映するか決める | 再承認、または重複不要記録で終了 |
68
+ | `E-03` | `S-03` | 判断根拠を記録できない | 確定以降 | 店主代表 | 補充依頼を確定せず、状況を保留記録に残す | 根拠の確認後に `S-03` から再開 |
69
+ | `E-04` | `S-02` | 未完了依頼を取得できない | `S-02` 以降 | 店主代表 | 中断し、取得失敗を保留記録に残す | 取得後に `S-02` から再開 |
70
+ | `E-05` | `S-04` | 仕入グループへ引き渡せない | 引き渡し | 店主代表 | 確定済み・未受領のまま状況を保留記録に残す | 可能になり次第 `S-04` から再開 |
81
71
 
82
72
  ## 8. 検証・受入観点
83
73
 
84
- | 観点 | 入力条件 | 期待する業務成果 | 確認可能な記録 |
85
- | -------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | -------------------------- |
86
- | 補充が必要 | 販売中の商品で、現在庫が補充基準を下回る | 店主代表が承認した補充依頼が一件確定し、仕入グループが商品と依頼数量を確認できる | 補充依頼、承認記録 |
87
- | 補充が不要 | 現在庫が補充基準以上、または販売停止・終売である | 補充依頼を作らず、対象商品と補充不要理由が記録される | 在庫記録の補充不要記録 |
88
- | 既存依頼と重複 | 同じ商品に未完了の補充依頼がある | 二重の補充依頼を作らず、既存依頼の更新または重複不要の判断を確認できる | 既存補充依頼、重複確認記録 |
89
- | 重複確認不能 | 未完了依頼を取得できない状態である | 処理を中断し、二重の補充依頼を作らずに未完了依頼の取得失敗が記録される | 保留記録 |
90
- | 判断情報が不足 | 商品、現在庫、補充基準、発注単位のいずれかが不明 | 補充依頼を確定せず、不足項目、確認担当、再開対象の商品が記録される | 保留記録 |
91
- | 確定・引渡失敗 | 判断根拠が記録できない、または引き渡しできない状態である | 補充依頼を非確定・未受領状態のまま保留し、保留記録から状況を確認できる。再開後に承認・受領された補充依頼を確認できる | 保留記録、補充依頼 |
74
+ | 観点 | 入力条件 | 期待する業務成果 | 確認可能な記録 |
75
+ | -------------- | -------------------------------------- | -------------------------------------------- | ---------------------- |
76
+ | 補充が必要 | 販売中、基準割れ、未完了依頼なし | 承認済みの補充依頼が一件、仕入グループに渡る | 補充依頼 |
77
+ | 補充が不要 | 販売停止・終売、または判定時に基準以上 | 補充依頼がなく、補充不要理由が残る | 補充不要記録 |
78
+ | 既存依頼と重複 | `E-02` の検出条件 | 新規依頼なし。再承認か重複不要記録がある | 補充依頼、重複不要記録 |
79
+ | 保留と再開 | `E-01`、`E-03`〜`E-05` の検出条件 | 処置の記録が残り、再開後に補充依頼へ至る | 保留記録、補充依頼 |
@@ -8,24 +8,21 @@ specdojo:
8
8
 
9
9
  # 駄菓子屋きぬや 在庫不足判定
10
10
 
11
- 在庫確認の対象商品について、予約分を差し引いた販売可能数が発注点を下回るかを判定する。
12
-
13
11
  ## 1. 概要
14
12
 
15
- - 業務価値: 店主代表以外の人が店番するときも、同じ在庫から同じ不足判定を得て、人気商品の欠品に気付けるようにする。
16
- - 利用者・適用場面: 店主代表または家族利用者代表が在庫を確認するとき、商品ごとの現在の在庫数・予約数・発注点がそろった時点で使う。
17
- - 適用範囲: 単一店舗の商品 1 種類に対する、同一の確認時点の個数の比較。在庫数は店舗が保有する総数で、予約分を含む。予約分は店頭で自由に販売できる数量から除く。
18
- - 本完成例では、個数を 0 以上の整数とし、比較時点と商品が一致する入力を前提とする。値は学習用であり、実店舗の設定値ではない。
19
- - 対象外: 発注点の決め方、発注量、仕入れ先、発注承認、在庫の更新、販売の可否。判定結果から自動的に発注を確定しない。
13
+ - 判断: 在庫確認の対象商品について、予約分を差し引いた販売可能数が発注点を下回るかを判定する。店主代表以外が店番しても、同じ在庫から同じ判定を得て人気商品の欠品に気付けるようにする。
14
+ - 利用者・場面: 店主代表または家族利用者代表が在庫を確認するとき、商品ごとの在庫数・予約数・発注点がそろった時点で使う。
15
+ - 前提: 単一店舗の商品 1 種類について、同じ確認時点の個数を比べる。値は学習用である。
16
+ - 対象外: 発注点の決め方、発注量、仕入れ先、発注承認、在庫の更新、販売の可否。
20
17
 
21
18
  ## 2. 入力
22
19
 
23
- | 入力 | 概念データ・項目 | 利用目的 | 適用条件・欠損時の扱い |
24
- | -------- | ---------------- | ------------------------------------ | ------------------------------------------------------------------- |
25
- | 対象商品 | 商品識別 | 入力と判定結果を同じ商品へ対応付ける | 必須。未設定は `E-01` |
26
- | 在庫 | 在庫数(個) | 販売可能数の計算の起点 | 必須。同じ確認時点の予約分を含む総数。未設定は `E-01` |
27
- | 予約 | 予約数(個) | 販売可能数から予約済みの個数を除く | 必須。予約なしは 0 を明示する。未設定は `E-01` |
28
- | 商品 | 発注点(個) | 不足とみなす境界 | 必須。0 も有効な値であり、未設定の代用には使わない。未設定は `E-01` |
20
+ | 入力 | 概念データ・項目 | 利用目的 | 適用条件・欠損時の扱い |
21
+ | -------- | ---------------- | -------------------------------- | ------------------------------------------ |
22
+ | 対象商品 | 商品識別 | 入力と結果を同じ商品へ対応付ける | 必須 |
23
+ | 在庫 | 在庫数(個) | 販売可能数の起点 | 必須。予約分を含む総数 |
24
+ | 予約 | 予約数(個) | 予約済みの個数を除く | 必須。予約なしは 0 を明示する |
25
+ | 商品 | 発注点(個) | 不足とみなす境界 | 必須。0 も有効な値で、未設定の代用にしない |
29
26
 
30
27
  ## 3. ルール(判定/計算)
31
28
 
@@ -33,62 +30,53 @@ specdojo:
33
30
 
34
31
  #### 3.1.1. R-01 入力の確認
35
32
 
36
- 最初に必須項目の有無を確認し、次に個数が整数であること、最後に負数でないことを確認する。不備があれば「例外 / 異常系」に従い、以後の計算を行わない。0 は未設定とは区別する。
33
+ 「例外 / 異常系」の順で入力を確認し、不備があれば以後の計算を行わない。
37
34
 
38
35
  #### 3.1.2. R-02 販売可能数の算出
39
36
 
40
- 販売可能数を「在庫数 − 予約数」で算出する。
41
-
42
- 予約数が在庫数を超える場合は、予約を満たす在庫も足りていないため、負の販売可能数をそのまま不足判定に使う。0 に丸めず、入力不備とも扱わない。予約の調整自体は本ルールの対象外である。
37
+ 販売可能数を「在庫数 − 予約数」で算出する。予約数が在庫数を超えても負の値を 0 に丸めず、入力不備とも扱わずに判定へ使う。予約の調整は対象外である。
43
38
 
44
39
  #### 3.1.3. R-03 不足判定
45
40
 
46
- - 販売可能数が発注点より小さい場合は「不足」とする。
47
- - 販売可能数が発注点と等しい、または大きい場合は「不足なし」とする。
41
+ 販売可能数が発注点より小さければ「不足」、等しいか大きければ「不足なし」とする。
48
42
 
49
43
  ### 3.2. 判定例
50
44
 
51
- 商品識別を `ITEM-A` とし、各行で同じ確認時点の入力を使う。「未設定」は値が与えられていないことを表す。
52
-
53
- | 例 | 入力・前提(在庫数 / 予約数 / 発注点、単位: 個) | 適用規則 | 期待結果 |
54
- | --- | ------------------------------------------------ | -------------- | ----------------------------------------------- |
55
- | 1 | 12 / 3 / 10 | `R-02`、`R-03` | 販売可能数 9、不足 |
56
- | 2 | 13 / 3 / 10 | `R-02`、`R-03` | 販売可能数 10、不足なし(境界一致) |
57
- | 3 | 14 / 3 / 10 | `R-02`、`R-03` | 販売可能数 11、不足なし |
58
- | 4 | 0 / 0 / 1 | `R-02`、`R-03` | 販売可能数 0、不足 |
59
- | 5 | 0 / 0 / 0 | `R-02`、`R-03` | 販売可能数 0、不足なし |
60
- | 6 | 2 / 4 / 0 | `R-02`、`R-03` | 販売可能数 −2、不足(予約超過) |
61
- | 7 | 8 / 未設定 / 10 | `R-01` | `E-01`。販売可能数・不足判定とも返さない |
62
- | 8 | 8 / 0.5 / 10 | `R-01` | `E-02`。販売可能数・不足判定とも返さない |
63
- | 9 | −1 / 0 / 10 | `R-01` | `E-03`。販売可能数・不足判定とも返さない |
64
- | 10 | −1 / 未設定 / 10 | `R-01` | `E-01` が先。修正後の再判定で `E-03` を確認する |
65
- | 11 | 商品識別が未設定、8 / 0 / 10 | `R-01` | `E-01`。商品へ結果を関連付けられない |
45
+ 商品識別は `ITEM-A` とする。`E-` の行は判定値を返さない。
46
+
47
+ | 例 | 入力・前提(在庫数 / 予約数 / 発注点、単位: 個) | 適用規則 | 期待結果 |
48
+ | --- | ------------------------------------------------ | -------------- | ------------------------------------------ |
49
+ | 1 | 12 / 3 / 10 | `R-02`、`R-03` | 販売可能数 9、不足 |
50
+ | 2 | 13 / 3 / 10 | `R-02`、`R-03` | 販売可能数 10、不足なし(境界一致) |
51
+ | 3 | 0 / 0 / 0 | `R-02`、`R-03` | 販売可能数 0、不足なし |
52
+ | 4 | 2 / 4 / 0 | `R-02`、`R-03` | 販売可能数 −2、不足(予約超過) |
53
+ | 5 | 8 / 未設定 / 10 | `R-01` | `E-01` |
54
+ | 6 | 8 / 0.5 / 10 | `R-01` | `E-02` |
55
+ | 7 | −1 / 0 / 10 | `R-01` | `E-03` |
56
+ | 8 | −1 / 未設定 / 10 | `R-01` | `E-01` が先。`E-03` は修正後の再判定で示す |
57
+ | 9 | 商品識別が未設定、8 / 0 / 10 | `R-01` | `E-01`。結果を商品へ関連付けられない |
66
58
 
67
59
  ## 4. 出力
68
60
 
69
- | 出力 | 意味・単位または区分 | 利用先 |
70
- | ---------- | ---------------------------------------------- | ---------------------------------------------- |
71
- | 対象商品 | 入力の商品識別。商品識別自体が不備なら返せない | 在庫確認結果を照合する店主代表・家族利用者代表 |
72
- | 販売可能数 | 予約分を除いた個数。負数もあり得る | 不足理由の確認 |
73
- | 不足判定 | 「不足 / 不足なし」。発注の確定を意味しない | 店主代表による補充検討 |
74
- | 入力不備 | 例外 ID と該当する項目名。正常時には返さない | 入力した担当者による修正 |
61
+ | 出力 | 意味・単位または区分 | 利用先 |
62
+ | ---------- | --------------------------------------- | -------------------------- |
63
+ | 対象商品 | 入力の商品識別 | 在庫を確認した人による照合 |
64
+ | 販売可能数 | 予約分を除いた個数。負数もあり得る | 不足理由の確認 |
65
+ | 不足判定 | 「不足 / 不足なし」。発注の確定ではない | 店主代表による補充検討 |
66
+ | 入力不備 | 例外 ID と該当する項目名 | 入力した担当者による修正 |
75
67
 
76
- 正常時は対象商品・販売可能数・不足判定を返す。入力不備のときは例外 ID と不備項目を返し、販売可能数・不足判定を返さない。判定不能を「不足なし」と扱わない。
68
+ 入力不備のときは例外 ID と項目名だけを返し、判定不能を「不足なし」と扱わない。
77
69
 
78
70
  ## 5. 例外 / 異常系
79
71
 
80
- | ID | 状況 | 扱い | 利用者の次の手 |
81
- | ------ | ---------------------------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------- |
82
- | `E-01` | 必須項目のいずれかが未設定 | 判定を行わず、未設定の項目名を返す | 在庫確認担当が不足項目を確認・入力して再判定する。発注点は店主代表へ確認する |
83
- | `E-02` | 在庫数・予約数・発注点のいずれかが整数でない(文字列や小数など) | 判定を行わず、該当項目を返す。単位の換算や端数の丸めはしない | 在庫確認担当が個数として入力し直して再判定する |
84
- | `E-03` | 在庫数・予約数・発注点のいずれかが負数 | 判定を行わず、負数の項目名を返す | 在庫確認担当が記録を確認・修正して再判定する |
72
+ | ID | 状況 | 扱い | 利用者の次の手 |
73
+ | ------ | -------------------------- | -------------------------------- | ------------------------------------ |
74
+ | `E-01` | 必須項目のいずれかが未設定 | 未設定の項目名を返す | 入力する。発注点は店主代表へ確認する |
75
+ | `E-02` | 個数のいずれかが整数でない | 項目名を返す。換算や丸めはしない | 個数で入力し直す |
76
+ | `E-03` | 個数のいずれかが負数 | 負数の項目名を返す | 記録を確かめて直す |
85
77
 
86
- 複数の種類の不備がある場合は `E-01` → `E-02` → `E-03` の順で最初の種類を返す。同じ種類に該当する項目はすべて示す。修正後は全入力を再確認する。
87
-
88
- 外部参照の取得処理は本ルールに含めない。呼出元が必要項目を取得できなければ、値を推測して本ルールを呼び出さない。
78
+ いずれも判定せず、在庫確認担当が直して再判定する。不備が複数の種類にわたる場合は `E-01` → `E-02` → `E-03` の順で最初の種類を返し、その種類の項目はすべて示す。呼出元が入力を取得できなければ、値を推測して本ルールを呼び出さない。
89
79
 
90
80
  ## 6. メモ / 将来課題
91
81
 
92
- 本完成例の判定範囲に未決事項はない。店主代表への業務承認依頼では、予約分の控除、発注点との等号の扱い、予約超過、入力不備時の判定不能を確認する。
93
-
94
- 季節別の発注点の設定方法は将来の別ルールで扱う。本ルールは与えられた発注点との比較だけを担うため、その設定方法を先取りしない。
82
+ 未決事項はない。季節別の発注点の設定方法は将来の別ルールで扱う。
@@ -28,7 +28,6 @@ specdojo:
28
28
 
29
29
  ```mermaid
30
30
  classDiagram
31
- direction LR
32
31
 
33
32
  class 商品 {
34
33
  商品ID: PK
@@ -0,0 +1,78 @@
1
+ ---
2
+ applyTo: "{app,src,tests}/**/*.{ts,tsx}"
3
+ specdojo:
4
+ id: specdojo:cdr-sample
5
+ type: architecture
6
+ status: draft
7
+ rulebook: specdojo:cdr-rulebook
8
+ based_on:
9
+ - specdojo:tsd-index-sample
10
+ ---
11
+
12
+ # TypeScript 実装ルール
13
+
14
+ 駄菓子屋きぬや販売管理システム(Next.js・TypeScript)の `app/`・`src/`・`tests/` 配下の TypeScript を実装・更新するときの規則です。言語・ライブラリ・版は技術スタック一覧に従い、本書では書き方と検証だけを定めます。
15
+
16
+ ## 1. 基本方針
17
+
18
+ - `tsconfig.json` の `strict: true` を前提にし、型エラーを隠さずに直す。
19
+ - 既存の関数分割、命名、エラー処理の書き方に合わせる。新しい書き方を持ち込む場合は、同じ変更で既存箇所をそろえるか、理由を変更の説明に書く。
20
+ - 1 回の変更は依頼された範囲に絞る。無関係なファイルの整形や名前の変更を混ぜない。
21
+ - 金額(販売額・つけ残高)は円単位の整数で扱う。
22
+
23
+ ## 2. モジュールと import
24
+
25
+ - ESM で書き、`require` を使わない。
26
+ - `src/` 内の import は `@/` の別名を使い、`../../` のような 2 階層以上の相対 import を書かない。
27
+ - `app/` から業務処理を呼ぶ場合は `src/` の公開関数を経由し、`src/` から `app/` を import しない。この向きは `eslint.config.mjs` の `no-restricted-imports` で検査する。
28
+ - サーバー専用の処理(Prisma による DB 接続、つけ残高の更新)は `src/server/` に置く。
29
+ - 型の import の書き方は `eslint.config.mjs` の `consistent-type-imports` に従う。
30
+
31
+ ## 3. 型
32
+
33
+ - `any` を使わない。フォーム入力や API の要求本文など型が不明な値は `unknown` で受け、型ガード関数で検証してから使う。
34
+ - 文字列の取り得る値の集合は union 型で表す(例: 支払方法 `"cash" | "tsuke"`)。
35
+ - `null` と `undefined` を混在させない。値が無いことは `undefined` で表し、Prisma が返す `null` は `src/server/` の境界で変換する。
36
+
37
+ ```typescript
38
+ type Payment = "cash" | "tsuke";
39
+
40
+ function isPayment(value: unknown): value is Payment {
41
+ return value === "cash" || value === "tsuke";
42
+ }
43
+ ```
44
+
45
+ ## 4. エラー処理
46
+
47
+ - 利用者の入力の不備は、検証結果として呼び出し側へ返し、画面に項目ごとのメッセージを出す。例外にしない。
48
+ - 想定外の失敗(DB 接続の失敗など)は例外として投げ、API ルートの境界で Sentry へ送ってから汎用のエラー応答に変換する。
49
+ - エラーメッセージには、操作名と対象の ID(商品コード、顧客 ID)を含める。
50
+ - 空の `catch` で例外を握りつぶさない。再送出する場合は `cause` に元のエラーを渡す。
51
+
52
+ ## 5. 命名
53
+
54
+ - 変数・関数は `camelCase`、型・コンポーネントは `PascalCase`、定数は `UPPER_SNAKE_CASE` を使う。
55
+ - 真偽値は `is`・`has`・`can` で始める(例: `isOutOfStock`)。
56
+ - 略語は `id`・`url` など定着したものだけを使い、`qty`・`amt` のような新しい略語を作らない。
57
+ - 業務の用語は既存コードで使っている英語名にそろえ、同じ用語に別の名前を付けない(例: つけは `tsuke` に統一し、`credit` と混ぜない)。
58
+
59
+ ## 6. テストと検証
60
+
61
+ | コマンド | 対象 | 実行条件 | 失敗時 |
62
+ | -------------------------- | ------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------ |
63
+ | `npm run typecheck` | 型検査(`app`・`src`・`tests`) | TypeScript を変更したとき(毎回) | 型エラーの原因を直す |
64
+ | `npm run lint` | ESLint(import の向き・型の import) | TypeScript を変更したとき(毎回) | `npm run lint -- --fix` で直し、残りを手で直す |
65
+ | `npm run test:unit` | Vitest の単体テスト(売上・つけ残高) | `src/` を変更したとき | 実装を直す。仕様変更で期待値が変わる場合だけ、根拠を確かめて期待値を直す |
66
+ | `npm run test:integration` | DB を使う統合テスト | DB 接続やマイグレーションを変更したとき | agent では実行しない。CI の失敗を直せない場合は内容を報告する |
67
+
68
+ - 金額の計算やつけ残高の更新を変えた場合は、境界値(残高 0 円、上限額ちょうど)の単体テストを追加する。
69
+
70
+ ## 7. 禁止事項
71
+
72
+ | 禁止事項 | 理由 |
73
+ | ---------------------------------------------------- | ------------------------------------------ |
74
+ | 金額を浮動小数点で計算する | 端数の誤差でつけ残高が合わなくなるため |
75
+ | クライアントコンポーネントから DB 接続を import する | 接続情報がブラウザへ送られる危険があるため |
76
+ | 検証していない入力を `as` で型に押し込む | 不正な数量や支払方法が記録されるため |
77
+ | ログに顧客の氏名や残高を出す | 常連客の個人情報が漏れるため |
78
+ | `// @ts-ignore` で型エラーを消す | 型エラーの原因を残したままにするため |
@@ -16,92 +16,76 @@ specdojo:
16
16
 
17
17
  店主代表と家族の店番担当が、販売の記録漏れと締めの差異を同じ根拠で確認できるよう、販売から日次・月次の確認に使う情報の管理境界を定める。販売明細と締めの判断を同じ欄で上書きすると、差異の発生元と誰が確認したかを追えなくなるため、取引の正本、再生成する集計、人が確定する記録を分ける。
18
18
 
19
- BA は店主代表と対象・用途を確認し、ARC・DEV は更新元と参照先を設計へ接続する。QE は一覧と検証対象の対応を確認する。店主代表は PO として業務範囲と公開可否を最終判断する。店番担当は OPS として日々の入力・照合を担い、仕様上の問い合わせは BA、記録の不整合・再生成の相談は OPS が受ける。
20
-
21
- ### 1.1. 対象と隣接領域
22
-
23
- 範囲の根拠は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の販売・締め領域である。販売に必要な商品台帳と、締めの内訳確認に使う日次販売集計を含む。
24
-
25
- | 区分 | 管理境界と理由 |
26
- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------- |
27
- | 本書で定義 | 商品台帳、販売記録、日次販売集計、日次締め記録、月次報告の5単位。取引の入力から締めの判断までを追う |
28
- | 隣接領域から参照 | 顧客台帳・つけ台帳は購入者と未収金、仕入記録・在庫記録は締めの差異確認に利用する。各台帳の更新責務は顧客・仕入・在庫領域へ委ねる |
29
- | 対象外 | 売場棚の現物管理、EC、複数店舗、本格会計、仕入先との通信。全体概要の領域分担に従い、販売・締めの記録と混在させない |
30
-
31
- 項目の意味は [[specdojo:bdd-sample|販売管理の業務データ辞書]]、識別と関連は [[specdojo:ccd-sample|概念クラス図]] を参照する。以下の数値は照合方法を示す例示データであり、実績や検証成功の記録ではない。
19
+ 範囲は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の販売・締め領域の5単位とする。顧客台帳・つけ台帳・仕入記録・在庫記録は購入者・未収金・差異確認のために参照だけし、更新責務は各領域へ委ねる。売場棚の現物管理、EC、複数店舗、本格会計、仕入先との通信は対象外とする。
32
20
 
33
21
  ## 2. 概念データストア一覧
34
22
 
35
- | データストア名 | 対応プロセス | 主な内容 | 更新タイミング | 粒度 | 主な用途 |
36
- | -------------- | ------------------------------ | -------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------- |
37
- | 商品台帳 | 店頭販売、つけ販売、月次見直し | 商品の識別、表示名、標準販売価格、補充基準 | 随時(商品の登録・売価や補充基準の承認済み変更時) | 店舗で扱う商品種類毎。現物一個毎ではない | 店番担当が販売対象と現在の価格を確認し、店主代表が売価・補充基準を見直す |
38
- | 販売記録 | 店頭販売、つけ販売、日次締め | 確定した売上記録と所属する売上明細、支払方法、購入者の参照 | イベント(会計確定時・承認済み訂正時) | 売上ID毎。明細は売上IDと明細番号の組で識別 | 店番担当が会計の記録漏れを確認し、店主代表が現金販売とつけ販売を区別する |
39
- | 日次販売集計 | 日次締め | 対象日の販売件数、請求金額合計、支払方法別内訳、集計の基準時点 | 日次(閉店後)、イベント(対象日の販売訂正後) | 店舗・対象日・基準時点毎 | 店番担当が元の販売を辿って集計漏れ・重複を調べ、店主代表が締めの販売額を確認する |
40
- | 日次締め記録 | 日次締め、月次見直し | 日次販売集計の参照、仕入額・在庫差異・つけ残高の確認結果、判断理由、確認者 | 日次(閉店時の照合後)、イベント(締めの再確認時) | 店舗・対象日・確認版毎 | 店主代表が差異と対応を確認し、その日の締めを確定できるか判断する |
41
- | 月次報告 | 月次見直し | 対象月の売上・欠品・つけ残高の根拠、比較結果、見直しの判断と担当 | 月次(月末の締め確認後)、イベント(根拠の訂正に伴う再確認時) | 店舗・対象月・報告版毎 | 店主代表が売価・補充基準・つけ上限の見直しを判断し、家族の店番担当へ申し送る |
23
+ | データストア名 | 対応プロセス | 主な内容 | 更新タイミング | 粒度 | 主な用途 |
24
+ | -------------- | ------------------------------ | -------------------------------------------------------------------- | -------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------ |
25
+ | 商品台帳 | 店頭販売、つけ販売、月次見直し | 商品の識別、表示名、標準販売価格、補充基準 | 随時(商品登録・承認済みの売価や補充基準の変更時) | 商品種類毎。現物一個毎ではない | 店番担当が販売対象と現在価格を確認し、店主代表が売価を見直す |
26
+ | 販売記録 | 店頭販売、つけ販売、日次締め | 確定した売上記録と売上明細、支払方法、購入者の参照 | イベント(会計確定時・承認済み訂正時) | 売上ID毎。明細は売上IDと明細番号の組 | 店番担当が記録漏れを確認し、店主代表が現金販売とつけ販売を区別する |
27
+ | 日次販売集計 | 日次締め | 対象日の販売件数、請求金額合計、支払方法別内訳、集計の基準時点 | 日次(閉店後)、イベント(対象日の販売訂正後) | 店舗・対象日・基準時点毎 | 店主代表が締めの販売額を確認し、店番担当が集計漏れ・重複を調べる |
28
+ | 日次締め記録 | 日次締め、月次見直し | 日次販売集計の参照、仕入・在庫・つけ残高の確認結果、判断理由、確認者 | 日次(閉店時の照合後)、イベント(締めの再確認時) | 店舗・対象日・確認版毎 | 店主代表がその日の締めを確定できるか判断する |
29
+ | 月次報告 | 月次見直し | 対象月の売上・欠品・つけ残高の根拠、比較結果、見直しの判断 | 月次(月末の締め確認後)、イベント(根拠の訂正後) | 店舗・対象月・報告版毎 | 店主代表が売価・補充基準・つけ上限の見直しを判断する |
42
30
 
43
- 販売記録の「売上記録」は辞書の会計単位、「売上明細」はその内訳に対応する。明細用ファイルが別でも独立した管理単位には分割しない。日次販売集計は販売記録から作る参照ビューであり、全体概要の「日次締め記録」とは更新責務が異なるため区別する。
31
+ 売上明細は売上記録の内訳であり、明細用ファイルが別でも独立した管理単位にしない。日次販売集計は販売記録から作る参照ビューで、全体概要の「日次締め記録」とは更新責務が異なるため区別する。
44
32
 
45
33
  ## 3. 正本区分と更新責務
46
34
 
47
35
  ### 3.1. 生成元と利用制約
48
36
 
49
- 更新・確認担当は業務上の責務を示す。システムによる保存・集計を用いる場合も、入力内容の責任は担当 Role code に残る。
50
-
51
- | データストア名 | 正本区分・生成元 | 更新契機・扱いの制約 | 更新担当 | 確認担当 |
52
- | -------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------- | -------- |
53
- | 商品台帳 | 商品種類と現在の販売条件の正本。店主代表の承認内容を反映 | 承認後に OPS が更新する。価格変更を過去の販売単価へ遡及させない | OPS | PO、BA |
54
- | 販売記録 | 確定した会計と明細の正本。販売プロセスの確定結果を保存 | 入力途中・取消済み取引を含めない。訂正は元の売上を特定し、PO が承認した販売側の訂正手順で行う | OPS | PO、QE |
55
- | 日次販売集計 | 販売記録から再生成する派生情報 | 対象日と基準時点の販売集合を記録して再生成する。集計値を直接訂正せず、元の販売記録を確認する | OPS | QE |
56
- | 日次締め記録 | PO が確定する日ごとの照合・判断の正本。販売集計と隣接台帳を根拠に作成 | 参照した版・基準時点を固定する。元データの訂正後は再確認し、以前の判断を黙って上書きしない | OPS(案作成)、PO(確定) | BA、QE |
57
- | 月次報告 | PO が確定する月ごとの判断記録。日次締め記録と隣接台帳の確認結果を参照 | 根拠となる対象日と版を識別する。報告の見直し案から商品台帳やつけ上限へ自動的に書き戻さず、承認後に各領域へ更新を依頼する | BA(案作成)、PO(確定) | QE、OPS |
37
+ | データストア名 | 正本区分・生成元 | 扱いの制約 | 更新担当 | 確認担当 |
38
+ | -------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------- | ------------------------- | -------- |
39
+ | 商品台帳 | 商品種類と現在の販売条件の正本。PO の承認内容を反映 | 価格変更を過去の販売単価へ遡及させない | OPS | PO、BA |
40
+ | 販売記録 | 確定した会計と明細の正本 | 入力途中・取消済みの取引を含めない。訂正は元の売上を特定し、PO の承認を得て行う | OPS | PO、QE |
41
+ | 日次販売集計 | 販売記録から再生成する派生情報 | 対象日と基準時点の販売集合を記録する。集計値を直接訂正しない | OPS | QE |
42
+ | 日次締め記録 | 日ごとの照合・判断の正本。日次販売集計と隣接台帳が根拠 | 参照した版・基準時点を固定する。以前の判断を黙って上書きしない | OPS(案作成)、PO(確定) | BA、QE |
43
+ | 月次報告 | 月ごとの判断記録。日次締め記録と隣接台帳が根拠 | 根拠の対象日と版を識別する。見直し案を台帳へ自動で書き戻さず、承認後に各領域へ依頼する | BA(案作成)、PO(確定) | QE、OPS |
58
44
 
59
45
  ### 3.2. 訂正・不整合時の扱い
60
46
 
61
- | 場面 | 確認と次の行動 | 受け付ける担当・復旧の参照先 |
62
- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
63
- | 商品の価格変更後に過去の売上が変わる | 販売当時の単価との不一致として扱う。現在の商品台帳から過去の請求額を計算し直さない | BA・DEV が [[specdojo:bdd-sample\|販売管理の辞書]] の標準販売価格と販売単価の区別を照合する |
64
- | 販売集計と元記録が合わない | OPS が対象日・基準時点と販売集合を照合する。元記録に誤りがあれば販売側で訂正し、QE の再照合後に締めへ渡す | OPS。訂正・再生成の詳細手順は予定文書 `specdojo:cop-sales-reconciliation`。未整備中は「確認事項と変更影響」の制約に従う |
65
- | 締め確定後に販売を訂正する | 旧締めの参照元と判断を保持し、再生成した集計で PO が締めの新しい確認版を判断する。該当月次報告への影響も BA が確認する | OPS・PO。予定手順 `specdojo:cop-sales-reconciliation` |
66
- | つけ台帳や在庫記録を取得できない | 未取得を残高0・差異なしと読み替えない。取得できた範囲だけを記録し、PO に締めの確定保留を提示する | OPS が各台帳の更新担当へ確認を依頼する。受け渡しの境界は [[specdojo:cdfd-overview-sample\|全体概要]] |
67
- | 月次報告に根拠のない見直し案がある | BA が対象月・根拠版・判断理由を補い、PO の判断後に更新依頼先と担当を記録する | BA・PM。未合意の変更は変更要求、採用した方針と理由は決定記録へつなぐ |
47
+ 訂正・再生成の詳細手順は予定文書 `specdojo:cop-sales-reconciliation` が担う。
48
+
49
+ | 場面 | 次の行動 | 受け付ける担当 |
50
+ | ---------------------------------- | ---------------------------------------------------------------------------------------------- | -------------- |
51
+ | 販売集計と元記録が合わない | 対象日・基準時点と販売集合を照合し、元記録の誤りは販売側で訂正してから集計を再生成する | OPS |
52
+ | 締め確定後に販売を訂正する | 旧締めの参照と判断を残し、再生成した集計で締めの新しい確認版を判断する。月次報告への影響も見る | OPS・PO・BA |
53
+ | つけ台帳や在庫記録を取得できない | 未取得を残高0・差異なしと読み替えず、取得できた範囲だけを記録して締めの確定を保留する | OPS・PO |
54
+ | 月次報告に根拠のない見直し案がある | 対象月・根拠版・判断理由を補ってから PO が判断する | BA・PO |
68
55
 
69
56
  ## 4. 関連仕様と検証
70
57
 
71
58
  ### 4.1. 管理単位ごとの参照対応
72
59
 
73
- | データストア名 | 根拠・参照先 | 照合する内容と検証対象 |
74
- | -------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
75
- | 商品台帳 | [[specdojo:bdd-sample\|販売管理の辞書]] の商品、[[specdojo:ccd-sample\|概念クラス図]] | 商品の識別・現在価格と販売時単価の区別。補充基準の全項目は辞書の既定範囲を超えて本書に追加しない |
76
- | 販売記録 | [[specdojo:bdd-sample\|販売管理の辞書]] の売上記録・売上明細、[[specdojo:ccd-sample\|概念クラス図]] | 売上と明細の所属・粒度、商品参照、つけ販売時の購入者。会計確定までの操作は [[specdojo:clis-sample\|販売管理 CLI 仕様]] を参照する |
77
- | 日次販売集計 | 本書の販売記録、予定仕様 `specdojo:bdd-sales-summary` | 対象日・基準時点に含めた売上の集合と支払方法別の集計。保存形式は未確定。仕様整備までは次節の手動照合を使う |
78
- | 日次締め記録 | [[specdojo:cdfd-overview-sample\|全体概要]] の日次締め、予定仕様 `specdojo:bdd-closing` | 販売記録との販売額照合、仕入・在庫・つけ台帳からの確認結果、PO の判断と参照版。販売側の一致だけで全体の締めを確定しない |
79
- | 月次報告 | [[specdojo:cdfd-overview-sample\|全体概要]] の月次見直し、予定仕様 `specdojo:bdd-monthly-report` | 対象月の日次締め記録の網羅、売上・欠品・つけ残高の根拠、判断と更新依頼先。台帳の未取得・未確定日は明示する |
60
+ | データストア名 | 根拠・参照先 | 照合する内容 |
61
+ | -------------- | --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
62
+ | 商品台帳 | [[specdojo:bdd-sample\|販売管理の辞書]] の商品、[[specdojo:ccd-sample\|概念クラス図]] | 商品の識別、標準販売価格と販売単価の区別 |
63
+ | 販売記録 | [[specdojo:bdd-sample\|販売管理の辞書]] の売上記録・売上明細、[[specdojo:ccd-sample\|概念クラス図]] | 売上と明細の所属・粒度、商品参照、つけ販売時の購入者。現金販売の確定までの操作は [[specdojo:clis-sample\|販売管理 CLI 仕様]]、つけ販売の確定は未作成の `specdojo:cdfd-sales` で扱う |
64
+ | 日次販売集計 | 本書の販売記録、未作成の `specdojo:bdd-sales-summary` | 対象日・基準時点に含めた売上の集合と支払方法別の集計 |
65
+ | 日次締め記録 | [[specdojo:cdfd-overview-sample\|全体概要]] の日次締め、未作成の `specdojo:bdd-closing` | 販売額の照合、仕入・在庫・つけ台帳の確認結果、PO の判断と参照版 |
66
+ | 月次報告 | [[specdojo:cdfd-overview-sample\|全体概要]] の月次見直し、未作成の `specdojo:bdd-monthly-report` | 日次締め記録の網羅、売上・欠品・つけ残高の根拠、更新依頼先 |
80
67
 
81
- 項目・値・構造の検証は各辞書が参照する schema・外部 I/F を正本とし、CDSD で別の制約を作らない。販売・締めの詳細 CDFD は予定 ID `specdojo:cdfd-sales`・`specdojo:cdfd-closing`、保管場所一覧は `specdojo:sll-sales-closing` として未作成である。確認できる管理境界と未確定の保存・復旧方式を区別し、後者の整備責務を「確認事項と変更影響」で追跡する。
68
+ 項目・値・構造は各辞書が参照する schema・外部 I/F を正本とし、本書で別の制約を作らない。
82
69
 
83
70
  ### 4.2. 照合手順と受入条件
84
71
 
85
- BA が「対象と隣接領域」の5単位を一覧・更新責務・参照対応と照合し、欠落・重複が0件であることを確認する。ARC・DEV が正本区分と生成元を確認した後、QE が次の手動照合を行う。未作成 schema の検証を実施済みとは扱わない。
72
+ schema が未作成のため、次の手動照合で確かめる。数値は例示データである。
86
73
 
87
- | 対象 | 確認手順・例示データ | 合格条件 | 不一致時 |
88
- | ------------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
89
- | 商品台帳 | 同じ商品の価格変更前後で商品IDを照合し、変更前に確定した売上明細と比較する | 商品IDが維持され、過去の販売単価・請求額が変わらない | BA・DEV へ差し戻す |
90
- | 販売記録 | 確定済み・入力途中・取消済みの取引を一つずつ用意し、保存された売上と明細の所属を確認する | 確定済みだけが販売記録に存在する。明細の所属する売上・参照商品が存在し、つけ販売には購入者参照がある | OPS が元取引を確認し、訂正方式が未整備なら本番データを変更しない |
91
- | 日次販売集計 | 同じ対象日の現金販売108円とつけ販売216円を集計し、元の売上IDの集合と照合する。入力途中・取消済みは含めない | 販売2件・請求合計324円、内訳108円・216円で元集合と一致する。つけ精算の入金を新たな売上に含めない | OPS が基準時点と入力を確認し、再生成後に QE が再照合する |
92
- | 日次締め記録 | 上記集計を使った締め案と、つけ残高が取得できない締め案を比較する | 集計の基準時点と各台帳の参照を追える。未取得がある案は確定保留となり、確認者と次の行動が残る | PO に保留理由を示し、OPS が不足根拠を集める |
93
- | 月次報告 | 対象月の日次締め記録と報告の根拠一覧を照合し、締め訂正前の版を参照する報告も確認する | 対象日の欠落・重複が0件。未確定日・旧版参照があれば影響と PO の再判断が明示され、無断で台帳へ反映しない | BA が根拠と影響を修正し、PO が再判断する |
74
+ | 対象 | 確認手順 | 合格条件 |
75
+ | ------------ | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
76
+ | 一覧の網羅 | 「概要」の5単位を一覧・正本区分・参照対応の各表と照合する | 欠落・重複が0件 |
77
+ | 商品台帳 | 価格変更の前後で商品IDと、変更前に確定した売上明細を照合する | 商品IDが維持され、過去の販売単価・請求額が変わらない |
78
+ | 販売記録 | 確定済み・入力途中・取消済みの取引を一つずつ用意し、保存された売上と明細を確認する | 確定済みだけが残り、明細の売上・商品の参照が存在し、つけ販売には購入者参照がある |
79
+ | 日次販売集計 | 同じ対象日の現金販売108円とつけ販売216円を集計し、元の売上IDの集合と照合する | 販売2件・請求合計324円、内訳108円・216円。入力途中・取消済みとつけ精算の入金を含めない |
80
+ | 日次締め記録 | 上記集計を使った締め案と、つけ残高を取得できない締め案を比べる | 基準時点と各台帳の参照を追える。未取得がある案は確定保留となり、確認者と次の行動が残る |
81
+ | 月次報告 | 対象月の日次締め記録と報告の根拠一覧を照合し、締め訂正前の版を参照する報告も確かめる | 対象日の欠落・重複が0件。旧版参照の影響が示され、台帳へ無断で反映しない |
94
82
 
95
- QE は文書の整形・Markdown・Frontmatter 検査も実施し、手動照合と区別してコマンド・対象・結果を実行記録に残す。導入済みの Prettier と lint のコマンドは [[specdojo:cdsd-rulebook|概念データストア定義 作成ルール]] の「検証と受入条件」を参照する。失敗があれば該当担当へ差し戻し、再確認する。
83
+ 不一致は「訂正・不整合時の扱い」に従って直し、再照合する。
96
84
 
97
85
  ## 5. 確認事項と変更影響
98
86
 
99
- 未整備の参照先と条件付きの変更を次の単位で追跡する。追跡先は未作成の候補 ID とし、登録済みとは扱わない。
100
-
101
- | 論点・区分 | 現在の判断・影響 | 担当・判断時期・次の行動 | 追跡先候補 |
102
- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
103
- | 集計・締め・報告の辞書と詳細プロセスの欠落(課題) | 管理境界と手動照合の基準までを採用し、保存形式や締めの全項目は確定しない。未整備のまま実装すると、異なる基準時点の情報を混在させる懸念がある | BA が各辞書・詳細 CDFD を作成し、ARC・DEV が参照対応、QE が受入条件を確認する。PM は辞書→プロセス→実装・検証の順に計画し、PO が設計着手前に範囲を判断する | `specdojo:pjr-sales-closing-specs` |
104
- | 保管先・訂正と再生成手順が未確定(意思決定・運用上の制約) | _UNDECIDED_: システム化後の保存・保持・復旧方式。現行の販売ノートは明細欄と締め欄を分けて扱う。手動照合で調査できるが、システム上の訂正・再生成は本番実施しない | OPS・DEV が `specdojo:sll-sales-closing` と `specdojo:cop-sales-reconciliation` を整備し、ARC が正本保持、QE が復旧後の照合を確認する。PM が PO へ報告し、運用開始前に PO が採用方針と公開範囲を決める | `specdojo:pjr-sales-storage` |
105
- | 販売の訂正方式や粒度を変える場合(変更要求) | 販売記録、辞書・概念クラス図、販売プロセス、集計、締め、月次報告と既存記録の再照合へ波及する | BA が差分と移行対象を整理し、ARC・DEV が schema・型・生成処理への影響を特定する。QE が再検証範囲、PM が担当・移行順・期限を計画し、PO が実施前に承認する。採用理由は決定記録へ残す | `specdojo:pjr-sales-correction-change` |
106
-
107
- 公開前に BA・ARC・QE が管理境界と受入条件を確認し、OPS が保管・復旧手順と閲覧範囲を確認する。人間の PO は未解決事項、顧客参照・つけ情報の公開範囲、実データが混入していないことを確認し、承認・保留・差し戻しを判断する。未整備の手順に依存する運用は保留し、agent は `draft` を維持する。
87
+ | 論点 | 影響と当面の扱い |
88
+ | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
89
+ | 集計・締め・報告の辞書と、販売・締めの詳細 CDFD が未作成 | 管理境界と手動照合の基準までを採用し、保存形式や締めの全項目は確定しない。未整備のまま実装すると基準時点の異なる情報が混ざる |
90
+ | `_UNDECIDED_`: システム化後の保存・保持・復旧方式(`specdojo:sll-sales-closing` が未作成) | 現行の販売ノートは明細欄と締め欄を分けて扱う。訂正・再生成の手順が整うまでシステム上で本番実施しない |
91
+ | 販売の訂正方式や粒度を変える場合 | 販売記録、辞書・概念クラス図、販売プロセス、集計、締め、月次報告と既存記録の再照合へ波及する |