specdojo 0.8.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (292) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +77 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/orchestrator.js +5 -77
  9. package/dist/commands/where.js +25 -0
  10. package/dist/dashboard/dashboard.js +5 -3
  11. package/dist/dashboard/routines.js +4 -7
  12. package/dist/dashboard/shared.js +2 -2
  13. package/dist/dashboard/timeline.js +14 -14
  14. package/dist/deliverable/trash.js +2 -1
  15. package/dist/docs/index-command.js +2 -2
  16. package/dist/docs/yaml-business-tables.js +243 -0
  17. package/dist/docs/yaml-interface-tables.js +106 -0
  18. package/dist/docs/yaml-pages-command.js +5 -3
  19. package/dist/docs/yaml-pages.js +146 -3
  20. package/dist/docs/yaml-table-shared.js +70 -0
  21. package/dist/docs/yaml-tables.js +39 -0
  22. package/dist/exec/agent-config.js +9 -0
  23. package/dist/exec/agent-protected-config.js +2 -0
  24. package/dist/exec/commands.js +31 -18
  25. package/dist/exec/events.js +34 -14
  26. package/dist/exec/evidence.js +13 -3
  27. package/dist/exec/opencode-permissions.js +117 -0
  28. package/dist/exec/parent-validation.js +56 -3
  29. package/dist/exec/plans-core.js +21 -2
  30. package/dist/exec/plans-generation.js +6 -7
  31. package/dist/exec/post-integration.js +162 -0
  32. package/dist/exec/queue-command.js +166 -0
  33. package/dist/exec/queue.js +285 -0
  34. package/dist/exec/register-foreign-wait.js +82 -0
  35. package/dist/exec/repo-integration-sync.js +17 -5
  36. package/dist/exec/repo-trace.js +2 -1
  37. package/dist/exec/reporter.js +2 -2
  38. package/dist/exec/results.js +24 -4
  39. package/dist/exec/review-kata.js +4 -1
  40. package/dist/exec/run/agent-pipeline.js +3 -2
  41. package/dist/exec/run/agent.js +12 -6
  42. package/dist/exec/run/change-scope.js +365 -0
  43. package/dist/exec/run/deferred-cleanup.js +31 -0
  44. package/dist/exec/run/in-place.js +5 -2
  45. package/dist/exec/run/job-lock.js +66 -0
  46. package/dist/exec/run/job-sequence.js +137 -0
  47. package/dist/exec/run/job.js +56 -19
  48. package/dist/exec/run/lifecycle-commands.js +1 -1
  49. package/dist/exec/run/lock.js +22 -1
  50. package/dist/exec/run/register-command.js +8 -5
  51. package/dist/exec/run/register-mode.js +68 -8
  52. package/dist/exec/run/register-resume.js +68 -14
  53. package/dist/exec/run/register-state.js +13 -8
  54. package/dist/exec/run/register-worktree.js +140 -125
  55. package/dist/exec/run/schedule-mode.js +75 -14
  56. package/dist/exec/run/schedule-prepare.js +3 -0
  57. package/dist/exec/run/schedule-task.js +88 -38
  58. package/dist/exec/run/shared.js +5 -0
  59. package/dist/exec/schedule/schedule.js +116 -4
  60. package/dist/exec/shared.js +2 -2
  61. package/dist/exec/smoke.js +190 -0
  62. package/dist/exec/strategy.js +13 -3
  63. package/dist/exec/task-repos.js +19 -4
  64. package/dist/exec/task-view.js +6 -4
  65. package/dist/exec/trial-commands.js +5 -2
  66. package/dist/exec/trial-core.js +6 -1
  67. package/dist/exec/validation-metrics.js +181 -0
  68. package/dist/exec/worktree-cleanup-lock.js +26 -0
  69. package/dist/exec/worktree-command.js +12 -2
  70. package/dist/exec/worktree-ops-commit.js +2 -2
  71. package/dist/exec/worktree.js +13 -2
  72. package/dist/grade/command-apply.js +3 -3
  73. package/dist/grade/command-inspect.js +5 -3
  74. package/dist/grade/command-plan.js +1 -1
  75. package/dist/grade/command-run.js +5 -1
  76. package/dist/grade/run.js +64 -8
  77. package/dist/job/definition.js +84 -8
  78. package/dist/job/job.js +79 -23
  79. package/dist/register/authoring-sources.js +22 -16
  80. package/dist/register/maintenance-commands.js +2 -2
  81. package/dist/register/register.js +31 -7
  82. package/dist/register/renumber.js +1 -3
  83. package/dist/routine/definition.js +9 -0
  84. package/dist/routine/routine.js +137 -43
  85. package/dist/routine/status.js +62 -0
  86. package/dist/schedule/schedule.js +38 -39
  87. package/dist/shared/agent-types.js +5 -0
  88. package/dist/shared/cross-process-lock.js +9 -1
  89. package/dist/shared/dist-freshness.js +8 -2
  90. package/dist/shared/git-environment.js +2 -1
  91. package/dist/shared/git.js +44 -1
  92. package/dist/shared/lefthook-scaffold.js +3 -0
  93. package/dist/shared/local-config.js +244 -0
  94. package/dist/shared/specdojo-config.js +34 -20
  95. package/dist/shared/specdojo-gitignore.js +1 -0
  96. package/dist/shared/text.js +17 -1
  97. package/dist/shared/where-alias.js +13 -0
  98. package/dist/specdojo.js +4 -0
  99. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  100. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  101. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  102. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  103. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
  104. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  105. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  106. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  107. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  108. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  109. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  110. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  111. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  112. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  113. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  114. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  115. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  116. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  117. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  118. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  119. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  120. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  121. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  122. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  123. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  124. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  125. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  126. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  127. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  128. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  129. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  130. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  131. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  132. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  133. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  134. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  135. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  136. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  137. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  138. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  139. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  140. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  141. package/docs/ja/specdojo/references/command-reference.md +258 -118
  142. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  143. package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
  144. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  145. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  146. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  147. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  148. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  149. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  150. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  151. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  152. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  153. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  154. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  155. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  156. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  157. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  158. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  159. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  160. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  161. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  162. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  163. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  164. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  165. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  166. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  167. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  168. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  169. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  170. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  171. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  172. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  173. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  174. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  175. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  176. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  177. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  178. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  179. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  180. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  181. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  182. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  183. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  184. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  185. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  186. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  187. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  188. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  189. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  190. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  191. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  192. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  193. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  194. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  195. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  196. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  197. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  198. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  199. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  200. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  201. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  202. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  203. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  204. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  205. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  206. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  207. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  208. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  209. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  210. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  211. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  212. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  213. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  214. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  215. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  216. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  217. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  218. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  219. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  220. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  221. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  222. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  223. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  224. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  225. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  226. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  227. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  228. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  229. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  230. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  234. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  235. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  236. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  237. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  238. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  239. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  240. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  241. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  242. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  243. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  244. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  245. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  246. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  247. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  248. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  249. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  250. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  251. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  252. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  253. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  254. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  255. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  256. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  257. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  258. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  259. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  260. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  261. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  262. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  263. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  264. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  265. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  266. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  267. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  268. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  269. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  270. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  271. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  272. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  273. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  274. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  275. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  276. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  277. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  278. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  279. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  280. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  281. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  282. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  283. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  284. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  285. package/package.json +9 -6
  286. package/templates/antigravity/orchestrator.md +4 -1
  287. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  288. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  289. package/templates/codex/orchestrator.md +4 -1
  290. package/templates/init-exec-defaults.yaml +13 -0
  291. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  292. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -12,33 +12,33 @@ specdojo:
12
12
 
13
13
  ## 1. 概要
14
14
 
15
- 店主代表と家族利用者代表が、購入明細と請求額を確認して現金販売を記録し、釣銭とレシートを来店客へ渡すための CLI コマンド群である。会計と印字の結果を区別して残し、店番の交代時にも未完了の取引を引き継げるようにする。
15
+ 店番担当が現金販売を記録し、釣銭とレシートを渡すための CLI コマンド群である。会計と印字の結果を区別して残し、店番の交代時に未完了の取引を引き継げるようにする。
16
16
 
17
17
  ## 2. 利用目的と対象ユーザー
18
18
 
19
- | 対象者 | 解決する課題・達成する結果 | 確認・合意する内容 |
20
- | -------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------- |
21
- | 店主代表 | 暗算やノートへの転記に頼らず、売上を記録して店番を引き継ぐ | 会計の確定条件、取消可能な範囲、障害時の照合結果を最終判断する |
22
- | 家族利用者代表 | 店主不在でも同じ手順で商品を登録し、請求額と釣銭を提示する | 開始から会計完了までの操作と、保留時に店主へ渡す情報を確認する |
23
- | 開発担当・同行レビュー担当 | 正常終了と警告・異常を識別し、二重会計を避ける | 入出力の正本、保存される記録、回復後の期待結果を照合する |
19
+ | 対象者 | 解決する課題・達成する結果 | 確認・合意する内容 |
20
+ | -------------------------- | ------------------------------------------ | ------------------------------------------------ |
21
+ | 店主代表 | 暗算や転記に頼らず売上を記録する | 会計の確定条件、取消できる範囲、障害時の照合結果 |
22
+ | 家族利用者代表 | 店主不在でも同じ手順で会計する | 会計までの操作、保留時に店主へ渡す情報 |
23
+ | 開発担当・同行レビュー担当 | 正常・警告・異常を識別し、二重会計を避ける | 入出力の正本、保存される記録、回復後の期待結果 |
24
24
 
25
- 日々の販売記録を継続する目的は [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針に対応する。対象は単一店舗・現金販売の開始、明細追加、金額確認、会計確定、確定前の取消とする。確定後の返品・訂正は店主代表の照合手順へ引き渡し、つけ販売、キャッシュレス決済、仕入れ、在庫調整は対象外とする。
25
+ 対象は単一店舗・現金販売の開始、明細追加、金額確認、会計確定、確定前の取消とする。確定後の返品・訂正は店主代表の照合手順へ引き渡し、つけ販売、キャッシュレス決済、仕入れ、在庫調整は対象外とする。
26
26
 
27
- _ASSUMPTION_: 本例は店舗端末1台を人が操作する学習用 CLI とし、商品マスタの取得と売上登録に本部 API を利用する。通常利用のタブレット画面とは別の操作例であり、自動会計・無人運転や通信不能時の販売継続は扱わない。架空のコマンド構文・データ契約の参照名は「メモ / 将来課題」で未同梱と区別する。
27
+ _ASSUMPTION_: 店舗端末1台を人が操作する学習用 CLI とし、商品マスタの取得と売上登録に本部 API を使う。自動会計・無人運転や通信不能時の販売継続は扱わない。
28
28
 
29
29
  ## 3. 操作の流れ
30
30
 
31
- 1. **取引を開始する**: 店番担当(店主代表または家族利用者代表)は、前の取引に未解決の会計がないことを確認して `sales start` を実行する。表示された取引番号を以後の照合に使う。既存取引があれば新規取引を重ねず、その明細と確定状態を確認する。
32
- 2. **明細をそろえる**: `sales add` で商品コードと数量を指定する。追加結果の商品名・数量・金額を現物と照合し、必要な商品分を繰り返す。商品マスタの取得失敗時は追加されていない明細を確認してから再試行する。誤登録をやり直す場合は、確定前に `sales cancel` で取引全体を取り消す。
33
- 3. **金額を提示する**: `sales total` で明細・税額・請求額を確認する。明細が空なら会計へ進まず商品を追加し、購入中止なら取り消す。来店客と金額が合意できた後に現金を受け取る。
34
- 4. **会計を確定する**: `sales complete` の対話で預かり金額を入力する。入力不正・不足は同じ対話で修正する。会計確定の通知、販売実績の保存、本部の受付結果を照合して釣銭を渡す。印字は会計確定後に行い、印字未完了の警告は会計の取消とみなさない。
35
- 5. **結果を引き継ぐ**: 店番担当は完了した取引番号とレシートを確認する。未印字・結果不明・保存失敗があれば、取引番号と保持された記録を店主代表へ渡す。店主代表は未解決事項の有無を確認してから次の店番へ引き継ぐ。
31
+ 1. **取引を開始する**: 店番担当(店主代表か家族利用者代表)が `sales start` を実行し、表示された取引番号を以後の照合に使う。
32
+ 2. **明細をそろえる**: `sales add` で商品コードと数量を指定し、結果を現物と照合する。誤登録は確定前に `sales cancel` で取引全体を取り消す。
33
+ 3. **金額を提示する**: `sales total` で明細・税額・請求額を確認し、来店客と合意してから現金を受け取る。
34
+ 4. **会計を確定する**: `sales complete` の対話で預かり金額を入力し、会計確定の通知を見て釣銭を渡す。印字未完了の警告は会計の取消とみなさない。
35
+ 5. **結果を引き継ぐ**: 未印字・結果不明・保存失敗があれば、取引番号と保持された記録を店主代表へ渡す。
36
36
 
37
- 会計要求前の中断では保存済みの同じ取引を `sales total` で確認して続けるか、`sales cancel` で取り消す。会計要求後に中断した場合は、先に「代表的な表示と利用者の次の手」に従って本部とローカルの確定状態を照合する。新しい取引で同じ販売を登録し直すことと、元の取引の確認・回復を区別する。
37
+ 会計要求前の中断は、同じ取引を `sales total` で確認して続けるか取り消す。会計要求後の中断は、新しい取引で登録し直さず、「代表的な表示と利用者の次の手」に従って確定状態を照合する。
38
38
 
39
39
  ## 4. 操作とコマンド参照
40
40
 
41
- 構文・引数・オプションの正本は `kinuya-cli-reference` とする。下表の参照名は未同梱の架空リファレンスの節を示す。
41
+ 構文・引数・オプションの正本は `kinuya-cli-reference`(未同梱の架空参照名)とする。
42
42
 
43
43
  | 操作 | 対象コマンド | 正本リファレンス |
44
44
  | ---------------------- | ---------------- | ------------------------------------- |
@@ -48,85 +48,78 @@ _ASSUMPTION_: 本例は店舗端末1台を人が操作する学習用 CLI とし
48
48
  | 会計確定 | `sales complete` | `kinuya-cli-reference#sales-complete` |
49
49
  | 確定前の取引全体の取消 | `sales cancel` | `kinuya-cli-reference#sales-cancel` |
50
50
 
51
- 再印刷は保存済みのレシートを使う運用手順へ引き渡す。印刷のために `sales complete` を再実行しない。外部印刷コマンドの起動方法は [[specdojo:ifx-cmd-sample|レシート印刷コマンド連携仕様]] を正本とする。
52
-
53
51
  ## 5. 入力と出力の要点
54
52
 
55
- 未同梱の正本は参照名をインラインコードで示す。「本書」は、CLI 内で完結する表示・対話であり、独立したデータ契約を設けないことを意味する。
53
+ 「本書」は独立したデータ契約を設けない表示・対話を示す。印字の契約例は学習用の [[specdojo:ifx-cmd-sample|レシート印刷コマンド連携仕様]] を参照する。
56
54
 
57
55
  ### 5.1. 入力情報
58
56
 
59
- | コマンド | 種類 | 対象 | 役割 | 正本の参照 | ない/壊れている/届かないときの扱い |
60
- | --------------------------------------------------- | ---------------------- | -------------------------- | ---------------------------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
61
- | `sales start`・`add`・`total`・`complete` | ファイル | `config/store-config.yaml` | 店舗・税計算・本部接続の条件を解決する | `kinuya-store-config-schema` | 欠落時は既定設定で進む。破損時は「店舗設定不正」として停止する |
62
- | `sales add`・`complete` | 環境変数 | `KINUYA_API_KEY` | 本部 API の認証に使う。値は表示・記録しない | `kinuya-cli-reference` の「認証設定」 | 未設定なら「認証設定不足」で停止。認証拒否は各 API の拒否として扱う |
63
- | `sales add` | 外部 API の応答 | 本部商品マスタ | 商品名・販売単価・税区分を取得する | `ifx-api-kinuya-products.yaml` | 接続不能・時間切れ・拒否は「商品マスタ取得失敗」で停止し、明細を追加しない。未登録商品は「商品コード未登録」とする |
64
- | `sales start`・`add`・`total`・`complete`・`cancel` | ファイル | `.session/current-tx.json` | 既存取引の有無を確認し、同じ取引の明細と確定状態を引き継ぐ | `kinuya-session-schema` | `start` では欠落時に新規作成し、既存取引があれば「取引二重開始」で停止する。他の操作では欠落を「取引未開始」、全操作で破損を「取引記録破損」として停止する |
65
- | `sales complete` | 対話での入力 | 預かり金額 | 受領した現金と請求額を照合する | 本書「操作の流れ」「代表的な表示と利用者の次の手」 | 不足・不正は再入力を促す。入力中断なら「預かり金入力中断」として会計要求前に停止する |
66
- | `sales complete` | 外部 API の応答 | 本部売上登録の受付結果 | 同じ取引の登録結果を確認する | `ifx-api-kinuya-sales.yaml` | 接続不能・時間切れ・拒否は「売上登録失敗」として停止。送信内容をローカルに保持し、結果不明を完了扱いにしない |
67
- | `sales complete` | 外部コマンドの実行結果 | `receipt-print` の印字結果 | 対象取引のレシートが印字されたか判断する | [[specdojo:ifx-cmd-sample\|レシート印刷コマンド連携仕様]] | 失敗・時間切れ・結果不正は「印字未完了」の警告で会計を維持し、控えを保持する |
57
+ | コマンド | 種類 | 対象 | 役割 | 正本の参照 | ない/壊れている/届かないときの扱い |
58
+ | --------------------------------------------------- | ---------------------- | -------------------------- | ---------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------- |
59
+ | `sales start`・`add`・`total`・`complete` | ファイル | `config/store-config.yaml` | 店舗・税計算・本部接続の条件 | `kinuya-store-config-schema` | 欠落時は既定設定で進む。破損時は「店舗設定不正」 |
60
+ | `sales add`・`complete` | 環境変数 | `KINUYA_API_KEY` | 本部 API の認証(値は出さない) | `kinuya-cli-reference` の「認証設定」 | 未設定は「認証設定不足」。認証拒否は各 API の拒否 |
61
+ | `sales add` | 外部 API の応答 | 本部商品マスタ | 商品名・販売単価・税区分を取得する | `ifx-api-kinuya-products.yaml` | 「商品マスタ取得失敗」で明細を追加しない。未登録は「商品コード未登録」 |
62
+ | `sales start`・`add`・`total`・`complete`・`cancel` | ファイル | `.session/current-tx.json` | 同じ取引の明細と確定状態を引き継ぐ | `kinuya-session-schema` | `start` は欠落時に作成し、既存なら「取引二重開始」。他は欠落を「取引未開始」。破損は「取引記録破損」 |
63
+ | `sales complete` | 対話での入力 | 預かり金額 | 受領額と請求額の照合 | 本書 | 不足・不正は再入力。中断は「預かり金入力中断」 |
64
+ | `sales complete` | 外部 API の応答 | 本部売上登録の受付結果 | 同じ取引の登録結果を確認する | `ifx-api-kinuya-sales.yaml` | 「売上登録失敗」。結果不明を完了扱いにしない |
65
+ | `sales complete` | 外部コマンドの実行結果 | `receipt-print` の印字結果 | 印字されたかの判断 | レシート印刷コマンド連携仕様 | 「印字未完了」の警告で会計を維持する |
68
66
 
69
67
  ### 5.2. 出力情報
70
68
 
71
- | コマンド | 種類 | 対象 | 役割 | 正本の参照 |
72
- | ------------------------------------------ | -------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
73
- | `sales start`・`cancel` | 標準出力 | 取引開始・取消の通知 | 対象取引と、開始済み/取消済みを確認する | 本書「操作の流れ」 |
74
- | `sales add`・`total` | 標準出力 | 追加明細・取引集計 | 商品・数量・金額の照合と、来店客への請求額の提示に使う | 本書「操作の流れ」 |
75
- | `sales complete` | 標準出力 | 会計確定サマリー | 取引番号・請求額・預かり金・釣銭と会計確定を確認する。印字結果は別に識別する | 本書「操作の流れ」 |
76
- | `sales complete` | 標準エラー | 再入力の案内・印字警告 | 対話での修正と、会計後に残る印字対応を識別する | 本書「代表的な表示と利用者の次の手」 |
77
- | 全コマンド | 標準エラー | 停止理由と回復案内 | 対象取引・原因・保持記録から次の手を選ぶ | 本書「代表的な表示と利用者の次の手」 |
78
- | `sales start`・`add`・`complete`・`cancel` | 作る/変えるファイル | `.session/current-tx.json` | 取引の開始・明細追加を保存し、会計完了または確定前の取消で終了する。会計が未解決なら保持する | `kinuya-session-schema` |
79
- | `sales add` | 外部 API への送信 | 本部商品マスタへの照会 | 指定商品を取得する。商品マスタは更新しない | `ifx-api-kinuya-products.yaml` |
80
- | `sales complete` | 外部 API への送信 | 本部売上登録 | 同じ取引の販売実績を渡す。受付応答は入力情報で扱う | `ifx-api-kinuya-sales.yaml` |
81
- | `sales complete` | 作る/変えるファイル | `data/sales/TX-YYYYMMDD-NNNN.json` | 販売実績のローカル控えと送信結果を残し、通信失敗時も照合に使う | `kinuya-sales-record-schema` |
82
- | `sales complete` | 作る/変えるファイル | `receipts/receipt-YYYYMMDD-NNNN.txt` | 確定済み会計のレシートを保存し、未印字時の確認・再印刷に使う | `kinuya-receipt-format-schema` |
83
- | `sales complete` | 外部コマンドの起動 | `receipt-print` | 保存済みレシートを渡して印字を依頼する。売上登録は委ねない | [[specdojo:ifx-cmd-sample\|レシート印刷コマンド連携仕様]] |
69
+ | コマンド | 種類 | 対象 | 役割 | 正本の参照 |
70
+ | ------------------------------------------ | -------------------- | ------------------------------------ | ------------------------------------------------------ | ------------------------------ |
71
+ | `sales start`・`add`・`total`・`cancel` | 標準出力 | 開始・追加・集計・取消の通知 | 対象取引、明細、請求額、取消済みの確認 | 本書 |
72
+ | `sales complete` | 標準出力 | 会計確定サマリー | 請求額・預かり金・釣銭と会計確定の確認 | 本書 |
73
+ | 全コマンド | 標準エラー | 再入力の案内・警告・停止理由 | 原因と保持記録から次の手を選ぶ | 本書 |
74
+ | `sales start`・`add`・`complete`・`cancel` | 作る/変えるファイル | `.session/current-tx.json` | 取引を保存し、会計完了か取消で終える。保存後に通知する | `kinuya-session-schema` |
75
+ | `sales add` | 外部 API への送信 | 本部商品マスタへの照会 | 商品の取得。マスタは更新しない | `ifx-api-kinuya-products.yaml` |
76
+ | `sales complete` | 外部 API への送信 | 本部売上登録 | 同じ取引の販売実績を渡す | `ifx-api-kinuya-sales.yaml` |
77
+ | `sales complete` | 作る/変えるファイル | `data/sales/TX-YYYYMMDD-NNNN.json` | 販売実績と送信結果の控え。照合に使う | `kinuya-sales-record-schema` |
78
+ | `sales complete` | 作る/変えるファイル | `receipts/receipt-YYYYMMDD-NNNN.txt` | レシートの保存。再印刷に使う | `kinuya-receipt-format-schema` |
79
+ | `sales complete` | 外部コマンドの起動 | `receipt-print` | 保存済みレシートの印字を依頼する | レシート印刷コマンド連携仕様 |
84
80
 
85
81
  ## 6. 終了コードとエラー表示・利用者の次の手
86
82
 
87
83
  ### 6.1. 終了時の判断
88
84
 
89
- 本例の CLI の終了コード区分は次表とし、値の正本は `kinuya-cli-reference` の「終了コード」とする。外部印刷コマンドの終了コードを販売 CLI 全体へそのまま伝播しない。
85
+ 値の正本は `kinuya-cli-reference` の「終了コード」とする。外部印刷コマンドの終了コードは販売 CLI 全体へ伝播しない。
90
86
 
91
- | 終了コード | 区分 | 利用者が確認する結果 |
92
- | ---------- | ------------------ | ------------------------------------------------------------------------------------------ |
93
- | `0` | 正常終了・警告継続 | 要求した操作の結果を確認する。会計確定後の印字警告を含むため、レシート発行済みとは限らない |
94
- | `1` | 入力の誤り・中断 | 入力を訂正または再開する。会計要求前の明細は保持されている |
95
- | `2` | 取引状態の不整合 | 既存取引・確定状態を確認する。新規取引でのやり直しを先行させない |
96
- | `3` | 本部 API の失敗 | 接続・認証と取引の受付結果を確認する。売上登録の結果不明を未登録と断定しない |
97
- | `4` | 設定・保存先の障害 | 開発担当へ環境復旧と保存状態の照合を依頼する |
87
+ | 終了コード | 区分 | 利用者が確認する結果 |
88
+ | ---------- | ------------------ | ------------------------------------------------------ |
89
+ | `0` | 正常終了・警告継続 | 操作結果。印字警告を含み、レシート発行済みとは限らない |
90
+ | `1` | 入力の誤り・中断 | 入力の訂正・再開。会計要求前の明細は保持される |
91
+ | `2` | 取引状態の不整合 | 既存取引と確定状態。新規取引でのやり直しを先にしない |
92
+ | `3` | 本部 API の失敗 | 接続・認証と受付結果。結果不明を未登録と断定しない |
93
+ | `4` | 設定・保存先の障害 | 開発担当による環境復旧と保存状態の照合 |
98
94
 
99
95
  ### 6.2. 代表的な表示と利用者の次の手
100
96
 
101
- 表示要点は全文の固定文言ではなく、利用者が事象を識別する内容を示す。停止・警告・再入力の案内は標準エラーへ、成功結果は標準出力へ出す。
102
-
103
- | 事象・条件 | 終了コード | 表示要点 | 利用者の次の手・回復の確認 |
104
- | ------------------------------------ | --------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
105
- | 正常な取引開始・明細追加・確認・取消 | `0` | 対象取引、操作結果、明細または取消済みの通知 | 店番担当が現物・購入意思と結果を照合し、「操作の流れ」の次の操作へ進む |
106
- | 会計確定・印字完了 | `0` | 会計確定、釣銭、対象取引の印字完了 | 店番担当が取引番号とレシートを照合し、釣銭とレシートを渡す |
107
- | 店舗設定不正 | `4` | 設定ファイルと不正の理由 | 開発担当が正本に従って訂正し、店主代表が店舗条件を確認する。設定を削除して回避しない |
108
- | 認証設定不足 | `1` | `KINUYA_API_KEY` の未設定。値は表示しない | 開発担当へ設定を依頼し、元の操作を再試行する |
109
- | 商品コード未登録・数量不正 | `1` | 対象コードまたは数量と訂正が必要な理由 | 店番担当が商品と指定値を確認して追加し直し、表示明細に1回だけ反映されたことを確認する。数量の許容範囲はリファレンスに従う |
110
- | 商品マスタ取得失敗 | `3` | 対象商品、接続不能/時間切れ/拒否の別、追加未実施 | 店番担当が接続を確認し、拒否なら開発担当へ認証・権限確認を依頼する。復旧後に同じ取引へ追加する |
111
- | 預かり金額不足・入力不正 | 入力待ちのため未終了 | 請求額・不足額または入力訂正の案内 | 店番担当が実際の受領額を確認して同じ対話で再入力する。この段階では本部へ会計要求を送らない |
112
- | 預かり金入力中断 | `1` | 会計未要求、明細保持、対象取引 | 店番担当が `sales total` で明細を確認し、同じ取引の会計を再開するか確定前に取り消す |
113
- | 取引未開始・取引二重開始 | `2` | 未開始または既存取引番号 | 未開始なら `sales start`、二重開始なら店番担当が既存取引の明細を確認する。未解決の会計がある間は取り消さない |
114
- | 明細なし | `2` | 会計対象の商品なし、会計未実施 | 店番担当が商品を追加するか取り消す。対象なしの停止を販売完了と数えない |
115
- | 取引記録破損・確定後の取消要求 | `2` | 対象取引、取消・継続できない理由 | 店主代表と開発担当が本部受付と保存記録を照合する。ファイル削除や `sales cancel` による強制初期化は行わない |
116
- | 売上登録失敗 | `3` | 接続不能/時間切れ/拒否の別、取引番号、保持記録、受付結果不明の有無 | 店主代表が本部受付とローカル記録を照合する。受付済みなら同じ取引の記録を回復し、未受付と確認できた場合だけ回復手順に従って送信を再開する。確認できなければ保留し、会計・取消を繰り返さない |
117
- | 印字未完了 | `0`(会計は確定済み) | 警告、対象取引、未印字/結果不明の別、控えの保存先 | 店番担当が紙面とプリンタを確認する。開発担当が接続・用紙・権限を復旧し、必要なら保存済みレシートだけを手動再印刷する。二重印字の可能性を確認し、売上は再送しない |
118
- | 売上・レシートファイル保存失敗 | `4` | 対象パス、取引番号、保存できた範囲、受付状態 | 開発担当が容量・権限を復旧し、店主代表が本部受付と保持記録を照合する。確定済み売上は再登録せず、記録・控えの回復後に結果を確認する |
119
-
120
- _ASSUMPTION_: 会計確定の通知は、本部受付とローカル販売実績の保存を確認してから行う。会計要求後の停止・応答欠落では、未確定と即断せず照合待ちとして保持する。本部登録の重複排除や照会・回復の詳細は連携契約へ委ね、契約未整備のまま自動再送を許可しない。
97
+ | 事象・条件 | 終了コード | 表示要点 | 利用者の次の手・回復の確認 |
98
+ | ---------------------------------------------------- | --------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
99
+ | 取引開始・明細追加・確認・取消の成功 | `0` | 対象取引、操作結果 | 現物と照合し、次の操作へ進む |
100
+ | 会計確定・印字完了 | `0` | 会計確定、釣銭、印字完了 | 取引番号とレシートを照合して渡す |
101
+ | 店舗設定不正 | `4` | 設定ファイル、不正の理由 | 開発担当が訂正し、店主代表が店舗条件を確認する。設定の削除で回避しない |
102
+ | 認証設定不足 | `1` | `KINUYA_API_KEY` の未設定(値は出さない) | 開発担当が設定し、元の操作を再試行する |
103
+ | 商品コード未登録・数量不正 | `1` | 対象の値、訂正の理由 | 直して追加し、明細に1回だけ反映されたことを確認する |
104
+ | 商品マスタ取得失敗 | `3` | 対象商品、失敗の別、追加未実施 | 接続を確認し、拒否なら開発担当へ権限確認を依頼する。復旧後に同じ取引へ追加する |
105
+ | 預かり金額不足・入力不正 | 入力待ちのため未終了 | 不足額または訂正の案内 | 同じ対話で再入力する。本部へはまだ送らない |
106
+ | 預かり金入力中断 | `1` | 会計未要求、明細保持 | `sales total` で明細を確認し、会計を再開するか取り消す |
107
+ | 取引未開始・取引二重開始 | `2` | 未開始または既存取引番号 | 未開始なら `sales start`。二重開始なら既存取引を確認し、会計が未解決なら取り消さない |
108
+ | 明細なし | `2` | 会計対象なし | 商品を追加するか取り消す。販売完了と数えない |
109
+ | 取引記録破損・確定後の取消要求 | `2` | 対象取引、続けられない理由 | 店主代表と開発担当が本部受付と保存記録を照合する。ファイル削除や `sales cancel` で初期化しない |
110
+ | 売上登録失敗 | `3` | 失敗の別、取引番号、受付結果不明の有無 | 店主代表が本部受付と控えを照合する。受付済みなら同じ取引を回復し、未受付と確認できた場合だけ再送する。確認できなければ保留する |
111
+ | 印字未完了 | `0`(会計は確定済み) | 警告、未印字/結果不明の別、控えの場所 | 紙面を確認し、開発担当の復旧後に保存済みレシートだけを再印刷する。売上は再送しない |
112
+ | 取引セッション保存失敗 | `4` | 対象取引、反映されなかった操作 | 開始・追加・取消は反映されず、成功も通知しない。開発担当の復旧後、店番担当が `sales total` で明細を確認して同じ操作をやり直す |
113
+ | 売上・レシートの保存失敗、会計後のセッション終了失敗 | `4` | 対象パス、取引番号、保存できた範囲 | 開発担当が復旧し、店主代表が本部受付と保持記録を照合する。会計を再実行しない |
114
+
115
+ _ASSUMPTION_: 会計確定は、本部受付と販売実績の保存を確認してから通知する。会計要求後の停止・応答欠落は照合待ちとして保持する。
121
116
 
122
117
  ## 7. メモ / 将来課題
123
118
 
124
- | 項目 | 未整備事項と影響 | 担当・解消条件・引き継ぎ先 |
125
- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
126
- | 上位の操作体系 | `kinuya-clis-index`、CLI 用の業務プロセス・システム化機能は未作成。`part_of`・`based_on` は未接続 | BA が対象範囲と依存関係を確認して接続する。通常利用を GUI とする機能仕様を CLI の直接根拠として流用しない |
127
- | 構文・設定・記録の正本 | `kinuya-cli-reference`、`kinuya-store-config-schema`、`kinuya-session-schema`、`kinuya-sales-record-schema`、`kinuya-receipt-format-schema` は未同梱の架空参照名 | 開発担当が構文・値・構造を各正本へ定義し、同行レビュー担当がコマンド表と終了コード、保存結果を照合する |
128
- | 本部との契約・障害回復 | `ifx-api-kinuya-products.yaml`・`ifx-api-kinuya-sales.yaml` は未同梱。受付照会・重複排除・保存失敗後の回復方法は未確定で、結果不明の取引を自動処理できない | 技術メンターと開発担当が契約と照合・回復手順を整え、店主代表が取引の保留と確定の判断を確認する。同行レビュー担当が応答欠落・受付済み・未受付の期待結果を確認するまで当該経路の受入を保留する |
129
- | 印字経路の受入 | 印刷契約の完成例は [[specdojo:ifx-cmd-sample\|レシート印刷コマンド連携仕様]]。実機での印字結果不明・二重印字の確認は未実施 | 開発担当と店番担当が警告、控え保持、紙面確認後の再印刷を検証し、同行レビュー担当が会計・売上の再実行がないことを確認する |
130
- | 確定・公開の判断 | 本例の参照名と前提は実案件での合意済み仕様を表さない | 店主代表が正常会計、入力訂正、確定前取消、通信失敗、未印字の各結果と引き継ぎ手順を確認し、正本・回復経路の整備後に実運用の可否を判断する |
131
-
132
- オフライン同期 `sales sync`、連続スキャン `sales scan`、キャッシュレス決済は将来の拡張候補であり、現行の回復操作には使わない。店主代表が必要性を判断した時点で BA が別の要求へ整理する。
119
+ | 論点 | 影響と当面の扱い |
120
+ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
121
+ | 上位の操作体系が未作成 | `kinuya-clis-index` と CLI 用のシステム化機能がなく、`part_of`・`based_on` は未接続。GUI の機能仕様を根拠に流用しない |
122
+ | 構文・設定・記録の正本 | `kinuya-cli-reference` と各 schema は未同梱の架空参照名 |
123
+ | 本部との契約・障害回復 | `ifx-api-kinuya-*.yaml` は未同梱。受付照会・重複排除・保存失敗後の回復が決まるまで、結果不明の取引は自動再送せず、当該経路の受入を保留する |
124
+ | 印字経路の実機確認 | 印字結果不明・二重印字は実機で未確認。確かめるまで再印刷は保存済みレシートに限る |
125
+ | 将来の拡張候補 | オフライン同期 `sales sync`、連続スキャン `sales scan`、キャッシュレス決済は現行の回復操作に使わない |
@@ -6,7 +6,7 @@ specdojo:
6
6
  rulebook: specdojo:dec-rulebook
7
7
  ---
8
8
 
9
- # [決定記録](../rulebooks/dec-rulebook.md) サンプル
9
+ # 決定記録 サンプル
10
10
 
11
11
  ## 1. 背景
12
12
 
@@ -24,13 +24,12 @@ specdojo:
24
24
  ## 3. 決定内容
25
25
 
26
26
  - 選択肢 C を採択する。
27
- - 管理画面は既存セッション認証を維持し、外部公開 API のみトークン認証を採用する。
28
27
 
29
28
  ## 4. 採択理由
30
29
 
31
30
  - 品質: 管理画面の監査性を維持しつつ、外部連携の拡張性を確保できる。
32
31
  - コスト: 既存機能への影響を最小化し、段階的移行が可能である。
33
- - 運用性: 認証失効制御の運用範囲を API 側に限定できる。
32
+ - 運用性: 失効制御の運用範囲を API 側に限定できる。
34
33
 
35
34
  ## 5. 影響範囲
36
35
 
@@ -2,8 +2,6 @@
2
2
  openapi: 3.0.3
3
3
  info:
4
4
  title: 決済サービスAPI
5
- description: |
6
- 決済サービスとの連携API仕様。
7
5
 
8
6
  x-spec-meta:
9
7
  id: specdojo:ifx-api-sample
@@ -2,8 +2,6 @@
2
2
  asyncapi: 2.6.0
3
3
  info:
4
4
  title: 在庫変更イベント仕様
5
- description: |
6
- 在庫が変更されたときに発行されるイベント仕様。
7
5
 
8
6
  x-spec-meta:
9
7
  id: specdojo:ifx-msg-sample
@@ -0,0 +1,67 @@
1
+ # yaml-language-server: $schema=../../../specdojo/schemas/v1/job.schema.yaml
2
+ id: job-sequence
3
+ name: 再開から検査までの順次実行
4
+ inputs:
5
+ resume_task:
6
+ type: string
7
+ required: true
8
+ track:
9
+ type: string
10
+ required: true
11
+ track_end_task:
12
+ type: string
13
+ required: true
14
+ schedule_state:
15
+ type: string
16
+ required: true
17
+ register_item:
18
+ type: string
19
+ required: true
20
+ register_ticket:
21
+ type: string
22
+ required: true
23
+ grade_path:
24
+ type: string
25
+ required: true
26
+ task:
27
+ mode: command
28
+ lock_wait_seconds: 3600
29
+ steps:
30
+ - id: resume
31
+ command: |
32
+ {{specdojo}} exec resume --project "{{project_id}}" --task "{{inputs.resume_task}}" --if-busy wait
33
+ {{specdojo}} exec refresh --project "{{project_id}}"
34
+ completion:
35
+ path: "{{inputs.schedule_state}}"
36
+ field: "tasks.{{inputs.resume_task}}.state"
37
+ succeeded: [done]
38
+ deferred: [todo, doing, blocked]
39
+ - id: auto-track
40
+ command: |
41
+ {{specdojo}} exec run --project "{{project_id}}" --auto --track "{{inputs.track}}" --loop --max-rounds 20 --if-busy wait
42
+ {{specdojo}} exec refresh --project "{{project_id}}"
43
+ completion:
44
+ path: "{{inputs.schedule_state}}"
45
+ field: "tasks.{{inputs.track_end_task}}.state"
46
+ succeeded: [done]
47
+ deferred: [todo, doing, blocked]
48
+ - id: register
49
+ command: >-
50
+ {{specdojo}} exec run --project "{{project_id}}"
51
+ --register "{{inputs.register_item}}" --worktree --if-busy wait
52
+ completion:
53
+ path: "{{inputs.register_ticket}}"
54
+ field: specdojo.item_status
55
+ succeeded: [review, closed]
56
+ deferred: [in-progress, waiting]
57
+ - id: grade
58
+ command: >-
59
+ {{specdojo}} grade run --project "{{project_id}}" --target deliverable
60
+ --path "{{inputs.grade_path}}" --run-id "{{job_run_id}}-grade" --if-busy wait
61
+ timeout_seconds: 7200
62
+ on_failure: continue
63
+ - id: docs-build
64
+ command: npm run docs:build
65
+ run:
66
+ idempotency_key: >-
67
+ {{job_id}}:{{scheduled_at}}:{{inputs.resume_task}}:{{inputs.track}}:{{inputs.track_end_task}}:{{inputs.schedule_state}}:{{inputs.register_item}}:{{inputs.register_ticket}}:{{inputs.grade_path}}
@@ -4,35 +4,113 @@ specdojo:
4
4
  type: project
5
5
  status: draft
6
6
  rulebook: specdojo:mip-index-rulebook
7
+ based_on: []
8
+ supersedes: []
7
9
  ---
8
10
 
9
- # 移行計画 サンプル
11
+ # 移行計画: 概要(駄菓子屋きぬや 販売管理システム)
10
12
 
11
- ## 1. 目的と適用範囲
13
+ ## 1. 移行の背景/目的
12
14
 
13
- 本書は、変更対象の移行方針と全体計画を定義し、切替リスクを管理するための最小サンプルである。
15
+ 駄菓子屋きぬやでは、販売・在庫・つけの記録をノートと店主の記憶に頼っており、記録漏れとつけ残高の確認の手間が生じている。本計画は、ノートの記録を店頭タブレットの販売管理システムへ移し、店主代表と家族利用者代表が同じ手順で販売・在庫・つけを記録できる状態にするまでの方針と判断点を定める。
14
16
 
15
- ## 2. 入力情報
17
+ 移行の成果は、つけ残高と現在庫を取りこぼさずにシステムへ移し、1 週間の並行記録の後にシステムの記録を正本として店舗運営を続けられることである。
16
18
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/mip-index-rulebook.md`
19
+ ## 2. 前提・制約
20
20
 
21
- ## 3. 記述内容
21
+ - 単一店舗・タブレット 1 台で運用する。移行作業もこの端末で行う。
22
+ - _ASSUMPTION_: 平日の午前は来店が少ないため、切替当日は午前に取り込みと動作確認を行い、下校時間に来店が増える午後から本番で利用する。閉店時間は変えない。
23
+ - 移行元は商品ノート、常連客ノート(顧客欄・つけ欄)、販売ノートの紙媒体である。電子データの移行元はない。
24
+ - 仕入先とのシステム連携、本格会計、過去の販売履歴の電子化は対象外とする。
25
+ - _UNDECIDED_: 切替日。店主代表が移行リハーサルの結果を見て決める。
22
26
 
23
- - 主な内容: 移行範囲、移行方式、体制、スケジュール、リスクと対策
24
- - 必須観点: 対象、条件、判定基準、責任者
27
+ ## 3. 移行方式と期間(方式/フェーズ/タイムライン)
25
28
 
26
- ## 4. 最小記述例
29
+ 並行移行とする。切替日から 1 週間はノートとシステムの両方に販売を記録し、ノートを正本として日次締めで突き合わせる。並行記録の差異が収まった時点で、システムの記録を正本に切り替える。
27
30
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ---------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | 移行計画 | 最小サンプル |
31
- | 目的 | 変更対象の移行方針と全体計画を定義し、切替リスクを管理する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 移行範囲、移行方式、体制、スケジュール、リスクと対策 | 要点のみ記載 |
31
+ | フェーズ | 期間 | 目的 | 成果物/完了条件 |
32
+ | ---------- | ------------------------ | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
33
+ | 準備 | 切替日の 2 週間前から | 転記用の表に商品・顧客・つけ残高を書き写し、取り込みを試す | 転記用の表と元ノートの全件照合が済み、移行リハーサルで取り込みと照合が通っている |
34
+ | 最終棚卸 | 切替日の前日(閉店後) | 現在庫を数え直し、移行する在庫数を確定する | 全商品の現在庫を数えた結果を転記用の表へ記入し、店主代表が確認している |
35
+ | 移行・検証 | 切替日の午前 | 転記用の表を取り込み、件数と残高を元ノートと照合する | 商品・顧客の件数と、つけ残高の合計・顧客ごとの残高が元ノートと一致している |
36
+ | 並行記録 | 切替日の午後から 1 週間 | 販売をノートとシステムの両方に記録し、日次締めで突き合わせる | 各営業日の日次締めで、売上額とつけ残高合計の差異が 0 円であるか、差異の理由が記録されている |
37
+ | 正本切替 | 並行記録の最終日の閉店後 | システムの記録を正本にし、ノートへの記録をやめる | 店主代表が正本切替を承認し、以後の販売・つけの記録先をシステムだけにしたことを店番担当へ伝えた |
33
38
 
34
- ## 5. 未解決事項
39
+ ## 4. 移行対象一覧(スコープ/非対象)
35
40
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
41
+ | 区分 | 対象 | 補足 |
42
+ | ------ | ---------------------------------------------------- | --------------------------------------------------------------------------------------- |
43
+ | 業務 | 店頭販売、つけ販売、つけ精算、在庫確認、日次締め | 並行記録の期間は、ノートとシステムの両方で行う |
44
+ | データ | 商品台帳(商品名、売価、補充基準、仕入先、発注単位) | 商品ノートから転記用の表へ書き写して取り込む |
45
+ | データ | 現在庫 | 切替日の前日に数えた最終棚卸の結果を移行する。入出庫の履歴は移さない |
46
+ | データ | 顧客台帳(常連客の氏名、連絡先、つけ上限)とつけ残高 | 常連客ノートから書き写す。つけ残高は顧客ごとの残高だけを移し、つけ販売の明細は移さない |
47
+ | 非対象 | 過去の販売ノート、仕入ノート、つけ販売の明細 | 紙のまま保管し、問い合わせ時に参照する。詳細の移行手順と照合方法は `dmd-index` で定める |
48
+ | 非対象 | 仕入先との連携、売上の会計処理 | 初期リリースの対象外であり、移行しない |
49
+
50
+ ## 5. 成功条件・受入基準
51
+
52
+ | 項目 | 基準 | 測定対象(対象データ/期間/業務) | 測定/証跡 | 判定者 | 失敗時の扱い(ロールバック/延期/代替手順) |
53
+ | -------------- | --------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------- | -------- | ------------------------------------------------------------------------ |
54
+ | 業務停止時間 | 0 時間(開店時間を変えない) | 切替日の午前(取り込み・動作確認) | 移行作業の記録表に書いた開始・終了時刻 | 店主代表 | 午後の開店までに終わらなければ延期し、ノートだけで営業する |
55
+ | つけ残高の一致 | 顧客ごとの残高と合計の差異が 0 円 | 常連客ノートの全顧客(移行時点の残高) | 取り込み後に出力した残高一覧と元ノートの照合表 | 店主代表 | 差異のある顧客を直して取り込み直す。午前中に直らなければ延期する |
56
+ | 件数の一致 | 商品・顧客の件数差異が 0 件 | 商品台帳・顧客台帳(移行時点の全件) | 取り込み結果の件数と転記用の表の行数の照合表 | 開発担当 | 不足分を転記用の表へ追加して取り込み直す |
57
+ | 在庫数の一致 | 全商品で最終棚卸の数と一致 | 現在庫(切替日の前日に数えた数) | 取り込み後の在庫一覧と最終棚卸の記入表の照合表 | 店主代表 | 不一致の商品を直して取り込み直す |
58
+ | 並行記録の一致 | 売上額とつけ残高合計の差異が 0 円 | 並行記録の 1 週間の各営業日の日次締め(店頭販売・つけ販売・精算) | 日次締め記録の差異欄と、差異の理由のメモ | 店主代表 | 理由が分からない差異が残る日があれば並行記録を延ばし、正本切替を延期する |
59
+
60
+ GO/NO-GO(最低条件):
61
+
62
+ - 午後の開店前に、つけ残高・件数・在庫数の照合がすべて一致している。
63
+ - 店主代表と家族利用者代表が、移行後の端末で現金販売とつけ販売を 1 件ずつ記録できた。
64
+ - 正本切替は、並行記録の最終日の日次締めまで理由の分からない差異が残っていない。
65
+
66
+ ## 6. 体制・役割(GO判断含む)
67
+
68
+ | 役割 | 担当 | 責務 | 連絡/判断 |
69
+ | ----------------- | ---------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------ |
70
+ | GO 判断・正本切替 | 店主代表 | 照合結果を見て本番利用と正本切替を決める。最終棚卸の数を確認する | 延期と並行記録の延長も店主代表が決める |
71
+ | 移行実行 | 開発担当 | 転記用の表の取り込み、件数・残高・在庫数の照合表の作成 | 照合で差異が出たら店主代表へ伝え、直し方を相談する |
72
+ | 照合の確認 | 同行レビュー担当 | 照合表と元ノートを第三者の立場で読み合わせる | 読み合わせの結果を照合表に記入する |
73
+ | 並行記録の店番 | 家族利用者代表 | 並行記録の期間にノートとシステムの両方へ販売を記録する | 記録の食い違いに気付いたら、その場でメモを残し、日次締めで店主代表へ渡す |
74
+ | 技術支援 | 技術メンター | 取り込みの失敗や端末の不具合を切り分け、直し方を助言する | 午前中に直せない不具合は、延期を店主代表へ提案する |
75
+
76
+ ## 7. 移行リスクと対策
77
+
78
+ | リスク | 影響 | 対策 | 検知/判断 |
79
+ | ------------------------------------ | ---------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------- |
80
+ | つけ残高の書き写し漏れ・誤記 | 常連客への請求の誤りと信用の低下 | 転記用の表と元ノートを同行レビュー担当が全件読み合わせる | 残高の照合表で差異がある顧客。店主代表が直し方と延期の要否を決める |
81
+ | 最終棚卸から切替までの販売の数え漏れ | 移行後の在庫数がずれ、補充の判断を誤る | 最終棚卸は前日の閉店後に行い、切替日の午前は販売しない | 在庫数の照合表。並行記録の日次締めで在庫差異が続く商品があれば数え直す |
82
+ | 並行記録の二重記録の負担 | 店番中の記録漏れと、差異の理由が残らない | 並行記録は 1 週間に限り、記録漏れはその場でメモを残す | 日次締めで理由の分からない差異が出たら、店主代表が並行記録の延長を判断する |
83
+ | 切替日の午前に作業が終わらない | 午後の開店で記録先が定まらない | 移行リハーサルで作業時間を測り、午前中に収まることを確かめる | 開店前に照合が終わっていなければ、店主代表が延期を決める |
84
+
85
+ ## 8. カットオーバー概要(当日タイムライン/判定点/ロールバック方針)
86
+
87
+ | 時刻(相対) | イベント | 完了条件 | 判定点 | 失敗時の扱い(ロールバック/延期/代替手順) |
88
+ | ---------------------- | -------------------------- | ----------------------------------------------- | ------ | ---------------------------------------------------------------------------- |
89
+ | T-1 日(閉店後) | 最終棚卸 | 全商品の現在庫を数えた結果を店主代表が確認した | GO1 | 延期(切替中止):数え終わらなければ切替日を延ばし、ノートで営業を続ける |
90
+ | T 当日(午前・開店前) | 転記用の表の取り込みと照合 | 件数・つけ残高・在庫数の照合がすべて一致した | GO2 | 代替手順:差異を直して取り込み直す(午前中に 1 回まで)。直らなければ延期 |
91
+ | T 当日(午前・開店前) | 動作確認 | 現金販売とつけ販売を 1 件ずつ記録し、取り消せた | GO3 | ロールバック:取り込んだデータを使わず、ノートだけで営業する |
92
+ | T 当日(午後・開店) | 本番利用と並行記録の開始 | 最初の販売をノートとシステムの両方に記録した | - | 代替手順:システムに記録できない販売はノートだけに記録し、日次締めで補記する |
93
+ | T+7 日(閉店後) | 正本切替 | 並行記録の最終日の日次締めで差異が残っていない | GO4 | 延期:並行記録を延ばし、ノートを正本のまま続ける |
94
+
95
+ ロールバック方針:
96
+
97
+ - 延期(切替中止):GO1・GO2 で失敗したら、切替を中止してノートだけで営業を続け、店主代表が切替日を決め直す。
98
+ - ロールバック(ノートへの復帰):GO3 で失敗したら、取り込んだデータを使わずノートで営業する。並行記録の期間中はノートが正本のため、システムを止めても記録は失われない。
99
+ - 当日の作業手順の詳細は `cop-index` に置く。
100
+
101
+ ## 9. 移行後ハイパーケア方針
102
+
103
+ | 項目 | 方針 |
104
+ | -------- | ----------------------------------------------------------------------------------------------------- |
105
+ | 期間 | 正本切替から 2 週間 |
106
+ | 体制 | 開発担当が閉店後の日次締めに立ち会い、店舗運営アドバイザーが店番の引継ぎで困った点を聞き取る |
107
+ | 対応範囲 | 記録の誤りの訂正、操作の分からない点の説明、端末の不具合の一次切り分け |
108
+ | 窓口/SLA | 店番中の困りごとは店主代表が受け、その日の閉店後までに開発担当が対応する |
109
+ | 旧ノート | 正本切替の後も、つけ残高の問い合わせに備えて店頭台帳保管棚に保管する。保管期間は `dmd-index` で定める |
110
+
111
+ 関連ドキュメント:
112
+
113
+ - `dmd-index`:データ移行設計(転記用の表、取り込み、照合の方法)
114
+ - `mtp-index`:移行リハーサル計画(作業時間の測定と照合の合否基準)
115
+ - `cop-index`:カットオーバー計画(切替日の作業手順と判定点)
116
+ - `otp-index`:運用切替計画(並行記録の運用と正本切替後の問い合わせ窓口)
@@ -13,34 +13,41 @@ specdojo:
13
13
 
14
14
  ## 1. 方針と適用範囲
15
15
 
16
- 店主、家族利用者、開発担当が、営業を妨げずに初期リリースと店頭試用を判断できるようにする。非同期の記録を基本とし、会議は利用者確認または意思決定が必要な場合だけ行う。役割や連絡先の一覧は各正本へ委譲する。
16
+ [[specdojo:pm-plan-sample|管理計画]] の判断ゲートと [[specdojo:prj-stakeholder-register-sample|ステークホルダー登録簿]] のコミュニケーション要件を、営業を妨げない確認・共有へ具体化する。Issue・Pull Request・チャットの非同期の記録を基本とし、対面は試用の準備と結果の聞き取りに限る。AI Agent は記録の整理と草案を支援し、合意・承認・公開は判断しない。
17
17
 
18
18
  ## 2. コミュニケーション機会
19
19
 
20
- | 対象・機会 | 伝える・確認する内容 | タイミング | 手段 | 責任 | 証跡 |
21
- | ---------------------- | ------------------------------------ | -------------------- | ----------------------- | ---- | ------------------ |
22
- | 店主への計画確認 | 対象範囲、試用日、費用・時間上限 | 着手前、重大変更時 | 対面または記録コメント | PM | 承認記録 |
23
- | 家族利用者との試用準備 | 操作方法、確認項目、困り事の伝え方 | 試用前 | 短時間の実演 | BA | 確認メモ |
24
- | 進捗共有 | 完了、次の作業、ブロック、必要な判断 | 節目または状態変化時 | Schedule と記録コメント | PM | Schedule、課題 |
25
- | 受入確認 | 受入条件、試験結果、未解決事項 | リリース前 | レビュー | QE | レビュー結果 |
26
- | 試用結果の確認 | 利用継続、追加負担、改善候補 | 試用終了時 | 店主・家族への聞き取り | BA | 試用結果、決定記録 |
20
+ | 対象・機会 | 伝える・確認する内容 | タイミング | 手段 | 責任 | 証跡 |
21
+ | -------------------------------------------------- | ----------------------------------------- | ---------------------------------------------------------------- | -------------------------- | ----- | ---------------------------- |
22
+ | `STH-SHOP-OWNER` への判断依頼 | 範囲・優先機能・UI の変更、費用・時間上限 | 準備着手前、管理計画の判断ゲート「重大変更・再開」に当たる変更時 | Issue(対面の結果も転記) | `PM` | Issue、変更要求ログの変更 ID |
23
+ | `STH-SHOP-OWNER` への進捗共有 | 完了、次の作業、ブロック、必要な判断 | 節目、ブロック発生時 | Schedule と Issue コメント | `PM` | `kinuya-schedule`、課題ログ |
24
+ | `STH-DEVELOPER` の実装結果の確認 | 機能範囲、テスト完了、設計と実装結果 | イテレーション末 | Pull Request、チャット | `DEV` | Pull Request |
25
+ | `STH-TECH-MENTOR` との設計相談 | データフローと画面構造案 | 週次 | チャット | `DEV` | Issue |
26
+ | `STH-FAMILY-USER` との試用準備 | 操作方法、確認項目、困り事の伝え方 | 試用前 | 簡易手順書と短時間の実演 | `BA` | Issue |
27
+ | `STH-SHOP-OWNER` の受入確認 | 受入条件、試験結果、未解決事項 | 初期リリース前 | Pull Request のレビュー | `QE` | `kinuya-acceptance-record` |
28
+ | `STH-SHOP-OWNER`・`STH-FAMILY-USER` の試用結果確認 | 継続可否、追加負担、改善候補 | 試用終了時 | 対面の聞き取り | `BA` | `kinuya-trial-log` |
27
29
 
28
30
  ## 3. エスカレーション
29
31
 
30
- | 条件 | 一次対応 | 最終判断 | 証跡 |
31
- | ------------------------------------ | ------------------------------- | -------- | ------------------ |
32
- | 利用者価値または受入条件が曖昧 | BA が事実と選択肢を整理する | PO | 確認メモ、決定記録 |
33
- | 費用・参加時間の上限を超える見込み | PM が縮小案と中止案を整理する | PO | 課題、決定記録 |
34
- | 品質、個人情報、公開適性に重大な懸念 | QE が対象を隔離し影響を整理する | PO | レビュー、決定記録 |
35
- | 範囲または試用日へ重大な影響 | PM が代替案と推奨案を整理する | PO | 変更要求、決定記録 |
32
+ | 条件 | 一次対応 | 最終判断 | 証跡 |
33
+ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -------- | ------------ |
34
+ | 利用者価値または受入条件を登録簿・成功条件から判定できない | `BA` が事実と選択肢を整理する | `PO` | 課題ログ |
35
+ | 現金支出・作業時間が管理計画 M-03・M-04 の上限を超える見込み | `PM` が縮小案と中止案を整理する | `PO` | 変更要求ログ |
36
+ | 受入条件の未達、または検証できない Agent 出力 | `QE` が対象版と不足証跡を整理し、`PM` が是正を Schedule に置く | `PO` | 受入記録 |
37
+ | 顧客情報・認証情報が公開資料・一般共有チャネル・Agent 入力に出た、または公開物に権利・内部事情の懸念 | 発見者が共有を止め、`QE` が影響範囲を確認し、`PM` が判断材料を整理する | `PO` | 課題ログ |
38
+ | 範囲・上限・試用日の基準を変える要求 | `PM` が影響と代替案を整理する | `PO` | 変更要求ログ |
36
39
 
37
40
  ## 4. 情報管理と公開
38
41
 
39
- - 判断、課題、リスク、変更は、後から理由と次の行動を追える形で正本へ記録する。
40
- - 顧客の氏名、つけ残高、連絡先、認証情報は公開資料や一般共有チャネルへ記載しない。
41
- - 公開情報は匿名化し、店舗運営に不要な内部事情を含めない。
42
- - 口頭で決まった事項は、PM が決定記録または該当する正本へ反映する。
42
+ | 情報区分 | 取扱い | 記録先 |
43
+ | -------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
44
+ | 判断・課題・リスク・変更 | 理由と次の行動を付ける。口頭の決定は `PM` が転記する | [[specdojo:pm-issue-log-sample\|課題ログ]]、[[specdojo:pm-risk-register-sample\|リスク登録簿]]、[[specdojo:pm-change-request-log-sample\|変更要求ログ]] |
45
+ | 進捗・作業結果 | プロジェクト関係者で共有する | `kinuya-schedule`、Pull Request |
46
+ | 顧客の氏名・つけ残高・連絡先、認証情報 | 公開資料・一般共有チャネル・AI Agent の入力に含めない | プロジェクトの記録には残さない |
47
+ | 公開する事例・画面 | 匿名化し、店舗運営に不要な内部事情を除く。`PO` の公開判断を経て公開する | `kinuya-acceptance-record` の公開可否 |
43
48
 
44
49
  ## 5. 見直し条件と未決事項
45
50
 
46
- 参加者、試用方法、公開範囲、主な連絡手段が変わった場合に本計画を見直す。営業時間外の緊急連絡手段は、店頭試用の開始前に PO が決定する。
51
+ 参加者、判断ゲート、公開範囲、主な連絡手段が変わった場合に本計画を見直す。
52
+
53
+ - _UNDECIDED_: 営業時間外の緊急連絡手段。決まるまで営業時間外の停止連絡の伝達先が定まらない。店頭試用の開始前に `PO` が決定する。