specdojo 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -1,71 +1,179 @@
1
1
  # yaml-language-server: $schema=../../../specdojo/schemas/v1/bdd.schema.yaml
2
2
  id: specdojo:bdd-sample
3
3
  type: data
4
- title: 業務データ辞書(main)
5
- status: draft
4
+ title: 業務データ辞書(駄菓子屋の販売管理)
5
+ status: ready
6
6
  rulebook: specdojo:bdd-rulebook
7
7
  supersedes: []
8
8
 
9
9
  entities:
10
10
  - logical_name: 商品
11
11
  physical_name: product
12
- description: 駄菓子屋で販売する個々の商品
13
- glossary_term_id: tm-product
14
- related_terms: [tm-price, tm-stock]
15
- key_fields: [product_code]
12
+ description: >-
13
+ 店舗で販売対象として管理する商品の種類。一個ずつの現物や販売時の明細とは区別する。
14
+ 商品・売上記録・売上明細は実装前の業務モデルとして本辞書で定義し、管理単位と関連は [[specdojo:ccd-sample|概念クラス図 サンプル]] に合わせる。
15
+ 用語参照は [[specdojo:gl-sample|用語集 在庫・調達]] を対象とする。
16
+ related_terms: [tm-standard-product]
17
+ key_fields: [product_id]
16
18
  fields:
17
- - logical_name: 商品コード
18
- physical_name: product_code
19
- glossary_term_id: tm-product-code
19
+ - logical_name: 商品ID
20
+ physical_name: product_id
20
21
  type: string
21
- description: 各商品を一意に識別するコード
22
+ description: 商品名や価格を変更しても同じ商品を追跡するための識別子。商品名をキーにしない。
22
23
  constraints:
23
24
  required: true
24
25
  unique: true
25
- example: 45-14603-32581-2
26
+ example: PRD-001
26
27
  - logical_name: 商品名
27
28
  physical_name: product_name
28
29
  type: string
29
- glossary_term_id: tm-product-name
30
- description: おばあちゃんやお客さんが読める商品名
30
+ description: 店主代表と来店客が商品を見分けるための表示名。同名の商品があっても識別は商品IDで行う。
31
31
  constraints:
32
32
  required: true
33
33
  example: うまか棒 たこ焼き味
34
- - logical_name: 価格
35
- physical_name: price
36
- type: integer
37
- glossary_term_id: tm-price
38
- description: 商品の販売価格(税抜き)
34
+ - logical_name: 標準販売価格
35
+ physical_name: standard_price
36
+ type: money
37
+ description: 現在の商品案内に使う税抜価格。過去の売上明細に残す販売単価とは区別する。
39
38
  unit: 円
40
39
  constraints:
41
40
  required: true
42
41
  example: 100
42
+ - logical_name: 発注点
43
+ physical_name: reorder_point
44
+ glossary_term_id: tm-reorder-point
45
+ type: integer
46
+ description: >-
47
+ 定番商品で在庫不足判定に使う基準数量。未設定はゼロを意味しない。
48
+ 判定と入力不備の扱いは [[specdojo:br-sample|在庫不足判定]] に従う。
49
+ unit: 個
50
+ constraints:
51
+ required: false
52
+ min: 0
53
+ example: 10
43
54
 
44
- - logical_name: 支払い
45
- physical_name: payment
46
- description: 顧客からの支払い情報
47
- glossary_term_id: tm-payment
48
- key_fields: [payment_id]
55
+ - logical_name: 売上記録
56
+ physical_name: sale
57
+ description: >-
58
+ 一回の店頭販売で確定した会計の管理単位。一件以上の売上明細を持ち、入力途中や取り消した取引は含めない。
59
+ 顧客が特定されない現金販売も記録する。顧客の基本情報とつけ残高の台帳は本辞書の対象外とする。
60
+ related_terms: [tm-sales, tm-accounts-receivable]
61
+ key_fields: [sale_id]
49
62
  fields:
50
- - logical_name: 支払いID
51
- physical_name: payment_id
63
+ - logical_name: 売上ID
64
+ physical_name: sale_id
52
65
  type: string
53
- glossary_term_id: tm-payment-id
54
- description: 支払いを一意に識別するID
66
+ description: 一回の販売を識別し、所属する全明細をまとめて確認するための識別子。
55
67
  constraints:
56
68
  required: true
57
69
  unique: true
58
- example: PAY-0001
59
- - logical_name: 支払ステータス
60
- physical_name: payment_status
70
+ example: SALE-001
71
+ - logical_name: 売上日時
72
+ physical_name: sold_at
73
+ type: datetime
74
+ description: 販売を確定した時点。入力を開始した時点や外部決済の応答時点とは区別する。
75
+ constraints:
76
+ required: true
77
+ example: "2026-11-08T10:00:00+09:00"
78
+ - logical_name: 合計金額
79
+ physical_name: total_amount
80
+ type: money
81
+ description: >-
82
+ この会計で顧客へ請求する税込金額。預かり金や釣銭、顧客の過去のつけ残高を含めない。
83
+ 税額と請求額を確認する操作は [[specdojo:clis-sample|販売管理 CLI 仕様]] に従う。
84
+ unit: 円
85
+ constraints:
86
+ required: true
87
+ example: 108
88
+ - logical_name: 支払方法
89
+ physical_name: payment_method
61
90
  type: enum
62
- description: 支払い処理の現在状態
91
+ description: 販売時に代金を受領するか、顧客のつけとして後日受領するかを区別する。決済サービスの処理状態とは別の判断軸。
92
+ constraints:
93
+ required: true
94
+ allowed_values_detailed:
95
+ - value: cash
96
+ label: 店頭で現金を受領する
97
+ - value: credit
98
+ label: 顧客のつけとして後日受領する
99
+ example: cash
100
+ - logical_name: 顧客ID
101
+ physical_name: customer_id
102
+ type: string
103
+ description: >-
104
+ 購入者として特定した顧客の識別子。一見客の現金販売では省略できる。
105
+ つけ販売では請求先を特定するために必要であり、未設定を現金販売と読み替えない。
106
+ constraints:
107
+ required: false
108
+ example: CUS-001
109
+
110
+ - logical_name: 売上明細
111
+ physical_name: sale_line
112
+ description: >-
113
+ 一回の販売に含まれる一行分の商品・単価・数量。売上IDと明細番号の組で識別し、売上記録から独立して管理しない。
114
+ 商品IDだけでは同じ販売に複数の行がある場合を識別できないため、キーにはしない。
115
+ key_fields: [sale_id, line_number]
116
+ fields:
117
+ - logical_name: 売上ID
118
+ physical_name: sale_id
119
+ type: string
120
+ description: 所属する売上記録の識別子。同じ売上に属する明細は同じ値を持つ。
63
121
  constraints:
64
122
  required: true
123
+ example: SALE-001
124
+ - logical_name: 明細番号
125
+ physical_name: line_number
126
+ type: integer
127
+ description: 一回の販売の中で行を識別する番号。他の販売で同じ番号を使ってよい。
128
+ constraints:
129
+ required: true
130
+ min: 1
131
+ example: 1
132
+ - logical_name: 商品ID
133
+ physical_name: product_id
134
+ type: string
135
+ description: この行で販売した商品の識別子。商品名の変更後も販売対象を確認できるようにする。
136
+ constraints:
137
+ required: true
138
+ example: PRD-001
139
+ - logical_name: 販売単価
140
+ physical_name: unit_price
141
+ type: money
142
+ description: この販売で適用した一個あたりの税抜価格。販売後に商品の標準販売価格が変わっても変更しない。
143
+ unit: 円
144
+ constraints:
145
+ required: true
146
+ example: 100
147
+ - logical_name: 販売数量
148
+ physical_name: quantity
149
+ type: integer
150
+ description: この行で販売する商品の個数。販売対象のない行や返品の数量は含めない。
151
+ unit: 個
152
+ constraints:
153
+ required: true
154
+ min: 1
155
+ example: 1
156
+
157
+ - logical_name: 支払い
158
+ physical_name: payment
159
+ description: >-
160
+ 決済サービス連携を検討する際に扱う支払い応答の管理単位。店頭販売の売上確定やつけ残高の管理とは区別する。
161
+ 応答の識別と受領状況の判断に必要な項目のみ注釈し、通信仕様・応答構造は [[specdojo:ifx-api-sample|決済サービスAPI]] を正本とする。
162
+ schema_ref: docs/ja/specdojo/samples/ifx-api-sample.yaml#/components/schemas/CreatePaymentResponse
163
+ key_fields: [payment_id]
164
+ fields:
165
+ - logical_name: 支払ID
166
+ physical_name: payment_id
167
+ description: 決済サービス側で支払いを識別する番号。店舗の売上IDとは別の識別子として照合に使う。
168
+ - logical_name: 支払ステータス
169
+ physical_name: status
170
+ description: >-
171
+ 決済サービスが返す支払いの処理結果。未処理や失敗を支払済みと扱わず、売上の確定とは別に確認する。
172
+ 許容値は応答スキーマに合わせ、ここでは業務上の意味を対応付ける。
65
173
  allowed_values_detailed:
66
174
  - value: PENDING
67
- label: 未処理
175
+ label: 未処理で支払済みを確認できない
68
176
  - value: PAID
69
- label: 支払済
70
- - value: CANCELED
71
- label: 取消
177
+ label: 決済サービスで支払済みと確認された
178
+ - value: FAILED
179
+ label: 決済処理に失敗し支払済みを確認できない
@@ -2,37 +2,116 @@
2
2
  specdojo:
3
3
  id: specdojo:bds-sample
4
4
  type: ui
5
- status: draft
5
+ status: ready
6
6
  rulebook: specdojo:bds-rulebook
7
+ based_on:
8
+ - specdojo:bes-sample
9
+ - specdojo:cdsd-sample
7
10
  ---
8
11
 
9
- # [帳票仕様](../rulebooks/bds-rulebook.md) サンプル
12
+ # 帳票仕様(週次販売・欠品報告)
10
13
 
11
- ## 1. 目的と適用範囲
14
+ ## 1. 概要
12
15
 
13
- 本書は、業務ユーザー視点の帳票の利用目的や表示項目を定義するための最小サンプルである。
16
+ 週次販売・欠品報告は、駄菓子屋きぬやの 1 週間分の販売記録と在庫記録から、商品別の販売数・欠品の発生・翌週の補充候補をまとめた報告である。店主代表はこの報告で人気商品の欠品の傾向を確かめ、翌週の仕入れ数量を判断する。勘に頼った仕入れを記録に基づく判断へ置き換える最初の手段として、欠品回数の削減の測定にも使う。
14
17
 
15
- ## 2. 入力情報
18
+ ## 2. 読み手と利用目的
16
19
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/bds-rulebook.md`
20
+ | 読み手 | 利用目的 | 帳票から判断すること |
21
+ | -------------------- | ---------------------------------------------- | -------------------------------------------------- |
22
+ | 店主代表 | 翌週の仕入れ前に、売れ筋と欠品を確かめる | 仕入れ数量を増やす商品、仕入れを見送る商品 |
23
+ | 家族利用者代表 | 店番のときに品切れしやすい商品を知る | 店番中に在庫を確かめる商品、店主代表へ知らせる事項 |
24
+ | 店舗運営アドバイザー | 欠品と記録漏れの傾向から運用の改善点を見つける | 記録の付け方や補充のタイミングの見直しが要る点 |
20
25
 
21
- ## 3. 記述内容
26
+ - 作成: 定期処理が作る。定期処理の設定と失敗時の再出力は DEV(開発担当)が担う。
27
+ - 確認・承認: PO(店主代表)が内容を確認し、仕入れ数量を決める。報告は補充の候補を示すだけで、仕入れ数量を決めない。
28
+ - 仕様の確認: BA が読み手と利用目的を、QE が表示項目の確かめ方と例外時の表示を確かめる。確定の条件と承認者は「メモ / 将来課題」に示す。
29
+ - 問い合わせ: 報告の読み方や項目の意味は BA、報告ができない・値が記録と食い違うときは DEV が受ける。
30
+ - 対象外の用途: つけ残高の確認と会計の締めには使わない。それぞれつけ台帳と、[[specdojo:cdsd-sample|概念データストア定義]] の日次締め記録を見る。
22
31
 
23
- - 主な内容: 帳票概要、利用目的、表示項目、出力タイミング など
24
- - 必須観点: 対象、条件、判定基準、責任者
32
+ ## 3. 出力の時期と契機
25
33
 
26
- ## 4. 最小記述例
34
+ - 契機: 日曜の日次締め記録の確定後に自動で作る。日曜が休業日で締めがない週は、日曜 24 時を過ぎて端末が最初に起動したときに作る。店主代表は必要なときに手動でも作れる。
35
+ - 対象期間: 月曜 0 時から日曜 24 時(日本時間)の 1 週間とする。休業日があっても期間は変えない。
36
+ - 取りこぼし: 端末を起動しなかった週は、次に起動したときに過ぎた週の分を 1 週ずつ作る。
37
+ - 再出力: 同じ週を再出力した場合は、その週の報告を作り直し、別の報告を増やさない。作り直す前の報告は残さない。作り直した週の販売数(「不完全」「不明」の印を含む)か記録の注意の販売件数の不一致の日が作り直す前と変わり、翌週の報告が作成済みなら、翌週の前週比の基準が変わるため翌週の報告も続けて再出力する。続けて再出力する週も「集計・算出ルール」の「締めの版」で数え直すため、その週の販売数や不一致の日も変わったときは、さらに次の週へ同じ手順を続ける。作り直す前と変わらなかった週か、作成済みの最新の週まで再出力したら止める。DEV は止めた週までの各週について、前週比が前週の報告の販売数との差と一致することを照合し、一致すれば復旧完了とする。
27
38
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ---------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | [帳票仕様](../rulebooks/bds-rulebook.md) | 最小サンプル |
31
- | 目的 | 業務ユーザー視点の帳票の利用目的や表示項目を定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 帳票概要、利用目的、表示項目、出力タイミング など | 要点のみ記載 |
39
+ ## 4. 出力形式と提供方法
33
40
 
34
- ## 5. 未解決事項
41
+ - 形式: タブレットの画面表示と、印刷用の PDF。日付は `YYYY-MM-DD`、値は整数の個数・回数で示す。CSV など機械で読む形式は出さない。
42
+ - 単位: 1 週につき 1 件。
43
+ - 提供方法: 店主代表がタブレットの報告一覧から開く。印刷した PDF は仕入れノートに綴じる。
44
+ - 閲覧範囲: 店内の店主代表と家族利用者代表に限り、店外へ公開しない。店舗運営アドバイザーには店主代表が店内で印刷を見せる。報告には購入者名・つけ残高を載せず、個人情報を含まない。
45
+ - 保存期間: 欠品回数の年間比較のため、1 年分を残す。
46
+ - 本文構成: 報告の本文構成を定める別の rulebook はない。報告に載せる項目と並び順は、本書の「表示項目」を正とする。
35
47
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
48
+ ## 5. 対象範囲と元にする記録
49
+
50
+ 対象は単一店舗の店頭販売とする。つけ販売は販売数に含め、取り消した販売は含めない。EC、仕入先への発注、廃棄・値引きは対象外とし、在庫の過不足は月次報告で扱う。店番ノートの手書きの控えはシステムに残らず、報告からは読めないため、例外時に店主代表が照合する資料として扱う。
51
+
52
+ | 記録 | 用途 | 正本 | 欠けるときの扱い |
53
+ | ------------ | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
54
+ | 日次締め記録 | 営業日を特定し、その日の販売件数を照合する | [[specdojo:cdsd-sample\|概念データストア定義]] の日次締め記録のうち PO が確定した確認版と、その版が参照する日次販売集計 | 確定した確認版も締め案も販売記録もない日は休業日とする。販売記録か締め案があり、確定した確認版がない日は締め未確定とする。締め記録そのものを読めない場合は営業日を推測せず、報告を保留する |
55
+ | 販売記録 | 商品別の販売数を数える | [[specdojo:cdsd-sample\|概念データストア定義]] の販売記録。現金販売の確定は [[specdojo:bes-sample\|業務イベント: 店頭の現金会計の確定]] | 締めの販売件数と一致しない日は「販売件数の不一致」と注記し、販売数を 0 とみなさず「集計・算出ルール」の「不完全」「不明」で示す |
56
+ | 欠品の記録 | 欠品の発生日と商品を特定する | `bes-stock-out-recorded`(未同梱) | 欠品の記録がない週は欠品 0 件とし、「欠品の記録なし」と注記する |
57
+ | 商品台帳 | 商品名と商品区分を表示する | [[specdojo:cdsd-sample\|概念データストア定義]] の商品台帳 | 商品台帳にない商品は商品コードのまま表示し、店主代表へ確認を促す |
58
+ | 前週の報告 | 前週からの販売数の増減を示す | 前週の本報告 | 初回は「前週なし」と表示する。2 回目以降で前週の報告がない・読めないとき、前週に販売件数の不一致の日があり前週の明細にない商品は「比較不可」と表示し、0 とみなさない |
59
+
60
+ ## 6. 表示項目
61
+
62
+ | No | 区分 | 項目名 | 意味・定義 | 元にする記録 | 記録からの確かめ方 |
63
+ | --- | ------ | ---------------- | ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
64
+ | 1 | 見出し | 対象週 | 対象期間の開始日(月曜)と終了日(日曜)(例: 2026-04-13〜04-19) | 出力の契機(対象期間) | 開始日と終了日が、出力を求めた週の月曜と日曜(日本時間)に一致することを照合する。販売や営業日がない週も同じ |
65
+ | 2 | 見出し | 営業日数 | 期間内で日次締め記録の確定した確認版がある日の数 | 日次締め記録 | 期間内の確定した確認版の対象日の数と一致することを照合する |
66
+ | 3 | 明細 | 商品名 | 期間内に販売数または欠品回数が 1 以上の商品の名前 | 商品台帳、販売記録、欠品の記録 | 販売か欠品の記録がある商品だけが載り、名前が商品台帳と一致する |
67
+ | 4 | 明細 | 販売数 | 期間内に販売した個数(単位: 個)。確かめられないときは「不完全」「不明」 | 販売記録、日次締め記録 | 日ごとに「参照した締めの版」の販売集合の明細を基準時点の状態で合計した値と一致し、印の付け方が「集計・算出ルール」と一致する |
68
+ | 5 | 明細 | 前週比 | 販売数の前週との差(単位: 個、増加は `+`)。差を出せないときは「前週なし」「比較不可」 | 前週の報告 | 今週の販売数から前週の報告の販売数を引いた値と一致する。差を出せない条件では差を表示しない |
69
+ | 6 | 明細 | 欠品回数 | 期間内に欠品を記録した日数 | 欠品の記録 | 欠品の記録がある日付の数と一致する |
70
+ | 7 | 明細 | 補充候補 | 欠品回数が 1 以上の商品に付ける印 | 欠品の記録 | 欠品回数が 1 以上の商品にだけ印があることを照合する |
71
+ | 8 | 集計 | 欠品回数の合計 | 全商品の欠品回数の合計 | 欠品の記録 | 明細の欠品回数の合計と一致する |
72
+ | 9 | 注記 | 記録の注意 | 販売件数が締め記録と一致しない日、締め未確定の日の販売、商品台帳にない商品、欠品の記録の有無、前週比を出せない理由 | 日次締め記録、販売記録、欠品の記録、商品台帳、前週の報告 | 「対象範囲と元にする記録」の欠けるときの扱いと「例外と注意事項」に該当する事項だけが載る |
73
+ | 10 | 注記 | 参照した締めの版 | 対象期間の日ごとに使った日次締め記録の確認版(確定した版がない日は「なし」) | 日次締め記録 | 各日について、出力時点で確定していた最新の確認版と一致する |
74
+
75
+ 並び順は販売数の多い順とし、同数の場合は商品名の五十音順とする。「不完全」を付けた販売数は付いた数値で並べ、印の有無で順を変えない。「不明」の商品は数値の販売数を持つすべての商品の後に、商品名の五十音順で並べる。例えば 12、「不完全」の 8、8、「不明」が混在する明細は、12、8 の 2 件(五十音順)、「不明」の順になる。
76
+
77
+ ## 7. 集計・算出ルール
78
+
79
+ - 期間への割り当て: 販売記録の会計確定日時を日本時間で判定し、対象期間に含まれるものを数える。
80
+ - 営業日の判定: 日次締め記録の確定した確認版がある日を営業日とする。締め案だけの日は営業日に数えず、締め未確定とする。確定した締めの販売件数が 0 で販売記録もない日は、販売 0 の営業日として扱い、注記しない。
81
+ - 締めの版: 各日について、出力時点で PO が確定した最新の確認版を使う。その日の販売数は、その版が参照する日次販売集計の販売集合(含めた売上 ID の集合)の明細を、集計の基準時点の状態で合計する。基準時点の後に承認した訂正と、販売集合にない販売記録は、PO が新しい確認版を確定するまで販売数に含めない。日ごとに使った版を「参照した締めの版」に載せ、同じ版から再出力すれば同じ値になるようにする。確定した版がない日は出力時点の販売記録で数えるため、再出力で値が変わりうる。前週比のために続けて再出力する週も同じ規則で数え直し、前回の販売数を引き継がない。
82
+ - 販売数: 販売明細の数量を商品ごとに合計する。取り消した販売の明細は除く。販売件数の不一致は、版が参照する日次販売集計の販売件数と、その販売集合のうち出力時点で読める売上の件数が一致しない日とする。不一致の日がある週は、記録にある分の合計に「不完全」と付け、販売記録がない商品(欠品だけの商品)は 0 ではなく「不明」とする。
83
+ - 欠品回数: 同じ日に同じ商品の欠品を複数回記録しても 1 回と数える。
84
+ - 前週比: 前週の報告に載っていない商品は前週の販売数を 0 として計算する。初回は「前週なし」とする。前週の報告がない・読めない場合と、今週か前週の販売数が「不完全」「不明」の場合は「比較不可」とし、差を出さない。前週の報告の記録の注意に販売件数の不一致の日がある場合は、前週の明細にない商品も販売数を 0 とみなさず「比較不可」とする。前週に販売記録が丸ごと欠けた商品は明細に載らず印も付かないため、0 との差を出すと誤った増減になる。
85
+ - 補充候補: 欠品回数が 1 以上の商品に印を付ける。仕入れ数量は算出しない。
86
+ - 端数・割合: 値はすべて個数と回数の整数で、端数は出ない。根拠となる分母を定めていないため、欠品率などの割合は出さない。
87
+
88
+ _UNDECIDED_: 欠品回数が 1 回でも補充候補とするか、2 回以上に絞るかは、店主代表が初回の報告を見てから決める。決まるまでは 1 回以上を候補とする。
89
+
90
+ ## 8. 例外と注意事項
91
+
92
+ | 状況 | 報告の扱い | 対応する役割と次の手 |
93
+ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
94
+ | 期間内に販売記録が 1 件もない | 報告を作る。確定した締めの販売件数がすべて 0 なら、欠品の記録がある商品を販売数 0 として明細に載せ、販売も欠品もなければ「明細なし」と表示する。締めの販売件数が 1 以上の日があれば販売件数の不一致として扱い、販売数を「不明」とする | 店主代表が締め記録の販売件数と照合し、記録漏れなら DEV へ知らせる |
95
+ | 期間内に日次締め記録(締め案を含む)も販売記録も 1 件もない(全休の週) | 報告を作り、見出しに「休業週」、営業日数 0 と表示する。欠品の記録がある商品だけを販売数 0 として明細に載せる | 店主代表が休業の予定と合うかを確かめ、合わなければ記録漏れとして DEV へ知らせる |
96
+ | 期間内に確定した締めが 1 件もないが、販売記録か締め案がある | 報告を作り、見出しに「締め未確定」、営業日数 0 と表示する。「休業週」とは表示しない。明細は記録にある販売で作る | 店主代表がその週の締めを確定し、同じ週を再出力する |
97
+ | 締め記録の販売件数と販売記録が一致しない日がある | 報告を作り、記録の注意にその日付と両方の件数を載せる。販売数は「不完全」「不明」とし、前週比は「比較不可」とする | 店主代表がノートの控えと照合し、記録を直したら同じ週を再出力する |
98
+ | 確定した締めのない日に販売記録がある(締め案だけの日を含む) | 販売数に含め、記録の注意に「締め未確定」とその日付を載せる。営業日数には数えない | 店主代表がその日の締めを確定し、同じ週を再出力する |
99
+ | 締めの確定後に、その日の販売記録の訂正・追加がある | 確定した版の基準時点の状態で数え、記録の注意にその日付と「締め後の訂正あり」を載せる | 店主代表がその日の締めの新しい確認版を確定し、同じ週を再出力する |
100
+ | 前週の報告がない・読めない(2 回目以降の週) | 報告を作り、前週比を「比較不可」と表示し、記録の注意に理由を載せる | DEV が前週の報告を再出力し、続けて本週を再出力する |
101
+ | 日次締め記録を読めない | 報告を作らず、報告一覧に「保留」と表示する | DEV が原因を確かめ、解消後に同じ週を再出力する |
102
+ | 日曜の日次締めの前に手動で出力した | 出力時点までの記録で作り、見出しに「締め前」と表示する | 店主代表は締めの後に再出力し、仕入れ判断には再出力した報告を使う |
103
+ | 自動での作成が失敗した | 報告を作らない | DEV が原因を確かめ、解消後に同じ週を再出力する |
104
+
105
+ ## 9. メモ / 将来課題
106
+
107
+ 未整備事項は分類ごとに PM が登録簿へ転記し、PO へ報告する。
108
+
109
+ | 項目(分類) | 未整備事項と影響 | 担当・解消条件 | 引き継ぎ先 |
110
+ | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
111
+ | 根拠の業務イベント(決定待ち) | つけ販売の確定と欠品の記録(`bes-stock-out-recorded`)の業務イベントが未同梱で、`based_on` に接続していない。つけ販売の数え方と欠品回数の境界を確かめられず、月次報告の帳票仕様とテストの設計もこの境界に依存する | 境界を確かめるまで全面受入はしない。PO は本書の確定の判断のときに、受入の保留か限定受入かを選び、選んだ内容を登録簿に記録する。限定受入で使えるのは販売数と営業日数による仕入れ判断だけで、欠品回数と補充候補は参考表示とし、仕入れ数量の根拠にしない。BA が業務イベントを作って `based_on` に接続し、QE がつけ販売と欠品回数の境界の期待結果を確かめた後に、PO が全面受入へ戻すかを判断する | `specdojo:pjr-bds-sales-events` |
112
+ | 補充候補の基準(決定待ち) | 補充候補とする欠品回数の基準が未決で、候補が多すぎる場合がある | PO が初回の報告を見て基準を決め、QE が基準の前後の判定例を確かめる | `specdojo:pjr-restock-threshold` |
113
+ | 欠品削減の測定(課題) | 欠品回数の月間 50% 削減の判定に要る月間の集計は本報告に含めていない | BA が月次報告の帳票仕様を作るときに、本報告の欠品回数を元にする記録として接続する | 月次報告の帳票仕様(未作成) |
114
+ | 上位の索引(課題) | 帳票仕様の索引 `bds-index` は未作成で、時刻の基準や閲覧範囲などの共通事項を本書に書いている | BA が 2 件目の帳票仕様を作るときに索引を作り、共通事項を索引へ移して本書は差分だけにする | - |
115
+ | 本書の変更(変更要求) | 表示項目・算出ルール・契機を変えると、定期処理、過去の週の再出力、再出力した週より後の週の前週比、仕入れノートに綴じた報告との比較に影響する | BA が差分を整理し、DEV が定期処理と再出力する週の範囲を、QE が再検証の範囲を示す。PO が承認してから定期処理へ反映し、反映後に直近の週を再出力する。過去の週を再出力するときは「出力の時期と契機」に従い、販売数が変わった週の次の週を順に再出力し、作り直す前と変わらなかった週か作成済みの最新の週まで続ける。QE は再出力した各週の前週比が、前週の報告の販売数との差と一致することを確かめる | 変更ごとに登録する |
116
+
117
+ 確定と公開: 本書は店内で使う報告の仕様で、店外へ公開しない。本例の値と記録は架空で、実在の購入者やつけの情報を含まない。確定の前に BA と QE が上の確認を終え、利用リポジトリの文書検査(本リポジトリでは `npm run lint:md`・`npm run lint:fm`・`npm run validate:schema`)がエラーなく終わることを確かめる。エラーがあれば作成者が直して再実行する。人間の PO(店主代表)が未決事項の扱いを確かめ、`status` を `ready` にするかを判断する。
@@ -4,35 +4,74 @@ specdojo:
4
4
  type: requirement
5
5
  status: draft
6
6
  rulebook: specdojo:bes-index-rulebook
7
+ based_on:
8
+ - specdojo:cdfd-overview-sample
9
+ supersedes: []
7
10
  ---
8
11
 
9
- # [業務イベント / 業務イベント仕様 全体構成](../rulebooks/bes-index-rulebook.md) サンプル
12
+ # 業務イベント一覧: 駄菓子屋きぬや販売管理
10
13
 
11
- ## 1. 目的と適用範囲
14
+ 駄菓子屋きぬやの店舗運営で、各プロセス領域を起動する業務上の出来事を一覧で定義する。対象は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の「プロセス領域」に挙げた仕入・販売・在庫・顧客・締めの 10 領域の起点イベントであり、領域 ID・領域名・起点イベントの文言は同書を正本とする。
12
15
 
13
- 本書は、業務上で発生する主要なイベントを一覧で定義するための最小サンプルである。
16
+ [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針に沿い、店主代表と家族利用者代表が、販売・入荷・つけをいつ記録するか同じ判断をできるようにする。購入の申し出と会計確定、納品と検品後の入荷記録を区別し、記録漏れや二重計上を防ぐための定義とする。
14
17
 
15
- ## 2. 入力情報
18
+ BA は本書を BPS・BR の入力、UX は UI 仕様の記録契機、QE はテスト仕様の発生・不成立条件の入口として使う。ARC・開発担当は個別 BES とデータモデルへの対応を確認し、人間の PO(店主代表)は対象範囲と未決事項の扱いを承認する。受けた後の手順は BPS、金額計算は [[specdojo:br-sample|販売金額計算の業務ルール]]、取引の状態は状態定義に委ねる。
16
19
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/bes-index-rulebook.md`
20
+ _ASSUMPTION_: 事実データは、上位文書の「データストア」に挙げた記録の主な内容から、発生時点で観測できる情報を概念名で挙げた。データモデルとの対応は未照合であり、保管先の未確定とは別の確認事項として「未決事項と承認条件」で管理する。値・構文・構造はデータモデル・schema を正本とする。
20
21
 
21
- ## 3. 記述内容
22
+ ## 1. 業務イベント一覧
22
23
 
23
- - 主な内容: イベントID、イベント名、何が起きたか、いつ、発生条件 など
24
- - 必須観点: 対象、条件、判定基準、責任者
24
+ <!-- prettier-ignore -->
25
+ | イベントID | イベント名 | 起点領域 | 何が起きたか | いつ | 誰が/何が | 発生条件 | 事実データ |
26
+ | --- | --- | --- | --- | --- | --- | --- | --- |
27
+ | `bes-restock-requested` | 在庫から補充依頼を受けた | `P-01` | 補充判断で決まった補充対象と数量が、仕入計画へ渡された。 | 仕入計画が補充依頼を受けた時点。発注の時点ではない。 | 店主代表 | 補充対象の商品と数量が特定されている。 | 商品、補充数量、依頼時点 |
28
+ | `bes-goods-delivered` | 仕入先から商品が納品された | `P-02` | 発注した商品が店に届いた。 | 店番担当が納品を受け取った時点。検品の完了時点ではない。 | 仕入先が届け、店番担当が受け取る | 対応する発注がある。発注のない納品は本イベントにせず未決事項で扱う。 | 仕入先、商品、納品数量、受取時点、受取担当 |
29
+ | `bes-cash-sale-confirmed` | 顧客が商品を購入した | `P-03` | 顧客が店頭で商品を現金で購入した。 | 店番担当の要求により販売管理システムが会計確定を記録した時点。控えの印字は待たない。 | 店番担当が現金受領を確認し、販売管理システムが確定を記録する | 現金取引で明細・請求金額を確認し、受領金額が請求金額以上で、未確定の会計を確定した。つけは `bes-credit-sale-requested` で扱う。 | 取引番号、商品明細、請求金額、受領金額、釣銭金額、支払区分、会計確定時点、確定担当 |
30
+ | `bes-credit-sale-requested` | 常連客がつけでの購入を依頼した | `P-04` | 登録済みの常連客が、代金を後払いにする購入を申し出た。 | 上限内は店番担当が申し出を受けた時点。上限超過の成立時点は個別仕様で確定する。 | 常連客 | 申し出た人が顧客台帳に登録されている。上限超過の扱いは未決事項に残す。 | 顧客、商品、数量、請求金額、申出時点、受付担当 |
31
+ | `bes-stock-movement-recorded` | 販売または入荷が記録された | `P-05` | 在庫を増減させる販売または入荷の記録が成立した。 | 販売の確定、または検品後の入荷の記録が成立した時点。 | 販売・入荷の記録を受けた販売管理システム | 販売の確定、または検品済みの入荷のどちらかである。 | 商品、増減の区分(販売・入荷)、数量、記録時点、元の取引 |
32
+ | `bes-stock-below-threshold` | 在庫が補充基準を下回った | `P-06` | 商品の現在庫が、商品台帳の補充基準より少なくなった。 | 在庫の記録で基準を下回った時点。棚を目で見た時点ではない。 | 在庫の記録を保つ販売管理システム | 対象の商品に補充基準が定められている。 | 商品、現在庫、補充基準、下回った時点 |
33
+ | `bes-credit-use-requested` | 常連客がつけの利用を申し出た | `P-07` | まだ登録のない客が、つけを使いたいと申し出た。 | 店主代表が申し出を受けた時点。登録の完了時点ではない。 | 客 | 申し出た人が顧客台帳に登録されていない。 | 申出者の連絡先、希望するつけ上限、申出時点 |
34
+ | `bes-credit-payment-offered` | 常連客がつけの支払を申し出た | `P-08` | 常連客が、つけ残高の全部または一部を払うと申し出た。 | 店主代表が申し出を受けた時点。残高の更新時点ではない。 | 常連客 | 申し出た客につけ残高がある。 | 顧客、支払額、申出時点、受付担当 |
35
+ | `bes-store-closed` | 閉店した | `P-09` | その日の営業が終わった。 | 店主代表が閉店とした時点。閉店時刻を過ぎても営業中なら発生しない。 | 店主代表 | その日に営業している。 | 営業日、閉店時点 |
36
+ | `bes-month-end-closed` | 月末の締めが確定した | `P-10` | 対象月の締めが確定した。 | 店主代表が対象月の締めを確定した時点。暦上の月末到来だけでは発生しない。 | 店主代表 | 対象月が特定され、店主代表が締めを確定している。日次締めとの関係は未決事項で扱う。 | 対象月、締めの確定時点 |
25
37
 
26
- ## 4. 最小記述例
38
+ ## 2. 個別仕様への詳細化
27
39
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ------------------------------------------------------------------------------ | ------------------------------------ |
30
- | ドキュメント | [業務イベント / 業務イベント仕様 全体構成](../rulebooks/bes-index-rulebook.md) | 最小サンプル |
31
- | 目的 | 業務上で発生する主要なイベントを一覧で定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | イベントID、イベント名、何が起きたか、いつ、発生条件 など | 要点のみ記載 |
40
+ | イベントID | 個別仕様 | 詳細化する範囲 | 詳細化の理由 |
41
+ | --------------------------- | ----------------------------------------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------- |
42
+ | `bes-cash-sale-confirmed` | [[specdojo:bes-sample\|業務イベント: 店頭の現金会計の確定]] | 行の全体 | 明細追加・金額確認・再表示・印字と確定の境界、一取引での発生回数と明細の対応を詳細化する |
43
+ | `bes-credit-sale-requested` | `bes-credit-sale-over-limit`(未作成) | つけ上限を超える申し出を受けた場合 | 上限超過時に、申し出の受付と店主代表の承認のどちらで成立するかが割れる |
33
44
 
34
- ## 5. 未解決事項
45
+ - `specdojo:bes-sample` は完成例の文書 ID であり、対応するイベント ID は `bes-cash-sale-confirmed` である。同書からも本一覧と対応行を参照する。
46
+ - `bes-credit-sale-requested` のうち上限内の申し出は、一覧の定義のまま扱う。上限超過の経路は個別仕様で境界を確定するまで、BPS・UI・テスト仕様の確定入力にしない。
47
+ - 未作成の個別仕様は文書 ID だけを仮置きし、作成時に BA が一覧の行と個別仕様の双方向の参照を設定する。
35
48
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
49
+ ## 3. 未決事項と承認条件
50
+
51
+ ### 3.1. 判断を残す論点
52
+
53
+ <!-- prettier-ignore -->
54
+ | 論点 | 現時点の扱い・影響 | 判断者・確認担当 | 次アクション・完了条件 | 解消の時期 |
55
+ | --- | --- | --- | --- | --- |
56
+ | 発注のない納品 | _UNDECIDED_: `bes-goods-delivered` に含めるかは未判断。現定義では発生せず、発注外納品の BPS・UI・テストが確定できない。 | BA が確認し、PO(店主代表)が判断する。 | BA が発注あり・なしの納品を店主代表に確認し、一覧に含めるか別の境界にするかを上位 CDFD と照合する。判断と影響先を記録して完了とする。 | 入荷検品 BPS の作成前 |
57
+ | つけ上限超過 | _UNDECIDED_: 申し出の受付と店主代表の承認のどちらで成立するかが未確定。当該経路の BPS・BR・UI・テストの判定に影響する。 | BA が整理し、PO(店主代表)が判断する。 | `bes-credit-sale-over-limit` を作成し、一覧との相互参照、上限内との境界、BR への参照を ARC・QE が確認して完了とする。 | つけ販売の設計への引き渡し前 |
58
+ | 締めの判定 | _ASSUMPTION_: 閉店は店主代表の宣言時点とした。月末の締めと最終営業日の日次締めの関係は未確認。日次・月次の起動時点が変わり得る。 | BA が確認し、PO(店主代表)が判断する。 | 営業延長日と月末休業日の例で発生時点を確認し、必要なら上位 CDFD と一覧を更新する。両方の締めの境界が決まれば完了とする。 | 日次締め・月次見直し BPS の作成前 |
59
+ | 事実データの照合 | _ASSUMPTION_: 販売記録・在庫記録・つけ台帳のデータモデルと未照合。発生時点で情報がそろわない場合、イベント処理・テストの入力が不足する。 | ARC が対応を確認し、BA・QE が業務上の意味と確認例を照合する。 | 全行の概念名をデータモデルへ対応付け、発生後の結果を含まないことを確認する。不足の解消または PO の制限事項承認を記録して完了とする。 | イベント処理・テスト設計への引き渡し前 |
60
+ | 一覧の範囲 | 10 領域の起点イベントだけを対象とする。値引き・取消・返品は内部の出来事として本一覧に含めず、全業務の対象外という意味にはしない。 | BA が網羅を確認し、PO(店主代表)が承認する。 | 起点イベントと有効行の対応を確認し、範囲の承認を記録する。追加の起点が必要なら先に上位 CDFD の範囲を見直す。 | 本書を確定入力として扱う前 |
61
+
62
+ 判断と確認結果は本書と対象案件のレビュー結果に記録する。PM は、未決の境界、個別仕様の未作成、データ未照合を PJR 登録候補として PO へ報告し、該当する確認担当・判断時期・後続作業への影響を転記する。期限までに解消できなければ、PM が影響する設計作業を保留し、PO に制限事項としての受入可否を求める。
63
+
64
+ ### 3.2. 確定入力としての受入条件
65
+
66
+ BA・ARC・QE は、次のすべてを満たすことを確認し、レビュー結果に証拠を残す。
67
+
68
+ - 上位 CDFD の 10 領域に有効な 10 行が対応し、出典のない行がない。必須 8 列に空欄がなく、廃止行を含めイベント ID の形式違反・重複が 0 件である。
69
+ - QE が、現金受領不足・明細確認中は現金会計の確定なし、確定後の再表示・再印字では追加の確定なしと判定できる。納品受取と検品後の入荷記録、閉店宣言と閉店時刻到来も区別できる。個別の判定例は個別 BES を参照する。
70
+ - 個別 BES の対応範囲と相互参照が一致し、上表の論点が解消または制限事項として承認され、PO(店主代表)が一覧の範囲を承認している。
71
+ - [[specdojo:bes-index-rulebook|業務イベント一覧 作成ルール]] の「検証と引き渡し」に従った静的検査で Markdown・Frontmatter のエラーが 0 件で、未解決指摘の扱いを QE が確認している。メタ情報の制約は同書の参照先を正本とし、sample の文書 ID とイベント ID を混同しない。
72
+
73
+ 本例は業務判断を残した完成記述例であり、実案件の承認済み仕様ではない。現時点では上の条件を満たしていないため `status: draft` を維持し、人間の PO が承認するまで BPS・BR・UI・テスト仕様への確定入力にしない。
74
+
75
+ ### 3.3. 改訂時の引き継ぎ
76
+
77
+ つけ上限超過の境界が決まった際は、BA が `bes-credit-sale-requested` の行と `bes-credit-sale-over-limit`、つけ販売の BPS・BR を照合し、UX が申出受付と承認の画面、QE が上限内・超過時の期待結果を更新する。ARC・開発担当は申出時点と承認時点で得られる情報をデータモデル・イベント契約と照合する。PM は未完の追従と引き渡し時期を PJR で管理し、PO が制限の解除を判断する。
@@ -2,37 +2,96 @@
2
2
  specdojo:
3
3
  id: specdojo:bes-sample
4
4
  type: requirement
5
- status: draft
5
+ status: ready
6
6
  rulebook: specdojo:bes-rulebook
7
+ based_on: []
8
+ supersedes: []
7
9
  ---
8
10
 
9
- # [業務イベント / 業務イベント仕様](../rulebooks/bes-rulebook.md) サンプル
11
+ # 業務イベント: 店頭の現金会計の確定
10
12
 
11
- ## 1. 目的と適用範囲
13
+ 駄菓子屋きぬやで、入力途中の取引や金額の確認を販売実績と混同しないため、一取引の現金会計が確定した事実を定義する。店主以外が店番しても、同じ境界で記録対象を判断できるようにする。
12
14
 
13
- 本書は、業務上で発生する主要なイベントを個別に定義するための最小サンプルである。
15
+ _ASSUMPTION_: 本例では単一店舗・一台のタブレットでの店頭現金販売を扱う。現金を受領してから会計を確定し、同じ取引を再表示しても別の会計確定とはしない。つけ販売、返品、取消、日次締めは別の出来事として扱う。
14
16
 
15
- ## 2. 入力情報
17
+ 本書は [[specdojo:bes-index-sample|業務イベント一覧]] の `bes-cash-sale-confirmed`(「顧客が商品を購入した」、起点領域 `P-03`)の行全体を詳細化する。一覧での購入の成立を、本書では「店頭の現金会計が確定した」として具体化する。イベント ID は `bes-cash-sale-confirmed`、完成例の文書 ID は `specdojo:bes-sample` として区別する。本書は完成記述の例であり、実案件での承認済み仕様を示すものではない。
16
18
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/bes-rulebook.md`
19
+ ## 1. 何が起きたか
20
20
 
21
- ## 3. 記述内容
21
+ 一つの取引について、購入明細と請求金額を店番担当が確認し、現金の受領を確認したうえで会計を確定した。
22
22
 
23
- - 主な内容: イベントID、イベント名、何が起きたか、いつ、発生条件 など
24
- - 必須観点: 対象、条件、判定基準、責任者
23
+ - 一取引の確定につき一回発生する。一取引に複数の商品明細があっても、明細ごとには発生しない。
24
+ - 商品の追加、数量の修正、合計金額の表示だけでは発生しない。
25
+ - 確定後の控えの印字や在庫への反映は、この出来事を受けた後の業務で扱う。
25
26
 
26
- ## 4. 最小記述例
27
+ 定義を利用できると判断する基準は、「発生条件」の各場面から発生有無と回数を決められ、「事実データ」から同じ取引の明細と金額を対応付けられることである。実案件では、業務定義と公開可否の承認を人間の PO である店主代表が担い、開発担当が条件・データの対応を説明する。BA はイベント処理とテスト設計への引き渡し前に一覧の行との整合と、後述するデータモデル・BPS の仮置き参照を照合する。未解決の参照を残して引き渡す場合は制限事項として PO が承認し、対象案件のレビュー結果に記録する。
27
28
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | --------------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | [業務イベント / 業務イベント仕様](../rulebooks/bes-rulebook.md) | 最小サンプル |
31
- | 目的 | 業務上で発生する主要なイベントを個別に定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | イベントID、イベント名、何が起きたか、いつ、発生条件 など | 要点のみ記載 |
29
+ ## 2. いつ
33
30
 
34
- ## 5. 未解決事項
31
+ 店番担当が現金の受領と釣銭を確認し、販売管理システムが対象取引の会計確定を記録した時点を発生時点とする。
35
32
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
33
+ - 顧客が現金を渡した時刻と、会計確定を記録した時刻を区別する。受領だけでは確定の成立を示さない。
34
+ - 発生時刻は個別取引の確定記録を基準にし、画面を参照した時刻や控えを再印字した時刻へ置き換えない。
35
+
36
+ 発生時点は営業日による集計時点とは分ける。日次締めの確定時刻を、個別取引の会計確定時刻として用いない。
37
+
38
+ ## 3. 誰が/何が
39
+
40
+ | 起点区分 | 確定を要求する主体 | 確定を記録する主体 | 主体ごとの責務 |
41
+ | -------------- | ------------------ | ------------------ | ------------------------------------------------------------------ |
42
+ | 店主による店番 | 店主代表 | 販売管理システム | 店主代表が明細・請求金額・現金の受領・釣銭を確認して確定を要求する |
43
+ | 家族による店番 | 家族利用者代表 | 販売管理システム | 家族利用者代表が同じ確認を行い、確定を要求する |
44
+
45
+ - 本書では、上の二つの役割を業務上の「店番担当」と呼ぶ。誰が店番していても発生境界は同じである。
46
+ - 販売管理システムは、一取引の会計確定と発生時点を記録するシステムである。現金を受け取った事実の確認は店番担当が担う。
47
+ - 顧客は商品を購入して現金を渡す主体であり、システムへ会計確定を要求する主体ではない。
48
+
49
+ ## 4. 発生条件
50
+
51
+ 次の条件がすべて成立したときに発生する。
52
+
53
+ 1. 対象は店頭の現金取引であり、会計がまだ確定していない(取引状態 `payment_status` が未確定 `unconfirmed`。仮置き ID `cdsd-order-status` / `bdd-sales-record`)。
54
+ 2. 一件以上の商品明細があり、店番担当が購入内容と請求金額を確認している。
55
+ 3. 受領金額が請求金額以上で、店番担当が受領と釣銭を確認している。
56
+ 4. 店番担当の確定要求により、対象取引の会計確定が記録された。
57
+
58
+ 金額計算と端数処理は販売金額の業務ルール `br-sales-amount`([[specdojo:br-sample|販売金額計算の業務ルールサンプル]])、確定後の控え・在庫反映は販売プロセス(仮置き ID `bps-sales-order-flow`)で扱う。本書ではそのロジックや手順を展開しない。
59
+
60
+ | 場面 | 発生有無・回数 | 判断根拠 |
61
+ | -------------------------------------------- | ---------------------- | ------------------------------------ |
62
+ | 複数の商品明細を一つの取引として確定 | 一回 | 明細数ではなく取引の確定が単位である |
63
+ | 合計表示後、受領金額が請求金額未満 | 発生しない | 受領条件を満たしていない |
64
+ | 現金を受領した後、確定前に入力内容を見直し中 | 発生しない | 確定の記録がない |
65
+ | 会計確定の記録が成立する前に処理が停止 | 発生しない | 受領済みでも確定の成立が確認できない |
66
+ | 確定済み取引の控えを再印字 | 新たには発生しない | 同じ確定済み取引の参照である |
67
+ | 確定後に控えの印字が失敗 | 確定時の一回のまま | 印字は確定後の処理である |
68
+ | つけでの購入を受け付ける | 本イベントは発生しない | 本例の現金取引の範囲外である |
69
+
70
+ 確定が記録されたか分からない場合に、現金の受領だけから発生済みと推定しない。事実の照合・復旧手順は販売プロセスへ委ねる。
71
+
72
+ ## 5. 事実データ
73
+
74
+ 項目名は業務上の論理名とする。型、値の形式、構造、保存形式は販売記録のデータモデル・schema(仮置き ID `bdd-sales-record` / `schema:sales-record`)で定義し、本書では重複定義しない。
75
+
76
+ | 項目 | 業務上の意味 | 必要になる条件 |
77
+ | ------------ | ------------------------------------------------------------------------ | ---------------------------- |
78
+ | 取引番号 | 確定した一つの販売取引を識別する | 常に必要 |
79
+ | 会計確定時点 | 本書の「いつ」で定義した成立時点 | 常に必要 |
80
+ | 確定担当 | 確定を要求した店番担当を識別する。役割だけでなく実際の担当をたどれる情報 | 常に必要 |
81
+ | 商品明細 | 購入した商品と数量、および会計確定時点の販売金額の内訳 | 常に必要 |
82
+ | 請求金額 | 当該取引で顧客に請求した金額 | 常に必要 |
83
+ | 受領金額 | 店番担当が受領を確認した現金の額 | 常に必要 |
84
+ | 釣銭金額 | 当該会計で確認した釣銭の額 | 常に必要。釣銭なしも識別する |
85
+ | 支払区分 | 当該イベントが現金会計であることを示す情報 | 常に必要 |
86
+
87
+ ### 5.1. 取引との対応の確認例
88
+
89
+ この例では、取引番号を会計確定と明細の対応に用いる。一括要求・並列要求は扱わないため、要求を束ねる識別子を追加しない。取引番号の採番規則はここでは定めない。
90
+
91
+ | 確認対象 | 確認する事実 |
92
+ | ---------------------------------- | -------------------------------------------------------------------------- |
93
+ | 取引 `TX-A` に二つの商品明細がある | 一回の確定に両明細が含まれ、どちらも `TX-A` の請求金額の根拠としてたどれる |
94
+ | 続けて別の取引 `TX-B` を確定する | 二つの取引の明細・受領金額が混ざらず、確定はそれぞれ一回となる |
95
+ | `TX-A` の控えを再印字する | 同じ取引番号を参照し、新しい会計確定として数えない |
96
+
97
+ データモデルとの照合では、上の確認例に加えて、同じ取引の受領金額・釣銭金額も対応することを確認する。モデル上の物理項目名や保存単位が変わっても、この業務上の対応を維持する。