specdojo 0.7.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 +7 -3
- package/CHANGELOG.md +217 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/catalog.js +16 -14
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- 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 +9 -3
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +616 -261
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +11 -12
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +23 -18
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- 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 +268 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +31 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +100 -39
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +179 -8
- package/dist/exec/evidence.js +77 -19
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +209 -15
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +45 -19
- package/dist/exec/plans-generation.js +52 -30
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- 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/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +21 -5
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +106 -25
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +112 -0
- package/dist/exec/run/agent-pipeline.js +78 -8
- package/dist/exec/run/agent.js +32 -13
- 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 +73 -33
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +135 -41
- package/dist/exec/run/lifecycle-commands.js +189 -37
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +14 -15
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +77 -17
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +95 -31
- package/dist/exec/run/register-state.js +23 -15
- package/dist/exec/run/register-worktree.js +184 -139
- package/dist/exec/run/schedule-mode.js +79 -18
- package/dist/exec/run/schedule-prepare.js +204 -59
- package/dist/exec/run/schedule-task.js +203 -49
- package/dist/exec/run/shared.js +9 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -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 +14 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +8 -4
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +38 -17
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +32 -4
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +7 -5
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +7 -1
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +87 -11
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +109 -39
- package/dist/job/noop.js +104 -0
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +6 -3
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -16
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +13 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +189 -71
- package/dist/routine/status.js +62 -0
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +39 -39
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +7 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +186 -16
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +73 -41
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +74 -6
- package/dist/shared/timeline-index.js +2 -0
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
- package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
- 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 +92 -99
- package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
- 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 -48
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
- 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 +88 -80
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +303 -148
- package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
- 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 +63 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
- 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 +51 -55
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
- 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 +79 -249
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -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 +171 -0
- 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 +93 -57
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
- 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 +12 -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 +92 -102
- 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 +45 -59
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
- 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 +106 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
- 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 +46 -40
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
- 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 +91 -161
- 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/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +87 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
- package/docs/ja/specdojo/samples/bes-sample.md +70 -21
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +57 -15
- package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +125 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- 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-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
- package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
- package/docs/ja/specdojo/samples/sf-sample.md +109 -21
- package/docs/ja/specdojo/samples/sld-sample.md +88 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +141 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -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/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +10 -7
- package/templates/antigravity/orchestrator.md +7 -3
- package/templates/claude/agents/specdojo-orchestrator.md +7 -3
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
- package/templates/codex/orchestrator.md +7 -3
- package/templates/devcontainer/tmux.conf +6 -0
- 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 +8 -4
|
@@ -2,37 +2,104 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:sld-sample
|
|
4
4
|
type: data
|
|
5
|
-
status:
|
|
5
|
+
status: ready
|
|
6
6
|
rulebook: specdojo:sld-rulebook
|
|
7
|
+
based_on:
|
|
8
|
+
- specdojo:cdfd-overview-sample
|
|
9
|
+
- specdojo:cdsd-sample
|
|
10
|
+
- specdojo:bdd-sample
|
|
11
|
+
- specdojo:stsd-sample
|
|
12
|
+
- specdojo:clis-sample
|
|
13
|
+
- specdojo:pm-members-sample
|
|
7
14
|
---
|
|
8
15
|
|
|
9
|
-
#
|
|
16
|
+
# 保管場所一覧(駄菓子屋きぬやの販売・在庫・記録管理)
|
|
10
17
|
|
|
11
|
-
## 1.
|
|
18
|
+
## 1. 概要
|
|
12
19
|
|
|
13
|
-
|
|
20
|
+
店主代表と店番担当が、現物・紙台帳・タブレット内のファイルをどこに置き、いつ消してよいかを同じ根拠で判断できるようにする。検品前の入荷品と販売可能な商品の混在や、販売記録の控え・入力途中のセッションファイルの誤削除を防ぐ。
|
|
14
21
|
|
|
15
|
-
|
|
22
|
+
対象範囲は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要): 駄菓子屋きぬや販売管理]] の仕入・販売・在庫・締め領域の物理保管場所と、店舗タブレットのローカル保存領域とする。仕入記録は現行の仕入ノートを含める。在庫記録は今は店主の記憶で保管場所がないため、「確認事項と変更影響」で追跡する。
|
|
16
23
|
|
|
17
|
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/sld-rulebook.md`
|
|
24
|
+
## 2. 保管場所一覧
|
|
20
25
|
|
|
21
|
-
|
|
26
|
+
### 2.1. 店舗内・母屋の物理保管場所
|
|
22
27
|
|
|
23
|
-
|
|
24
|
-
|
|
28
|
+
| 保管場所 | 置くもの | 関連プロセス・操作 | 共有の有無 | 寿命・管理頻度 | 削除・処分の可否と条件 |
|
|
29
|
+
| --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
|
|
30
|
+
| 検品場所(店舗奥の荷受台) | 配置前の入荷品、納品伝票、外箱 | 入荷受入、入荷検品 | 店舗内共有 | 入荷当日の配置完了まで | `条件付き処分可`。検品結果を仕入ノートへ記録し、商品を売場棚か返品保管箱へ移してから外箱を処分する。伝票は店頭台帳保管棚へ移す |
|
|
31
|
+
| 売場棚(陳列棚・平台) | 販売可能な商品、棚札 | 売場配置、店頭販売、開店前の期限確認 | 店舗内公開 | 販売・撤去まで(毎朝点検) | `処分不可`。期限切れ・破損品は撤去品保留箱へ移す。棚札は取扱終了を店主代表が確かめてから外す |
|
|
32
|
+
| 返品保管箱(バックヤード下段・赤ラベル) | 検品で受入不可とした商品 | 入荷検品、仕入先への返品 | 店舗内共有(売場と分離) | 仕入先への引渡しまで(週次の回収日) | `条件付き処分可`。仕入先へ引き渡し、返品日と数量を仕入ノートへ記録してから空にする。店舗で廃棄しない |
|
|
33
|
+
| 撤去品保留箱(バックヤード下段・黄ラベル) | `_ASSUMPTION_`: 売場から撤去した期限切れ・破損品 | 開店前の期限確認、廃棄確定 | 店舗内共有(売場・返品保管箱と分離) | 撤去した日の日次締めまで | `条件付き処分可`。店主代表が廃棄を確定し、廃棄数を日次締め記録の在庫差異欄へ記入してから廃棄する |
|
|
34
|
+
| レジ釣銭準備箱・手提げ金庫 | 釣銭準備金、当日の現金売上 | 開店準備、店頭販売、日次締め | 店舗内共有(閉店後は施錠) | 日次締めまで | `処分不可`。日次締めで店主代表が現金と販売額の一致を確かめ、売上金を母屋金庫へ移す |
|
|
35
|
+
| 仮メモ挟み(レジ横) | 仮領収メモ、つけ販売の仮メモ | 店頭販売、日次締め | 店番担当のみ(客から見えない位置) | 書いた日の日次締めまで | `条件付き処分可`。販売ノートと顧客・つけ台帳への転記を店主代表が確かめたメモだけ破棄する |
|
|
36
|
+
| 店頭台帳保管棚(施錠キャビネット) | 当年度の商品台帳、顧客・つけ台帳、仕入ノート、納品伝票綴り、販売ノート(販売明細欄・日次締め欄)、月次報告 | 入荷検品、つけ販売、日次締め、月次見直し | 店主代表・家族利用者代表のみ(施錠) | 当年度分。年度末に母屋書庫へ移す | `処分不可`。取引・未収金・仕入の正本記録 |
|
|
37
|
+
| 母屋書庫(施錠書棚) | 旧年度の台帳・ノート・伝票・月次報告 | 年度末の移管、過去の照合 | 店主代表が施錠管理(家族利用者代表は了承を得て閲覧) | 保持期間は未決。決まるまで全年度 | `処分不可`。満了分の処分も PO の承認を要する |
|
|
38
|
+
| 母屋金庫 | 日次締め後の売上金 | 日次締め、仕入代金の支払 | 店主代表のみ | 支払・入金まで | `処分不可`。持ち出すときは金額と用途を販売ノートの日次締め欄へ記入する |
|
|
39
|
+
| 外部退避媒体(`_UNDECIDED_`: SD カードか USB メモリ。手提げ金庫か母屋金庫) | `config/store-config.yaml` と `data/sales/` の日次複製 | 日次締め後の退避、消失時の復元 | 店主代表のみ | 保持世代数は未決。決まるまで全世代 | `処分不可`。上書き・消去しない |
|
|
25
40
|
|
|
26
|
-
|
|
41
|
+
### 2.2. 店舗タブレット内の論理保管場所
|
|
27
42
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
43
|
+
| 保管場所 | 置くもの | 関連プロセス・操作 | 共有の有無 | 寿命・管理頻度 | 削除・処分の可否と条件 |
|
|
44
|
+
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------------- | -------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
45
|
+
| 店舗設定ファイル(`config/store-config.yaml`) | 店舗・税計算・本部接続の条件 | 全 `sales` コマンドの設定解決 | 共有なし(端末ローカル。外部退避媒体へ複製) | 店舗運用期間中 | `削除不可`。欠落すると CLI は既定設定で動き、条件が変わる。変更は DEV が旧ファイルを退避してから行い、PO が条件を確かめる |
|
|
46
|
+
| 取引セッション(`.session/current-tx.json`) | 進行中の取引の明細と確定状態 | `sales start`、`add`、`total`、`complete`、`cancel` | 共有なし(端末ローカル) | 取引開始から会計完了・確定前取消まで | `条件付き削除可`。CLI が終了させる場合に限る。手で消さない |
|
|
47
|
+
| 販売記録の控え(`data/sales/TX-YYYYMMDD-NNNN.json`) | 現金販売の販売実績と本部の受付結果(受付済み・未受付・結果不明)。つけ販売は販売ノートに紙で記録 | `sales complete`、本部受付との照合、日次締め | 共有なし(端末ローカル。外部退避媒体へ複製) | 保持期間は未決。決まるまで全件 | `削除不可`。本部受付との照合根拠で、正本の保存先も未決 |
|
|
48
|
+
| 日次販売集計(`_ASSUMPTION_`: `data/summary/`) | 日ごとの販売件数・請求合計・支払方法別内訳(派生情報) | 日次締め、販売訂正後の再集計 | 共有なし(端末ローカル) | 閉店後に作成し、販売訂正時に作り直す | `条件付き削除可`。再生成手順(予定 `specdojo:cop-sales-reconciliation`)が整い、日次締め記録の参照値を再現できる場合に限る |
|
|
49
|
+
| レシート控え(`receipts/receipt-YYYYMMDD-NNNN.txt`) | 確定済み会計のレシート | `sales complete`、未印字時の再印刷 | 共有なし(端末ローカル) | 月次締め確定まで | `条件付き削除可`。月次締め確定後で、未印字・照合中の取引がない場合に限る。再出力できないため、削除後の照合は `data/sales/` で行う |
|
|
50
|
+
| 一時作業領域(`_ASSUMPTION_`: `tmp/`) | 保守作業の一時ファイル | DEV の保守作業 | 共有なし(端末ローカル) | 保守作業の終了まで | `削除可`。CLI と保守作業が止まっていれば消してよい |
|
|
33
51
|
|
|
34
|
-
##
|
|
52
|
+
## 3. 削除・退避・復旧の判断基準
|
|
35
53
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
54
|
+
### 3.1. 区分ごとの扱い
|
|
55
|
+
|
|
56
|
+
- `削除不可` / `処分不可`: 清掃や容量整理で消さず、一覧に書いた移し先へ移す。電子記録は保持期間が決まるまで整理しない。
|
|
57
|
+
- `条件付き削除可` / `条件付き処分可`: 「保管場所一覧」の条件をすべて満たした場合だけ消す。満たせなければ残して持ち越す。
|
|
58
|
+
- `削除可`: 使用中の作業がなければ消す。
|
|
59
|
+
|
|
60
|
+
### 3.2. 場面別の対処と復旧手順
|
|
61
|
+
|
|
62
|
+
| 場面 | 確認と対処 | 担当・連絡先 |
|
|
63
|
+
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
|
|
64
|
+
| 会計要求前に再起動し、取引が残っている | `sales total` で明細を確かめ、続けるか `sales cancel` で取り消す | 店番担当。解消しなければ DEV |
|
|
65
|
+
| 会計要求後に再起動・応答欠落し、本部の受付結果が分からない | 取消・ファイル削除・再登録をしない。PO が本部受付と `data/sales/` を照合し、受付済みなら同じ取引を回復し、未受付と確かめた場合だけ送信を再開する。照合・回復手順が整うまで、確かめられない取引は保留する | OPS が会計を止めて PO・DEV へ連絡。PO が判断 |
|
|
66
|
+
| `data/summary/` を誤って削除した | 再生成手順が整うまでは、受付済みの `data/sales/` の現金販売(結果不明を除く)と販売ノートのつけ販売を手で集計し、日次締め記録の参照値と照合する。照合者・照合日・結果は本部の受付結果と別に日次締め記録へ書く | OPS(店主代表)が再集計、QE が一致を確認。不一致なら PO が締めを再判断 |
|
|
67
|
+
| `config/store-config.yaml` が消失・破損した | 会計を止める。DEV が外部退避媒体の最新世代を復元する。退避がなければ、構造の正本 `kinuya-store-config-schema`(CLIS の未同梱の参照名)がある場合に限り作り直し、なければ PO へ報告する。PO が条件を確かめるまで再開しない | OPS → DEV(復元)・PO(条件確認) |
|
|
68
|
+
| `data/sales/` が消失・破損した | 新規会計を止める。DEV が最新世代を復元し、退避後の取引を PO が販売ノート・レシート控え・本部受付と照合し、QE が取引番号の連続と日次締め記録の件数を照合する。退避がなければ推測で作り直さず、照合できない日の締めを保留する | OPS → DEV(復元)・PO(照合と締め)・QE(一致確認) |
|
|
69
|
+
| 売場で期限切れ・破損品を見つけた | 売場で捨てず撤去品保留箱へ移す | 店番担当(移動)→ PO(廃棄確定) |
|
|
70
|
+
| タブレットの空き容量が不足した | `tmp/` と条件を満たした `receipts/` だけを消す | OPS(削除)、DEV・PO(保持期間が決まるまでの容量確保) |
|
|
71
|
+
|
|
72
|
+
## 4. 関連仕様・実装配置との対応と検証
|
|
73
|
+
|
|
74
|
+
### 4.1. 隣接仕様との分担と対応
|
|
75
|
+
|
|
76
|
+
| 隣接仕様 | 定義するものと対応する保管場所 |
|
|
77
|
+
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
78
|
+
| [[specdojo:cdsd-sample\|概念データストア定義(駄菓子屋きぬやの販売と締め)]] | 管理単位と正本区分・更新責務。商品台帳・販売記録・日次締め記録・月次報告は店頭台帳保管棚と母屋書庫、販売記録は `data/sales/`(結果不明の取引は照合待ち)、日次販売集計(保存形式未確定)は `data/summary/` |
|
|
79
|
+
| [[specdojo:cdfd-overview-sample\|概念データフロー図(全体概要)]] | 仕入記録(仕入ノート)と顧客・つけ台帳は店頭台帳保管棚と母屋書庫 |
|
|
80
|
+
| [[specdojo:stsd-sample\|商品のステータス定義]] | 商品の状態と遷移。入荷済み(`received`)・検品済み(`inspected`)は検品場所、販売可能(`sellable`)は売場棚、返品待ち(`return-pending`)は返品保管箱。撤去品保留箱に当たる状態はない |
|
|
81
|
+
| [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] | 商品・売上記録・売上明細の項目。本書は項目を再掲しない |
|
|
82
|
+
| [[specdojo:clis-sample\|駄菓子屋きぬや 販売管理 CLI 仕様]] | コマンドと入出力ファイル(`config/`、`.session/`、`data/sales/`、`receipts/`)の作成・停止条件 |
|
|
83
|
+
|
|
84
|
+
### 4.2. 検証手順と受入条件
|
|
85
|
+
|
|
86
|
+
| 観点 | 手順 | 合格条件 |
|
|
87
|
+
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
88
|
+
| CLI 仕様との一致 | タブレット内の各パスと役割を CLIS と照合する | CLIS にないパスに `_ASSUMPTION_` が付き、取引セッションと販売記録の控えが別ファイルである |
|
|
89
|
+
| 設定ファイルの欠落・破損 | 検証用端末で `config/store-config.yaml` を外して `sales start` を実行し、次に壊して実行する | 欠落時は既定設定で起動し、破損時は「店舗設定不正」(終了コード `4`)で停止する |
|
|
90
|
+
| 受付結果不明の取引 | 本部の応答を欠落させて `sales complete` を実行し、続けて `sales cancel` を試す | `.session/current-tx.json` と `data/sales/` に結果不明として残り、取消は終了コード `2` で拒否される |
|
|
91
|
+
| 日次集計の再集計 | CDSD の照合例の現金販売108円を受付済みの `data/sales/` に、つけ販売216円を販売ノートに用意し、結果不明の現金取引1件を加える。`data/summary/` を消して場面別の対処で作り直す | 販売2件・請求合計324円で元の売上IDの集合と一致し、結果不明の取引を含まない |
|
|
92
|
+
| 記録・状態の網羅 | CDSD の5管理単位、全体概要の仕入記録・在庫記録、STSD の全状態を一覧と照合する | 保管場所のない記録・状態が「確認事項と変更影響」にある。紙の正本が年度で二か所に分かれても欠落せず、受入不可品・撤去品が売場や返品待ちと混ざらない |
|
|
93
|
+
| 削除・復旧判断の実効性 | 清掃・障害復旧・容量整理・返品の判断を本書で模擬する | 消してよい場所、削除前の条件、復旧の経路と連絡先を迷わず判断できる |
|
|
94
|
+
|
|
95
|
+
## 5. 確認事項と変更影響
|
|
96
|
+
|
|
97
|
+
| 論点 | 影響と当面の扱い |
|
|
98
|
+
| -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
|
|
99
|
+
| `_UNDECIDED_`: 外部退避媒体の種類・保管先・保持世代数 | 決まるまで全世代を保持する |
|
|
100
|
+
| `_UNDECIDED_`: 販売記録の正本保存先と電子・紙記録の保持期間(CDSD で未決) | 決まるまで `data/sales/` と母屋書庫の記録を処分しない |
|
|
101
|
+
| 日次集計の再生成手順(`specdojo:cop-sales-reconciliation`)が未整備 | 整うまで `data/summary/` を削除できない |
|
|
102
|
+
| 本部との受付照会・重複排除・回復の契約が未整備 | 誤った取消・再登録で二重登録や照合根拠の消失が起こる。回復と日次集計の自動再生成に依存する運用は始めない |
|
|
103
|
+
| `_UNDECIDED_`: 仕入記録・在庫記録のシステム化後の保管先 | 在庫記録は今は保管場所がない。決まったら「保管場所一覧」へ行を足す |
|
|
104
|
+
| 撤去品保留箱に当たる商品状態が STSD にない | 撤去品保留箱は仮置きで運用する。STSD に状態が足されたら対応を見直す |
|
|
105
|
+
| 紙の台帳・締め記録をタブレットへ完全移行する場合 | 正本区分、`data/` の構成、外部退避の対象、日次集計の再集計元、本部照合に使う記録、検証項目が変わる |
|
|
@@ -10,16 +10,26 @@ specdojo:
|
|
|
10
10
|
|
|
11
11
|
# 商品のステータス定義
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
駄菓子屋きぬやの商品について、納品から販売または返品までの状態と遷移を定義する。
|
|
14
14
|
|
|
15
|
-
## 1.
|
|
15
|
+
## 1. 目的
|
|
16
|
+
|
|
17
|
+
商品の受入から販売・返品までの進み具合と販売可否を管理する。店番担当(店主代表または家族利用者代表)が、検品、売場補充、顧客への引渡し、仕入先への返品のどれを次に行えるか判断するために使う。
|
|
18
|
+
|
|
19
|
+
## 2. 適用範囲
|
|
16
20
|
|
|
17
21
|
- 対象: 店舗が仕入先へ発注し、納品を受けた商品
|
|
18
|
-
-
|
|
22
|
+
- 業務範囲: 商品の受領を起点とする入荷受入、検品、売場補充、販売、仕入先への返品。納品前の発注業務と顧客への引渡し後の対応は対象外とする
|
|
23
|
+
- 到達点: 販売処理確定または返品処理確定で店舗管理のライフサイクルを終了する
|
|
24
|
+
|
|
25
|
+
## 3. 状態の判定
|
|
26
|
+
|
|
19
27
|
- 状態の正本: 仕入記録、在庫記録、販売記録。現物の配置は売場棚または返品保管箱で補助確認する
|
|
20
|
-
- 一意判定:
|
|
28
|
+
- 一意判定: 対象商品の記録を業務の発生順に照合し、開始から遷移表の条件を満たす遷移を順にたどり、最後に成立した遷移の遷移先を現在状態とする。入荷受入前は状態を割り当てず、後続遷移が成立した時点で遷移元の状態は終了するため、同時に複数状態へは分類しない
|
|
29
|
+
- 未成立時の扱い: 条件の一部だけが満たされた場合は遷移元の状態を保つ。入荷受入が未成立なら状態を割り当てず、受入日時と数量の記録だけで入荷済みと判定しない
|
|
30
|
+
- 互換の扱い: 旧状態値・旧イベントの読み替えは不要とする。記録が欠けて判定できない場合は現物だけで補完せず、店主代表が記録を確認・補記した後に再判定する
|
|
21
31
|
|
|
22
|
-
##
|
|
32
|
+
## 4. 状態一覧
|
|
23
33
|
|
|
24
34
|
| 値 | 状態名 | 通称 | 意味 | 成立条件 | 管理場所 |
|
|
25
35
|
| -------------- | -------- | ---------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------- |
|
|
@@ -30,29 +40,47 @@ specdojo:
|
|
|
30
40
|
| return-pending | 返品待ち | 返す品 | 数量違いまたは品質不良により受入不可の商品 | 不合格理由を仕入記録へ記録して返品保管箱へ分け、返品日と数量をまだ記録していない | 仕入記録、返品保管箱 |
|
|
31
41
|
| returned | 返品済み | 返した品 | 仕入先へ返却し、店舗の管理対象から外れた商品 | 仕入先へ商品を引き渡し、返品日と数量を仕入記録へ記録した | 仕入記録 |
|
|
32
42
|
|
|
33
|
-
##
|
|
43
|
+
## 5. 状態遷移
|
|
44
|
+
|
|
45
|
+
検品後の販売と返品を分けて確認するため、通常系と例外系に分割する。
|
|
46
|
+
|
|
47
|
+
通常系(`T-01`〜`T-05`)。例外系との共有状態は検品済み(`inspected`)。
|
|
48
|
+
|
|
49
|
+
```mermaid
|
|
50
|
+
stateDiagram-v2
|
|
51
|
+
state "入荷済み<br>received" as received
|
|
52
|
+
state "検品済み<br>inspected" as inspected
|
|
53
|
+
state "販売可能<br>sellable" as sellable
|
|
54
|
+
state "販売済み<br>sold" as sold
|
|
55
|
+
[*] --> received : T-01 入荷受入 / 商品受領後に納品情報を発注内容へ照合し、受入日時と数量を仕入記録へ記録した
|
|
56
|
+
received --> inspected : T-02 検品結果記録 / 検品結果と理由を仕入記録へ記録した
|
|
57
|
+
inspected --> sellable : T-03 検品完了 / 結果が合格で在庫を更新し売場へ配置した
|
|
58
|
+
sellable --> sold : T-04 商品引渡し / 会計・販売記録・在庫減算・顧客受領が完了した
|
|
59
|
+
sold --> [*] : T-05 販売処理確定 / 販売記録と在庫記録が一致した
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
| 遷移 ID | 遷移元 | 遷移先 | イベント | 条件 | 補足 |
|
|
63
|
+
| ------- | -------- | -------- | ------------ | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
|
|
64
|
+
| `T-01` | 開始 | 入荷済み | 入荷受入 | 商品受領後に納品情報を発注内容へ照合し、受入日時と数量を仕入記録へ記録した | 照合未実施なら店主代表または家族利用者代表が納品情報と発注内容を確認してから受入を確定する |
|
|
65
|
+
| `T-02` | 入荷済み | 検品済み | 検品結果記録 | 検品結果と理由を仕入記録へ記録した | 現物を見ただけで結果未記録なら入荷済みに留め、検品した店主代表または家族利用者代表が記録する |
|
|
66
|
+
| `T-03` | 検品済み | 販売可能 | 検品完了 | 結果が合格で在庫を更新し売場へ配置した | 店番担当は在庫記録と売場棚を確認して販売対象として引き受ける。合格でも配置未完了なら販売を保留する |
|
|
67
|
+
| `T-04` | 販売可能 | 販売済み | 商品引渡し | 会計・販売記録・在庫減算・顧客受領が完了した | 店番担当は顧客受領まで確認する。会計のみ完了した場合は販売済みとせず、未完了の引渡し・記録を店主代表へ引き継ぐ |
|
|
68
|
+
| `T-05` | 販売済み | 終了 | 販売処理確定 | 販売記録と在庫記録が一致した | 不一致なら店主代表が対象商品と数量を照合し、記録を補正してから確定する。照合のために販売をやり直さない |
|
|
69
|
+
|
|
70
|
+
例外系(`T-06`〜`T-08`)。通常系との共有状態は検品済み(`inspected`)。
|
|
34
71
|
|
|
35
72
|
```mermaid
|
|
36
73
|
stateDiagram-v2
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
販売済み --> [*] : 販売処理確定 / 販売記録と在庫記録が一致した
|
|
44
|
-
返品済み --> [*] : 返品処理確定 / 返品商品と仕入記録が一致した
|
|
74
|
+
state "検品済み<br>inspected" as inspected
|
|
75
|
+
state "返品待ち<br>return-pending" as return_pending
|
|
76
|
+
state "返品済み<br>returned" as returned
|
|
77
|
+
inspected --> return_pending : T-06 検品完了 / 結果が数量違いまたは品質不良で返品保管箱へ分けた
|
|
78
|
+
return_pending --> returned : T-07 返品処理完了 / 仕入先へ引き渡し返品日と数量を仕入記録へ記録した
|
|
79
|
+
returned --> [*] : T-08 返品処理確定 / 返品商品と仕入記録が一致した
|
|
45
80
|
```
|
|
46
81
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
|
50
|
-
|
|
|
51
|
-
| `T-
|
|
52
|
-
| `T-02` | 入荷済み | 検品済み | 検品結果記録 | 検品結果と理由を仕入記録へ記録した | 後続作業中も現在状態を判定できる |
|
|
53
|
-
| `T-03` | 検品済み | 販売可能 | 検品完了 | 結果が合格で在庫を更新し売場へ配置した | 販売グループへ売場商品を引き渡せる |
|
|
54
|
-
| `T-04` | 検品済み | 返品待ち | 検品完了 | 結果が数量違いまたは品質不良で返品保管箱へ分けた | 合格条件と相互排他的に判定する |
|
|
55
|
-
| `T-05` | 販売可能 | 販売済み | 商品引渡し | 会計・販売記録・在庫減算・顧客受領が完了した | 販売記録で顧客への引き渡しを確認する |
|
|
56
|
-
| `T-06` | 返品待ち | 返品済み | 返品処理完了 | 仕入先へ引き渡し返品日と数量を仕入記録へ記録した | 仕入記録を返品経路の正本とする |
|
|
57
|
-
| `T-07` | 販売済み | 終了 | 販売処理確定 | 販売記録と在庫記録が一致した | 店舗在庫としてのライフサイクルを終了する |
|
|
58
|
-
| `T-08` | 返品済み | 終了 | 返品処理確定 | 返品商品と仕入記録が一致した | 店舗の管理対象としてのライフサイクルを終了する |
|
|
82
|
+
| 遷移 ID | 遷移元 | 遷移先 | イベント | 条件 | 補足 |
|
|
83
|
+
| ------- | -------- | -------- | ------------ | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
|
|
84
|
+
| `T-06` | 検品済み | 返品待ち | 検品完了 | 結果が数量違いまたは品質不良で返品保管箱へ分けた | 店番担当は不合格理由と返品保管箱への分離を確認する。分離未完了なら販売対象へ混ぜず、店主代表へ引き継ぐ |
|
|
85
|
+
| `T-07` | 返品待ち | 返品済み | 返品処理完了 | 仕入先へ引き渡し返品日と数量を仕入記録へ記録した | 引渡しだけで記録がなければ返品待ちに留め、返品した店主代表または家族利用者代表が補記する。商品を再度送らない |
|
|
86
|
+
| `T-08` | 返品済み | 終了 | 返品処理確定 | 返品商品と仕入記録が一致した | 店主代表が仕入先へ渡した商品・数量と記録を照合する。不一致なら返品済みに留め、補記・訂正後に確定する |
|
|
@@ -2,37 +2,182 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:sysd-critical-flows-sample
|
|
4
4
|
type: architecture
|
|
5
|
-
status:
|
|
5
|
+
status: ready
|
|
6
|
+
owner: ARC
|
|
6
7
|
rulebook: specdojo:sysd-critical-flows-rulebook
|
|
8
|
+
part_of: []
|
|
9
|
+
based_on: []
|
|
7
10
|
---
|
|
8
11
|
|
|
9
|
-
#
|
|
12
|
+
# 駄菓子屋きぬや 販売管理システム重要フロー
|
|
10
13
|
|
|
11
|
-
## 1.
|
|
14
|
+
## 1. 概要(対象・運用方針)
|
|
12
15
|
|
|
13
|
-
|
|
16
|
+
単一店舗・タブレット1台で、店主代表と家族利用者代表が販売を記録して店番を引き継ぐ。[[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針に対応し、会計要求から受付照合、確定後のレシート保存・印字回復までを扱う。境界を誤ると二重売上や二重請求につながるため、重要フローをこの2件に絞る。商品閲覧、明細入力、在庫分析は対象外とし、追加候補は統合・置換を判断して最大5件に収める。
|
|
14
17
|
|
|
15
|
-
|
|
18
|
+
_ASSUMPTION_: [[specdojo:clis-sample|販売管理 CLI 仕様]] と同じ学習用の現金販売 CLI を扱い、本部売上サービスへの送信、端末への販売控え・レシート保存、USB 直結プリンタへの同期印字を前提とする。通常のタブレット画面、つけ販売、キャッシュレス決済、オフライン販売の継続は本例の対象外。本部の受付照会・重複排除契約を未整備のまま自動再送しない。
|
|
16
19
|
|
|
17
|
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/sysd-critical-flows-rulebook.md`
|
|
20
|
+
公開対象は設計条件と架空の検証ケースであり、実際の顧客名・購入履歴・つけ残高・認証情報を含めない。開発担当 DEV が設計を更新し、技術メンター ARC が境界、同行レビュー担当 QE が期待結果、店番を担う家族利用者代表が操作と引継ぎを確認する。人間の店主代表 PO が業務条件・実運用・公開の最終判断を行う。
|
|
20
21
|
|
|
21
|
-
|
|
22
|
+
設計索引 `kinuya-sysd-index`、取引状態仕様 `kinuya-stsd-sale` は未同梱の架空参照名で、SU-01で追跡する。本例の「会計確定」は本部受付とローカル販売実績の保存が確認できた状態、「照合待ち」は受付の成否を断定できない状態を指す。正式な状態体系は状態仕様へ委譲する。
|
|
22
23
|
|
|
23
|
-
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
24
|
+
## 2. 重要フロー一覧(最大5件)
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
| Flow ID | フロー名 | 事故論点 | 利用者・運用者(Role code) | 放置時の業務影響 | 期待効果・選定理由 |
|
|
27
|
+
| ------- | ------------------------------ | ------------------------ | ------------------------------------ | -------------------------------------------------------------- | ------------------------------------------------------------------ |
|
|
28
|
+
| scf-001 | 会計確定と受付結果の照合 | 冪等・応答欠落・部分成功 | 店番担当、店主代表 PO、開発担当 DEV | 売上の二重計上や受付済み取引の取消で、閉店時の照合負荷が増える | 同じ取引の記録を一件に保つ。閲覧より金銭・引継ぎへの影響が大きい |
|
|
29
|
+
| scf-002 | 確定後のレシート保存と印字回復 | 外部コマンド障害・再実行 | 店番担当、運用助言 OPS、開発担当 DEV | 印字失敗を会計失敗と誤認して再請求し、または紙の控えを失う | 売上と印字の結果を分ける。通常表示と異なり外部機器の結果確認が必要 |
|
|
27
30
|
|
|
28
|
-
|
|
29
|
-
| ------------ | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
|
|
30
|
-
| ドキュメント | 重要フロー | 最小サンプル |
|
|
31
|
-
| 目的 | “読まないと事故る”フローだけを可視化し、実装・テスト・運用の共通理解を作る | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | 最大5フロー(冪等/補償/非同期/順序/整合性/外部I/F障害など)について、境界・永続化点・再実行性・失敗時挙動を図または箇条書きで定義 | 要点のみ記載 |
|
|
31
|
+
## 3. フロー詳細(IDごと)
|
|
33
32
|
|
|
34
|
-
|
|
33
|
+
図の実線は同期の処理・読み書き・要求応答、破線は中断後の照合や人間による後続対応を示す。本例に非同期キューはない。システム内部の処理、端末保存、外部サービス/機器、人間を subgraph で分ける。
|
|
35
34
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
35
|
+
### 3.1. scf-001: 会計確定と受付結果の照合
|
|
36
|
+
|
|
37
|
+
- **目的・起動**: 店番担当が明細・請求額・預かり金を確認して会計を要求したとき、売上を一度だけ確定する。
|
|
38
|
+
- **範囲・入出力**: 入力は取引 ID、確定する明細、預かり金。出力は本部受付結果、ローカル販売実績、釣銭と確定表示、または照合待ち。明細訂正と印字は対象外。
|
|
39
|
+
|
|
40
|
+
```mermaid
|
|
41
|
+
flowchart LR
|
|
42
|
+
subgraph H[人間]
|
|
43
|
+
U[店番担当]
|
|
44
|
+
O[店主代表 PO]
|
|
45
|
+
end
|
|
46
|
+
subgraph C[販売管理CLI内部]
|
|
47
|
+
V[会計入力確認 / 取引ID]
|
|
48
|
+
S[本部登録と結果判定]
|
|
49
|
+
Q[受付照合]
|
|
50
|
+
end
|
|
51
|
+
subgraph L[端末ファイル]
|
|
52
|
+
T[(取引状態 / 同一取引ID)]
|
|
53
|
+
D[(販売控え / 受付結果)]
|
|
54
|
+
end
|
|
55
|
+
subgraph X[外部本部売上サービス]
|
|
56
|
+
A[(受付記録 / 取引IDと受付ID)]
|
|
57
|
+
end
|
|
58
|
+
U -->|会計要求| V
|
|
59
|
+
V -->|明細と送信開始を保存| T
|
|
60
|
+
T --> S
|
|
61
|
+
S -->|同一取引IDで送信| A
|
|
62
|
+
A -->|受付応答| S
|
|
63
|
+
S -->|受付確認後の保存| D
|
|
64
|
+
D -->|保存確認後の確定表示| U
|
|
65
|
+
S -.->|応答欠落なら照合待ち| Q
|
|
66
|
+
O -.->|受付と控えの照合判断| Q
|
|
67
|
+
Q -->|受付状況の照会| A
|
|
68
|
+
A -->|照会結果| Q
|
|
69
|
+
Q -->|受付済みなら控え回復| D
|
|
70
|
+
Q -->|未受付を確認した同じ取引だけ再開| S
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
- **永続化点**: 送信前に取引 ID と送信対象の明細を保存できなければ本部を呼ばない。送信開始を記録した取引は、再起動後も照合対象とする。本部受付記録とローカル販売実績の両方を確認して初めて確定表示を許す。販売実績保存後・表示前の中断では保存済み結果を再表示し、本部へ再登録しない。
|
|
74
|
+
- **整合性・再実行**: 本部と端末の保存は一つのトランザクションにできないため、部分成功を取引 ID で照合して回復する。会計要求後は明細を固定し、端末上で同じ取引の確定処理を重ねない。受付済みなら記録を回復し、未受付と確認できた場合だけ同じ取引の送信を再開する。確認不能なら照合待ちを保つ。排他・保存の実現方法は SU-01、本部契約と再送条件は SU-02 で確定する。
|
|
75
|
+
- **失敗・補償**: 入力不正は送信前に訂正する。応答欠落・保存失敗では明細と受付情報を保持し、店主代表 PO と開発担当 DEV が照合する。受付済み売上を取引ファイルの削除や確定前取消で戻さない。返品・確定後訂正は別の業務判断へ渡す。
|
|
76
|
+
- **受入 KA-01**: 店番担当は「確定」「照合待ち」を見分けられる。同行レビュー担当 QE は同一取引の繰り返し操作でも本部売上一件、端末控え一件になることを確認し、店主代表 PO は照合待ちからの引継ぎを判断できる。
|
|
77
|
+
|
|
78
|
+
### 3.2. scf-002: 確定後のレシート保存と印字回復
|
|
79
|
+
|
|
80
|
+
- **目的・起動**: 会計確定後に取引の控えを印字し、印字だけの失敗を回復できるようにする。
|
|
81
|
+
- **範囲・入出力**: 入力は保存済み販売実績、出力はレシートファイルと印字結果。売上の再送・再会計は含めない。
|
|
82
|
+
|
|
83
|
+
```mermaid
|
|
84
|
+
flowchart LR
|
|
85
|
+
subgraph L[端末ファイル]
|
|
86
|
+
D[(販売控え / 取引ID)]
|
|
87
|
+
R[(レシート / 取引ID)]
|
|
88
|
+
B[(試行開始 / 取引IDと試行識別子)]
|
|
89
|
+
E[(印字結果 / 同じ試行識別子)]
|
|
90
|
+
end
|
|
91
|
+
subgraph C[販売管理CLI内部]
|
|
92
|
+
G[控え生成]
|
|
93
|
+
P[印刷起動準備]
|
|
94
|
+
K[終了報告の検証]
|
|
95
|
+
end
|
|
96
|
+
subgraph X[外部印刷コマンドと機器]
|
|
97
|
+
A[印刷処理 / 対象取引]
|
|
98
|
+
end
|
|
99
|
+
subgraph H[人間]
|
|
100
|
+
U[店番担当]
|
|
101
|
+
V[開発担当 DEV]
|
|
102
|
+
end
|
|
103
|
+
D --> G
|
|
104
|
+
G -->|送信前保存| R
|
|
105
|
+
R --> P
|
|
106
|
+
P -->|起動前に試行開始を保存| B
|
|
107
|
+
B -->|開始保存成功後だけ同期起動| A
|
|
108
|
+
A -->|終了と対象取引の報告| K
|
|
109
|
+
K -->|検証した結果を保存| E
|
|
110
|
+
E -->|会計確定と印字結果を表示| U
|
|
111
|
+
U -.->|紙面と機器を確認| V
|
|
112
|
+
V -.->|復旧後に保存控えだけ再印刷| P
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
- **永続化点・整合性・再実行**: レシートと試行開始を保存してから印刷を起動し、終了後に結果を保存する。試行識別子は呼出し元の記録であり、プリンタの重複排除キーではない。開始記録だけ残る中断、終了報告の不正、結果保存の失敗は結果不明とし、紙面確認前に再印刷しない。印字完了は終了成功と対象取引の完了報告の両方で判定する。
|
|
116
|
+
- **失敗・保持・補償・再開**: レシートまたは開始記録を保存できなければ印刷せず、販売実績を保持して DEV が保存先を復旧する。自動再試行は [[specdojo:ifx-cmd-sample|レシート印刷コマンド連携仕様]] の送信前ビジーと確認できた場合に限り、上限・待機・同時起動制約も同契約へ委ねる。その他の失敗や結果不明は店番担当が紙面を確認し、DEV が復旧する。既に出た紙は取り消せないため、必要な手動再印刷は保存控えだけを使い、会計・本部登録を再実行しない。
|
|
117
|
+
- **受入 KA-02**: 店番担当は印字未完了でも会計が確定済みであること、保持控えと次の手を確認できる。QE は印刷失敗後の回復で売上件数が増えず、結果不明時に自動再印刷されないことを確認する。
|
|
118
|
+
|
|
119
|
+
## 4. 観測性と運用連携
|
|
120
|
+
|
|
121
|
+
### 4.1. 検知と責任
|
|
122
|
+
|
|
123
|
+
外部本部 API には内部 `trace_id` を受け渡す契約が未整備で、USB 印字にも分散 trace の受渡し先がないため、本例では分散 trace を採用しない。代替として下表のキーを用い、CLI がフロー ID、actor、時刻、処理結果、停止段階を記録する。本部との相関契約の確認は SU-02、印字試行記録の保存方式は SU-01 で追跡する。公開ログには明細・顧客情報・認証情報を含めない。
|
|
124
|
+
|
|
125
|
+
| Flow ID | 相関キーと追跡範囲 | 検知条件・閾値の正本 | 実装動作 | 人間の一次対応・照会先 |
|
|
126
|
+
| ------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------- | ----------------------------------------------------------- |
|
|
127
|
+
| scf-001 | 取引 ID → 本部受付 ID → 端末販売実績。受付 ID 未取得時も取引 ID を保持 | 本書「会計確定と受付結果の照合」:一件でも受付不明・保存失敗・重複を検出 | 確定表示と新しい会計を保留し、同じ取引の記録を保持 | 店番担当 → PO が照合、技術調査は DEV → ARC |
|
|
128
|
+
| scf-002 | 取引 ID → 保存レシート → 呼出し元の試行識別子 → 終了報告・紙面確認 | 本書「確定後のレシート保存と印字回復」:一件でも保存失敗・印字未完了・結果不明を検出 | 会計結果を維持し、印字警告と保持先を表示 | 店番担当が紙面確認、DEV が復旧、運用助言 OPS が引継ぎを確認 |
|
|
129
|
+
|
|
130
|
+
上記は本例のイベント条件で、営業時間外の通知先や応答期限は未決である。SU-03を解消するまで常駐監視や無人復旧があるとは扱わない。
|
|
131
|
+
|
|
132
|
+
### 4.2. 管理記録への引渡し
|
|
133
|
+
|
|
134
|
+
| 条件・対象 | 記録種別 | 担当Role code・対応方針 | 報告・判断先 |
|
|
135
|
+
| ------------------------------------------------- | -------------- | -------------------------------------------------- | ------------------------------------------------ |
|
|
136
|
+
| 受付不明、重複、保存失敗、印字未完了(両フロー) | issue | DEV が取引 ID、停止段階、保持状態、業務影響を報告 | PM が課題記録へ接続、PO が照合結果を判断 |
|
|
137
|
+
| 本部契約・復旧手順・通知条件の未整備(SU-01〜03) | risk | PM が受入への影響を記録し、OPS/ARC が補完案を提示 | PO が運用保留または代替手順の採否を判断 |
|
|
138
|
+
| 自動再送・印刷方式の追加変更(両フロー) | change-request | ARC/DEV が条件と費用、検証への影響を提示 | PM が計画へ反映し、PO が採否を判断 |
|
|
139
|
+
| 照合・運用留保・公開可否の結論(両フロー) | decision | PM が PO の結論・根拠・対象差分を保存 | `KIN-DEC-01`(会計)、`KIN-DEC-02`(印字・公開) |
|
|
140
|
+
|
|
141
|
+
## 5. 関連ドキュメント導線(SDI/テスト/運用/DEC)
|
|
142
|
+
|
|
143
|
+
### 5.1. 正本と変更影響
|
|
144
|
+
|
|
145
|
+
架空の参照名はすべて未同梱であり、実在する実装・自動テストとして示すものではない。
|
|
146
|
+
|
|
147
|
+
| Flow ID | 実装・設定の一意な参照先 | 変更時の契約・schema・生成物・CLI・互換性 | 運用・判断への導線 |
|
|
148
|
+
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
|
|
149
|
+
| scf-001 | `kinuya-sysd-index` の会計保存・排他、`kinuya-stsd-sale` の確定・照合待ち、`ifx-api-kinuya-sales.yaml` の受付・照会 | `kinuya-session-schema` と `kinuya-sales-record-schema`、販売控え、[[specdojo:clis-sample\|販売管理 CLI 仕様]] の確定・停止表示。旧控えの照合と未解決取引の再開を維持 | `kinuya-opr-sale-reconciliation`、SU-01/02/03、`KIN-DEC-01` |
|
|
150
|
+
| scf-002 | [[specdojo:ifx-cmd-sample\|レシート印刷コマンド連携仕様]] の `execution`・`error_handling`、呼出し元の保存方式は `kinuya-sysd-index` の印字試行記録 | `kinuya-receipt-format-schema`、生成レシート、CLI の印字警告。既存控えの再印刷と開始記録だけの旧試行の判定を維持 | `kinuya-opr-reprint`、SU-01/03、`KIN-DEC-02` |
|
|
151
|
+
|
|
152
|
+
### 5.2. 検証への引渡し
|
|
153
|
+
|
|
154
|
+
以下は本例内で定義する手動シナリオ ID であり、実行済みの証跡ではない。QE が DEV と試験用受付・印刷先を用意し、架空の取引だけで実施する。内部の保存・表示境界は ITC、外部本部・印刷契約との境界は ETC に分ける。自動テストファイル・コマンド・schema 検査の確定は SU-02 へ渡し、未同梱の CLI を実行可能とは扱わない。
|
|
155
|
+
|
|
156
|
+
| 検証ID / フロー | 実在する確認先・実行方法 | 対象条件 | 期待結果・失敗判定 |
|
|
157
|
+
| ----------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
|
|
158
|
+
| etc-kinuya-cf-01 / scf-001(KA-01) | 本表の手動シナリオ:正常会計後に同じ取引を再要求し、本部・端末を照合 | 同じ取引 ID の繰返し、同時確定要求 | 売上一件・控え一件で pass。二重登録・明細変更のまま再送は fail |
|
|
159
|
+
| etc-kinuya-cf-02 / scf-001(KA-01) | 本表の手動シナリオ:試験用本部で応答を欠落させ、PO/DEV が照合 | 受付済み/未受付/確認不能を個別に用意 | 受付済みは控え回復だけ、未受付は同じ取引で再開、確認不能は保留で pass。照合前再送・取消・新規取引への置換は fail |
|
|
160
|
+
| itc-kinuya-cf-03 / scf-001(KA-01) | 本表の手動シナリオ:各保存点で書込み失敗または停止を注入し、再起動 | 送信前保存、本部受付後の控え保存、控え保存後・表示前 | 送信前保存失敗は本部呼出しゼロ、受付後は照合待ち、保存済みは再表示だけで pass。先行確定・保持消失・再登録は fail |
|
|
161
|
+
| etc-kinuya-cf-04 / scf-002(KA-02) | 本表の手動シナリオ:試験用印刷先の終了・診断・報告を切り替え、店番担当が紙面確認 | 送信前ビジー/送信後失敗/時間切れ/報告欠落・対象不一致 | ビジーだけ契約内で有限再試行。他は警告し紙面確認まで再印刷せず、売上件数不変で pass。契約上限超過・結果不明の自動再印刷は fail |
|
|
162
|
+
| itc-kinuya-cf-05 / scf-002(KA-02) | 本表の手動シナリオ:保存失敗、印字後の中断を注入し、保持記録から復旧 | レシート・試行開始の保存失敗、起動後・結果保存前の中断 | 保存失敗は印刷起動ゼロ、開始記録だけなら結果不明、回復は保存控えのみで pass。会計取消・本部再送・無確認の印字済み判定は fail |
|
|
163
|
+
|
|
164
|
+
### 5.3. 未決事項と後続作業
|
|
165
|
+
|
|
166
|
+
SU は本書内の追跡 ID であり、登録済み課題や Schedule の task ではない。PM は各判断時期までに計画・管理記録へ移し、実 ID を本表へ戻す。
|
|
167
|
+
|
|
168
|
+
| ID / 対象 | 未充足事項・依存とScheduleへの影響 | 作業単位・依存順・担当Role code | 完了条件・判断時期・登録先 |
|
|
169
|
+
| ---------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
|
|
170
|
+
| SU-01 / 両フロー | 索引・状態仕様・保存構造・排他方式が未同梱。実装入力と開始記録の耐中断性が未確定 | ARC/DEV が「正本と変更影響」の未同梱正本を整備 → QE が境界・用語・保存前後のケースを照合 | 実装着手前に正本を接続し、二重確定防止と途中保存の回復方法を説明できること。PM が issue と依存作業を計画 |
|
|
171
|
+
| SU-02 / 両フロー | 本部契約と自動テスト・検査コマンドは未整備。会計受入と自動再送を保留、印字も実機未検証 | SU-01 → ARC/DEV が受付・照会・重複排除と相関契約を定義 → QE が「検証への引渡し」の ITC/ETC 全件を実施 | 会計・印字の受入前に KA-01/02 の結果と検査コマンドを追跡可能にし、PO が採否判断。PM が risk、検証不足を issue へ |
|
|
172
|
+
| SU-03 / 両フロー | 照合・再印刷 OPR、通知先・応答期限が未整備。店番交代時の復旧と運用開始を保留 | SU-01/02 の結果 → OPS/DEV が二つの OPR と通知条件を作成 → 家族利用者代表と QE が保持記録からの引継ぎを確認 | 運用開始前に照会先・紙面確認・再開条件まで到達でき、PO が運用可否を判断。PM が risk/必要な change-request を記録 |
|
|
173
|
+
|
|
174
|
+
### 5.4. 承認対象と公開前条件
|
|
175
|
+
|
|
176
|
+
| 判断対象 | 設計確認担当と合意事項 | 人間の承認責任・確定条件 |
|
|
177
|
+
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
|
|
178
|
+
| scf-001 | ARC/DEV が保存・排他と本部契約、QE が KA-01 と `etc-kinuya-cf-01`・`etc-kinuya-cf-02`・`itc-kinuya-cf-03` の検証結果、PM が SU-01〜03 の影響を提示 | PO が確定・照合待ち・取消の境界を承認。受付不明のまま再送する経路は受入不可 |
|
|
179
|
+
| scf-002 | DEV/QE が KA-02 と `etc-kinuya-cf-04`・`itc-kinuya-cf-05` の検証結果、OPS と家族利用者代表が紙面確認・再印刷の引継ぎを提示 | PO が会計と印字の分離、有限再試行、結果不明時の手動確認を承認 |
|
|
180
|
+
|
|
181
|
+
公開/`ready` 昇格前に ARC が構造・参照、QE が上表の期待結果と実績の区別、OPS が非公開記録の除外と運用導線、PM が SU の解消または留保の影響と判断記録を確認する。PO が対象差分に対する人間の承認を残し、設計例の公開と実運用の可否を別々に判断する。
|
|
182
|
+
|
|
183
|
+
本例は設計文書としての完成例であり、未同梱の契約や手順の存在・実装成功を表さない。人間の判断を得るまで `draft` を維持する。
|