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
|
@@ -16,45 +16,45 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
### 1.1. 利用環境と対象範囲
|
|
18
18
|
|
|
19
|
-
- 単一店舗のタブレット 1 台で、認証済みの担当者が 1
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
- _ASSUMPTION_:
|
|
19
|
+
- 単一店舗のタブレット 1 台で、認証済みの担当者が 1 件ずつ取引する。
|
|
20
|
+
- 商品コードは手入力するか、入力欄を選択した状態でバーコードスキャナから読み取るし、スキャンで商品追加を確定する。
|
|
21
|
+
- 本画面は現金販売を扱う。つけ販売・返品・確定後の取消は別業務とする。
|
|
22
|
+
- _ASSUMPTION_: 店舗サービスに接続して商品情報の取得と会計確定を行う(「メモ / 将来課題」)。
|
|
23
23
|
|
|
24
24
|
## 2. 対象ユーザー/利用目的
|
|
25
25
|
|
|
26
|
-
| 対象ユーザー | 利用場面・目的 | 許可される操作
|
|
27
|
-
| ------------ | ---------------------------------------------------------- |
|
|
28
|
-
| 店員 | 接客中に商品を登録し、請求額と預かり金を照合して釣銭を渡す |
|
|
29
|
-
| 店主 | 自ら店番し、誤入力や通信失敗時にも取引の確定状況を確認する |
|
|
26
|
+
| 対象ユーザー | 利用場面・目的 | 許可される操作 |
|
|
27
|
+
| ------------ | ---------------------------------------------------------- | ---------------- |
|
|
28
|
+
| 店員 | 接客中に商品を登録し、請求額と預かり金を照合して釣銭を渡す | 「操作」の全操作 |
|
|
29
|
+
| 店主 | 自ら店番し、誤入力や通信失敗時にも取引の確定状況を確認する | 店員と同じ |
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
画面を操作するのは店員・店主で、来店客には担当者が合計請求金額と釣銭を伝える。
|
|
32
32
|
|
|
33
33
|
## 3. 表示項目
|
|
34
34
|
|
|
35
35
|
### 3.1. 入力・明細・集計
|
|
36
36
|
|
|
37
|
-
| 項目名 | 種別 | 表示内容 | 編集可否 | 初期値・表示条件・更新契機
|
|
38
|
-
| ------------------------ | ---- | ------------------------------------------------ | -------- |
|
|
39
|
-
| 取引番号 | 識別 | 開始時に発行された取引の一意な番号 | 不可 | 例 `TX-20261108-0012
|
|
40
|
-
|
|
|
41
|
-
|
|
|
42
|
-
| 商品コード | 入力 | 登録する商品の 8 桁数字コード | 可 |
|
|
43
|
-
| 明細の商品コード・商品名 | 一覧 | 追加済みの商品の識別と名称 | 不可 | 商品台帳から取得。明細なしは「商品を追加してください」
|
|
44
|
-
| 明細の単価 | 一覧 | 1 個あたりの税込販売価格、円単位 | 不可 |
|
|
45
|
-
| 明細の数量 | 入力 |
|
|
46
|
-
| 明細小計 | 一覧 | 税込単価 × 数量、円単位 | 不可 | 追加・数量変更の成功時に更新
|
|
47
|
-
| 現在庫数 | 一覧 |
|
|
48
|
-
| 品目数・総数量 | 集計 | 異なる商品の件数と数量の合計 | 不可 | 初期値は 0 品目 0
|
|
49
|
-
| 税抜小計 | 集計 |
|
|
50
|
-
| 内税額 | 集計 | 税率別の内税額とその合計、円単位 | 不可 | 初期値は各 0
|
|
51
|
-
| 合計請求金額 | 集計 | 全明細小計の合計、円単位 | 不可 | 初期値は 0
|
|
52
|
-
| 預かり金額 | 入力 |
|
|
53
|
-
| 釣銭金額 | 集計 | 預かり金額 − 合計請求金額、円単位 | 不可 |
|
|
54
|
-
| 取引状態 | 状態 | 「登録中」「会計処理中」「結果確認待ち」 | 不可 |
|
|
55
|
-
| 処理・エラー通知 | 状態 | 実行中の操作、失敗理由、修正対象、次に行える操作 | 不可 |
|
|
56
|
-
|
|
57
|
-
|
|
37
|
+
| 項目名 | 種別 | 表示内容 | 編集可否 | 初期値・表示条件・更新契機 |
|
|
38
|
+
| ------------------------ | ---- | ------------------------------------------------ | -------- | ------------------------------------------------------ |
|
|
39
|
+
| 取引番号 | 識別 | 開始時に発行された取引の一意な番号 | 不可 | 例 `TX-20261108-0012`。回復操作でも同じ番号を使う |
|
|
40
|
+
| 担当者 | 識別 | 認証済みの担当者の表示名 | 不可 | 例「店主」 |
|
|
41
|
+
| 取引開始日時 | 識別 | 店舗時刻の年月日・時分 | 不可 | 新規販売開始時に設定し、再試行で変えない |
|
|
42
|
+
| 商品コード | 入力 | 登録する商品の 8 桁数字コード | 可 | 初期値は空。追加成功時に空へ戻し、失敗時は保持 |
|
|
43
|
+
| 明細の商品コード・商品名 | 一覧 | 追加済みの商品の識別と名称 | 不可 | 商品台帳から取得。明細なしは「商品を追加してください」 |
|
|
44
|
+
| 明細の単価 | 一覧 | 1 個あたりの税込販売価格、円単位 | 不可 | 商品追加時に取得 |
|
|
45
|
+
| 明細の数量 | 入力 | 購入数量、個単位 | 可 | 初回追加は 1。同じ商品の追加で 1 増加 |
|
|
46
|
+
| 明細小計 | 一覧 | 税込単価 × 数量、円単位 | 不可 | 追加・数量変更の成功時に更新 |
|
|
47
|
+
| 現在庫数 | 一覧 | 販売可能な数量、個単位 | 不可 | 在庫の判定時に更新 |
|
|
48
|
+
| 品目数・総数量 | 集計 | 異なる商品の件数と数量の合計 | 不可 | 初期値は 0 品目 0 点 |
|
|
49
|
+
| 税抜小計 | 集計 | 合計請求金額から内税額を引いた金額 | 不可 | 初期値は 0 円 |
|
|
50
|
+
| 内税額 | 集計 | 税率別の内税額とその合計、円単位 | 不可 | 初期値は各 0 円 |
|
|
51
|
+
| 合計請求金額 | 集計 | 全明細小計の合計、円単位 | 不可 | 初期値は 0 円 |
|
|
52
|
+
| 預かり金額 | 入力 | 来店客から受け取った金額、円単位 | 可 | 初期値は空。明細更新後も保持して再判定 |
|
|
53
|
+
| 釣銭金額 | 集計 | 預かり金額 − 合計請求金額、円単位 | 不可 | 預かり金額が無効・不足の間は「未計算」 |
|
|
54
|
+
| 取引状態 | 状態 | 「登録中」「会計処理中」「結果確認待ち」 | 不可 | 「状態と操作可否」 |
|
|
55
|
+
| 処理・エラー通知 | 状態 | 実行中の操作、失敗理由、修正対象、次に行える操作 | 不可 | 解消時に消す |
|
|
56
|
+
|
|
57
|
+
集計は明細の更新ごとに計算し直す。商品台帳は税込単価と税率区分(8% または 10%)を持つ。税率別に税込明細小計を合算し、合算額 × 税率 ÷(100 + 税率)の 1 円未満を切り捨てて内税額とする。請求額に内税額を加算しない。
|
|
58
58
|
|
|
59
59
|
### 3.2. 表示値の確認例
|
|
60
60
|
|
|
@@ -63,120 +63,97 @@ specdojo:
|
|
|
63
63
|
| きなこ棒(袋) | 108 円 | 8% | 2 個 | 216 円 |
|
|
64
64
|
| おもちゃ入り菓子 | 110 円 | 10% | 1 個 | 110 円 |
|
|
65
65
|
|
|
66
|
-
この明細では 2 品目 3 点、合計請求金額 326 円、内税額は 8% 分 16 円と 10% 分 10 円の計 26 円、税抜小計 300 円となる。預かり金額 500 円で釣銭は 174 円、326
|
|
66
|
+
この明細では 2 品目 3 点、合計請求金額 326 円、内税額は 8% 分 16 円と 10% 分 10 円の計 26 円、税抜小計 300 円となる。預かり金額 500 円で釣銭は 174 円、326 円で 0 円、325 円で「未計算」となる。
|
|
67
67
|
|
|
68
68
|
## 4. 操作
|
|
69
69
|
|
|
70
70
|
### 4.1. 状態と操作可否
|
|
71
71
|
|
|
72
|
-
| 状態 | 可能な操作
|
|
73
|
-
| ------------ |
|
|
74
|
-
| 登録中 |
|
|
75
|
-
| 会計処理中 | 状態表示の確認
|
|
76
|
-
| 結果確認待ち | 「結果確認」、認証失効・権限不足時の「再ログイン」
|
|
72
|
+
| 状態 | 可能な操作 | 状態を抜ける条件 |
|
|
73
|
+
| ------------ | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
74
|
+
| 登録中 | 結果確認・再ログイン以外の操作 | 会計確定の受付で「会計処理中」。中止に同意すると店舗待機画面へ |
|
|
75
|
+
| 会計処理中 | 状態表示の確認 | 成功時は販売完了画面へ。未確定と確認できる失敗は「登録中」。通信切断・30 秒の応答待ち超過は「結果確認待ち」 |
|
|
76
|
+
| 結果確認待ち | 「結果確認」、認証失効・権限不足時の「再ログイン」 | 確定済みは販売完了画面へ。元の確定処理が終わって未確定と確認できれば「登録中」。処理継続中・照会失敗はこの状態を保持 |
|
|
77
77
|
|
|
78
|
-
|
|
78
|
+
登録中の取得・変更操作は 1 件ずつ処理し、その処理中は他の登録操作を無効化する。認証失効・権限不足時は「再ログイン」だけを許す。
|
|
79
79
|
|
|
80
80
|
### 4.2. 操作ごとの前提と結果
|
|
81
81
|
|
|
82
|
-
|
|
83
|
-
| ------------ | -------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
|
|
84
|
-
| 商品追加 | 商品コード入力欄と「商品追加」、スキャナ入力 | 登録中。商品コードを入力済み | 制約確認後、未追加の商品は数量 1 の行を追加。同じ商品は既存行の数量を 1 増やし、集計・釣銭を再計算。失敗時は明細を保持 |
|
|
85
|
-
| 数量変更 | 明細の数量 | 登録中。対象明細が存在 | 制約確認後に数量と集計・釣銭を更新。失敗時は前の有効数量を保持し、修正用の入力値とエラーを表示 |
|
|
86
|
-
| 明細削除 | 明細の「削除」 | 登録中。対象明細が存在 | 対象行を削除し、集計・釣銭を再計算。最終行の削除後は空の明細表示へ戻る |
|
|
87
|
-
| 預かり金入力 | 預かり金額 | 登録中 | 入力値を保持。形式・金額を判定し、有効なら釣銭を再計算 |
|
|
88
|
-
| 商品検索 | 「商品検索」 | 登録中 | 商品検索ダイアログを開く。選択した商品コードを商品追加と同じ条件で反映。選択取消時は元の入力・明細を保持 |
|
|
89
|
-
| 取引中止 | 「取引中止」 | 登録中 | 中止確認を開く。同意時に明細・預かり金を破棄して店舗待機画面へ。戻る場合は登録を継続 |
|
|
90
|
-
| 会計確定 | 「会計確定」 | 登録中。明細が 1 件以上あり、明細の数量に未修正の入力エラーがなく、預かり金額の形式・範囲が有効 | 「バリデーション」の確定条件を判定。成功時は販売記録と在庫引落をまとめて確定し、完了画面へ。条件違反時は登録中のまま対応エラーを表示 |
|
|
91
|
-
| 読み直し | 「読み直し」 | 登録中。商品取得・在庫確認が通信失敗 | 同じ商品コード・数量で情報を再取得し、成功時に元の追加・変更を 1 回反映。失敗時は入力と有効な明細を保持 |
|
|
92
|
-
| 結果確認 | 「結果確認」 | 結果確認待ち。認証と販売登録権限が有効 | 同じ取引番号の状態を照会し、「状態と操作可否」に従って復帰。新たな会計確定要求は発行しない |
|
|
93
|
-
| 再ログイン | 「再ログイン」 | 認証失効または権限不足を検出 | 取引番号・状態・入力を保持してログイン画面へ。同じ担当者が再認証し権限確認できた場合に復帰 |
|
|
82
|
+
取引中止・再ログインは「遷移」、入力条件は「バリデーション」、回復は「エラー表示と利用者の次の手」に従う。
|
|
94
83
|
|
|
95
|
-
|
|
84
|
+
| 操作名 | 対象 | 前提条件 | 結果 |
|
|
85
|
+
| ------------ | -------------------------------------------- | -------------------------------------- | --------------------------------------------------------------------------- |
|
|
86
|
+
| 商品追加 | 商品コード入力欄と「商品追加」、スキャナ入力 | 登録中。商品コードを入力済み | 未追加の商品は数量 1 の行を追加し、追加済みの商品は数量を 1 増やす |
|
|
87
|
+
| 数量変更 | 明細の数量 | 登録中。対象明細がある | 数量と集計を更新する |
|
|
88
|
+
| 明細削除 | 明細の「削除」 | 登録中。対象明細がある | 行を削除して集計を更新する。最終行の削除後は空の明細表示へ戻る |
|
|
89
|
+
| 預かり金入力 | 預かり金額 | 登録中 | 入力値を保持し、有効なら釣銭を計算する |
|
|
90
|
+
| 商品検索 | 「商品検索」 | 登録中 | 商品検索ダイアログを開き、選んだ商品を商品追加と同じ条件で反映する |
|
|
91
|
+
| 会計確定 | 「会計確定」 | 登録中。確定時の条件を満たす | 販売記録と在庫引落をまとめて確定し、販売完了画面へ |
|
|
92
|
+
| 読み直し | 「読み直し」 | 登録中。商品取得・在庫確認が通信失敗 | 同じ商品コード・数量で情報を取り直し、成功時に元の追加・変更を 1 回反映する |
|
|
93
|
+
| 結果確認 | 「結果確認」 | 結果確認待ち。認証と販売登録権限が有効 | 同じ取引番号の状態を照会する。新たな会計確定要求は出さない |
|
|
96
94
|
|
|
97
|
-
|
|
95
|
+
会計確定は販売記録と在庫引落の両方が成功した時点を完了とし、片方だけの成功を完了と表示しない。同じ取引番号で確定を再実行しても、販売記録と在庫引落は各 1 回とする。
|
|
96
|
+
|
|
97
|
+
「読み直し」は直前に失敗した商品取得・在庫確認を対象とし、入力の修正、別の明細操作、追加・変更の成功で解除する。
|
|
98
98
|
|
|
99
99
|
## 5. 遷移
|
|
100
100
|
|
|
101
|
-
|
|
101
|
+
本画面の識別子は `uis-sales-register` とする。
|
|
102
102
|
|
|
103
|
-
| 遷移名 |
|
|
104
|
-
| ---------------- | -------------------------------------------- | -------------------------------- | ------------------------------------------ | ------------------------------------ |
|
|
105
|
-
| 新規取引開始 | 「新規販売」 | `店舗待機画面(uis-store-home)` | 販売登録画面 | 販売登録権限があり、未完了取引がない |
|
|
106
|
-
| 商品検索表示 | 「商品検索」 | 販売登録画面 | `商品検索ダイアログ(uis-product-search)` | 登録中 |
|
|
107
|
-
| 商品選択反映 | 検索で「選択」 | `商品検索ダイアログ` | 販売登録画面 | 商品を 1 件選択済み |
|
|
108
|
-
| 商品検索取消 | 検索で「戻る」 | `商品検索ダイアログ` | 販売登録画面 | 選択せず戻る |
|
|
109
|
-
| 中止確認表示 | 「取引中止」 | 販売登録画面 | 中止確認ダイアログ | 登録中 |
|
|
110
|
-
| 中止確定 | 確認で「中止する」 | 中止確認ダイアログ | `店舗待機画面` | 中止への同意 | 中止した取引番号。販売・在庫は更新せず、入力を破棄
|
|
111
|
-
| 中止確認から復帰 | 確認で「戻る」 | 中止確認ダイアログ | 販売登録画面 | 中止せず戻る |
|
|
112
|
-
| 会計完了 | 会計確定成功、または結果確認で確定済みを確認 | 販売登録画面 | `販売完了画面(uis-sales-complete)` | 同じ取引の販売・在庫更新が確定済み | 取引番号、確定明細、合計請求金額、預かり金額、釣銭。以後は編集不可
|
|
113
|
-
| 再認証へ | 「再ログイン」 | 販売登録画面 | `ログイン画面(uis-login)` | 認証失効または権限不足 |
|
|
114
|
-
| 再認証から復帰 | ログイン成功 | `ログイン画面` | 販売登録画面 | 同じ担当者に販売登録権限がある |
|
|
103
|
+
| 遷移名 | 契機 | 遷移元 | 遷移先 | 条件 | 引き渡し情報・入力の扱い |
|
|
104
|
+
| ---------------- | -------------------------------------------- | -------------------------------- | ------------------------------------------ | ------------------------------------ | ------------------------------------------------------------------ |
|
|
105
|
+
| 新規取引開始 | 「新規販売」 | `店舗待機画面(uis-store-home)` | 販売登録画面 | 販売登録権限があり、未完了取引がない | 新規取引番号と担当者。空の明細と未入力の預かり金で開始 |
|
|
106
|
+
| 商品検索表示 | 「商品検索」 | 販売登録画面 | `商品検索ダイアログ(uis-product-search)` | 登録中 | なし。明細・入力を保持 |
|
|
107
|
+
| 商品選択反映 | 検索で「選択」 | `商品検索ダイアログ` | 販売登録画面 | 商品を 1 件選択済み | 選択した商品コード |
|
|
108
|
+
| 商品検索取消 | 検索で「戻る」 | `商品検索ダイアログ` | 販売登録画面 | 選択せず戻る | なし。保持した明細・入力へ戻る |
|
|
109
|
+
| 中止確認表示 | 「取引中止」 | 販売登録画面 | 中止確認ダイアログ | 登録中 | 取引番号。入力を保持 |
|
|
110
|
+
| 中止確定 | 確認で「中止する」 | 中止確認ダイアログ | `店舗待機画面` | 中止への同意 | 中止した取引番号。販売・在庫は更新せず、入力を破棄 |
|
|
111
|
+
| 中止確認から復帰 | 確認で「戻る」 | 中止確認ダイアログ | 販売登録画面 | 中止せず戻る | なし。保持した明細・入力へ戻る |
|
|
112
|
+
| 会計完了 | 会計確定成功、または結果確認で確定済みを確認 | 販売登録画面 | `販売完了画面(uis-sales-complete)` | 同じ取引の販売・在庫更新が確定済み | 取引番号、確定明細、合計請求金額、預かり金額、釣銭。以後は編集不可 |
|
|
113
|
+
| 再認証へ | 「再ログイン」 | 販売登録画面 | `ログイン画面(uis-login)` | 認証失効または権限不足 | 復帰先と取引番号。入力と取引状態を保持 |
|
|
114
|
+
| 再認証から復帰 | ログイン成功 | `ログイン画面` | 販売登録画面 | 同じ担当者に販売登録権限がある | 保持した取引へ戻る。会計結果が不明なら結果確認待ちで戻る |
|
|
115
115
|
|
|
116
|
-
|
|
116
|
+
販売完了画面は釣銭の手渡し確認とレシート発行を担い、印刷失敗時の再発行も同画面で扱う(販売登録へ戻して再会計しない)。権限が回復しない場合はログイン画面に留まる。
|
|
117
117
|
|
|
118
118
|
## 6. バリデーション
|
|
119
119
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
|
123
|
-
|
|
|
124
|
-
|
|
|
125
|
-
|
|
|
126
|
-
|
|
|
127
|
-
|
|
|
128
|
-
|
|
|
129
|
-
|
|
|
120
|
+
違反時の状態の扱いは「エラー表示と利用者の次の手」の対応エラーの行に従う。
|
|
121
|
+
|
|
122
|
+
| 対象 | 必須性 | 条件 | 判定時点 | 対応エラー |
|
|
123
|
+
| ---------------------- | ---------------- | ----------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
|
|
124
|
+
| 商品コード | 商品追加時に必須 | 半角数字 8 桁。先頭の 0 を保持し、前後空白や記号を許さない | 商品追加時、スキャン確定時 | 商品コード形式不正 |
|
|
125
|
+
| 商品の存在・販売可否 | 商品追加時に必須 | 商品台帳にあり、販売中である | 商品追加時と会計確定時 | 商品コード未登録、販売対象外 |
|
|
126
|
+
| 数量 | 各明細で必須 | 半角数字による 1〜999 の整数。空欄・符号・小数・文字を許さない | 商品追加時、数量変更時、会計確定時 | 数量形式・範囲不正 |
|
|
127
|
+
| 在庫との相関 | 各明細で必須 | 同一商品をまとめた数量が最新の現在庫数以下 | 商品追加時、数量変更時、会計確定時 | 在庫不足 |
|
|
128
|
+
| 販売価格 | 確定時に必須 | 追加時の税込単価と最新の単価が一致 | 会計確定時 | 販売価格変更 |
|
|
129
|
+
| 明細の有無 | 確定時に必須 | 明細 1 件以上 | 会計確定前 | なし。0 件では「会計確定」を無効化 |
|
|
130
|
+
| 預かり金額の形式・範囲 | 確定時に必須 | 半角数字による 0〜999999 の整数、円単位。空欄・符号・小数・桁区切りを許さない | 入力変更時と会計確定前 | 預かり金形式・範囲不正。空欄・形式不正の間は「会計確定」を無効化 |
|
|
131
|
+
| 預かり金額との相関 | 確定時に必須 | 預かり金額が合計請求金額以上 | 預かり金入力時、明細更新時、会計確定時 | 預かり金額不足 |
|
|
130
132
|
|
|
131
|
-
|
|
133
|
+
会計確定時の違反では販売記録も在庫引落も確定しない。数量は 1・999 を許し、0・1000・1.5 を拒否する。在庫数 3 の商品は数量 3 を許し、4 を拒否する。金額の境界は「表示値の確認例」に従う。
|
|
132
134
|
|
|
133
135
|
## 7. エラー表示と利用者の次の手
|
|
134
136
|
|
|
135
|
-
| エラー事象 | 発生条件
|
|
136
|
-
| ---------------------------- |
|
|
137
|
-
| 商品コード形式不正 |
|
|
138
|
-
| 商品コード未登録 | 入力コードが商品台帳にない
|
|
139
|
-
| 販売対象外 | 追加時または確定時に販売停止を検出
|
|
140
|
-
| 数量形式・範囲不正 |
|
|
141
|
-
| 在庫不足(初回追加) |
|
|
142
|
-
| 在庫不足(既存明細) |
|
|
143
|
-
| 預かり金形式・範囲不正 |
|
|
144
|
-
| 預かり金額不足 | 預かり金額が合計請求金額未満
|
|
145
|
-
| 販売価格変更 | 確定時に単価の変更を検出
|
|
146
|
-
| 商品取得・在庫確認の通信失敗 | 登録中の取得要求で接続切断または 30 秒の応答待ち超過
|
|
147
|
-
| 会計確定失敗 | 店舗サービスから、会計が未確定であるとの失敗応答
|
|
148
|
-
| 会計結果不明 | 会計要求後の接続切断または 30 秒の応答待ち超過
|
|
149
|
-
| 会計結果の照会未完了 | 結果確認で処理継続中、または照会に失敗
|
|
150
|
-
| 認証失効 | 登録中または結果確認時に認証失効を検出
|
|
151
|
-
| 権限不足 | 画面への進入時または操作時に販売登録権限がない
|
|
137
|
+
| エラー事象 | 発生条件 | 表示要点 | 状態の扱い | 利用者の次の手 |
|
|
138
|
+
| ---------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------- | ------------------------------------------------------------------- |
|
|
139
|
+
| 商品コード形式不正 | 「バリデーション」の商品コード | 「商品コードを 8 桁の数字で入力してください」 | 入力を保持。明細・集計は変えない | コードを直して「商品追加」するか、「商品検索」 |
|
|
140
|
+
| 商品コード未登録 | 入力コードが商品台帳にない | 「商品コードが登録されていません」と入力コード | 入力を保持。明細は追加しない | 入力を確かめるか「商品検索」で選ぶ |
|
|
141
|
+
| 販売対象外 | 追加時または確定時に販売停止を検出 | 「現在販売できない商品です」と商品名 | 確定せず登録中を保持 | 別の商品を選ぶか、明細内なら「明細削除」 |
|
|
142
|
+
| 数量形式・範囲不正 | 「バリデーション」の数量 | 「数量は 1〜999 の整数で入力してください」と対象商品 | 前の有効明細と集計を保持し、修正入力を残す | 数量を直すか、購入しないなら「明細削除」 |
|
|
143
|
+
| 在庫不足(初回追加) | 未追加の商品の現在庫数が 0 | 「在庫が不足しています」と商品名、現在庫数 0 | 行は作らず、入力・既存明細を保持 | 追加を取りやめるか、別の商品を追加する |
|
|
144
|
+
| 在庫不足(既存明細) | 再追加・数量変更・会計確定時に数量が現在庫数を超える | 「在庫が不足しています」と商品名、現在庫数 | 入力と直前の有効明細・集計を保持 | 数量を現在庫数以下へ直す。現在庫数 0 か購入をやめるなら「明細削除」 |
|
|
145
|
+
| 預かり金形式・範囲不正 | 「バリデーション」の預かり金額の形式・範囲 | 「預かり金額を 0〜999999 円の整数で入力してください」 | 入力を保持。釣銭は未計算 | 桁区切りなどを除いて預かり金額を直す |
|
|
146
|
+
| 預かり金額不足 | 預かり金額が合計請求金額未満 | 「預かり金が不足しています」と不足額 | 登録中を保持。釣銭は未計算 | 不足分を受け取り、預かり金額を直して「会計確定」 |
|
|
147
|
+
| 販売価格変更 | 確定時に単価の変更を検出 | 「価格が変わりました。金額を確認してください」と変更商品、旧単価・新単価 | 最新価格で計算し直し、預かり金は保持 | 新しい請求額を伝えて「会計確定」 |
|
|
148
|
+
| 商品取得・在庫確認の通信失敗 | 登録中の取得要求で接続切断または 30 秒の応答待ち超過 | 「商品情報を取得できません」と「読み直し」 | 入力と有効な明細を保持。追加・変更は未反映 | 接続を確かめて「読み直し」 |
|
|
149
|
+
| 会計確定失敗 | 店舗サービスから、会計が未確定であるとの失敗応答 | 「会計を確定できませんでした」と取引番号 | 登録中へ戻る。販売・在庫は未更新、入力を保持 | 接続の復旧後に再度「会計確定」。再発時は店主へ取引番号を伝える |
|
|
150
|
+
| 会計結果不明 | 会計要求後の接続切断または 30 秒の応答待ち超過 | 「会計結果を確認してください」と取引番号、「結果確認」 | 結果確認待ちへ移る | 接続の復旧後に「結果確認」。未確定と確認できた場合だけ登録を再開 |
|
|
151
|
+
| 会計結果の照会未完了 | 結果確認で処理継続中、または照会に失敗 | 「会計結果をまだ確認できません」と取引番号 | 結果確認待ちを保持 | 再度「結果確認」。復旧しない場合は店主へ取引番号を伝える |
|
|
152
|
+
| 認証失効 | 登録中または結果確認時に認証失効を検出 | 「再ログインしてください」 | 入力と状態を保持。会計要求後なら結果確認待ち | 「再ログイン」で再認証し、結果確認待ちなら「結果確認」 |
|
|
153
|
+
| 権限不足 | 画面への進入時または操作時に販売登録権限がない | 「販売登録の権限がありません」 | 進入を拒否。操作中は入力を保持して変更を止め、会計要求後は結果確認待ち | 「再ログイン」へ進み、店主に担当者の権限確認を頼む |
|
|
152
154
|
|
|
153
155
|
## 8. メモ / 将来課題
|
|
154
156
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
| 未確認事項 | 影響範囲・次の確認 | 確認担当(Role code) | 確認・判断時点 | 報告先 |
|
|
160
|
-
| -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
|
|
161
|
-
| _ASSUMPTION_: 店舗サービスへの接続を前提に販売を行い、復旧しない場合は店主が紙の記録による継続を判断する | 商品取得・会計確定・結果確認に影響。開発担当が接続断と復旧後の同一取引の照会を確認し、店主代表が結果不明取引を重複記録しない引継ぎ手順と紙での継続可否を確認する | DEV(技術確認)、PO(業務確認・判断) | 採用先の画面仕様承認前。未確認なら承認を保留する | DEV から PO へ結果と残る制約を報告。PO から PM(未配置なら PO が兼務)へ採用可否と運用への影響を報告 |
|
|
162
|
-
|
|
163
|
-
### 8.2. 採用プロジェクトの管理記録へ引き継ぐ事項
|
|
164
|
-
|
|
165
|
-
次表は本仕様の現行動作とは分けて管理する、採用先のプロジェクト登録簿(PJR)への転記候補である。PM(未配置なら PO が兼務)が起票要否と優先順位を判断する。本 sample は実際の起票・採否決定を示すものではない。
|
|
166
|
-
|
|
167
|
-
| 転記候補 | 対応方針・仕様への影響 | 確認担当(Role code) | 判断時点 | 報告先 |
|
|
168
|
-
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------- | ---------------------------------------------- | -------------------------------------- |
|
|
169
|
-
| 接続前提と障害時運用の受入確認 | 「本仕様内の未確認事項」の確認作業と結果をリスク・対応記録へ引き継ぎ、画面仕様の承認条件として追跡する | PM | 採用計画を作るとき。仕様承認前に結果を確認する | PO |
|
|
170
|
-
| 電子マネー・QR 決済への拡張 | 初期の現金販売には含めない。店主代表が決済方法と取消手順を確認し、預かり金・会計確定・結果確認の変更範囲を整理する | BA、PO | 決済方法の追加を検討するとき | PM へ変更要求候補、PO へ採否判断を報告 |
|
|
171
|
-
| 入力欄の選択を要しない連続スキャン | 初期の入力方式には含めない。店員と開発担当が誤読・重複追加時の修正手順を確認する | BA、DEV | 連続スキャンの導入を検討するとき | PM へ改善候補、PO へ採否判断を報告 |
|
|
172
|
-
|
|
173
|
-
### 8.3. 同梱 sample の承認と公開前確認
|
|
174
|
-
|
|
175
|
-
公開対象は、架空の画面仕様の完成例としての本文・表示値・課題表であり、SpecDojo の同梱文書として一般の利用者へ公開する範囲とする。実顧客・実取引の情報、担当者の個人情報、認証情報、店舗固有の非公開情報を含めない。同梱 sample の `ready` 化と公開可否の最終承認・説明責任は、SpecDojo 側の人間の PO が担う。agent による編集・検査だけでは承認済みとしない。
|
|
176
|
-
|
|
177
|
-
`draft` から `ready` へ進める前に、次の条件を確認する。
|
|
178
|
-
|
|
179
|
-
- QE が rulebook の必須項目と、表示値・操作・遷移・入力境界・回復操作の整合を確認する。在庫 0 の初回追加では行が作られず、既存明細だけが削除対象になることを含める。
|
|
180
|
-
- QE が Markdown・Frontmatter の検査と、uis-rulebook・uis-sample の最新内容に対する grade の pass を確認する。残る指摘があれば対応内容または未対応理由を PO に報告する。
|
|
181
|
-
- PO が未確認事項の担当・判断時点・報告先と PJR 転記候補を確認する。架空の運用仮定は採用時の確認事項として残せるが、同梱公開を妨げる未解決指摘は解消し、解消できなければ保留理由を記録して `draft` を維持する。
|
|
182
|
-
- PO が公開対象に非公開情報を含まないことを確認し、承認対象の版と承認理由をプロジェクトの管理記録へ残してから、人が `status` を変更する。
|
|
157
|
+
- _ASSUMPTION_: 店舗サービスとの接続が営業中に復旧しない場合は、店主が取引番号と状況を控えて開発担当へ連絡し、紙の販売記録で続けるかを判断する。採用前に、復旧後に同じ取引を照会できることと、結果不明の取引を紙と二重に記録しないことを確かめる。
|
|
158
|
+
- 電子マネー・QR 決済は初期の現金販売に含めない。導入時は決済方法と取消手順を決め、預かり金・会計確定・結果確認への影響を整理する。
|
|
159
|
+
- 入力欄の選択を要しない連続スキャンは初期の入力方式に含めない。導入時は誤読・重複追加時の修正手順を決める。
|
|
@@ -20,22 +20,23 @@ Job Definition Standard
|
|
|
20
20
|
|
|
21
21
|
## 2. 基本方針
|
|
22
22
|
|
|
23
|
-
-
|
|
23
|
+
- 決定論的な手順は script または CLI へ実装し、`mode: command` の `task.command` から入口を呼ぶ。複数の入口を順に実行する場合は `task.steps` を使う。
|
|
24
24
|
- `task.command` は materialize 時に入力を展開して Run へ凍結し、runner が agent の sandbox 外で直接実行する。
|
|
25
25
|
- 対象選択を伴う command Job は任意の `task.precondition` で選択を先に評価できる。skip 条件を満たした場合は Job Run と付随成果物を作らない。
|
|
26
26
|
- command Job が同じプロジェクトの `specdojo exec` を子プロセスとして呼ぶ場合、runner が保持する project 実行 lock の token を子へ継承する。子は owner token の一致を検証した場合だけ再取得を省略し、Job 全体の排他範囲を維持する。
|
|
27
27
|
- 判断(観測した結果の解釈、失敗の切り分け、次の行動の提案)が必要な command Job だけ、`task.analysis` で reporter agent と判断内容を指定する。
|
|
28
28
|
- `edit` / `review` Job は従来どおり agent に作業を委譲し、`task.description` に判断内容を書く。
|
|
29
29
|
- 委譲先の agent は nickname で指名する。`capabilities` / `proficiency` による間接指定は、指名が不要な場合に限る。
|
|
30
|
+
- `task.proficiency` は `low` / `normal` / `high` / `expert` / `frontier` を受け付ける。最上位の `frontier` は、`task.agent` で指名するか `task.proficiency: frontier` を明示した場合だけ候補にする。provider の起動設定は [[specdojo:exec-config-guide|exec 設定ガイド]] に従う。
|
|
30
31
|
- 同じ論理実行に対して同じ Run を作れるよう、Job が使う値は `inputs`、`job_id`、`scheduled_at`、前回成功 checkpoint に限定する。Run ID 確定後の task と checkpoint では `job_run_id` も参照できる。
|
|
31
32
|
|
|
32
33
|
### 2.1. 判断と手順の切り分け基準
|
|
33
34
|
|
|
34
|
-
次の表で「手順」に該当する記述は `task.description`
|
|
35
|
+
次の表で「手順」に該当する記述は `task.description` へ書かず、`task.steps` または script / CLI へ移す。
|
|
35
36
|
|
|
36
37
|
| 区分 | 判定基準 | 記述場所 | 例 |
|
|
37
38
|
| ---- | ---------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------ |
|
|
38
|
-
| 手順 | 実行前に条件と順序が確定し、結果が入力から一意に決まる | script / CLI と `task.command`
|
|
39
|
+
| 手順 | 実行前に条件と順序が確定し、結果が入力から一意に決まる | `task.steps` または script / CLI と `task.command` | 対象文書の列挙、段の順序制御、1件ごとの CLI 実行 |
|
|
39
40
|
| 手順 | 同じ操作を対象ごとに繰り返す | script / CLI と `task.command` | 全件ループ、対象0件時の分岐 |
|
|
40
41
|
| 判断 | 観測した結果を解釈し、複数の説明のどれが妥当かを選ぶ | `task.analysis.description` または `task.description` | 失敗が rate limit か agent の失敗かの切り分け |
|
|
41
42
|
| 判断 | 事実から次の行動(再開・見直し・エスカレーション)を決める | `task.analysis.description` または `task.description` | 閾値の見直し要否、再開可否の判断 |
|
|
@@ -77,7 +78,7 @@ Job Definition Standard
|
|
|
77
78
|
### 3.4. 責務境界と粒度
|
|
78
79
|
|
|
79
80
|
- 1つの Job は1つの委譲単位に対応させる。同じ処理を条件違いで繰り返すために Job を分割してはならない。条件差は `inputs` で表す。
|
|
80
|
-
- 実行順序を Job の分割で表現してはならない。順序は
|
|
81
|
+
- 実行順序を Job の分割で表現してはならない。順序は `task.steps` または script / CLI が持ち、routine の `action` 配列は独立した委譲単位の並びにだけ使う。
|
|
81
82
|
- Job は起動時刻を持たない。時刻条件は routine または外部スケジューラが持つ。
|
|
82
83
|
- Job は agent 実行エンジンを持たない。plan 生成、agent 選択、result、worktree、commit は `exec` 実行基盤へ委ねる。
|
|
83
84
|
|
|
@@ -101,6 +102,20 @@ Job Definition Standard
|
|
|
101
102
|
- `job_run_id` は `idempotency_key` から導出されるため、`run.idempotency_key` では参照できない。
|
|
102
103
|
- 同じ `scheduled_at` を明示した手動・routine 起動は同じ実行枠として重複排除する。`scheduled_at` を省略した手動起動は起動ごとに新しい実行枠とする。
|
|
103
104
|
|
|
105
|
+
### 3.7. command Job の順次実行
|
|
106
|
+
|
|
107
|
+
`task.command` の代わりに非空の `task.steps` を指定すると、runner は各段のプロセス終了を待ってから次を実行する。両方の併記、agent mode での使用、`task.partial_exit_code` との併用は認めない。各段の `id` は Job 内で一意な小文字 slug、`command` は非空とし、入力 template を materialize 時に解決して Run へ凍結する。
|
|
108
|
+
|
|
109
|
+
- 各段の `on_failure` は自身の失敗・延期後の `stop`(既定)または `continue`。続行しても既に発生した失敗を成功へ読み替えない。
|
|
110
|
+
- 段は終了コード 0 で成功、75 で延期、それ以外(signal・起動不能を含む)で失敗とする。未実行の後続段も理由付きの `deferred` として `attempts[].steps` に保存する。全段が成功した場合だけ Run は `succeeded`、失敗・延期があれば `failed`。CLI は失敗を含めば 1、延期だけなら 75 を返す。
|
|
111
|
+
- 終了コードだけでは完了を表せないコマンドには `completion` を必ず指定する。`path` は repository 内の相対パス(JSON、YAML、Markdown frontmatter)、`field` はドット区切りのキー、`succeeded` は成功状態の非空リスト、任意の `deferred` は延期状態のリスト。終了コード 0 に加え、そのフィールドが成功状態に一致する場合だけ成功とする。ファイル欠落・不正、キー欠落、未指定の状態は失敗とする。CLI が最新状態を生成する必要があれば、同じ段の command の最後で refresh する。ログの文言から完了を判定しない。
|
|
112
|
+
- sequence は project 実行 lock を排他的に取得するまで待つ。`task.lock_wait_seconds` は待機上限の秒数(非負整数、既定 3600、0 は即時判定)。この Job の外側の `--if-busy` より定義を優先する。上限超過では precondition・段・analysis を実行せず、全段を延期として記録する。
|
|
113
|
+
- lock は全段の終了まで保持し、同一 project の子 exec は検証済み token を継承する。先行プロセスのログや `pgrep` は監視しない。同じ論理 Run の同時起動は別の guard で拒否し、待機中の記録を上書きしない。
|
|
114
|
+
- 各段の任意の `timeout_seconds`(1〜2147483 の整数)は lock 待機を含む command 全体の上限。超過は延期とし、POSIX では command のプロセス群を停止してから後続へ進む。grade 独自の lock を待つ場合は `grade run --if-busy wait` と併用する。
|
|
115
|
+
- 各段の状態を直ちに保存し、実行済み段には終了コード・時刻・command evidence 参照を残す。同じ実行枠の retry は新しい attempt として全段を先頭から実行する。段のコマンドには冪等な操作、既存の resume、grade の再開機能を使う。
|
|
116
|
+
|
|
117
|
+
例と routine / cron の接続は [[specdojo:job-sequence-guide|順次実行 Job の例]] を参照する。
|
|
118
|
+
|
|
104
119
|
## 4. 値制約・判定基準
|
|
105
120
|
|
|
106
121
|
| 項目 | 必須 | 判定基準 |
|
|
@@ -108,7 +123,8 @@ Job Definition Standard
|
|
|
108
123
|
| `id` | ○ | `job-<slug>` 形式で、ファイル名の拡張子を除いた部分と一致する |
|
|
109
124
|
| `task.mode` | ○ | `edit` / `review` / `command` |
|
|
110
125
|
| `task.description` | 条件 | `edit` / `review` で必須。決定論的手順の列挙を含まない |
|
|
111
|
-
| `task.command` | 条件 | `command`
|
|
126
|
+
| `task.command` | 条件 | `command` で `task.steps` といずれか一方が必須。入力展開後も非空 |
|
|
127
|
+
| `task.steps` | 条件 | `command` の順次実行。第3.7節に従う |
|
|
112
128
|
| `task.partial_exit_code` | 任意 | `command` だけで使用する1〜255の終了コード。明示した値だけを`partial`とする |
|
|
113
129
|
| `task.precondition` | 任意 | `command` と `empty-output` または 0〜255 の終了コードを指定 |
|
|
114
130
|
| `task.analysis` | 任意 | command 結果の判断が必要な場合だけ agent と description を指定 |
|
|
@@ -123,7 +139,7 @@ Job Definition Standard
|
|
|
123
139
|
|
|
124
140
|
## 5. 記述例
|
|
125
141
|
|
|
126
|
-
次の grade Job は
|
|
142
|
+
次の grade Job は `grade run` で変更済みの Kata を評価する例です。成果物の grade には project の `catalog_path` が必要です。
|
|
127
143
|
|
|
128
144
|
```yaml
|
|
129
145
|
task:
|
|
@@ -133,12 +149,11 @@ task:
|
|
|
133
149
|
command: "{{specdojo}} grade list --target kata --changed-only --project {{project_id}}"
|
|
134
150
|
skip_when: empty-output
|
|
135
151
|
command: |
|
|
136
|
-
|
|
137
|
-
cat logs/grade/runs/per-document/{{job_run_id}}/results.tsv
|
|
152
|
+
{{specdojo}} grade run --run-id {{job_run_id}} --target kata --changed-only --project {{project_id}}
|
|
138
153
|
analysis:
|
|
139
154
|
agent: claude-reporter
|
|
140
155
|
description: |
|
|
141
|
-
command evidence と
|
|
156
|
+
command evidence と grade run の出力から未完了の文書の有無、失敗の切り分け、
|
|
142
157
|
閾値の見直し要否を判断して報告する。
|
|
143
158
|
paths:
|
|
144
159
|
- docs/ja/specdojo/rulebooks
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cdr-template
|
|
4
|
+
type: template
|
|
5
|
+
status: draft
|
|
6
|
+
frontmatter_template:
|
|
7
|
+
applyTo: _APPLY_TO_
|
|
8
|
+
specdojo:
|
|
9
|
+
id: _LOCAL_ID_
|
|
10
|
+
type: architecture
|
|
11
|
+
status: draft
|
|
12
|
+
rulebook: specdojo:cdr-rulebook
|
|
13
|
+
based_on: _BASED_ON_
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# _DELIVERABLE_NAME_
|
|
17
|
+
|
|
18
|
+
_DELIVERABLE_OVERVIEW_
|
|
19
|
+
|
|
20
|
+
## 1. 基本方針
|
|
21
|
+
|
|
22
|
+
- _TODO_
|
|
23
|
+
|
|
24
|
+
## 2. モジュールと import
|
|
25
|
+
|
|
26
|
+
- モジュール方式・import の書き方: _TODO_
|
|
27
|
+
- 依存の向きの制約と検査する仕組み: _TODO_
|
|
28
|
+
|
|
29
|
+
## 3. 型
|
|
30
|
+
|
|
31
|
+
<!-- 動的型の言語では型ヒントの方針に置き換えるか、章を削除して導入文に理由を書く。 -->
|
|
32
|
+
|
|
33
|
+
- 型の宣言: _TODO_
|
|
34
|
+
- 不明な外部入力の扱い: _TODO_
|
|
35
|
+
- 型の強制の制限: _TODO_
|
|
36
|
+
|
|
37
|
+
## 4. エラー処理
|
|
38
|
+
|
|
39
|
+
- 例外と戻り値の使い分け: _TODO_
|
|
40
|
+
- エラーメッセージに含める文脈: _TODO_
|
|
41
|
+
- 例外の握りつぶしの禁止: _TODO_
|
|
42
|
+
|
|
43
|
+
## 5. 命名
|
|
44
|
+
|
|
45
|
+
- 識別子の大文字小文字: _TODO_
|
|
46
|
+
- 略語・真偽値の名前: _TODO_
|
|
47
|
+
|
|
48
|
+
## 6. テストと検証
|
|
49
|
+
|
|
50
|
+
| コマンド | 対象 | 実行条件 | 失敗時 |
|
|
51
|
+
| --------- | ------ | -------- | ------ |
|
|
52
|
+
| _COMMAND_ | _TODO_ | _TODO_ | _TODO_ |
|
|
53
|
+
|
|
54
|
+
## 7. 禁止事項
|
|
55
|
+
|
|
56
|
+
| 禁止事項 | 理由 |
|
|
57
|
+
| -------- | ------ |
|
|
58
|
+
| _TODO_ | _TODO_ |
|
|
@@ -94,13 +94,14 @@ $defs:
|
|
|
94
94
|
|
|
95
95
|
Proficiency:
|
|
96
96
|
type: string
|
|
97
|
-
enum: ["low", "normal", "high", "expert"]
|
|
97
|
+
enum: ["low", "normal", "high", "expert", "frontier"]
|
|
98
98
|
description: >
|
|
99
99
|
Agent proficiency level used for task assignment and brief generation.
|
|
100
100
|
low: lightweight tasks such as formatting or template filling.
|
|
101
101
|
normal: standard document creation and editing.
|
|
102
102
|
high: complex analysis or cross-domain work.
|
|
103
103
|
expert: deep technical judgment or architectural decisions.
|
|
104
|
+
frontier: highest tier above expert; selected only by name or an explicit frontier request.
|
|
104
105
|
|
|
105
106
|
Capability:
|
|
106
107
|
type: string
|
|
@@ -160,6 +160,31 @@ $defs:
|
|
|
160
160
|
one of them, and records `not_applicable` otherwise. Without `paths`, or when
|
|
161
161
|
the change set is unknown or truncated, or when the integration targets were
|
|
162
162
|
merged into the worktree, the validation always runs.
|
|
163
|
+
post_integration:
|
|
164
|
+
type: array
|
|
165
|
+
uniqueItems: true
|
|
166
|
+
description: >
|
|
167
|
+
Fixed actions run in the integration target checkout after its merge commit, while
|
|
168
|
+
retaining the exec/lifecycle lock. Failure is recorded without undoing integration.
|
|
169
|
+
Each ID may appear only once; arbitrary commands, arguments and repositories are rejected.
|
|
170
|
+
items:
|
|
171
|
+
type: object
|
|
172
|
+
additionalProperties: false
|
|
173
|
+
required: [id, paths]
|
|
174
|
+
properties:
|
|
175
|
+
id:
|
|
176
|
+
type: string
|
|
177
|
+
enum: [build-dist]
|
|
178
|
+
description: Runs npm run build with fixed argv (no shell).
|
|
179
|
+
paths:
|
|
180
|
+
type: array
|
|
181
|
+
minItems: 1
|
|
182
|
+
items:
|
|
183
|
+
type: string
|
|
184
|
+
pattern: "\\S"
|
|
185
|
+
description: >
|
|
186
|
+
Repository-relative globs (`**`, `*`, `?`, `{a,b}`) selecting the action from
|
|
187
|
+
the actual integration commit diff, including deletions and both rename paths.
|
|
163
188
|
commit_hook_skips:
|
|
164
189
|
type: array
|
|
165
190
|
description: >
|
|
@@ -300,9 +325,16 @@ $defs:
|
|
|
300
325
|
by_proficiency:
|
|
301
326
|
type: object
|
|
302
327
|
minProperties: 1
|
|
303
|
-
description:
|
|
328
|
+
description: >
|
|
329
|
+
Variables selected by the member's proficiency. Frontier members require an explicit
|
|
330
|
+
frontier entry before launch; use an empty mapping when no extra variables are needed.
|
|
304
331
|
propertyNames:
|
|
305
|
-
|
|
332
|
+
$ref: "./exec-common.schema.yaml#/$defs/Proficiency"
|
|
333
|
+
properties:
|
|
334
|
+
frontier:
|
|
335
|
+
anyOf:
|
|
336
|
+
- $ref: "#/$defs/CommandVariableSet"
|
|
337
|
+
- const: {}
|
|
306
338
|
additionalProperties:
|
|
307
339
|
$ref: "#/$defs/CommandVariableSet"
|
|
308
340
|
by_nickname:
|
|
@@ -413,17 +445,22 @@ $defs:
|
|
|
413
445
|
additionalProperties: false
|
|
414
446
|
required:
|
|
415
447
|
- action
|
|
416
|
-
description:
|
|
448
|
+
description: >
|
|
449
|
+
Compatibility-only field, still required by this schema. Ignored at runtime:
|
|
450
|
+
automatic agent selection uses on_critical.retry for all tasks, regardless of
|
|
451
|
+
critical-path membership. Keep action: skip in existing configurations.
|
|
417
452
|
properties:
|
|
418
453
|
action:
|
|
419
454
|
const: "skip"
|
|
420
|
-
description: "
|
|
455
|
+
description: "Compatibility value only; does not skip tasks at runtime."
|
|
421
456
|
on_critical:
|
|
422
457
|
type: object
|
|
423
458
|
additionalProperties: false
|
|
424
459
|
required:
|
|
425
460
|
- action
|
|
426
|
-
description:
|
|
461
|
+
description: >
|
|
462
|
+
Retry policy used by automatic agent selection for all tasks, regardless of
|
|
463
|
+
critical-path membership. The on_critical name is retained for compatibility.
|
|
427
464
|
properties:
|
|
428
465
|
action:
|
|
429
466
|
type: string
|