specdojo 0.8.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +4 -1
- package/CHANGELOG.md +64 -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/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/timeline.js +14 -14
- 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/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 +84 -0
- package/dist/exec/repo-integration-sync.js +17 -5
- 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 +4 -1
- 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 +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +13 -3
- 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 +9 -1
- 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/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 +9 -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/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 +257 -117
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
- 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
|
@@ -10,129 +10,117 @@ specdojo:
|
|
|
10
10
|
|
|
11
11
|
## 1. 目的と概要
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
店主代表と家族利用者代表が、店頭のタブレットから現金販売を記録し、請求額・釣銭と在庫への反映結果を同じ取引で確認できるようにする。ノートへの転記漏れと暗算の誤りを減らし、店番が交代しても記録を続けられるようにする。これは [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針に対応する。
|
|
14
14
|
|
|
15
|
-
上位のシステム化機能一覧は `sf-index
|
|
15
|
+
上位のシステム化機能一覧は `sf-index`(未作成)で、対応エントリは機能 ID `SF-POS-01`「店頭商品販売」とする。一覧への登録時に対応を確定する(「未決事項」の `Q-01`)。
|
|
16
16
|
|
|
17
|
-
| 区分 | 範囲
|
|
18
|
-
| ------ |
|
|
19
|
-
| 対象 |
|
|
20
|
-
| 対象外 |
|
|
17
|
+
| 区分 | 範囲 |
|
|
18
|
+
| ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
|
|
19
|
+
| 対象 | 単一店舗の現金販売。明細の登録・修正、税額・請求額・釣銭の提示、販売記録の確定、在庫反映結果の確認、レシート発行要求、確定前の中止 |
|
|
20
|
+
| 対象外 | つけ販売(`P-04`)、補充判断(`P-06`)、キャッシュレス決済、確定後の返品・値引訂正、EC・複数店舗 |
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
公開対象は店舗内の運用者と開発・レビュー担当であり、実顧客の情報や認証情報は含めない。人間の PO(店主代表)がスコープ・受入条件・公開可否を最終判断する。
|
|
22
|
+
店番中の店主代表・家族利用者代表が利用し、設計と受入試験では本書の要件と受入条件を入力にする。
|
|
25
23
|
|
|
26
24
|
## 2. 業務プロセス・画面との対応
|
|
27
25
|
|
|
28
|
-
業務境界は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の店頭販売 `P-03` と在庫確認 `P-05` に対応する。詳細 BPS `bps-sales-order-flow`
|
|
26
|
+
業務境界は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の店頭販売 `P-03` と在庫確認 `P-05` に対応する。詳細 BPS `bps-sales-order-flow` は未作成のため、領域単位で対応付ける(`Q-01`)。
|
|
29
27
|
|
|
30
|
-
| 根拠領域 | 本機能の責務
|
|
31
|
-
| --------------- |
|
|
32
|
-
| `P-03` 店頭販売 |
|
|
33
|
-
| `P-03` 店頭販売 | 現金の受領確認を受け、販売を記録して完了可否を返す
|
|
34
|
-
| `P-05` 在庫確認 |
|
|
35
|
-
| `P-03` 店頭販売 | 確定前の取引中止を受け、未確定の明細を破棄する
|
|
28
|
+
| 根拠領域 | 本機能の責務 | 対応要件・入出力 |
|
|
29
|
+
| --------------- | -------------------------------------------------------------- | ----------------------------------- |
|
|
30
|
+
| `P-03` 店頭販売 | 購入商品と数量を受け、明細と請求額を提示する | `FR-01`・`FR-02`、購入明細・請求額 |
|
|
31
|
+
| `P-03` 店頭販売 | 現金の受領確認を受け、販売を記録して完了可否を返す | `FR-03`、預かり金・販売記録 |
|
|
32
|
+
| `P-05` 在庫確認 | 払出数量を渡し、反映結果を会計結果へ対応付ける。在庫算出は委譲 | `FR-03`、販売確定情報・在庫反映結果 |
|
|
33
|
+
| `P-03` 店頭販売 | 確定前の取引中止を受け、未確定の明細を破棄する | `FR-04`、取引中止結果 |
|
|
36
34
|
|
|
37
|
-
| 接点 | トリガー・受け渡し
|
|
38
|
-
| -------------------------------------- |
|
|
39
|
-
| [[specdojo:uis-sample\|販売登録画面]] |
|
|
40
|
-
| 在庫確認機能 `sf-inventory` |
|
|
41
|
-
| レシート出力 `ifx-cmd-receipt-printer` | 確定した販売の印字内容を渡し、印刷結果を受ける
|
|
35
|
+
| 接点 | トリガー・受け渡し | 責務境界 |
|
|
36
|
+
| -------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------- |
|
|
37
|
+
| [[specdojo:uis-sample\|販売登録画面]] | 商品追加・数量修正・会計確定・中止を受け、明細・金額・結果を返す | 表示・入力形式・遷移は UIS、会計の確定可否は本機能 |
|
|
38
|
+
| 在庫確認機能 `sf-inventory` | 払出数量を渡し、反映済み・未反映・結果不明の区別を受ける | 在庫更新は連携先。未反映・結果不明を販売完了と通知しない |
|
|
39
|
+
| レシート出力 `ifx-cmd-receipt-printer` | 確定した販売の印字内容を渡し、印刷結果を受ける | 印刷失敗は販売確定と区別する |
|
|
42
40
|
|
|
43
|
-
利用接点は GUI とし、CLI
|
|
41
|
+
利用接点は GUI とし、CLI による会計は対象外とする。
|
|
44
42
|
|
|
45
43
|
## 3. 入出力と前提条件
|
|
46
44
|
|
|
47
45
|
### 3.1. 入出力
|
|
48
46
|
|
|
49
|
-
| 区分 | 論理情報
|
|
50
|
-
| ---- |
|
|
51
|
-
| 入力 |
|
|
52
|
-
| 入力 |
|
|
53
|
-
| 入力 | 預かり金額、現金の受領確認
|
|
54
|
-
| 入力 | 在庫反映結果、保存済みの販売と処理結果
|
|
55
|
-
| 出力 | 購入明細、税額、請求額、釣銭
|
|
56
|
-
| 出力 | 売上記録・売上明細、販売確定情報
|
|
57
|
-
| 出力 |
|
|
47
|
+
| 区分 | 論理情報 | 入手元 / 提供先 | 必須性・確定条件 | 正本仕様 | 対応要件 |
|
|
48
|
+
| ---- | -------------------------------------- | --------------------------------------- | -------------------------------------- | ----------------------------------------------------- | ---------------- |
|
|
49
|
+
| 入力 | 商品識別子、販売数量、明細の修正・削除 | 店番担当 / 明細登録 | 登録・修正時に必須 | 販売登録画面、[[specdojo:bdd-sample\|業務データ辞書]] | `FR-01` |
|
|
50
|
+
| 入力 | 販売単価、税区分、販売可能な在庫数量 | 商品台帳・在庫確認機能 / 会計確認 | 会計前に確認できること | 業務データ辞書、`br-tax-calculation`、`sf-inventory` | `FR-01`・`FR-02` |
|
|
51
|
+
| 入力 | 預かり金額、現金の受領確認 | 店番担当 / 会計確定 | 確定時に必須 | 販売登録画面 | `FR-02`・`FR-03` |
|
|
52
|
+
| 入力 | 在庫反映結果、保存済みの販売と処理結果 | 在庫確認機能・販売記録 / 確定・再開判定 | 確定要求時と結果照合時に必須 | `sf-inventory`、`ifx-api-store-sales` | `FR-03` |
|
|
53
|
+
| 出力 | 購入明細、税額、請求額、釣銭 | 本機能 / 店番担当・来店客 | 明細・預かり金の変更に追従する | 販売登録画面、`br-tax-calculation` | `FR-01`・`FR-02` |
|
|
54
|
+
| 出力 | 売上記録・売上明細、販売確定情報 | 本機能 / 販売記録・在庫確認機能 | 確定要求ごとに一度だけ記録・反映する | 業務データ辞書、`sf-inventory` | `FR-03` |
|
|
55
|
+
| 出力 | 会計結果、停止理由、中止結果、印字内容 | 本機能 / 店番担当・レシート出力 | 完了・保留・中止と印刷成否を識別できる | 販売登録画面、`ifx-cmd-receipt-printer` | `FR-03`・`FR-04` |
|
|
58
56
|
|
|
59
|
-
|
|
57
|
+
データ項目・型・コード値は業務データ辞書を正本とし、本書へ転記しない。
|
|
60
58
|
|
|
61
59
|
### 3.2. 前提条件と事後条件
|
|
62
60
|
|
|
63
|
-
- 着手条件:
|
|
64
|
-
- 事後条件:
|
|
61
|
+
- 着手条件: 店番担当が販売権限で利用でき、商品台帳と店舗内の記録先へ接続できること。進行中の取引があれば継続し、別の取引を重ねない。
|
|
62
|
+
- 事後条件: 正常完了は `FR-03`、中止は `FR-04`、保留・失敗は「例外・回復条件」に従う。印刷成否は会計結果と分けて判定する。
|
|
65
63
|
|
|
66
64
|
## 4. 処理要件・機能振る舞い
|
|
67
65
|
|
|
68
66
|
### 4.1. 通常処理
|
|
69
67
|
|
|
70
|
-
| 要件 ID | 開始条件
|
|
71
|
-
| ------- |
|
|
72
|
-
| `FR-01` |
|
|
73
|
-
| `FR-02` | 有効な明細がある
|
|
74
|
-
| `FR-03` |
|
|
75
|
-
| `FR-04` | 確定前に取引中止の確認を受けた
|
|
68
|
+
| 要件 ID | 開始条件 | 処理の責務・確定する結果 | 判断の正本 |
|
|
69
|
+
| ------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
|
|
70
|
+
| `FR-01` | 商品・数量を受けた | 商品と在庫を照合して明細を更新する。未登録商品・販売不可の数量は理由を返し、既存明細を維持する | 販売登録画面の入力条件 |
|
|
71
|
+
| `FR-02` | 有効な明細がある | 税額・請求額を提示し、預かり金から釣銭を求める。明細が空、または預かり金が不足する間は確定を受け付けない | `br-tax-calculation`、販売登録画面の会計条件 |
|
|
72
|
+
| `FR-03` | 現金の受領を確認し、会計確定を要求した | 販売時の単価・数量を売上記録へ残し、在庫反映結果を照合してから販売完了を返し、レシート発行を要求する。再送には元の結果を返す | 業務データ辞書、`sf-inventory`、`ifx-api-store-sales` |
|
|
73
|
+
| `FR-04` | 確定前に取引中止の確認を受けた | 未確定の明細を破棄する。確定中・結果不明の取引は照合へ引き渡し、取消済みと扱わない | 販売登録画面、`stsd-sales-transaction` |
|
|
76
74
|
|
|
77
|
-
商品の販売済みへの遷移は [[specdojo:stsd-sample|商品 ステータス定義]]
|
|
75
|
+
商品の販売済みへの遷移は [[specdojo:stsd-sample|商品 ステータス定義]] を参照する。販売完了の通知は釣銭・商品の手渡しとは別であり、システムは顧客受領を推測しない。
|
|
78
76
|
|
|
79
77
|
### 4.2. 例外・回復条件
|
|
80
78
|
|
|
81
|
-
| 条件
|
|
82
|
-
|
|
|
83
|
-
| 未登録商品、数量不正、在庫不足
|
|
84
|
-
| 明細なし、預かり金不足・入力不正
|
|
85
|
-
|
|
|
86
|
-
| 会計完了後の印刷失敗
|
|
79
|
+
| 条件 | 通知と保持する情報 | 回復・再開条件 |
|
|
80
|
+
| ---------------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
|
|
81
|
+
| 未登録商品、数量不正、在庫不足 | 対象商品と理由を通知する。拒否した変更を明細・記録・在庫に反映しない | 商品または数量を修正し、`FR-01` で再照合する |
|
|
82
|
+
| 明細なし、預かり金不足・入力不正 | 確定不可と理由を返し、有効な明細を維持する | 明細追加または預かり金の補正後に `FR-02` から確認する |
|
|
83
|
+
| 保存・在庫反映の失敗、応答途絶で結果不明 | 完了を通知せず、取引・停止位置・反映状況を保持する。自動で別取引を作らない | OPS が記録と在庫を照合し、確定済みなら結果を再提示、未完了なら未反映部分だけを再開する。照合まで再確定・中止を許可しない |
|
|
84
|
+
| 会計完了後の印刷失敗 | 会計完了と印刷未完了を分けて通知し、販売記録と印字内容を保持する | プリンタ回復後に同じ販売を再印刷する。売上・在庫を再更新しない |
|
|
87
85
|
|
|
88
86
|
## 5. 非機能・技術制約
|
|
89
87
|
|
|
90
|
-
| 観点 | 制約と適用範囲
|
|
91
|
-
| ------------------ |
|
|
92
|
-
| 利用構成・外部依存 | 単一店舗・タブレット1
|
|
93
|
-
| 完全性 |
|
|
94
|
-
| 性能・使いやすさ |
|
|
95
|
-
| 権限・秘匿 |
|
|
96
|
-
| 契約・互換性 |
|
|
88
|
+
| 観点 | 制約と適用範囲 | 正本・判定方法 |
|
|
89
|
+
| ------------------ | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
|
|
90
|
+
| 利用構成・外部依存 | 単一店舗・タブレット1台で店舗内の記録先へ接続して使う。未接続時の新規確定は保証しない | [[specdojo:sample-authoring-standard\|共通サンプル文脈]]、`V-05` |
|
|
91
|
+
| 完全性 | 完了を表示した販売は記録と在庫反映を照合できる。再送でも二重売上・二重払出を起こさない | `FR-03`、`V-04`・`V-05` |
|
|
92
|
+
| 性能・使いやすさ | 店番中の登録と会計確認を続けられる。応答時間の受入値は実端末の測定後に決める | `Q-02`、`V-08` |
|
|
93
|
+
| 権限・秘匿 | 販売権限のない主体は確定できない。顧客情報を必須にせず、認証情報を画面・レシート・証跡へ出さない | `opr-pos-operation`、`V-07` |
|
|
94
|
+
| 契約・互換性 | 画面・記録先・在庫連携・印刷先の schema・版・再送契約が一致するまで統合受入を保留する | `Q-01`。物理構造と公開契約は連携仕様・schema を正本とする |
|
|
97
95
|
|
|
98
96
|
## 6. 操作手順・コマンド参照
|
|
99
97
|
|
|
100
|
-
| 参照先 | 種類 | 参照目的
|
|
101
|
-
| ------------------------------------- | -------- |
|
|
102
|
-
| [[specdojo:uis-sample\|販売登録画面]] | 画面仕様 | 商品登録・修正、預かり金確認、確定・中止の操作と入力形式
|
|
103
|
-
| `opr-pos-operation` | 運用手順 |
|
|
104
|
-
| `opr-sales-recovery` | 回復手順 |
|
|
105
|
-
|
|
106
|
-
一次対応は店番担当が行い、会計結果不明・記録不一致・再印刷不能は OPS に引き渡す。OPS は `opr-sales-recovery` で照合し、契約不一致・不具合なら ARC・DEV、営業継続への影響なら PM・PO へ報告する。未作成の運用手順は `Q-02` の承認条件とする。
|
|
98
|
+
| 参照先 | 種類 | 参照目的 |
|
|
99
|
+
| ------------------------------------- | -------- | ---------------------------------------------------------- |
|
|
100
|
+
| [[specdojo:uis-sample\|販売登録画面]] | 画面仕様 | 商品登録・修正、預かり金確認、確定・中止の操作と入力形式 |
|
|
101
|
+
| `opr-pos-operation` | 運用手順 | 店番交代時の確認、利用権限の設定、印刷失敗時の再印刷 |
|
|
102
|
+
| `opr-sales-recovery` | 回復手順 | 結果不明の取引の照合、部分失敗の再開、代替運用への切替判断 |
|
|
107
103
|
|
|
108
|
-
|
|
104
|
+
一次対応は店番担当が行い、結果不明・記録不一致・再印刷不能は OPS へ引き渡す。OPS は契約不一致・不具合を ARC・DEV へ、営業継続への影響を PO へ報告する。
|
|
109
105
|
|
|
110
106
|
## 7. 検証・受入観点
|
|
111
107
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
以下は試験の判定基準であり、実施済み・合格済みを表さない。データは架空の商品・取引を使い、証跡には比較前後の記録、在庫、表示結果を残す。
|
|
115
|
-
|
|
116
|
-
| 観点 ID | 対象要件 | 対象条件 | 観測する期待結果 | 検証方法・証跡 | 確認ロール |
|
|
117
|
-
| ------- | ---------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------ |
|
|
118
|
-
| `V-01` | `FR-01`・`FR-02` | 登録済み商品を追加・数量変更・削除する。数量は UIS の許容下限・上限とその外側、在庫と同数・超過で確認する | 許容時だけ明細と金額が更新される。未登録・不正・在庫超過は理由を返し、既存明細を維持する | 結合試験、入出力比較 | DEV・QE |
|
|
119
|
-
| `V-02` | `FR-02`・`FR-03` | 税計算結果が請求額108円の明細に、預かり金107円・108円・200円を与える | 107円では確定不可、108円では釣銭0円、200円では釣銭92円となる。完了時は売上記録と在庫反映を確認できる | 結合試験、金額表示・記録照合 | QE・BA |
|
|
120
|
-
| `V-03` | `FR-02`・`FR-04` | 空明細で確定、非数値の預かり金で確定、有効明細を確定前に中止する | 前二者は理由付きで拒否し、後者は未確定明細を破棄する。いずれも売上記録・在庫払出を作らない | 結合試験、処理前後の記録 | QE |
|
|
121
|
-
| `V-04` | `FR-03` | 確定成功後に同じ要求を再送し、その後商品台帳の単価を変更する | 売上と払出は各1回分で、元の会計結果を返す。過去の売上明細の販売単価は変更されない | 結合試験、件数・在庫差分・明細照合 | DEV・QE |
|
|
122
|
-
| `V-05` | `FR-03`・`FR-04` | 保存前、販売記録後・在庫反映前、在庫反映後・応答前に障害を発生させる | 完了を推測せず、停止位置と反映状況が残る。照合前の再確定・中止は拒否する。回復後は売上・払出が各1回分で一致する | 障害注入、保留表示・回復記録 | ARC・QE・OPS |
|
|
123
|
-
| `V-06` | `FR-03` | 会計完了後に印刷失敗し、回復後に再印刷する | 印刷未完了の通知と控えが残る。同じ販売を印刷でき、売上件数と在庫が変わらない | 外部連携試験、印刷結果・記録比較 | QE・OPS |
|
|
124
|
-
| `V-07` | 権限・秘匿 | 販売権限なしで確定要求する。現金販売を顧客情報なしで実施する | 無権限の確定は拒否される。権限ありの現金販売は顧客情報なしで完了し、出力に認証情報が含まれない | 権限試験、画面・レシート・証跡確認 | QE・OPS |
|
|
125
|
-
| `V-08` | 性能・使いやすさ | 実店舗と同じ端末で店主代表・家族利用者代表が登録・修正・会計・中止を行う | プロジェクト概要の作業完遂・重大な行き詰まりの基準を満たす。応答時間は `Q-02` で合意した条件・受入値と比較する | 利用者受入、観察・計測記録 | UX・QE・PO |
|
|
126
|
-
|
|
127
|
-
### 7.2. 文書の完成判定と承認
|
|
128
|
-
|
|
129
|
-
文書検査は利用リポジトリの package・hook 設定に従い、Markdown 整形、Markdown lint、Frontmatter・参照検査の対象・コマンド・結果を実行記録に残す。適用検査のエラーがなく、主要要件と受入条件が対応し、カタログの完了条件を確認できることを文書の完成条件とする。
|
|
108
|
+
データは架空の商品・取引を使い、証跡には処理前後の記録・在庫・表示を残す。
|
|
130
109
|
|
|
131
|
-
|
|
110
|
+
| 観点 ID | 対象要件 | 対象条件 | 観測する期待結果 | 検証方法・証跡 | 確認ロール |
|
|
111
|
+
| ------- | ---------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------ |
|
|
112
|
+
| `V-01` | `FR-01`・`FR-02` | 追加・数量変更・削除。数量は UIS の許容下限・上限とその外側、在庫と同数・超過 | 許容時だけ明細と金額が更新される。それ以外は理由を返し、既存明細を維持する | 結合試験、入出力比較 | DEV・QE |
|
|
113
|
+
| `V-02` | `FR-02`・`FR-03` | 請求額108円の明細に、預かり金107円・108円・200円を与える | 107円は確定不可、108円は釣銭0円、200円は釣銭92円。完了時は売上記録と在庫反映を確認できる | 結合試験、金額表示・記録照合 | QE・BA |
|
|
114
|
+
| `V-03` | `FR-02`・`FR-04` | 空明細で確定、非数値の預かり金で確定、有効明細を確定前に中止 | 前二者は理由付きで拒否、後者は明細を破棄する。いずれも売上記録・在庫払出を作らない | 結合試験、処理前後の記録 | QE |
|
|
115
|
+
| `V-04` | `FR-03` | 確定成功後に同じ要求を再送し、その後商品台帳の単価を変える | 売上と払出は各1回分で元の結果を返す。過去の売上明細の単価は変わらない | 結合試験、件数・在庫差分・明細照合 | DEV・QE |
|
|
116
|
+
| `V-05` | `FR-03`・`FR-04` | 保存前、販売記録後・在庫反映前、在庫反映後・応答前に障害を起こす | 完了を推測せず停止位置と反映状況が残り、照合前の再確定・中止を拒否する。回復後は売上・払出が各1回分で一致する | 障害注入、保留表示・回復記録 | ARC・QE・OPS |
|
|
117
|
+
| `V-06` | `FR-03` | 会計完了後に印刷失敗し、回復後に再印刷する | 印刷未完了の通知と控えが残り、再印刷しても売上件数と在庫が変わらない | 外部連携試験、印刷結果・記録比較 | QE・OPS |
|
|
118
|
+
| `V-07` | 権限・秘匿 | 販売権限なしで確定要求する。顧客情報なしで現金販売する | 無権限の確定は拒否される。権限ありは顧客情報なしで完了し、出力に認証情報が含まれない | 権限試験、画面・レシート・証跡確認 | QE・OPS |
|
|
119
|
+
| `V-08` | 性能・使いやすさ | 実店舗と同じ端末で店主代表・家族利用者代表が登録・修正・会計・中止を行う | プロジェクト概要の作業完遂・行き詰まりの基準を満たす。応答時間は `Q-02` で決めた受入値と比べる | 利用者受入、観察・計測記録 | UX・QE・PO |
|
|
132
120
|
|
|
133
121
|
## 8. 未決事項
|
|
134
122
|
|
|
135
|
-
| 論点
|
|
136
|
-
|
|
|
137
|
-
| `Q-01
|
|
138
|
-
| `Q-02
|
|
123
|
+
| 論点 | 影響と当面の扱い |
|
|
124
|
+
| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
125
|
+
| `Q-01` `_UNDECIDED_`: `sf-index` の対応、BPS の詳細対応、税計算、取引状態、在庫・印刷・記録先の連携契約が未整備 | 設計境界・税額・再送時の一意性を保証できない。確定までは未照合部分を確定した設計入力に使わず、確定後に「業務プロセス・画面との対応」と `FR-03` を照合する |
|
|
126
|
+
| `Q-02` `_UNDECIDED_`: 応答時間の受入値と、接続不能・部分失敗時の代替運用が未合意 | `V-05`・`V-08` を判定できず、営業停止や紙からの二重転記のおそれがある。オフライン販売を足す場合は対象範囲と受入条件を見直す |
|
|
@@ -17,108 +17,89 @@ specdojo:
|
|
|
17
17
|
|
|
18
18
|
## 1. 概要
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
店主代表と店番担当が、現物・紙台帳・タブレット内のファイルをどこに置き、いつ消してよいかを同じ根拠で判断できるようにする。検品前の入荷品と販売可能な商品の混在や、販売記録の控え・入力途中のセッションファイルの誤削除を防ぐ。
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
### 1.1. 対象範囲と隣接仕様との分担
|
|
25
|
-
|
|
26
|
-
対象範囲は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要): 駄菓子屋きぬや販売管理]] の仕入・販売・在庫・締め領域で用いる物理保管場所および店舗タブレットのローカル保存領域とする。仕入記録は現行の仕入ノートを対象に含める。在庫記録は現行が店主の記憶で保管場所を持たないため一覧に載せず、システム化後の保管先を「確認事項と変更影響」で追跡する。
|
|
27
|
-
|
|
28
|
-
| 隣接仕様・正本 | 本書(`sld-sample`)との分担 |
|
|
29
|
-
| ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
30
|
-
| [[specdojo:cdsd-sample\|概念データストア定義(駄菓子屋きぬやの販売と締め)]] | CDSD は管理単位(商品台帳・販売記録・日次販売集計・日次締め記録・月次報告)と正本区分・更新責務を定義する。本書はそれらの現物・ファイルが置かれる場所、共有範囲、寿命、削除可否を定義する |
|
|
31
|
-
| [[specdojo:stsd-sample\|商品のステータス定義]] | STSD は納品から販売・返品までの状態と遷移条件を定義する。本書は状態ごとの現物の保管場所と処分の境界を定義する |
|
|
32
|
-
| [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] | BDD は商品・売上記録・売上明細の項目定義を正本とする。本書は項目構造を再掲せず、ファイル単位の保管場所と保持期間を定義する |
|
|
33
|
-
| [[specdojo:clis-sample\|駄菓子屋きぬや 販売管理 CLI 仕様]] | CLIS はコマンド構文と入出力ファイル(`config/`、`.session/`、`data/sales/`、`receipts/`)の作成・停止条件を定義する。本書はそれらの寿命、削除可否、消失・障害時の復旧経路を定義する |
|
|
22
|
+
対象範囲は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要): 駄菓子屋きぬや販売管理]] の仕入・販売・在庫・締め領域の物理保管場所と、店舗タブレットのローカル保存領域とする。仕入記録は現行の仕入ノートを含める。在庫記録は今は店主の記憶で保管場所がないため、「確認事項と変更影響」で追跡する。
|
|
34
23
|
|
|
35
24
|
## 2. 保管場所一覧
|
|
36
25
|
|
|
37
26
|
### 2.1. 店舗内・母屋の物理保管場所
|
|
38
27
|
|
|
39
|
-
| 保管場所
|
|
40
|
-
|
|
|
41
|
-
| 検品場所(店舗奥の荷受台)
|
|
42
|
-
|
|
|
43
|
-
| 返品保管箱(バックヤード下段・赤ラベル)
|
|
44
|
-
| 撤去品保留箱(バックヤード下段・黄ラベル)
|
|
45
|
-
| レジ釣銭準備箱・手提げ金庫
|
|
46
|
-
| 仮メモ挟み(レジ横)
|
|
47
|
-
| 店頭台帳保管棚(施錠キャビネット)
|
|
48
|
-
| 母屋書庫(施錠書棚)
|
|
49
|
-
| 母屋金庫
|
|
50
|
-
| 外部退避媒体(`_UNDECIDED_`: SD
|
|
28
|
+
| 保管場所 | 置くもの | 関連プロセス・操作 | 共有の有無 | 寿命・管理頻度 | 削除・処分の可否と条件 |
|
|
29
|
+
| --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
|
|
30
|
+
| 検品場所(店舗奥の荷受台) | 配置前の入荷品、納品伝票、外箱 | 入荷受入、入荷検品 | 店舗内共有 | 入荷当日の配置完了まで | `条件付き処分可`。検品結果を仕入ノートへ記録し、商品を売場棚か返品保管箱へ移してから外箱を処分する。伝票は店頭台帳保管棚へ移す |
|
|
31
|
+
| 売場棚(陳列棚・平台) | 販売可能な商品、棚札 | 売場配置、店頭販売、開店前の期限確認 | 店舗内公開 | 販売・撤去まで(毎朝点検) | `処分不可`。期限切れ・破損品は撤去品保留箱へ移す。棚札は取扱終了を店主代表が確かめてから外す |
|
|
32
|
+
| 返品保管箱(バックヤード下段・赤ラベル) | 検品で受入不可とした商品 | 入荷検品、仕入先への返品 | 店舗内共有(売場と分離) | 仕入先への引渡しまで(週次の回収日) | `条件付き処分可`。仕入先へ引き渡し、返品日と数量を仕入ノートへ記録してから空にする。店舗で廃棄しない |
|
|
33
|
+
| 撤去品保留箱(バックヤード下段・黄ラベル) | `_ASSUMPTION_`: 売場から撤去した期限切れ・破損品 | 開店前の期限確認、廃棄確定 | 店舗内共有(売場・返品保管箱と分離) | 撤去した日の日次締めまで | `条件付き処分可`。店主代表が廃棄を確定し、廃棄数を日次締め記録の在庫差異欄へ記入してから廃棄する |
|
|
34
|
+
| レジ釣銭準備箱・手提げ金庫 | 釣銭準備金、当日の現金売上 | 開店準備、店頭販売、日次締め | 店舗内共有(閉店後は施錠) | 日次締めまで | `処分不可`。日次締めで店主代表が現金と販売額の一致を確かめ、売上金を母屋金庫へ移す |
|
|
35
|
+
| 仮メモ挟み(レジ横) | 仮領収メモ、つけ販売の仮メモ | 店頭販売、日次締め | 店番担当のみ(客から見えない位置) | 書いた日の日次締めまで | `条件付き処分可`。販売ノートと顧客・つけ台帳への転記を店主代表が確かめたメモだけ破棄する |
|
|
36
|
+
| 店頭台帳保管棚(施錠キャビネット) | 当年度の商品台帳、顧客・つけ台帳、仕入ノート、納品伝票綴り、販売ノート(販売明細欄・日次締め欄)、月次報告 | 入荷検品、つけ販売、日次締め、月次見直し | 店主代表・家族利用者代表のみ(施錠) | 当年度分。年度末に母屋書庫へ移す | `処分不可`。取引・未収金・仕入の正本記録 |
|
|
37
|
+
| 母屋書庫(施錠書棚) | 旧年度の台帳・ノート・伝票・月次報告 | 年度末の移管、過去の照合 | 店主代表が施錠管理(家族利用者代表は了承を得て閲覧) | 保持期間は未決。決まるまで全年度 | `処分不可`。満了分の処分も PO の承認を要する |
|
|
38
|
+
| 母屋金庫 | 日次締め後の売上金 | 日次締め、仕入代金の支払 | 店主代表のみ | 支払・入金まで | `処分不可`。持ち出すときは金額と用途を販売ノートの日次締め欄へ記入する |
|
|
39
|
+
| 外部退避媒体(`_UNDECIDED_`: SD カードか USB メモリ。手提げ金庫か母屋金庫) | `config/store-config.yaml` と `data/sales/` の日次複製 | 日次締め後の退避、消失時の復元 | 店主代表のみ | 保持世代数は未決。決まるまで全世代 | `処分不可`。上書き・消去しない |
|
|
51
40
|
|
|
52
41
|
### 2.2. 店舗タブレット内の論理保管場所
|
|
53
42
|
|
|
54
|
-
| 保管場所 | 置くもの
|
|
55
|
-
| ---------------------------------------------------- |
|
|
56
|
-
| 店舗設定ファイル(`config/store-config.yaml`) | 店舗・税計算・本部接続の条件
|
|
57
|
-
| 取引セッション(`.session/current-tx.json`) | 進行中の取引の明細と確定状態
|
|
58
|
-
| 販売記録の控え(`data/sales/TX-YYYYMMDD-NNNN.json`) |
|
|
59
|
-
| 日次販売集計(`_ASSUMPTION_`: `data/summary/`) |
|
|
60
|
-
| レシート控え(`receipts/receipt-YYYYMMDD-NNNN.txt`) | 確定済み会計のレシート
|
|
61
|
-
| 一時作業領域(`_ASSUMPTION_`: `tmp/`) | 保守作業の一時ファイル
|
|
43
|
+
| 保管場所 | 置くもの | 関連プロセス・操作 | 共有の有無 | 寿命・管理頻度 | 削除・処分の可否と条件 |
|
|
44
|
+
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------------- | -------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
45
|
+
| 店舗設定ファイル(`config/store-config.yaml`) | 店舗・税計算・本部接続の条件 | 全 `sales` コマンドの設定解決 | 共有なし(端末ローカル。外部退避媒体へ複製) | 店舗運用期間中 | `削除不可`。欠落すると CLI は既定設定で動き、条件が変わる。変更は DEV が旧ファイルを退避してから行い、PO が条件を確かめる |
|
|
46
|
+
| 取引セッション(`.session/current-tx.json`) | 進行中の取引の明細と確定状態 | `sales start`、`add`、`total`、`complete`、`cancel` | 共有なし(端末ローカル) | 取引開始から会計完了・確定前取消まで | `条件付き削除可`。CLI が終了させる場合に限る。手で消さない |
|
|
47
|
+
| 販売記録の控え(`data/sales/TX-YYYYMMDD-NNNN.json`) | 現金販売の販売実績と本部の受付結果(受付済み・未受付・結果不明)。つけ販売は販売ノートに紙で記録 | `sales complete`、本部受付との照合、日次締め | 共有なし(端末ローカル。外部退避媒体へ複製) | 保持期間は未決。決まるまで全件 | `削除不可`。本部受付との照合根拠で、正本の保存先も未決 |
|
|
48
|
+
| 日次販売集計(`_ASSUMPTION_`: `data/summary/`) | 日ごとの販売件数・請求合計・支払方法別内訳(派生情報) | 日次締め、販売訂正後の再集計 | 共有なし(端末ローカル) | 閉店後に作成し、販売訂正時に作り直す | `条件付き削除可`。再生成手順(予定 `specdojo:cop-sales-reconciliation`)が整い、日次締め記録の参照値を再現できる場合に限る |
|
|
49
|
+
| レシート控え(`receipts/receipt-YYYYMMDD-NNNN.txt`) | 確定済み会計のレシート | `sales complete`、未印字時の再印刷 | 共有なし(端末ローカル) | 月次締め確定まで | `条件付き削除可`。月次締め確定後で、未印字・照合中の取引がない場合に限る。再出力できないため、削除後の照合は `data/sales/` で行う |
|
|
50
|
+
| 一時作業領域(`_ASSUMPTION_`: `tmp/`) | 保守作業の一時ファイル | DEV の保守作業 | 共有なし(端末ローカル) | 保守作業の終了まで | `削除可`。CLI と保守作業が止まっていれば消してよい |
|
|
62
51
|
|
|
63
52
|
## 3. 削除・退避・復旧の判断基準
|
|
64
53
|
|
|
65
|
-
### 3.1.
|
|
54
|
+
### 3.1. 区分ごとの扱い
|
|
66
55
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
| `条件付き削除可` / `条件付き処分可` | 検品場所、返品保管箱、撤去品保留箱、仮メモ挟み、`.session/current-tx.json`、`data/summary/`、`receipts/` | 一覧に書いた削除前条件(記録への反映・転記、PO の確定、CLI による終了、再生成手順の整備、月次締め確定)をすべて満たした場合だけ処分・削除する |
|
|
71
|
-
| `削除可` | `tmp/` | 保守作業の終了後に削除してよい |
|
|
56
|
+
- `削除不可` / `処分不可`: 清掃や容量整理で消さず、一覧に書いた移し先へ移す。電子記録は保持期間が決まるまで整理しない。
|
|
57
|
+
- `条件付き削除可` / `条件付き処分可`: 「保管場所一覧」の条件をすべて満たした場合だけ消す。満たせなければ残して持ち越す。
|
|
58
|
+
- `削除可`: 使用中の作業がなければ消す。
|
|
72
59
|
|
|
73
60
|
### 3.2. 場面別の対処と復旧手順
|
|
74
61
|
|
|
75
|
-
| 場面 |
|
|
76
|
-
| ---------------------------------------------------------- |
|
|
77
|
-
| 会計要求前に再起動し、取引が残っている | `sales total`
|
|
78
|
-
| 会計要求後に再起動・応答欠落し、本部の受付結果が分からない |
|
|
79
|
-
| `data/summary/` を誤って削除した |
|
|
80
|
-
| `config/store-config.yaml` が消失・破損した | 会計を止める。DEV
|
|
81
|
-
| `data/sales/` が消失・破損した | 新規会計を止める。DEV
|
|
82
|
-
| 売場で期限切れ・破損品を見つけた |
|
|
83
|
-
| タブレットの空き容量が不足した | `tmp/` と条件を満たした `receipts/`
|
|
62
|
+
| 場面 | 確認と対処 | 担当・連絡先 |
|
|
63
|
+
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
|
|
64
|
+
| 会計要求前に再起動し、取引が残っている | `sales total` で明細を確かめ、続けるか `sales cancel` で取り消す | 店番担当。解消しなければ DEV |
|
|
65
|
+
| 会計要求後に再起動・応答欠落し、本部の受付結果が分からない | 取消・ファイル削除・再登録をしない。PO が本部受付と `data/sales/` を照合し、受付済みなら同じ取引を回復し、未受付と確かめた場合だけ送信を再開する。照合・回復手順が整うまで、確かめられない取引は保留する | OPS が会計を止めて PO・DEV へ連絡。PO が判断 |
|
|
66
|
+
| `data/summary/` を誤って削除した | 再生成手順が整うまでは、受付済みの `data/sales/` の現金販売(結果不明を除く)と販売ノートのつけ販売を手で集計し、日次締め記録の参照値と照合する。照合者・照合日・結果は本部の受付結果と別に日次締め記録へ書く | OPS(店主代表)が再集計、QE が一致を確認。不一致なら PO が締めを再判断 |
|
|
67
|
+
| `config/store-config.yaml` が消失・破損した | 会計を止める。DEV が外部退避媒体の最新世代を復元する。退避がなければ、構造の正本 `kinuya-store-config-schema`(CLIS の未同梱の参照名)がある場合に限り作り直し、なければ PO へ報告する。PO が条件を確かめるまで再開しない | OPS → DEV(復元)・PO(条件確認) |
|
|
68
|
+
| `data/sales/` が消失・破損した | 新規会計を止める。DEV が最新世代を復元し、退避後の取引を PO が販売ノート・レシート控え・本部受付と照合し、QE が取引番号の連続と日次締め記録の件数を照合する。退避がなければ推測で作り直さず、照合できない日の締めを保留する | OPS → DEV(復元)・PO(照合と締め)・QE(一致確認) |
|
|
69
|
+
| 売場で期限切れ・破損品を見つけた | 売場で捨てず撤去品保留箱へ移す | 店番担当(移動)→ PO(廃棄確定) |
|
|
70
|
+
| タブレットの空き容量が不足した | `tmp/` と条件を満たした `receipts/` だけを消す | OPS(削除)、DEV・PO(保持期間が決まるまでの容量確保) |
|
|
84
71
|
|
|
85
72
|
## 4. 関連仕様・実装配置との対応と検証
|
|
86
73
|
|
|
87
|
-
### 4.1.
|
|
74
|
+
### 4.1. 隣接仕様との分担と対応
|
|
88
75
|
|
|
89
|
-
|
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
94
|
-
|
|
|
95
|
-
|
|
|
96
|
-
| `data/summary/` | CDSD の日次販売集計(派生情報・保存形式未確定) | 仮置きのパスであることと、集計元が現金販売は受付確認済みの `data/sales/`、つけ販売は販売ノートの販売明細欄であることが明示されていること |
|
|
76
|
+
| 隣接仕様 | 定義するものと対応する保管場所 |
|
|
77
|
+
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
78
|
+
| [[specdojo:cdsd-sample\|概念データストア定義(駄菓子屋きぬやの販売と締め)]] | 管理単位と正本区分・更新責務。商品台帳・販売記録・日次締め記録・月次報告は店頭台帳保管棚と母屋書庫、販売記録は `data/sales/`(結果不明の取引は照合待ち)、日次販売集計(保存形式未確定)は `data/summary/` |
|
|
79
|
+
| [[specdojo:cdfd-overview-sample\|概念データフロー図(全体概要)]] | 仕入記録(仕入ノート)と顧客・つけ台帳は店頭台帳保管棚と母屋書庫 |
|
|
80
|
+
| [[specdojo:stsd-sample\|商品のステータス定義]] | 商品の状態と遷移。入荷済み(`received`)・検品済み(`inspected`)は検品場所、販売可能(`sellable`)は売場棚、返品待ち(`return-pending`)は返品保管箱。撤去品保留箱に当たる状態はない |
|
|
81
|
+
| [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] | 商品・売上記録・売上明細の項目。本書は項目を再掲しない |
|
|
82
|
+
| [[specdojo:clis-sample\|駄菓子屋きぬや 販売管理 CLI 仕様]] | コマンドと入出力ファイル(`config/`、`.session/`、`data/sales/`、`receipts/`)の作成・停止条件 |
|
|
97
83
|
|
|
98
84
|
### 4.2. 検証手順と受入条件
|
|
99
85
|
|
|
100
|
-
|
|
|
101
|
-
|
|
|
102
|
-
|
|
|
103
|
-
|
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
| `[QE]` 文書品質・整合性検証 | 標準6列・必須章、章見出しの末尾ピリオド、wikilink の解決を確認し、整形・lint を実行する | `npx prettier --write`、`npm run lint:md`、`npm run lint:fm` がエラー0件で通過すること |
|
|
86
|
+
| 観点 | 手順 | 合格条件 |
|
|
87
|
+
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
88
|
+
| CLI 仕様との一致 | タブレット内の各パスと役割を CLIS と照合する | CLIS にないパスに `_ASSUMPTION_` が付き、取引セッションと販売記録の控えが別ファイルである |
|
|
89
|
+
| 設定ファイルの欠落・破損 | 検証用端末で `config/store-config.yaml` を外して `sales start` を実行し、次に壊して実行する | 欠落時は既定設定で起動し、破損時は「店舗設定不正」(終了コード `4`)で停止する |
|
|
90
|
+
| 受付結果不明の取引 | 本部の応答を欠落させて `sales complete` を実行し、続けて `sales cancel` を試す | `.session/current-tx.json` と `data/sales/` に結果不明として残り、取消は終了コード `2` で拒否される |
|
|
91
|
+
| 日次集計の再集計 | CDSD の照合例の現金販売108円を受付済みの `data/sales/` に、つけ販売216円を販売ノートに用意し、結果不明の現金取引1件を加える。`data/summary/` を消して場面別の対処で作り直す | 販売2件・請求合計324円で元の売上IDの集合と一致し、結果不明の取引を含まない |
|
|
92
|
+
| 記録・状態の網羅 | CDSD の5管理単位、全体概要の仕入記録・在庫記録、STSD の全状態を一覧と照合する | 保管場所のない記録・状態が「確認事項と変更影響」にある。紙の正本が年度で二か所に分かれても欠落せず、受入不可品・撤去品が売場や返品待ちと混ざらない |
|
|
93
|
+
| 削除・復旧判断の実効性 | 清掃・障害復旧・容量整理・返品の判断を本書で模擬する | 消してよい場所、削除前の条件、復旧の経路と連絡先を迷わず判断できる |
|
|
109
94
|
|
|
110
95
|
## 5. 確認事項と変更影響
|
|
111
96
|
|
|
112
|
-
| 論点
|
|
113
|
-
|
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
| 本部との受付照会・重複排除・回復の契約が未整備
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
| 紙の台帳・締め記録をタブレットへ完全移行する場合
|
|
121
|
-
|
|
122
|
-
PM は各行を区分どおりの管理台帳の種別で登録し、担当と判断時期を Schedule へ接続する。
|
|
123
|
-
|
|
124
|
-
公開および `status: ready` への昇格前に、BA・ARC・DEV・OPS・QE が受入条件を確認し、人間の PO(店主代表)が顧客情報の施錠保管と上表の未決事項の扱いを承認する。照合・回復契約と日次集計の再生成手順が整備されるまで、受付結果不明の取引の回復と日次集計の自動再生成は保留中の手順として扱い、それらに依存する運用開始を承認しない。agent は `status: draft` を維持する。
|
|
97
|
+
| 論点 | 影響と当面の扱い |
|
|
98
|
+
| -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
|
|
99
|
+
| `_UNDECIDED_`: 外部退避媒体の種類・保管先・保持世代数 | 決まるまで全世代を保持する |
|
|
100
|
+
| `_UNDECIDED_`: 販売記録の正本保存先と電子・紙記録の保持期間(CDSD で未決) | 決まるまで `data/sales/` と母屋書庫の記録を処分しない |
|
|
101
|
+
| 日次集計の再生成手順(`specdojo:cop-sales-reconciliation`)が未整備 | 整うまで `data/summary/` を削除できない |
|
|
102
|
+
| 本部との受付照会・重複排除・回復の契約が未整備 | 誤った取消・再登録で二重登録や照合根拠の消失が起こる。回復と日次集計の自動再生成に依存する運用は始めない |
|
|
103
|
+
| `_UNDECIDED_`: 仕入記録・在庫記録のシステム化後の保管先 | 在庫記録は今は保管場所がない。決まったら「保管場所一覧」へ行を足す |
|
|
104
|
+
| 撤去品保留箱に当たる商品状態が STSD にない | 撤去品保留箱は仮置きで運用する。STSD に状態が足されたら対応を見直す |
|
|
105
|
+
| 紙の台帳・締め記録をタブレットへ完全移行する場合 | 正本区分、`data/` の構成、外部退避の対象、日次集計の再集計元、本部照合に使う記録、検証項目が変わる |
|