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.
- package/.github/agents/specdojo-orchestrator.md +4 -1
- package/CHANGELOG.md +77 -0
- package/dist/catalog/catalog.js +16 -14
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +4 -2
- package/dist/commands/orchestrator.js +5 -77
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/shared.js +2 -2
- package/dist/dashboard/timeline.js +14 -14
- package/dist/deliverable/trash.js +2 -1
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +146 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +9 -0
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +31 -18
- package/dist/exec/events.js +34 -14
- package/dist/exec/evidence.js +13 -3
- package/dist/exec/opencode-permissions.js +117 -0
- package/dist/exec/parent-validation.js +56 -3
- package/dist/exec/plans-core.js +21 -2
- package/dist/exec/plans-generation.js +6 -7
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +82 -0
- package/dist/exec/repo-integration-sync.js +17 -5
- package/dist/exec/repo-trace.js +2 -1
- package/dist/exec/reporter.js +2 -2
- package/dist/exec/results.js +24 -4
- package/dist/exec/review-kata.js +4 -1
- package/dist/exec/run/agent-pipeline.js +3 -2
- package/dist/exec/run/agent.js +12 -6
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +5 -2
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +56 -19
- package/dist/exec/run/lifecycle-commands.js +1 -1
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/register-command.js +8 -5
- package/dist/exec/run/register-mode.js +68 -8
- package/dist/exec/run/register-resume.js +68 -14
- package/dist/exec/run/register-state.js +13 -8
- package/dist/exec/run/register-worktree.js +140 -125
- package/dist/exec/run/schedule-mode.js +75 -14
- package/dist/exec/run/schedule-prepare.js +3 -0
- package/dist/exec/run/schedule-task.js +88 -38
- package/dist/exec/run/shared.js +5 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +2 -2
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +13 -3
- package/dist/exec/task-repos.js +19 -4
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trial-commands.js +5 -2
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +12 -2
- package/dist/exec/worktree-ops-commit.js +2 -2
- package/dist/exec/worktree.js +13 -2
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +5 -3
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +5 -1
- package/dist/grade/run.js +64 -8
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +79 -23
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/maintenance-commands.js +2 -2
- package/dist/register/register.js +31 -7
- package/dist/register/renumber.js +1 -3
- package/dist/routine/definition.js +9 -0
- package/dist/routine/routine.js +137 -43
- package/dist/routine/status.js +62 -0
- package/dist/schedule/schedule.js +38 -39
- package/dist/shared/agent-types.js +5 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +44 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/specdojo-config.js +34 -20
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +17 -1
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
- package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
- package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
- package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
- package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
- package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
- package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
- package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +258 -118
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bds-sample.md +58 -71
- package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
- package/docs/ja/specdojo/samples/bes-sample.md +43 -53
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +40 -52
- package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
- package/docs/ja/specdojo/samples/clis-sample.md +70 -77
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
- package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
- package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
- package/docs/ja/specdojo/samples/sf-sample.md +73 -85
- package/docs/ja/specdojo/samples/sld-sample.md +60 -79
- package/docs/ja/specdojo/samples/uis-sample.md +98 -121
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +9 -6
- package/templates/antigravity/orchestrator.md +4 -1
- package/templates/claude/agents/specdojo-orchestrator.md +4 -1
- package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
- package/templates/codex/orchestrator.md +4 -1
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
|
@@ -12,33 +12,33 @@ specdojo:
|
|
|
12
12
|
|
|
13
13
|
## 1. 概要
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
店番担当が現金販売を記録し、釣銭とレシートを渡すための CLI コマンド群である。会計と印字の結果を区別して残し、店番の交代時に未完了の取引を引き継げるようにする。
|
|
16
16
|
|
|
17
17
|
## 2. 利用目的と対象ユーザー
|
|
18
18
|
|
|
19
|
-
| 対象者 | 解決する課題・達成する結果
|
|
20
|
-
| -------------------------- |
|
|
21
|
-
| 店主代表 |
|
|
22
|
-
| 家族利用者代表 |
|
|
23
|
-
| 開発担当・同行レビュー担当 |
|
|
19
|
+
| 対象者 | 解決する課題・達成する結果 | 確認・合意する内容 |
|
|
20
|
+
| -------------------------- | ------------------------------------------ | ------------------------------------------------ |
|
|
21
|
+
| 店主代表 | 暗算や転記に頼らず売上を記録する | 会計の確定条件、取消できる範囲、障害時の照合結果 |
|
|
22
|
+
| 家族利用者代表 | 店主不在でも同じ手順で会計する | 会計までの操作、保留時に店主へ渡す情報 |
|
|
23
|
+
| 開発担当・同行レビュー担当 | 正常・警告・異常を識別し、二重会計を避ける | 入出力の正本、保存される記録、回復後の期待結果 |
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
対象は単一店舗・現金販売の開始、明細追加、金額確認、会計確定、確定前の取消とする。確定後の返品・訂正は店主代表の照合手順へ引き渡し、つけ販売、キャッシュレス決済、仕入れ、在庫調整は対象外とする。
|
|
26
26
|
|
|
27
|
-
_ASSUMPTION_:
|
|
27
|
+
_ASSUMPTION_: 店舗端末1台を人が操作する学習用 CLI とし、商品マスタの取得と売上登録に本部 API を使う。自動会計・無人運転や通信不能時の販売継続は扱わない。
|
|
28
28
|
|
|
29
29
|
## 3. 操作の流れ
|
|
30
30
|
|
|
31
|
-
1. **取引を開始する**:
|
|
32
|
-
2. **明細をそろえる**: `sales add`
|
|
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
|
-
|
|
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
|
-
|
|
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` |
|
|
62
|
-
| `sales add`・`complete` | 環境変数 | `KINUYA_API_KEY` | 本部 API
|
|
63
|
-
| `sales add` | 外部 API の応答 | 本部商品マスタ | 商品名・販売単価・税区分を取得する
|
|
64
|
-
| `sales start`・`add`・`total`・`complete`・`cancel` | ファイル | `.session/current-tx.json` |
|
|
65
|
-
| `sales complete` | 対話での入力 | 預かり金額 |
|
|
66
|
-
| `sales complete` | 外部 API の応答 | 本部売上登録の受付結果 | 同じ取引の登録結果を確認する
|
|
67
|
-
| `sales complete` | 外部コマンドの実行結果 | `receipt-print` の印字結果 |
|
|
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
|
|
75
|
-
|
|
|
76
|
-
| `sales complete`
|
|
77
|
-
|
|
|
78
|
-
| `sales
|
|
79
|
-
| `sales
|
|
80
|
-
| `sales complete` |
|
|
81
|
-
| `sales complete` |
|
|
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
|
-
|
|
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
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
|
|
|
118
|
-
|
|
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
|
-
|
|
|
127
|
-
| 構文・設定・記録の正本 | `kinuya-cli-reference
|
|
128
|
-
| 本部との契約・障害回復 | `ifx-api-kinuya
|
|
129
|
-
|
|
|
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
|
-
#
|
|
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
|
-
- 運用性:
|
|
32
|
+
- 運用性: 失効制御の運用範囲を API 側に限定できる。
|
|
34
33
|
|
|
35
34
|
## 5. 影響範囲
|
|
36
35
|
|
|
@@ -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
|
-
|
|
17
|
+
移行の成果は、つけ残高と現在庫を取りこぼさずにシステムへ移し、1 週間の並行記録の後にシステムの記録を正本として店舗運営を続けられることである。
|
|
16
18
|
|
|
17
|
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/mip-index-rulebook.md`
|
|
19
|
+
## 2. 前提・制約
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
- 単一店舗・タブレット 1 台で運用する。移行作業もこの端末で行う。
|
|
22
|
+
- _ASSUMPTION_: 平日の午前は来店が少ないため、切替当日は午前に取り込みと動作確認を行い、下校時間に来店が増える午後から本番で利用する。閉店時間は変えない。
|
|
23
|
+
- 移行元は商品ノート、常連客ノート(顧客欄・つけ欄)、販売ノートの紙媒体である。電子データの移行元はない。
|
|
24
|
+
- 仕入先とのシステム連携、本格会計、過去の販売履歴の電子化は対象外とする。
|
|
25
|
+
- _UNDECIDED_: 切替日。店主代表が移行リハーサルの結果を見て決める。
|
|
22
26
|
|
|
23
|
-
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
27
|
+
## 3. 移行方式と期間(方式/フェーズ/タイムライン)
|
|
25
28
|
|
|
26
|
-
|
|
29
|
+
並行移行とする。切替日から 1 週間はノートとシステムの両方に販売を記録し、ノートを正本として日次締めで突き合わせる。並行記録の差異が収まった時点で、システムの記録を正本に切り替える。
|
|
27
30
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
31
|
+
| フェーズ | 期間 | 目的 | 成果物/完了条件 |
|
|
32
|
+
| ---------- | ------------------------ | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
|
|
33
|
+
| 準備 | 切替日の 2 週間前から | 転記用の表に商品・顧客・つけ残高を書き写し、取り込みを試す | 転記用の表と元ノートの全件照合が済み、移行リハーサルで取り込みと照合が通っている |
|
|
34
|
+
| 最終棚卸 | 切替日の前日(閉店後) | 現在庫を数え直し、移行する在庫数を確定する | 全商品の現在庫を数えた結果を転記用の表へ記入し、店主代表が確認している |
|
|
35
|
+
| 移行・検証 | 切替日の午前 | 転記用の表を取り込み、件数と残高を元ノートと照合する | 商品・顧客の件数と、つけ残高の合計・顧客ごとの残高が元ノートと一致している |
|
|
36
|
+
| 並行記録 | 切替日の午後から 1 週間 | 販売をノートとシステムの両方に記録し、日次締めで突き合わせる | 各営業日の日次締めで、売上額とつけ残高合計の差異が 0 円であるか、差異の理由が記録されている |
|
|
37
|
+
| 正本切替 | 並行記録の最終日の閉店後 | システムの記録を正本にし、ノートへの記録をやめる | 店主代表が正本切替を承認し、以後の販売・つけの記録先をシステムだけにしたことを店番担当へ伝えた |
|
|
33
38
|
|
|
34
|
-
##
|
|
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
|
-
|
|
|
23
|
-
|
|
|
24
|
-
|
|
|
25
|
-
|
|
|
26
|
-
|
|
|
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
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
|
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
|
-
-
|
|
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
|
-
|
|
51
|
+
参加者、判断ゲート、公開範囲、主な連絡手段が変わった場合に本計画を見直す。
|
|
52
|
+
|
|
53
|
+
- _UNDECIDED_: 営業時間外の緊急連絡手段。決まるまで営業時間外の停止連絡の伝達先が定まらない。店頭試用の開始前に `PO` が決定する。
|