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
|
@@ -13,7 +13,7 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
## 1. 概要
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
駄菓子屋きぬやの 1 週間分の販売記録と在庫記録から、商品別の販売数・欠品の発生・翌週の補充候補をまとめた報告である。店主代表はこの報告で欠品の傾向を確かめ、翌週の仕入れ数量を判断する。欠品回数の削減の測定にも使う。
|
|
17
17
|
|
|
18
18
|
## 2. 読み手と利用目的
|
|
19
19
|
|
|
@@ -23,95 +23,82 @@ specdojo:
|
|
|
23
23
|
| 家族利用者代表 | 店番のときに品切れしやすい商品を知る | 店番中に在庫を確かめる商品、店主代表へ知らせる事項 |
|
|
24
24
|
| 店舗運営アドバイザー | 欠品と記録漏れの傾向から運用の改善点を見つける | 記録の付け方や補充のタイミングの見直しが要る点 |
|
|
25
25
|
|
|
26
|
-
-
|
|
27
|
-
- 確認・承認: PO(店主代表)が内容を確認し、仕入れ数量を決める。報告は補充の候補を示すだけで、仕入れ数量を決めない。
|
|
28
|
-
- 仕様の確認: BA が読み手と利用目的を、QE が表示項目の確かめ方と例外時の表示を確かめる。確定の条件と承認者は「メモ / 将来課題」に示す。
|
|
29
|
-
- 問い合わせ: 報告の読み方や項目の意味は BA、報告ができない・値が記録と食い違うときは DEV が受ける。
|
|
30
|
-
- 対象外の用途: つけ残高の確認と会計の締めには使わない。それぞれつけ台帳と、[[specdojo:cdsd-sample|概念データストア定義]] の日次締め記録を見る。
|
|
26
|
+
対象外の用途: つけ残高の確認と会計の締めには使わない。それぞれつけ台帳と、[[specdojo:cdsd-sample|概念データストア定義]] の日次締め記録を見る。
|
|
31
27
|
|
|
32
28
|
## 3. 出力の時期と契機
|
|
33
29
|
|
|
34
|
-
- 契機:
|
|
35
|
-
- 対象期間: 月曜 0 時から日曜 24
|
|
36
|
-
- 取りこぼし:
|
|
37
|
-
- 再出力:
|
|
30
|
+
- 契機: 日曜の日次締め記録の確定後に自動で作る。日曜の締めがない週は、日曜 24 時を過ぎて端末が最初に起動したときに作る。店主代表は手動でも作れる。
|
|
31
|
+
- 対象期間: 月曜 0 時から日曜 24 時(日本時間)。休業日があっても変えない。
|
|
32
|
+
- 取りこぼし: 端末を起動しなかった週は、次の起動時に 1 週ずつ作る。
|
|
33
|
+
- 再出力: 同じ週の報告を作り直し、報告を増やさない。作り直す前の報告は残さない。販売数(印を含む)か販売件数の不一致の日が変わり、翌週の報告が作成済みなら、翌週も再出力する。変わらなかった週か作成済みの最新の週で止め、各週の前週比が前週の報告の販売数との差と一致すれば完了とする。
|
|
38
34
|
|
|
39
35
|
## 4. 出力形式と提供方法
|
|
40
36
|
|
|
41
|
-
- 形式:
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
46
|
-
- 本文構成: 報告の本文構成を定める別の rulebook はない。報告に載せる項目と並び順は、本書の「表示項目」を正とする。
|
|
37
|
+
- 形式: タブレットの画面表示と印刷用の PDF。日付は `YYYY-MM-DD`、値は整数。機械で読む形式は出さない。
|
|
38
|
+
- 単位と提供方法: 1 週 1 件。店主代表が報告一覧から開き、印刷は仕入れノートに綴じる。
|
|
39
|
+
- 閲覧範囲: 店主代表と家族利用者代表に限る。店舗運営アドバイザーには店内で印刷を見せる。購入者名・つけ残高は載せない。
|
|
40
|
+
- 保存期間: 欠品回数の年間比較のため 1 年分を残す。
|
|
41
|
+
- 本文構成: 別の rulebook はなく、本書の「表示項目」を正とする。
|
|
47
42
|
|
|
48
43
|
## 5. 対象範囲と元にする記録
|
|
49
44
|
|
|
50
|
-
|
|
45
|
+
対象は単一店舗の店頭販売とし、つけ販売を含め、取り消した販売を除く。EC、発注、廃棄・値引きは対象外とし、在庫の過不足は月次報告で扱う。店番ノートの手書きの控えは報告から読めないため、例外時に店主代表が照合する資料とする。
|
|
51
46
|
|
|
52
|
-
| 記録 | 用途
|
|
53
|
-
| ------------ |
|
|
54
|
-
| 日次締め記録 |
|
|
55
|
-
| 販売記録 |
|
|
56
|
-
| 欠品の記録 |
|
|
57
|
-
| 商品台帳 |
|
|
58
|
-
| 前週の報告 |
|
|
47
|
+
| 記録 | 用途 | 正本 | 欠けるときの扱い |
|
|
48
|
+
| ------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
|
|
49
|
+
| 日次締め記録 | 営業日の特定、販売件数の照合 | [[specdojo:cdsd-sample\|概念データストア定義]] の日次締め記録の確定した確認版と、その版が参照する日次販売集計 | 締め記録・締め案・販売記録のない日は休業日、確定した版のない日は締め未確定とする。締め記録を読めなければ報告を保留する |
|
|
50
|
+
| 販売記録 | 商品別の販売数 | [[specdojo:cdsd-sample\|概念データストア定義]] の販売記録、[[specdojo:bes-sample\|業務イベント: 店頭の現金会計の確定]] | 締めの販売件数と一致しない日は「集計・算出ルール」の「不完全」「不明」で示し、0 とみなさない |
|
|
51
|
+
| 欠品の記録 | 欠品の発生日と商品 | `bes-stock-out-recorded`(未同梱) | 記録がない週は欠品 0 件とし、「欠品の記録なし」と注記する |
|
|
52
|
+
| 商品台帳 | 商品名と商品区分 | [[specdojo:cdsd-sample\|概念データストア定義]] の商品台帳 | 台帳にない商品は商品コードで表示し、店主代表へ確認を促す |
|
|
53
|
+
| 前週の報告 | 前週からの販売数の増減 | 前週の本報告 | 「集計・算出ルール」の前週比に従う |
|
|
59
54
|
|
|
60
55
|
## 6. 表示項目
|
|
61
56
|
|
|
62
|
-
| No | 区分 | 項目名 | 意味・定義
|
|
63
|
-
| --- | ------ | ---------------- |
|
|
64
|
-
| 1 | 見出し | 対象週 |
|
|
65
|
-
| 2 | 見出し | 営業日数 | 期間内で日次締め記録の確定した確認版がある日の数
|
|
66
|
-
| 3 | 明細 | 商品名 |
|
|
67
|
-
| 4 | 明細 | 販売数 |
|
|
68
|
-
| 5 | 明細 | 前週比 |
|
|
69
|
-
| 6 | 明細 | 欠品回数 | 期間内に欠品を記録した日数
|
|
70
|
-
| 7 | 明細 | 補充候補 | 欠品回数が 1 以上の商品に付ける印
|
|
71
|
-
| 8 | 集計 | 欠品回数の合計 | 全商品の欠品回数の合計
|
|
72
|
-
| 9 | 注記 | 記録の注意 |
|
|
73
|
-
| 10 | 注記 | 参照した締めの版 |
|
|
74
|
-
|
|
75
|
-
|
|
57
|
+
| No | 区分 | 項目名 | 意味・定義 | 元にする記録 | 記録からの確かめ方 |
|
|
58
|
+
| --- | ------ | ---------------- | ------------------------------------------------------------ | ---------------------------------- | ---------------------------------------------------------------------- |
|
|
59
|
+
| 1 | 見出し | 対象週 | 対象期間の開始日(月曜)と終了日(日曜) | 出力の契機 | 出力を求めた週の月曜と日曜(日本時間)に一致する |
|
|
60
|
+
| 2 | 見出し | 営業日数 | 期間内で日次締め記録の確定した確認版がある日の数 | 日次締め記録 | 確定した確認版の対象日の数と一致する |
|
|
61
|
+
| 3 | 明細 | 商品名 | 期間内に販売数か欠品回数が 1 以上の商品の名前 | 商品台帳、販売記録、欠品の記録 | 販売か欠品の記録がある商品だけが載り、名前が商品台帳と一致する |
|
|
62
|
+
| 4 | 明細 | 販売数 | 期間内に販売した個数。確かめられないときは「不完全」「不明」 | 販売記録、日次締め記録 | 「集計・算出ルール」の締めの版と販売数で数え直した値・印と一致する |
|
|
63
|
+
| 5 | 明細 | 前週比 | 販売数の前週との差(増加は `+`)。出せないときは理由の表示 | 前週の報告 | 今週の販売数から前週の報告の販売数を引いた値と一致する |
|
|
64
|
+
| 6 | 明細 | 欠品回数 | 期間内に欠品を記録した日数 | 欠品の記録 | 欠品の記録がある日付の数と一致する |
|
|
65
|
+
| 7 | 明細 | 補充候補 | 欠品回数が 1 以上の商品に付ける印 | 欠品の記録 | 欠品回数が 1 以上の商品にだけ印がある |
|
|
66
|
+
| 8 | 集計 | 欠品回数の合計 | 全商品の欠品回数の合計 | 欠品の記録 | 明細の欠品回数の合計と一致する |
|
|
67
|
+
| 9 | 注記 | 記録の注意 | 記録の欠け・不一致・締め未確定、前週比を出せない理由 | 「対象範囲と元にする記録」の各記録 | 「対象範囲と元にする記録」と「例外と注意事項」に該当する事項だけが載る |
|
|
68
|
+
| 10 | 注記 | 参照した締めの版 | 日ごとに使った日次締め記録の確認版(ない日は「なし」) | 日次締め記録 | 出力時点で確定していた最新の確認版と一致する |
|
|
69
|
+
|
|
70
|
+
並び順は販売数の多い順、同数は商品名の五十音順とする。「不完全」は数値で並べ、「不明」は数値を持つ商品の後に五十音順で並べる。
|
|
76
71
|
|
|
77
72
|
## 7. 集計・算出ルール
|
|
78
73
|
|
|
79
|
-
- 期間への割り当て:
|
|
80
|
-
-
|
|
81
|
-
- 締めの版: 各日について、出力時点で PO
|
|
82
|
-
- 販売数:
|
|
83
|
-
- 欠品回数:
|
|
84
|
-
- 前週比:
|
|
85
|
-
- 補充候補: 欠品回数が 1
|
|
86
|
-
- 端数・割合:
|
|
87
|
-
|
|
88
|
-
_UNDECIDED_: 欠品回数が 1 回でも補充候補とするか、2 回以上に絞るかは、店主代表が初回の報告を見てから決める。決まるまでは 1 回以上を候補とする。
|
|
74
|
+
- 期間への割り当て: 販売記録の会計確定日時を日本時間で判定する。
|
|
75
|
+
- 営業日: 日次締め記録の確定した確認版がある日とする。締め案だけの日は締め未確定とし、数えない。確定した締めの販売件数が 0 で販売記録もない日は販売 0 の営業日とし、注記しない。
|
|
76
|
+
- 締めの版: 各日について、出力時点で PO が確定した最新の確認版を使い、その版の日次販売集計の販売集合(売上 ID の集合)を基準時点の状態で合計する。基準時点の後の訂正は、新しい確認版の確定まで含めない。同じ版からの再出力は同じ値になる。確定した版がない日は出力時点の販売記録で数える。再出力では前回の値を引き継がず数え直す。
|
|
77
|
+
- 販売数: 販売明細の数量を商品ごとに合計し、取り消した販売を除く。版の販売件数と、その販売集合のうち読める売上の件数が一致しない日があれば、その週の合計に「不完全」と付け、販売記録がない商品は「不明」とする。
|
|
78
|
+
- 欠品回数: 同じ日の同じ商品の欠品は 1 回と数える。
|
|
79
|
+
- 前週比: 前週の報告にない商品は前週を 0 とする。初回は「前週なし」とする。前週の報告がない・読めない場合、今週か前週が「不完全」「不明」の場合、前週に販売件数の不一致の日があり前週の明細にない商品は「比較不可」とし、差を出さない。
|
|
80
|
+
- 補充候補: 欠品回数が 1 以上の商品に印を付け、仕入れ数量は算出しない。
|
|
81
|
+
- 端数・割合: 値は整数で端数は出ない。分母を定めていないため割合は出さない。
|
|
89
82
|
|
|
90
83
|
## 8. 例外と注意事項
|
|
91
84
|
|
|
92
|
-
| 状況
|
|
93
|
-
|
|
|
94
|
-
| 期間内に販売記録が 1 件もない
|
|
95
|
-
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
99
|
-
|
|
|
100
|
-
|
|
|
101
|
-
|
|
|
102
|
-
| 日曜の日次締めの前に手動で出力した | 出力時点までの記録で作り、見出しに「締め前」と表示する | 店主代表は締めの後に再出力し、仕入れ判断には再出力した報告を使う |
|
|
103
|
-
| 自動での作成が失敗した | 報告を作らない | DEV が原因を確かめ、解消後に同じ週を再出力する |
|
|
85
|
+
| 状況 | 報告の扱い | 次の手 |
|
|
86
|
+
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
|
|
87
|
+
| 期間内に販売記録が 1 件もない | 締めの販売件数がすべて 0 なら欠品の商品を販売数 0 で載せ、なければ「明細なし」。1 以上の日があれば「不明」とする | 店主代表が締め記録と照合し、記録漏れなら DEV へ知らせる |
|
|
88
|
+
| 締め記録・締め案・販売記録がない(全休の週) | 見出しに「休業週」、営業日数 0 と表示し、欠品の商品だけを販売数 0 で載せる | 店主代表が休業の予定と照合し、合わなければ DEV へ知らせる |
|
|
89
|
+
| 確定した締めがない日に販売記録か締め案がある | 販売数に含め、記録の注意に「締め未確定」と日付を載せる。全日がそうなら見出しに「締め未確定」と表示する | 店主代表が締めを確定し、再出力する |
|
|
90
|
+
| 締めの販売件数と販売記録が一致しない日がある | 記録の注意に日付と両方の件数を載せる | 店主代表がノートの控えと照合し、記録を直して再出力する |
|
|
91
|
+
| 締めの確定後に販売記録の訂正・追加がある | 記録の注意に日付と「締め後の訂正あり」を載せる | 店主代表が新しい確認版を確定し、再出力する |
|
|
92
|
+
| 前週の報告がない・読めない | 記録の注意に理由を載せる | DEV が前週を再出力し、続けて本週を再出力する |
|
|
93
|
+
| 日次締め記録を読めない・自動作成が失敗した | 報告を作らず、締め記録を読めないときは一覧に「保留」と表示する | DEV が原因を解消し、再出力する |
|
|
94
|
+
| 日曜の締めの前に手動で出力した | 見出しに「締め前」と表示する | 仕入れ判断には締めの後に再出力した報告を使う |
|
|
104
95
|
|
|
105
96
|
## 9. メモ / 将来課題
|
|
106
97
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
| 上位の索引(課題) | 帳票仕様の索引 `bds-index` は未作成で、時刻の基準や閲覧範囲などの共通事項を本書に書いている | BA が 2 件目の帳票仕様を作るときに索引を作り、共通事項を索引へ移して本書は差分だけにする | - |
|
|
115
|
-
| 本書の変更(変更要求) | 表示項目・算出ルール・契機を変えると、定期処理、過去の週の再出力、再出力した週より後の週の前週比、仕入れノートに綴じた報告との比較に影響する | BA が差分を整理し、DEV が定期処理と再出力する週の範囲を、QE が再検証の範囲を示す。PO が承認してから定期処理へ反映し、反映後に直近の週を再出力する。過去の週を再出力するときは「出力の時期と契機」に従い、販売数が変わった週の次の週を順に再出力し、作り直す前と変わらなかった週か作成済みの最新の週まで続ける。QE は再出力した各週の前週比が、前週の報告の販売数との差と一致することを確かめる | 変更ごとに登録する |
|
|
116
|
-
|
|
117
|
-
確定と公開: 本書は店内で使う報告の仕様で、店外へ公開しない。本例の値と記録は架空で、実在の購入者やつけの情報を含まない。確定の前に BA と QE が上の確認を終え、利用リポジトリの文書検査(本リポジトリでは `npm run lint:md`・`npm run lint:fm`・`npm run validate:schema`)がエラーなく終わることを確かめる。エラーがあれば作成者が直して再実行する。人間の PO(店主代表)が未決事項の扱いを確かめ、`status` を `ready` にするかを判断する。
|
|
98
|
+
| 項目 | 未整備事項と影響 |
|
|
99
|
+
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
100
|
+
| 根拠の業務イベント | つけ販売の確定と欠品の記録(`bes-stock-out-recorded`)が未同梱で `based_on` に接続していない。境界を確かめるまで全面受入はせず、限定受入では欠品回数と補充候補を参考表示とし、仕入れ数量の根拠にしない |
|
|
101
|
+
| 補充候補の基準 | `_UNDECIDED_`: 1 回でも候補とするか 2 回以上に絞るか。初回の報告を見て決め、決まるまでは 1 回以上とする |
|
|
102
|
+
| 欠品削減の測定 | 欠品回数の月間 50% 削減の判定に要る月間の集計は含めない。月次報告の帳票仕様で本報告を元にする記録とする |
|
|
103
|
+
| 上位の索引 | `bds-index` が未作成で、時刻の基準や閲覧範囲などの共通事項を本書に書いている。索引を作ったら本書は差分だけにする |
|
|
104
|
+
| 本書の変更 | 表示項目・算出ルール・契機を変えると、定期処理、過去の週の再出力(「出力の時期と契機」)、前週比、綴じた報告との比較に影響する。反映後に直近の週を再出力し、前週比を照合する |
|
|
@@ -13,11 +13,9 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
駄菓子屋きぬやの店舗運営で、各プロセス領域を起動する業務上の出来事を一覧で定義する。対象は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の「プロセス領域」に挙げた仕入・販売・在庫・顧客・締めの 10 領域の起点イベントであり、領域 ID・領域名・起点イベントの文言は同書を正本とする。
|
|
15
15
|
|
|
16
|
-
[[specdojo:
|
|
16
|
+
販売・入荷・つけをいつ記録するかを揃え、購入の申し出と会計確定、納品と検品後の入荷記録を区別して記録漏れや二重計上を防ぐ。BPS・UI・テスト仕様は本一覧の行を出来事の単位とする。受けた後の手順は BPS、金額計算は [[specdojo:br-sample|販売金額計算の業務ルール]]、取引の状態は状態定義、事実データの値・構文・構造はデータモデル・schema に委ねる。
|
|
17
17
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
_ASSUMPTION_: 事実データは、上位文書の「データストア」に挙げた記録の主な内容から、発生時点で観測できる情報を概念名で挙げた。データモデルとの対応は未照合であり、保管先の未確定とは別の確認事項として「未決事項と承認条件」で管理する。値・構文・構造はデータモデル・schema を正本とする。
|
|
18
|
+
_ASSUMPTION_: 事実データは、上位文書の「データストア」の記録から発生時点で観測できる情報を概念名で挙げた。
|
|
21
19
|
|
|
22
20
|
## 1. 業務イベント一覧
|
|
23
21
|
|
|
@@ -25,15 +23,15 @@ _ASSUMPTION_: 事実データは、上位文書の「データストア」に挙
|
|
|
25
23
|
| イベントID | イベント名 | 起点領域 | 何が起きたか | いつ | 誰が/何が | 発生条件 | 事実データ |
|
|
26
24
|
| --- | --- | --- | --- | --- | --- | --- | --- |
|
|
27
25
|
| `bes-restock-requested` | 在庫から補充依頼を受けた | `P-01` | 補充判断で決まった補充対象と数量が、仕入計画へ渡された。 | 仕入計画が補充依頼を受けた時点。発注の時点ではない。 | 店主代表 | 補充対象の商品と数量が特定されている。 | 商品、補充数量、依頼時点 |
|
|
28
|
-
| `bes-goods-delivered` | 仕入先から商品が納品された | `P-02` | 発注した商品が店に届いた。 | 店番担当が納品を受け取った時点。検品の完了時点ではない。 | 仕入先が届け、店番担当が受け取る |
|
|
29
|
-
| `bes-cash-sale-confirmed` | 顧客が商品を購入した | `P-03` | 顧客が店頭で商品を現金で購入した。 |
|
|
30
|
-
| `bes-credit-sale-requested` | 常連客がつけでの購入を依頼した | `P-04` | 登録済みの常連客が、代金を後払いにする購入を申し出た。 |
|
|
26
|
+
| `bes-goods-delivered` | 仕入先から商品が納品された | `P-02` | 発注した商品が店に届いた。 | 店番担当が納品を受け取った時点。検品の完了時点ではない。 | 仕入先が届け、店番担当が受け取る | 対応する発注がある(発注のない納品は「未決事項」)。 | 仕入先、商品、納品数量、受取時点、受取担当 |
|
|
27
|
+
| `bes-cash-sale-confirmed` | 顧客が商品を購入した | `P-03` | 顧客が店頭で商品を現金で購入した。 | 販売管理システムが会計確定を記録した時点。控えの印字は待たない。 | 店番担当が現金受領を確認し、販売管理システムが確定を記録する | 現金取引で明細・請求金額を確認し、受領金額が請求金額以上で、未確定の会計である。つけは `bes-credit-sale-requested`。 | 取引番号、商品明細、請求金額、受領金額、釣銭金額、支払区分、会計確定時点、確定担当 |
|
|
28
|
+
| `bes-credit-sale-requested` | 常連客がつけでの購入を依頼した | `P-04` | 登録済みの常連客が、代金を後払いにする購入を申し出た。 | 上限内は店番担当が申し出を受けた時点(超過は「未決事項」)。 | 常連客 | 申し出た人が顧客台帳に登録されている。 | 顧客、商品、数量、請求金額、申出時点、受付担当 |
|
|
31
29
|
| `bes-stock-movement-recorded` | 販売または入荷が記録された | `P-05` | 在庫を増減させる販売または入荷の記録が成立した。 | 販売の確定、または検品後の入荷の記録が成立した時点。 | 販売・入荷の記録を受けた販売管理システム | 販売の確定、または検品済みの入荷のどちらかである。 | 商品、増減の区分(販売・入荷)、数量、記録時点、元の取引 |
|
|
32
30
|
| `bes-stock-below-threshold` | 在庫が補充基準を下回った | `P-06` | 商品の現在庫が、商品台帳の補充基準より少なくなった。 | 在庫の記録で基準を下回った時点。棚を目で見た時点ではない。 | 在庫の記録を保つ販売管理システム | 対象の商品に補充基準が定められている。 | 商品、現在庫、補充基準、下回った時点 |
|
|
33
31
|
| `bes-credit-use-requested` | 常連客がつけの利用を申し出た | `P-07` | まだ登録のない客が、つけを使いたいと申し出た。 | 店主代表が申し出を受けた時点。登録の完了時点ではない。 | 客 | 申し出た人が顧客台帳に登録されていない。 | 申出者の連絡先、希望するつけ上限、申出時点 |
|
|
34
32
|
| `bes-credit-payment-offered` | 常連客がつけの支払を申し出た | `P-08` | 常連客が、つけ残高の全部または一部を払うと申し出た。 | 店主代表が申し出を受けた時点。残高の更新時点ではない。 | 常連客 | 申し出た客につけ残高がある。 | 顧客、支払額、申出時点、受付担当 |
|
|
35
33
|
| `bes-store-closed` | 閉店した | `P-09` | その日の営業が終わった。 | 店主代表が閉店とした時点。閉店時刻を過ぎても営業中なら発生しない。 | 店主代表 | その日に営業している。 | 営業日、閉店時点 |
|
|
36
|
-
| `bes-month-end-closed` | 月末の締めが確定した | `P-10` | 対象月の締めが確定した。 | 店主代表が対象月の締めを確定した時点。暦上の月末到来だけでは発生しない。 | 店主代表 |
|
|
34
|
+
| `bes-month-end-closed` | 月末の締めが確定した | `P-10` | 対象月の締めが確定した。 | 店主代表が対象月の締めを確定した時点。暦上の月末到来だけでは発生しない。 | 店主代表 | 対象月が特定されている(日次締めとの関係は「未決事項」)。 | 対象月、締めの確定時点 |
|
|
37
35
|
|
|
38
36
|
## 2. 個別仕様への詳細化
|
|
39
37
|
|
|
@@ -42,36 +40,21 @@ _ASSUMPTION_: 事実データは、上位文書の「データストア」に挙
|
|
|
42
40
|
| `bes-cash-sale-confirmed` | [[specdojo:bes-sample\|業務イベント: 店頭の現金会計の確定]] | 行の全体 | 明細追加・金額確認・再表示・印字と確定の境界、一取引での発生回数と明細の対応を詳細化する |
|
|
43
41
|
| `bes-credit-sale-requested` | `bes-credit-sale-over-limit`(未作成) | つけ上限を超える申し出を受けた場合 | 上限超過時に、申し出の受付と店主代表の承認のどちらで成立するかが割れる |
|
|
44
42
|
|
|
45
|
-
- `specdojo:bes-sample` は完成例の文書 ID であり、対応するイベント ID は `bes-cash-sale-confirmed` である。同書からも本一覧と対応行を参照する。
|
|
46
|
-
- `bes-credit-sale-requested` のうち上限内の申し出は、一覧の定義のまま扱う。上限超過の経路は個別仕様で境界を確定するまで、BPS・UI・テスト仕様の確定入力にしない。
|
|
47
|
-
- 未作成の個別仕様は文書 ID だけを仮置きし、作成時に BA が一覧の行と個別仕様の双方向の参照を設定する。
|
|
48
|
-
|
|
49
43
|
## 3. 未決事項と承認条件
|
|
50
44
|
|
|
51
|
-
### 3.1.
|
|
45
|
+
### 3.1. 未決事項
|
|
52
46
|
|
|
53
47
|
<!-- prettier-ignore -->
|
|
54
|
-
| 論点 |
|
|
55
|
-
| --- | --- |
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
- 上位 CDFD の 10 領域に有効な 10 行が対応し、出典のない行がない。必須 8 列に空欄がなく、廃止行を含めイベント ID の形式違反・重複が 0 件である。
|
|
69
|
-
- QE が、現金受領不足・明細確認中は現金会計の確定なし、確定後の再表示・再印字では追加の確定なしと判定できる。納品受取と検品後の入荷記録、閉店宣言と閉店時刻到来も区別できる。個別の判定例は個別 BES を参照する。
|
|
70
|
-
- 個別 BES の対応範囲と相互参照が一致し、上表の論点が解消または制限事項として承認され、PO(店主代表)が一覧の範囲を承認している。
|
|
71
|
-
- [[specdojo:bes-index-rulebook|業務イベント一覧 作成ルール]] の「検証と引き渡し」に従った静的検査で Markdown・Frontmatter のエラーが 0 件で、未解決指摘の扱いを QE が確認している。メタ情報の制約は同書の参照先を正本とし、sample の文書 ID とイベント ID を混同しない。
|
|
72
|
-
|
|
73
|
-
本例は業務判断を残した完成記述例であり、実案件の承認済み仕様ではない。現時点では上の条件を満たしていないため `status: draft` を維持し、人間の PO が承認するまで BPS・BR・UI・テスト仕様への確定入力にしない。
|
|
74
|
-
|
|
75
|
-
### 3.3. 改訂時の引き継ぎ
|
|
76
|
-
|
|
77
|
-
つけ上限超過の境界が決まった際は、BA が `bes-credit-sale-requested` の行と `bes-credit-sale-over-limit`、つけ販売の BPS・BR を照合し、UX が申出受付と承認の画面、QE が上限内・超過時の期待結果を更新する。ARC・開発担当は申出時点と承認時点で得られる情報をデータモデル・イベント契約と照合する。PM は未完の追従と引き渡し時期を PJR で管理し、PO が制限の解除を判断する。
|
|
48
|
+
| 論点 | 影響と当面の扱い |
|
|
49
|
+
| --- | --- |
|
|
50
|
+
| _UNDECIDED_: 発注のない納品を `bes-goods-delivered` に含めるか | 現定義では発生しない。決まるまで発注外納品の BPS・UI・テストを確定しない。決まったら `bes-goods-delivered` の発生条件を直すか、上位 CDFD と照合して行を足す |
|
|
51
|
+
| _UNDECIDED_: つけ上限超過は受付と店主代表の承認のどちらで成立するか | 上限内は一覧の定義で扱う。超過の経路は個別仕様(「個別仕様への詳細化」)で決まるまで確定入力にしない。決まったら `bes-credit-sale-requested` の行と、つけ販売の BPS・BR・UI・テストの期待結果を直す |
|
|
52
|
+
| _ASSUMPTION_: 閉店は店主代表の宣言時点とした。月末の締めと最終営業日の日次締めの関係は未確認 | 日次・月次の起動時点が変わり得る。営業延長日と月末休業日の例で決まったら、上位 CDFD と `bes-store-closed`・`bes-month-end-closed` の行を直す |
|
|
53
|
+
| _ASSUMPTION_: 事実データが販売記録・在庫記録・つけ台帳のデータモデルと未照合 | 照合まで事実データ列を確定入力にしない。発生時点で情報がそろわない、または発生後の結果を含む行は直す |
|
|
54
|
+
| 一覧の範囲は 10 領域の起点イベントだけとした | 値引き・取消・返品は領域内部の出来事として含めない(業務の対象外ではない)。起点を足すなら先に上位 CDFD を見直す |
|
|
55
|
+
|
|
56
|
+
### 3.2. 確定入力として扱う条件
|
|
57
|
+
|
|
58
|
+
- 上位 CDFD の 10 領域に有効な 10 行が対応し、出典のない行・空欄、イベント ID の形式違反・重複(廃止行を含む)が 0 件である。
|
|
59
|
+
- 現金受領不足・明細確認中は現金会計の確定なし、確定後の再表示・再印字では追加の確定なしと判定できる。納品受取と検品後の入荷記録、閉店宣言と閉店時刻到来も区別できる。個別の判定例は個別 BES に委ねる。
|
|
60
|
+
- 「個別仕様への詳細化」の対応範囲と個別 BES からの参照が一致する。「未決事項」の範囲は解消まで除く。
|
|
@@ -10,88 +10,78 @@ specdojo:
|
|
|
10
10
|
|
|
11
11
|
# 業務イベント: 店頭の現金会計の確定
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
駄菓子屋きぬやで、入力途中の取引や金額の確認を販売実績と混同しないため、一取引の現金会計が確定した事実を定義する。利用できる基準は、「発生条件」の場面から発生有無と回数を決められ、「事実データ」から同じ取引の明細と金額を対応付けられることである。
|
|
14
14
|
|
|
15
|
-
_ASSUMPTION_:
|
|
15
|
+
_ASSUMPTION_: 単一店舗・一台のタブレットでの店頭現金販売を扱う。つけ販売、返品、取消、日次締めは別の出来事とする。
|
|
16
16
|
|
|
17
|
-
本書は [[specdojo:bes-index-sample|業務イベント一覧]] の `bes-cash-sale-confirmed`(「顧客が商品を購入した」、起点領域 `P-03
|
|
17
|
+
本書は [[specdojo:bes-index-sample|業務イベント一覧]] の `bes-cash-sale-confirmed`(「顧客が商品を購入した」、起点領域 `P-03`)の購入の成立を、現金会計の確定として詳細化する。
|
|
18
18
|
|
|
19
19
|
## 1. 何が起きたか
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
一つの取引について、店番担当が購入明細・請求金額・現金の受領を確認し、会計を確定した。
|
|
22
22
|
|
|
23
|
-
-
|
|
23
|
+
- 一取引の確定につき一回発生する。明細ごとには発生しない。
|
|
24
24
|
- 商品の追加、数量の修正、合計金額の表示だけでは発生しない。
|
|
25
|
-
-
|
|
26
|
-
|
|
27
|
-
定義を利用できると判断する基準は、「発生条件」の各場面から発生有無と回数を決められ、「事実データ」から同じ取引の明細と金額を対応付けられることである。実案件では、業務定義と公開可否の承認を人間の PO である店主代表が担い、開発担当が条件・データの対応を説明する。BA はイベント処理とテスト設計への引き渡し前に一覧の行との整合と、後述するデータモデル・BPS の仮置き参照を照合する。未解決の参照を残して引き渡す場合は制限事項として PO が承認し、対象案件のレビュー結果に記録する。
|
|
25
|
+
- 控えの印字や在庫への反映は、この出来事の後の業務である。
|
|
28
26
|
|
|
29
27
|
## 2. いつ
|
|
30
28
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
- 顧客が現金を渡した時刻と、会計確定を記録した時刻を区別する。受領だけでは確定の成立を示さない。
|
|
34
|
-
- 発生時刻は個別取引の確定記録を基準にし、画面を参照した時刻や控えを再印字した時刻へ置き換えない。
|
|
35
|
-
|
|
36
|
-
発生時点は営業日による集計時点とは分ける。日次締めの確定時刻を、個別取引の会計確定時刻として用いない。
|
|
29
|
+
販売管理システムが対象取引の会計確定を記録した時点を発生時点とする。顧客が現金を渡した時刻、画面の参照や控えの再印字の時刻、日次締めの確定時刻では置き換えない。
|
|
37
30
|
|
|
38
31
|
## 3. 誰が/何が
|
|
39
32
|
|
|
40
|
-
| 起点区分 | 確定を要求する主体 | 確定を記録する主体 | 主体ごとの責務
|
|
41
|
-
| -------------- | ------------------ | ------------------ |
|
|
42
|
-
| 店主による店番 | 店主代表 | 販売管理システム |
|
|
43
|
-
| 家族による店番 | 家族利用者代表 | 販売管理システム |
|
|
33
|
+
| 起点区分 | 確定を要求する主体 | 確定を記録する主体 | 主体ごとの責務 |
|
|
34
|
+
| -------------- | ------------------ | ------------------ | -------------------------------------------------------- |
|
|
35
|
+
| 店主による店番 | 店主代表 | 販売管理システム | 明細・請求金額・現金の受領・釣銭を確認して確定を要求する |
|
|
36
|
+
| 家族による店番 | 家族利用者代表 | 販売管理システム | 店主代表と同じ確認を行い、確定を要求する |
|
|
44
37
|
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
- 顧客は商品を購入して現金を渡す主体であり、システムへ会計確定を要求する主体ではない。
|
|
38
|
+
- 二つの役割を本書では「店番担当」と呼ぶ。誰が店番しても発生境界は同じである。
|
|
39
|
+
- 顧客は現金を渡す主体であり、システムへ会計確定を要求する主体ではない。
|
|
48
40
|
|
|
49
41
|
## 4. 発生条件
|
|
50
42
|
|
|
51
43
|
次の条件がすべて成立したときに発生する。
|
|
52
44
|
|
|
53
|
-
1.
|
|
45
|
+
1. 店頭の現金取引で、会計がまだ確定していない(取引状態 `payment_status` が `unconfirmed`。仮置き ID `cdsd-order-status`)。
|
|
54
46
|
2. 一件以上の商品明細があり、店番担当が購入内容と請求金額を確認している。
|
|
55
47
|
3. 受領金額が請求金額以上で、店番担当が受領と釣銭を確認している。
|
|
56
|
-
4.
|
|
48
|
+
4. 店番担当の確定要求により、会計確定が記録された。
|
|
57
49
|
|
|
58
|
-
|
|
50
|
+
金額計算と端数処理は [[specdojo:br-sample|販売金額計算の業務ルールサンプル]]、確定後の控え・在庫反映と事実の照合・復旧は販売プロセス(仮置き ID `bps-sales-order-flow`)へ委ねる。
|
|
59
51
|
|
|
60
|
-
| 場面
|
|
61
|
-
|
|
|
62
|
-
| 複数の商品明細を一つの取引として確定
|
|
63
|
-
|
|
|
64
|
-
|
|
|
65
|
-
|
|
|
66
|
-
| 確定済み取引の控えを再印字
|
|
67
|
-
| 確定後に控えの印字が失敗
|
|
68
|
-
| つけでの購入を受け付ける
|
|
52
|
+
| 場面 | 発生有無・回数 | 判断根拠 |
|
|
53
|
+
| ---------------------------------------- | ---------------------- | -------------------------------- |
|
|
54
|
+
| 複数の商品明細を一つの取引として確定 | 一回 | 単位は取引の確定である |
|
|
55
|
+
| 受領金額が請求金額未満 | 発生しない | 条件 3 を満たさない |
|
|
56
|
+
| 現金の受領後、確定前に入力を見直し中 | 発生しない | 確定の記録がない |
|
|
57
|
+
| 確定の記録が成立したか分からないまま停止 | 発生しない | 受領だけから発生済みと推定しない |
|
|
58
|
+
| 確定済み取引の控えを再印字 | 新たには発生しない | 同じ取引の参照である |
|
|
59
|
+
| 確定後に控えの印字が失敗 | 確定時の一回のまま | 印字は確定後の処理である |
|
|
60
|
+
| つけでの購入を受け付ける | 本イベントは発生しない | 現金取引の範囲外である |
|
|
69
61
|
|
|
70
|
-
|
|
62
|
+
_UNDECIDED_: 仮置き ID の文書は未作成で、状態値と項目名を正本と照合できていない。当面は本書の条件と場面の表で判定し、正本が定まったら条件 1 と「事実データ」の項目を見直す。
|
|
71
63
|
|
|
72
64
|
## 5. 事実データ
|
|
73
65
|
|
|
74
|
-
|
|
66
|
+
型・形式・構造は販売記録のデータモデル(仮置き ID `bdd-sales-record`)へ委ねる。
|
|
75
67
|
|
|
76
|
-
| 項目 | 業務上の意味
|
|
77
|
-
| ------------ |
|
|
78
|
-
| 取引番号 | 確定した一つの販売取引を識別する
|
|
79
|
-
| 会計確定時点 |
|
|
80
|
-
| 確定担当 |
|
|
81
|
-
| 商品明細 |
|
|
82
|
-
| 請求金額 |
|
|
83
|
-
| 受領金額 | 店番担当が受領を確認した現金の額
|
|
84
|
-
| 釣銭金額 | 当該会計で確認した釣銭の額
|
|
85
|
-
| 支払区分 |
|
|
68
|
+
| 項目 | 業務上の意味 | 必要になる条件 |
|
|
69
|
+
| ------------ | ------------------------------------------ | ---------------------------- |
|
|
70
|
+
| 取引番号 | 確定した一つの販売取引を識別する | 常に必要 |
|
|
71
|
+
| 会計確定時点 | 「いつ」で定義した成立時点 | 常に必要 |
|
|
72
|
+
| 確定担当 | 確定を要求した実際の店番担当 | 常に必要 |
|
|
73
|
+
| 商品明細 | 商品・数量と、会計確定時点の販売金額の内訳 | 常に必要 |
|
|
74
|
+
| 請求金額 | 顧客に請求した金額 | 常に必要 |
|
|
75
|
+
| 受領金額 | 店番担当が受領を確認した現金の額 | 常に必要 |
|
|
76
|
+
| 釣銭金額 | 当該会計で確認した釣銭の額 | 常に必要。釣銭なしも識別する |
|
|
77
|
+
| 支払区分 | 現金会計であることを示す情報 | 常に必要 |
|
|
86
78
|
|
|
87
79
|
### 5.1. 取引との対応の確認例
|
|
88
80
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
| 確認対象 | 確認する事実 |
|
|
92
|
-
| ---------------------------------- | -------------------------------------------------------------------------- |
|
|
93
|
-
| 取引 `TX-A` に二つの商品明細がある | 一回の確定に両明細が含まれ、どちらも `TX-A` の請求金額の根拠としてたどれる |
|
|
94
|
-
| 続けて別の取引 `TX-B` を確定する | 二つの取引の明細・受領金額が混ざらず、確定はそれぞれ一回となる |
|
|
95
|
-
| `TX-A` の控えを再印字する | 同じ取引番号を参照し、新しい会計確定として数えない |
|
|
81
|
+
取引番号で会計確定と明細・金額を対応付ける。一括・並列の要求は扱わないため、要求を束ねる識別子は持たない。
|
|
96
82
|
|
|
97
|
-
|
|
83
|
+
| 確認対象 | 確認する事実 |
|
|
84
|
+
| ---------------------------------- | ---------------------------------------------------------------- |
|
|
85
|
+
| 取引 `TX-A` に二つの商品明細がある | 一回の確定に両明細が含まれ、どちらも `TX-A` の請求金額へたどれる |
|
|
86
|
+
| 続けて別の取引 `TX-B` を確定する | 明細・受領金額・釣銭金額が混ざらず、確定はそれぞれ一回となる |
|
|
87
|
+
| `TX-A` の控えを再印字する | 同じ取引番号を参照し、新しい会計確定として数えない |
|