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
|
@@ -8,84 +8,72 @@ specdojo:
|
|
|
8
8
|
|
|
9
9
|
# 補充依頼確定
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
在庫の補充基準割れを受け、店主代表が補充対象と依頼数量を決め、確定した補充依頼を仕入グループへ渡す。
|
|
12
12
|
|
|
13
13
|
## 1. 概要
|
|
14
14
|
|
|
15
|
-
- 業務目的:
|
|
15
|
+
- 業務目的: 単一店舗で人気商品の欠品を減らす。
|
|
16
16
|
- プロセス領域: 在庫グループの補充判断(`P-06`)
|
|
17
|
-
- 対象者:
|
|
17
|
+
- 対象者: 店主代表(判断)、開発担当と同行レビュー担当(後続設計・レビュー)
|
|
18
18
|
- 主担当: 店主代表
|
|
19
|
-
- 開始点:
|
|
20
|
-
- 終了点:
|
|
21
|
-
- 対象外:
|
|
22
|
-
|
|
23
|
-
本書は単一店舗の日常的な補充判断を扱う。発注から入荷、売場補充までのグループ横断順序は `cdfd-uc-replenishment`、仕入グループ内の処理は `cdfd-purchasing` を正本とする。
|
|
19
|
+
- 開始点: `T-01` の受領時点
|
|
20
|
+
- 終了点: 「出力」のいずれかが確定した時点
|
|
21
|
+
- 対象外: 仕入先の決定、発注の承認・送付、入荷検品、売場補充。グループ横断の順序は `cdfd-uc-replenishment`、仕入グループ内は `cdfd-purchasing` が正本
|
|
24
22
|
|
|
25
23
|
## 2. トリガー
|
|
26
24
|
|
|
27
|
-
| トリガー ID | 出来事 | 発生元 | 受領情報 | 開始条件
|
|
28
|
-
| ----------- | -------------------------- | ---------------- | -------------------------------- |
|
|
29
|
-
| `T-01` | 現在庫が補充基準を下回った | 在庫確認プロセス | 商品、現在庫、補充基準、確認時刻 |
|
|
30
|
-
|
|
31
|
-
トリガーは在庫確認プロセスの判定結果であり、在庫記録の物理的な更新方式には依存しない。
|
|
25
|
+
| トリガー ID | 出来事 | 発生元 | 受領情報 | 開始条件 | 不成立時の扱い |
|
|
26
|
+
| ----------- | -------------------------- | ---------------- | -------------------------------- | -------------------------- | -------------- |
|
|
27
|
+
| `T-01` | 現在庫が補充基準を下回った | 在庫確認プロセス | 商品、現在庫、補充基準、確認時刻 | 対象商品と現在庫を受領済み | 起動しない |
|
|
32
28
|
|
|
33
29
|
## 3. 前提条件
|
|
34
30
|
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
- 補充基準: 補充が必要か判定するための閾値。現在庫がこれを下回ると補充要となる。
|
|
38
|
-
- 補充必要数: `br-reorder-point` が判定する、補充に必要な数量。算出方法は `br-reorder-point` を正本とする。
|
|
39
|
-
- 依頼数量: 補充必要数を発注単位に合わせて調整し、仕入グループへ依頼する最終的な数量。
|
|
40
|
-
- 発注単位: 仕入先が指定する、発注可能な最小の数量単位。
|
|
31
|
+
- 店主代表が補充要否と依頼数量を判断できる(家族利用者代表の検出時も確定は店主代表)。判断できない間は起動せず、トリガーを保留する。
|
|
32
|
+
- 依頼数量は、`br-reorder-point` が判定する補充必要数を発注単位(仕入先が定める最小の発注数量)に合わせた数量とする。
|
|
41
33
|
|
|
42
34
|
## 4. 入力
|
|
43
35
|
|
|
44
|
-
| 入力 | 入手元 | 利用目的
|
|
45
|
-
| ------------ | ------------------ |
|
|
46
|
-
| 対象商品 | 商品台帳 |
|
|
47
|
-
| 現在庫 | 在庫記録 |
|
|
48
|
-
| 未完了依頼 | 補充依頼 |
|
|
49
|
-
| 補充判断基準 | `br-reorder-point` |
|
|
50
|
-
|
|
51
|
-
商品台帳、在庫記録、補充依頼は論理的な正本名であり、保存先や物理項目は本書では定めない。
|
|
36
|
+
| 入力 | 入手元 | 利用目的 | 必須 | 正本 |
|
|
37
|
+
| ------------ | ------------------ | -------------------------------------- | ---- | ------------------ |
|
|
38
|
+
| 対象商品 | 商品台帳 | 販売状態、継続取扱、補充基準、発注単位 | ○ | 商品台帳 |
|
|
39
|
+
| 現在庫 | 在庫記録 | 補充基準との差と補充必要数 | ○ | 在庫記録 |
|
|
40
|
+
| 未完了依頼 | 補充依頼 | 同じ商品への重複依頼の防止 | ○ | 補充依頼 |
|
|
41
|
+
| 補充判断基準 | `br-reorder-point` | 要否と補充必要数の判定規則 | ○ | `br-reorder-point` |
|
|
52
42
|
|
|
53
43
|
## 5. 処理
|
|
54
44
|
|
|
55
|
-
| ステップ ID | CDFD プロセス | 担当 | 入力
|
|
56
|
-
| ----------- | ------------- | -------- |
|
|
57
|
-
| `S-01` | `P-06` | 店主代表 | 対象商品、現在庫
|
|
58
|
-
| `S-02` | `P-06` | 店主代表 |
|
|
59
|
-
| `S-03` | `P-06` | 店主代表 | 補充要の判定結果
|
|
60
|
-
| `S-04` | `P-06` | 店主代表 | 確定した補充依頼
|
|
45
|
+
| ステップ ID | CDFD プロセス | 担当 | 入力 | 活動・判断 | 出力・完了条件 | 例外 |
|
|
46
|
+
| ----------- | ------------- | -------- | ---------------------------- | ------------------------------------------------------------------- | -------------------------------------------- | -------------- |
|
|
47
|
+
| `S-01` | `P-06` | 店主代表 | 対象商品、現在庫 | 販売状態と継続取扱から補充判断の対象かを決める | 対象または補充不要が理由付きで確定 | `E-01` |
|
|
48
|
+
| `S-02` | `P-06` | 店主代表 | 対象商品、現在庫、未完了依頼 | `br-reorder-point` で判定時点の要否と依頼数量を決め、重複を確認する | 補充要否、依頼数量、重複有無が確定 | `E-02`、`E-04` |
|
|
49
|
+
| `S-03` | `P-06` | 店主代表 | 補充要の判定結果 | 判断根拠を添えて補充依頼を承認する | 商品、数量、根拠、承認者、承認時刻付きで確定 | `E-03` |
|
|
50
|
+
| `S-04` | `P-06` | 店主代表 | 確定した補充依頼 | 仕入グループへ引き渡す | 仕入グループが参照できる | `E-05` |
|
|
61
51
|
|
|
62
|
-
|
|
52
|
+
補充不要と判断した場合は `S-03` と `S-04` を行わず、補充不要記録を確定して終了する。
|
|
63
53
|
|
|
64
54
|
## 6. 出力
|
|
65
55
|
|
|
66
|
-
| 出力 | 受け手 | 確定条件
|
|
67
|
-
| ------------ | ------------ |
|
|
68
|
-
| 補充依頼 | 仕入グループ |
|
|
69
|
-
| 補充不要記録 | 店主代表 |
|
|
70
|
-
|
|
71
|
-
補充依頼は `cdfd-uc-replenishment` の引き渡し `H-01` で仕入グループへ渡す情報に対応する。
|
|
56
|
+
| 出力 | 受け手 | 確定条件 | 正本 | 後続処理 |
|
|
57
|
+
| ------------ | ------------ | ------------------------------------------ | -------- | ---------------------------------- |
|
|
58
|
+
| 補充依頼 | 仕入グループ | `S-03` の完了条件を満たす | 補充依頼 | `H-01` で `P-01-01` 発注内容確定へ |
|
|
59
|
+
| 補充不要記録 | 店主代表 | 対象商品、理由、確認時刻があり、依頼がない | 在庫記録 | 次回の販売・入荷後に再判定 |
|
|
60
|
+
| 重複不要記録 | 店主代表 | 対象商品、既存依頼、理由、確認時刻がある | 補充依頼 | 既存依頼の処理を続ける |
|
|
72
61
|
|
|
73
62
|
## 7. 例外・代替経路
|
|
74
63
|
|
|
75
|
-
| 例外 ID | 対象ステップ
|
|
76
|
-
| ------- |
|
|
77
|
-
| `E-01` | `S-01`
|
|
78
|
-
| `E-02` | `S-02`
|
|
79
|
-
| `E-03` | `S-03
|
|
80
|
-
| `E-04` | `S-02`
|
|
64
|
+
| 例外 ID | 対象ステップ | 検出条件 | 停止範囲 | 担当 | 処置 | 再開条件・代替成果 |
|
|
65
|
+
| ------- | ------------ | -------------------------- | -------------- | -------- | ---------------------------------------------- | -------------------------------- |
|
|
66
|
+
| `E-01` | `S-01` | 「入力」の必須項目が不明 | `S-01` 以降 | 店主代表 | 不足項目、対象商品、確認依頼先を保留記録に残す | 補完後に `S-01` から再開 |
|
|
67
|
+
| `E-02` | `S-02` | 同じ商品に未完了依頼がある | 新規依頼の確定 | 店主代表 | 既存依頼へ数量を反映するか決める | 再承認、または重複不要記録で終了 |
|
|
68
|
+
| `E-03` | `S-03` | 判断根拠を記録できない | 確定以降 | 店主代表 | 補充依頼を確定せず、状況を保留記録に残す | 根拠の確認後に `S-03` から再開 |
|
|
69
|
+
| `E-04` | `S-02` | 未完了依頼を取得できない | `S-02` 以降 | 店主代表 | 中断し、取得失敗を保留記録に残す | 取得後に `S-02` から再開 |
|
|
70
|
+
| `E-05` | `S-04` | 仕入グループへ引き渡せない | 引き渡し | 店主代表 | 確定済み・未受領のまま状況を保留記録に残す | 可能になり次第 `S-04` から再開 |
|
|
81
71
|
|
|
82
72
|
## 8. 検証・受入観点
|
|
83
73
|
|
|
84
|
-
| 観点 | 入力条件
|
|
85
|
-
| -------------- |
|
|
86
|
-
| 補充が必要 |
|
|
87
|
-
| 補充が不要 |
|
|
88
|
-
| 既存依頼と重複 |
|
|
89
|
-
|
|
|
90
|
-
| 判断情報が不足 | 商品、現在庫、補充基準、発注単位のいずれかが不明 | 補充依頼を確定せず、不足項目、確認担当、再開対象の商品が記録される | 保留記録 |
|
|
91
|
-
| 確定・引渡失敗 | 判断根拠が記録できない、または引き渡しできない状態である | 補充依頼を非確定・未受領状態のまま保留し、保留記録から状況を確認できる。再開後に承認・受領された補充依頼を確認できる | 保留記録、補充依頼 |
|
|
74
|
+
| 観点 | 入力条件 | 期待する業務成果 | 確認可能な記録 |
|
|
75
|
+
| -------------- | -------------------------------------- | -------------------------------------------- | ---------------------- |
|
|
76
|
+
| 補充が必要 | 販売中、基準割れ、未完了依頼なし | 承認済みの補充依頼が一件、仕入グループに渡る | 補充依頼 |
|
|
77
|
+
| 補充が不要 | 販売停止・終売、または判定時に基準以上 | 補充依頼がなく、補充不要理由が残る | 補充不要記録 |
|
|
78
|
+
| 既存依頼と重複 | `E-02` の検出条件 | 新規依頼なし。再承認か重複不要記録がある | 補充依頼、重複不要記録 |
|
|
79
|
+
| 保留と再開 | `E-01`、`E-03`〜`E-05` の検出条件 | 処置の記録が残り、再開後に補充依頼へ至る | 保留記録、補充依頼 |
|
|
@@ -8,24 +8,21 @@ specdojo:
|
|
|
8
8
|
|
|
9
9
|
# 駄菓子屋きぬや 在庫不足判定
|
|
10
10
|
|
|
11
|
-
在庫確認の対象商品について、予約分を差し引いた販売可能数が発注点を下回るかを判定する。
|
|
12
|
-
|
|
13
11
|
## 1. 概要
|
|
14
12
|
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
- 対象外: 発注点の決め方、発注量、仕入れ先、発注承認、在庫の更新、販売の可否。判定結果から自動的に発注を確定しない。
|
|
13
|
+
- 判断: 在庫確認の対象商品について、予約分を差し引いた販売可能数が発注点を下回るかを判定する。店主代表以外が店番しても、同じ在庫から同じ判定を得て人気商品の欠品に気付けるようにする。
|
|
14
|
+
- 利用者・場面: 店主代表または家族利用者代表が在庫を確認するとき、商品ごとの在庫数・予約数・発注点がそろった時点で使う。
|
|
15
|
+
- 前提: 単一店舗の商品 1 種類について、同じ確認時点の個数を比べる。値は学習用である。
|
|
16
|
+
- 対象外: 発注点の決め方、発注量、仕入れ先、発注承認、在庫の更新、販売の可否。
|
|
20
17
|
|
|
21
18
|
## 2. 入力
|
|
22
19
|
|
|
23
|
-
| 入力 | 概念データ・項目 | 利用目的
|
|
24
|
-
| -------- | ---------------- |
|
|
25
|
-
| 対象商品 | 商品識別 |
|
|
26
|
-
| 在庫 | 在庫数(個) |
|
|
27
|
-
| 予約 | 予約数(個) |
|
|
28
|
-
| 商品 | 発注点(個) | 不足とみなす境界
|
|
20
|
+
| 入力 | 概念データ・項目 | 利用目的 | 適用条件・欠損時の扱い |
|
|
21
|
+
| -------- | ---------------- | -------------------------------- | ------------------------------------------ |
|
|
22
|
+
| 対象商品 | 商品識別 | 入力と結果を同じ商品へ対応付ける | 必須 |
|
|
23
|
+
| 在庫 | 在庫数(個) | 販売可能数の起点 | 必須。予約分を含む総数 |
|
|
24
|
+
| 予約 | 予約数(個) | 予約済みの個数を除く | 必須。予約なしは 0 を明示する |
|
|
25
|
+
| 商品 | 発注点(個) | 不足とみなす境界 | 必須。0 も有効な値で、未設定の代用にしない |
|
|
29
26
|
|
|
30
27
|
## 3. ルール(判定/計算)
|
|
31
28
|
|
|
@@ -33,62 +30,53 @@ specdojo:
|
|
|
33
30
|
|
|
34
31
|
#### 3.1.1. R-01 入力の確認
|
|
35
32
|
|
|
36
|
-
|
|
33
|
+
「例外 / 異常系」の順で入力を確認し、不備があれば以後の計算を行わない。
|
|
37
34
|
|
|
38
35
|
#### 3.1.2. R-02 販売可能数の算出
|
|
39
36
|
|
|
40
|
-
販売可能数を「在庫数 −
|
|
41
|
-
|
|
42
|
-
予約数が在庫数を超える場合は、予約を満たす在庫も足りていないため、負の販売可能数をそのまま不足判定に使う。0 に丸めず、入力不備とも扱わない。予約の調整自体は本ルールの対象外である。
|
|
37
|
+
販売可能数を「在庫数 − 予約数」で算出する。予約数が在庫数を超えても負の値を 0 に丸めず、入力不備とも扱わずに判定へ使う。予約の調整は対象外である。
|
|
43
38
|
|
|
44
39
|
#### 3.1.3. R-03 不足判定
|
|
45
40
|
|
|
46
|
-
|
|
47
|
-
- 販売可能数が発注点と等しい、または大きい場合は「不足なし」とする。
|
|
41
|
+
販売可能数が発注点より小さければ「不足」、等しいか大きければ「不足なし」とする。
|
|
48
42
|
|
|
49
43
|
### 3.2. 判定例
|
|
50
44
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
| 例 | 入力・前提(在庫数 / 予約数 / 発注点、単位: 個) | 適用規則 | 期待結果
|
|
54
|
-
| --- | ------------------------------------------------ | -------------- |
|
|
55
|
-
| 1 | 12 / 3 / 10 | `R-02`、`R-03` | 販売可能数 9、不足
|
|
56
|
-
| 2 | 13 / 3 / 10 | `R-02`、`R-03` | 販売可能数 10、不足なし(境界一致)
|
|
57
|
-
| 3 |
|
|
58
|
-
| 4 |
|
|
59
|
-
| 5 |
|
|
60
|
-
| 6 |
|
|
61
|
-
| 7 |
|
|
62
|
-
| 8 |
|
|
63
|
-
| 9 |
|
|
64
|
-
| 10 | −1 / 未設定 / 10 | `R-01` | `E-01` が先。修正後の再判定で `E-03` を確認する |
|
|
65
|
-
| 11 | 商品識別が未設定、8 / 0 / 10 | `R-01` | `E-01`。商品へ結果を関連付けられない |
|
|
45
|
+
商品識別は `ITEM-A` とする。`E-` の行は判定値を返さない。
|
|
46
|
+
|
|
47
|
+
| 例 | 入力・前提(在庫数 / 予約数 / 発注点、単位: 個) | 適用規則 | 期待結果 |
|
|
48
|
+
| --- | ------------------------------------------------ | -------------- | ------------------------------------------ |
|
|
49
|
+
| 1 | 12 / 3 / 10 | `R-02`、`R-03` | 販売可能数 9、不足 |
|
|
50
|
+
| 2 | 13 / 3 / 10 | `R-02`、`R-03` | 販売可能数 10、不足なし(境界一致) |
|
|
51
|
+
| 3 | 0 / 0 / 0 | `R-02`、`R-03` | 販売可能数 0、不足なし |
|
|
52
|
+
| 4 | 2 / 4 / 0 | `R-02`、`R-03` | 販売可能数 −2、不足(予約超過) |
|
|
53
|
+
| 5 | 8 / 未設定 / 10 | `R-01` | `E-01` |
|
|
54
|
+
| 6 | 8 / 0.5 / 10 | `R-01` | `E-02` |
|
|
55
|
+
| 7 | −1 / 0 / 10 | `R-01` | `E-03` |
|
|
56
|
+
| 8 | −1 / 未設定 / 10 | `R-01` | `E-01` が先。`E-03` は修正後の再判定で示す |
|
|
57
|
+
| 9 | 商品識別が未設定、8 / 0 / 10 | `R-01` | `E-01`。結果を商品へ関連付けられない |
|
|
66
58
|
|
|
67
59
|
## 4. 出力
|
|
68
60
|
|
|
69
|
-
| 出力 | 意味・単位または区分
|
|
70
|
-
| ---------- |
|
|
71
|
-
| 対象商品 |
|
|
72
|
-
| 販売可能数 | 予約分を除いた個数。負数もあり得る
|
|
73
|
-
| 不足判定 | 「不足 /
|
|
74
|
-
| 入力不備 | 例外 ID
|
|
61
|
+
| 出力 | 意味・単位または区分 | 利用先 |
|
|
62
|
+
| ---------- | --------------------------------------- | -------------------------- |
|
|
63
|
+
| 対象商品 | 入力の商品識別 | 在庫を確認した人による照合 |
|
|
64
|
+
| 販売可能数 | 予約分を除いた個数。負数もあり得る | 不足理由の確認 |
|
|
65
|
+
| 不足判定 | 「不足 / 不足なし」。発注の確定ではない | 店主代表による補充検討 |
|
|
66
|
+
| 入力不備 | 例外 ID と該当する項目名 | 入力した担当者による修正 |
|
|
75
67
|
|
|
76
|
-
|
|
68
|
+
入力不備のときは例外 ID と項目名だけを返し、判定不能を「不足なし」と扱わない。
|
|
77
69
|
|
|
78
70
|
## 5. 例外 / 異常系
|
|
79
71
|
|
|
80
|
-
| ID | 状況
|
|
81
|
-
| ------ |
|
|
82
|
-
| `E-01` | 必須項目のいずれかが未設定
|
|
83
|
-
| `E-02` |
|
|
84
|
-
| `E-03` |
|
|
72
|
+
| ID | 状況 | 扱い | 利用者の次の手 |
|
|
73
|
+
| ------ | -------------------------- | -------------------------------- | ------------------------------------ |
|
|
74
|
+
| `E-01` | 必須項目のいずれかが未設定 | 未設定の項目名を返す | 入力する。発注点は店主代表へ確認する |
|
|
75
|
+
| `E-02` | 個数のいずれかが整数でない | 項目名を返す。換算や丸めはしない | 個数で入力し直す |
|
|
76
|
+
| `E-03` | 個数のいずれかが負数 | 負数の項目名を返す | 記録を確かめて直す |
|
|
85
77
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
外部参照の取得処理は本ルールに含めない。呼出元が必要項目を取得できなければ、値を推測して本ルールを呼び出さない。
|
|
78
|
+
いずれも判定せず、在庫確認担当が直して再判定する。不備が複数の種類にわたる場合は `E-01` → `E-02` → `E-03` の順で最初の種類を返し、その種類の項目はすべて示す。呼出元が入力を取得できなければ、値を推測して本ルールを呼び出さない。
|
|
89
79
|
|
|
90
80
|
## 6. メモ / 将来課題
|
|
91
81
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
季節別の発注点の設定方法は将来の別ルールで扱う。本ルールは与えられた発注点との比較だけを担うため、その設定方法を先取りしない。
|
|
82
|
+
未決事項はない。季節別の発注点の設定方法は将来の別ルールで扱う。
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
---
|
|
2
|
+
applyTo: "{app,src,tests}/**/*.{ts,tsx}"
|
|
3
|
+
specdojo:
|
|
4
|
+
id: specdojo:cdr-sample
|
|
5
|
+
type: architecture
|
|
6
|
+
status: draft
|
|
7
|
+
rulebook: specdojo:cdr-rulebook
|
|
8
|
+
based_on:
|
|
9
|
+
- specdojo:tsd-index-sample
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# TypeScript 実装ルール
|
|
13
|
+
|
|
14
|
+
駄菓子屋きぬや販売管理システム(Next.js・TypeScript)の `app/`・`src/`・`tests/` 配下の TypeScript を実装・更新するときの規則です。言語・ライブラリ・版は技術スタック一覧に従い、本書では書き方と検証だけを定めます。
|
|
15
|
+
|
|
16
|
+
## 1. 基本方針
|
|
17
|
+
|
|
18
|
+
- `tsconfig.json` の `strict: true` を前提にし、型エラーを隠さずに直す。
|
|
19
|
+
- 既存の関数分割、命名、エラー処理の書き方に合わせる。新しい書き方を持ち込む場合は、同じ変更で既存箇所をそろえるか、理由を変更の説明に書く。
|
|
20
|
+
- 1 回の変更は依頼された範囲に絞る。無関係なファイルの整形や名前の変更を混ぜない。
|
|
21
|
+
- 金額(販売額・つけ残高)は円単位の整数で扱う。
|
|
22
|
+
|
|
23
|
+
## 2. モジュールと import
|
|
24
|
+
|
|
25
|
+
- ESM で書き、`require` を使わない。
|
|
26
|
+
- `src/` 内の import は `@/` の別名を使い、`../../` のような 2 階層以上の相対 import を書かない。
|
|
27
|
+
- `app/` から業務処理を呼ぶ場合は `src/` の公開関数を経由し、`src/` から `app/` を import しない。この向きは `eslint.config.mjs` の `no-restricted-imports` で検査する。
|
|
28
|
+
- サーバー専用の処理(Prisma による DB 接続、つけ残高の更新)は `src/server/` に置く。
|
|
29
|
+
- 型の import の書き方は `eslint.config.mjs` の `consistent-type-imports` に従う。
|
|
30
|
+
|
|
31
|
+
## 3. 型
|
|
32
|
+
|
|
33
|
+
- `any` を使わない。フォーム入力や API の要求本文など型が不明な値は `unknown` で受け、型ガード関数で検証してから使う。
|
|
34
|
+
- 文字列の取り得る値の集合は union 型で表す(例: 支払方法 `"cash" | "tsuke"`)。
|
|
35
|
+
- `null` と `undefined` を混在させない。値が無いことは `undefined` で表し、Prisma が返す `null` は `src/server/` の境界で変換する。
|
|
36
|
+
|
|
37
|
+
```typescript
|
|
38
|
+
type Payment = "cash" | "tsuke";
|
|
39
|
+
|
|
40
|
+
function isPayment(value: unknown): value is Payment {
|
|
41
|
+
return value === "cash" || value === "tsuke";
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## 4. エラー処理
|
|
46
|
+
|
|
47
|
+
- 利用者の入力の不備は、検証結果として呼び出し側へ返し、画面に項目ごとのメッセージを出す。例外にしない。
|
|
48
|
+
- 想定外の失敗(DB 接続の失敗など)は例外として投げ、API ルートの境界で Sentry へ送ってから汎用のエラー応答に変換する。
|
|
49
|
+
- エラーメッセージには、操作名と対象の ID(商品コード、顧客 ID)を含める。
|
|
50
|
+
- 空の `catch` で例外を握りつぶさない。再送出する場合は `cause` に元のエラーを渡す。
|
|
51
|
+
|
|
52
|
+
## 5. 命名
|
|
53
|
+
|
|
54
|
+
- 変数・関数は `camelCase`、型・コンポーネントは `PascalCase`、定数は `UPPER_SNAKE_CASE` を使う。
|
|
55
|
+
- 真偽値は `is`・`has`・`can` で始める(例: `isOutOfStock`)。
|
|
56
|
+
- 略語は `id`・`url` など定着したものだけを使い、`qty`・`amt` のような新しい略語を作らない。
|
|
57
|
+
- 業務の用語は既存コードで使っている英語名にそろえ、同じ用語に別の名前を付けない(例: つけは `tsuke` に統一し、`credit` と混ぜない)。
|
|
58
|
+
|
|
59
|
+
## 6. テストと検証
|
|
60
|
+
|
|
61
|
+
| コマンド | 対象 | 実行条件 | 失敗時 |
|
|
62
|
+
| -------------------------- | ------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------ |
|
|
63
|
+
| `npm run typecheck` | 型検査(`app`・`src`・`tests`) | TypeScript を変更したとき(毎回) | 型エラーの原因を直す |
|
|
64
|
+
| `npm run lint` | ESLint(import の向き・型の import) | TypeScript を変更したとき(毎回) | `npm run lint -- --fix` で直し、残りを手で直す |
|
|
65
|
+
| `npm run test:unit` | Vitest の単体テスト(売上・つけ残高) | `src/` を変更したとき | 実装を直す。仕様変更で期待値が変わる場合だけ、根拠を確かめて期待値を直す |
|
|
66
|
+
| `npm run test:integration` | DB を使う統合テスト | DB 接続やマイグレーションを変更したとき | agent では実行しない。CI の失敗を直せない場合は内容を報告する |
|
|
67
|
+
|
|
68
|
+
- 金額の計算やつけ残高の更新を変えた場合は、境界値(残高 0 円、上限額ちょうど)の単体テストを追加する。
|
|
69
|
+
|
|
70
|
+
## 7. 禁止事項
|
|
71
|
+
|
|
72
|
+
| 禁止事項 | 理由 |
|
|
73
|
+
| ---------------------------------------------------- | ------------------------------------------ |
|
|
74
|
+
| 金額を浮動小数点で計算する | 端数の誤差でつけ残高が合わなくなるため |
|
|
75
|
+
| クライアントコンポーネントから DB 接続を import する | 接続情報がブラウザへ送られる危険があるため |
|
|
76
|
+
| 検証していない入力を `as` で型に押し込む | 不正な数量や支払方法が記録されるため |
|
|
77
|
+
| ログに顧客の氏名や残高を出す | 常連客の個人情報が漏れるため |
|
|
78
|
+
| `// @ts-ignore` で型エラーを消す | 型エラーの原因を残したままにするため |
|
|
@@ -16,92 +16,76 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
店主代表と家族の店番担当が、販売の記録漏れと締めの差異を同じ根拠で確認できるよう、販売から日次・月次の確認に使う情報の管理境界を定める。販売明細と締めの判断を同じ欄で上書きすると、差異の発生元と誰が確認したかを追えなくなるため、取引の正本、再生成する集計、人が確定する記録を分ける。
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
### 1.1. 対象と隣接領域
|
|
22
|
-
|
|
23
|
-
範囲の根拠は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の販売・締め領域である。販売に必要な商品台帳と、締めの内訳確認に使う日次販売集計を含む。
|
|
24
|
-
|
|
25
|
-
| 区分 | 管理境界と理由 |
|
|
26
|
-
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------- |
|
|
27
|
-
| 本書で定義 | 商品台帳、販売記録、日次販売集計、日次締め記録、月次報告の5単位。取引の入力から締めの判断までを追う |
|
|
28
|
-
| 隣接領域から参照 | 顧客台帳・つけ台帳は購入者と未収金、仕入記録・在庫記録は締めの差異確認に利用する。各台帳の更新責務は顧客・仕入・在庫領域へ委ねる |
|
|
29
|
-
| 対象外 | 売場棚の現物管理、EC、複数店舗、本格会計、仕入先との通信。全体概要の領域分担に従い、販売・締めの記録と混在させない |
|
|
30
|
-
|
|
31
|
-
項目の意味は [[specdojo:bdd-sample|販売管理の業務データ辞書]]、識別と関連は [[specdojo:ccd-sample|概念クラス図]] を参照する。以下の数値は照合方法を示す例示データであり、実績や検証成功の記録ではない。
|
|
19
|
+
範囲は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の販売・締め領域の5単位とする。顧客台帳・つけ台帳・仕入記録・在庫記録は購入者・未収金・差異確認のために参照だけし、更新責務は各領域へ委ねる。売場棚の現物管理、EC、複数店舗、本格会計、仕入先との通信は対象外とする。
|
|
32
20
|
|
|
33
21
|
## 2. 概念データストア一覧
|
|
34
22
|
|
|
35
|
-
| データストア名 | 対応プロセス | 主な内容
|
|
36
|
-
| -------------- | ------------------------------ |
|
|
37
|
-
| 商品台帳 | 店頭販売、つけ販売、月次見直し | 商品の識別、表示名、標準販売価格、補充基準
|
|
38
|
-
| 販売記録 | 店頭販売、つけ販売、日次締め |
|
|
39
|
-
| 日次販売集計 | 日次締め | 対象日の販売件数、請求金額合計、支払方法別内訳、集計の基準時点
|
|
40
|
-
| 日次締め記録 | 日次締め、月次見直し |
|
|
41
|
-
| 月次報告 | 月次見直し |
|
|
23
|
+
| データストア名 | 対応プロセス | 主な内容 | 更新タイミング | 粒度 | 主な用途 |
|
|
24
|
+
| -------------- | ------------------------------ | -------------------------------------------------------------------- | -------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------ |
|
|
25
|
+
| 商品台帳 | 店頭販売、つけ販売、月次見直し | 商品の識別、表示名、標準販売価格、補充基準 | 随時(商品登録・承認済みの売価や補充基準の変更時) | 商品種類毎。現物一個毎ではない | 店番担当が販売対象と現在価格を確認し、店主代表が売価を見直す |
|
|
26
|
+
| 販売記録 | 店頭販売、つけ販売、日次締め | 確定した売上記録と売上明細、支払方法、購入者の参照 | イベント(会計確定時・承認済み訂正時) | 売上ID毎。明細は売上IDと明細番号の組 | 店番担当が記録漏れを確認し、店主代表が現金販売とつけ販売を区別する |
|
|
27
|
+
| 日次販売集計 | 日次締め | 対象日の販売件数、請求金額合計、支払方法別内訳、集計の基準時点 | 日次(閉店後)、イベント(対象日の販売訂正後) | 店舗・対象日・基準時点毎 | 店主代表が締めの販売額を確認し、店番担当が集計漏れ・重複を調べる |
|
|
28
|
+
| 日次締め記録 | 日次締め、月次見直し | 日次販売集計の参照、仕入・在庫・つけ残高の確認結果、判断理由、確認者 | 日次(閉店時の照合後)、イベント(締めの再確認時) | 店舗・対象日・確認版毎 | 店主代表がその日の締めを確定できるか判断する |
|
|
29
|
+
| 月次報告 | 月次見直し | 対象月の売上・欠品・つけ残高の根拠、比較結果、見直しの判断 | 月次(月末の締め確認後)、イベント(根拠の訂正後) | 店舗・対象月・報告版毎 | 店主代表が売価・補充基準・つけ上限の見直しを判断する |
|
|
42
30
|
|
|
43
|
-
|
|
31
|
+
売上明細は売上記録の内訳であり、明細用ファイルが別でも独立した管理単位にしない。日次販売集計は販売記録から作る参照ビューで、全体概要の「日次締め記録」とは更新責務が異なるため区別する。
|
|
44
32
|
|
|
45
33
|
## 3. 正本区分と更新責務
|
|
46
34
|
|
|
47
35
|
### 3.1. 生成元と利用制約
|
|
48
36
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
|
56
|
-
| 日次締め記録 | PO が確定する日ごとの照合・判断の正本。販売集計と隣接台帳を根拠に作成 | 参照した版・基準時点を固定する。元データの訂正後は再確認し、以前の判断を黙って上書きしない | OPS(案作成)、PO(確定) | BA、QE |
|
|
57
|
-
| 月次報告 | PO が確定する月ごとの判断記録。日次締め記録と隣接台帳の確認結果を参照 | 根拠となる対象日と版を識別する。報告の見直し案から商品台帳やつけ上限へ自動的に書き戻さず、承認後に各領域へ更新を依頼する | BA(案作成)、PO(確定) | QE、OPS |
|
|
37
|
+
| データストア名 | 正本区分・生成元 | 扱いの制約 | 更新担当 | 確認担当 |
|
|
38
|
+
| -------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------- | ------------------------- | -------- |
|
|
39
|
+
| 商品台帳 | 商品種類と現在の販売条件の正本。PO の承認内容を反映 | 価格変更を過去の販売単価へ遡及させない | OPS | PO、BA |
|
|
40
|
+
| 販売記録 | 確定した会計と明細の正本 | 入力途中・取消済みの取引を含めない。訂正は元の売上を特定し、PO の承認を得て行う | OPS | PO、QE |
|
|
41
|
+
| 日次販売集計 | 販売記録から再生成する派生情報 | 対象日と基準時点の販売集合を記録する。集計値を直接訂正しない | OPS | QE |
|
|
42
|
+
| 日次締め記録 | 日ごとの照合・判断の正本。日次販売集計と隣接台帳が根拠 | 参照した版・基準時点を固定する。以前の判断を黙って上書きしない | OPS(案作成)、PO(確定) | BA、QE |
|
|
43
|
+
| 月次報告 | 月ごとの判断記録。日次締め記録と隣接台帳が根拠 | 根拠の対象日と版を識別する。見直し案を台帳へ自動で書き戻さず、承認後に各領域へ依頼する | BA(案作成)、PO(確定) | QE、OPS |
|
|
58
44
|
|
|
59
45
|
### 3.2. 訂正・不整合時の扱い
|
|
60
46
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
|
64
|
-
|
|
|
65
|
-
|
|
|
66
|
-
|
|
|
67
|
-
|
|
|
47
|
+
訂正・再生成の詳細手順は予定文書 `specdojo:cop-sales-reconciliation` が担う。
|
|
48
|
+
|
|
49
|
+
| 場面 | 次の行動 | 受け付ける担当 |
|
|
50
|
+
| ---------------------------------- | ---------------------------------------------------------------------------------------------- | -------------- |
|
|
51
|
+
| 販売集計と元記録が合わない | 対象日・基準時点と販売集合を照合し、元記録の誤りは販売側で訂正してから集計を再生成する | OPS |
|
|
52
|
+
| 締め確定後に販売を訂正する | 旧締めの参照と判断を残し、再生成した集計で締めの新しい確認版を判断する。月次報告への影響も見る | OPS・PO・BA |
|
|
53
|
+
| つけ台帳や在庫記録を取得できない | 未取得を残高0・差異なしと読み替えず、取得できた範囲だけを記録して締めの確定を保留する | OPS・PO |
|
|
54
|
+
| 月次報告に根拠のない見直し案がある | 対象月・根拠版・判断理由を補ってから PO が判断する | BA・PO |
|
|
68
55
|
|
|
69
56
|
## 4. 関連仕様と検証
|
|
70
57
|
|
|
71
58
|
### 4.1. 管理単位ごとの参照対応
|
|
72
59
|
|
|
73
|
-
| データストア名 | 根拠・参照先 |
|
|
74
|
-
| -------------- | --------------------------------------------------------------------------------------------------- |
|
|
75
|
-
| 商品台帳 | [[specdojo:bdd-sample\|販売管理の辞書]] の商品、[[specdojo:ccd-sample\|概念クラス図]] |
|
|
76
|
-
| 販売記録 | [[specdojo:bdd-sample\|販売管理の辞書]] の売上記録・売上明細、[[specdojo:ccd-sample\|概念クラス図]] |
|
|
77
|
-
| 日次販売集計 |
|
|
78
|
-
| 日次締め記録 | [[specdojo:cdfd-overview-sample\|全体概要]]
|
|
79
|
-
| 月次報告 | [[specdojo:cdfd-overview-sample\|全体概要]]
|
|
60
|
+
| データストア名 | 根拠・参照先 | 照合する内容 |
|
|
61
|
+
| -------------- | --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
62
|
+
| 商品台帳 | [[specdojo:bdd-sample\|販売管理の辞書]] の商品、[[specdojo:ccd-sample\|概念クラス図]] | 商品の識別、標準販売価格と販売単価の区別 |
|
|
63
|
+
| 販売記録 | [[specdojo:bdd-sample\|販売管理の辞書]] の売上記録・売上明細、[[specdojo:ccd-sample\|概念クラス図]] | 売上と明細の所属・粒度、商品参照、つけ販売時の購入者。現金販売の確定までの操作は [[specdojo:clis-sample\|販売管理 CLI 仕様]]、つけ販売の確定は未作成の `specdojo:cdfd-sales` で扱う |
|
|
64
|
+
| 日次販売集計 | 本書の販売記録、未作成の `specdojo:bdd-sales-summary` | 対象日・基準時点に含めた売上の集合と支払方法別の集計 |
|
|
65
|
+
| 日次締め記録 | [[specdojo:cdfd-overview-sample\|全体概要]] の日次締め、未作成の `specdojo:bdd-closing` | 販売額の照合、仕入・在庫・つけ台帳の確認結果、PO の判断と参照版 |
|
|
66
|
+
| 月次報告 | [[specdojo:cdfd-overview-sample\|全体概要]] の月次見直し、未作成の `specdojo:bdd-monthly-report` | 日次締め記録の網羅、売上・欠品・つけ残高の根拠、更新依頼先 |
|
|
80
67
|
|
|
81
|
-
|
|
68
|
+
項目・値・構造は各辞書が参照する schema・外部 I/F を正本とし、本書で別の制約を作らない。
|
|
82
69
|
|
|
83
70
|
### 4.2. 照合手順と受入条件
|
|
84
71
|
|
|
85
|
-
|
|
72
|
+
schema が未作成のため、次の手動照合で確かめる。数値は例示データである。
|
|
86
73
|
|
|
87
|
-
| 対象 |
|
|
88
|
-
| ------------ |
|
|
89
|
-
|
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
74
|
+
| 対象 | 確認手順 | 合格条件 |
|
|
75
|
+
| ------------ | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
|
|
76
|
+
| 一覧の網羅 | 「概要」の5単位を一覧・正本区分・参照対応の各表と照合する | 欠落・重複が0件 |
|
|
77
|
+
| 商品台帳 | 価格変更の前後で商品IDと、変更前に確定した売上明細を照合する | 商品IDが維持され、過去の販売単価・請求額が変わらない |
|
|
78
|
+
| 販売記録 | 確定済み・入力途中・取消済みの取引を一つずつ用意し、保存された売上と明細を確認する | 確定済みだけが残り、明細の売上・商品の参照が存在し、つけ販売には購入者参照がある |
|
|
79
|
+
| 日次販売集計 | 同じ対象日の現金販売108円とつけ販売216円を集計し、元の売上IDの集合と照合する | 販売2件・請求合計324円、内訳108円・216円。入力途中・取消済みとつけ精算の入金を含めない |
|
|
80
|
+
| 日次締め記録 | 上記集計を使った締め案と、つけ残高を取得できない締め案を比べる | 基準時点と各台帳の参照を追える。未取得がある案は確定保留となり、確認者と次の行動が残る |
|
|
81
|
+
| 月次報告 | 対象月の日次締め記録と報告の根拠一覧を照合し、締め訂正前の版を参照する報告も確かめる | 対象日の欠落・重複が0件。旧版参照の影響が示され、台帳へ無断で反映しない |
|
|
94
82
|
|
|
95
|
-
|
|
83
|
+
不一致は「訂正・不整合時の扱い」に従って直し、再照合する。
|
|
96
84
|
|
|
97
85
|
## 5. 確認事項と変更影響
|
|
98
86
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
|
102
|
-
|
|
|
103
|
-
|
|
|
104
|
-
| 保管先・訂正と再生成手順が未確定(意思決定・運用上の制約) | _UNDECIDED_: システム化後の保存・保持・復旧方式。現行の販売ノートは明細欄と締め欄を分けて扱う。手動照合で調査できるが、システム上の訂正・再生成は本番実施しない | OPS・DEV が `specdojo:sll-sales-closing` と `specdojo:cop-sales-reconciliation` を整備し、ARC が正本保持、QE が復旧後の照合を確認する。PM が PO へ報告し、運用開始前に PO が採用方針と公開範囲を決める | `specdojo:pjr-sales-storage` |
|
|
105
|
-
| 販売の訂正方式や粒度を変える場合(変更要求) | 販売記録、辞書・概念クラス図、販売プロセス、集計、締め、月次報告と既存記録の再照合へ波及する | BA が差分と移行対象を整理し、ARC・DEV が schema・型・生成処理への影響を特定する。QE が再検証範囲、PM が担当・移行順・期限を計画し、PO が実施前に承認する。採用理由は決定記録へ残す | `specdojo:pjr-sales-correction-change` |
|
|
106
|
-
|
|
107
|
-
公開前に BA・ARC・QE が管理境界と受入条件を確認し、OPS が保管・復旧手順と閲覧範囲を確認する。人間の PO は未解決事項、顧客参照・つけ情報の公開範囲、実データが混入していないことを確認し、承認・保留・差し戻しを判断する。未整備の手順に依存する運用は保留し、agent は `draft` を維持する。
|
|
87
|
+
| 論点 | 影響と当面の扱い |
|
|
88
|
+
| ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
|
|
89
|
+
| 集計・締め・報告の辞書と、販売・締めの詳細 CDFD が未作成 | 管理境界と手動照合の基準までを採用し、保存形式や締めの全項目は確定しない。未整備のまま実装すると基準時点の異なる情報が混ざる |
|
|
90
|
+
| `_UNDECIDED_`: システム化後の保存・保持・復旧方式(`specdojo:sll-sales-closing` が未作成) | 現行の販売ノートは明細欄と締め欄を分けて扱う。訂正・再生成の手順が整うまでシステム上で本番実施しない |
|
|
91
|
+
| 販売の訂正方式や粒度を変える場合 | 販売記録、辞書・概念クラス図、販売プロセス、集計、締め、月次報告と既存記録の再照合へ波及する |
|