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
|
@@ -1,71 +1,179 @@
|
|
|
1
1
|
# yaml-language-server: $schema=../../../specdojo/schemas/v1/bdd.schema.yaml
|
|
2
2
|
id: specdojo:bdd-sample
|
|
3
3
|
type: data
|
|
4
|
-
title:
|
|
5
|
-
status:
|
|
4
|
+
title: 業務データ辞書(駄菓子屋の販売管理)
|
|
5
|
+
status: ready
|
|
6
6
|
rulebook: specdojo:bdd-rulebook
|
|
7
7
|
supersedes: []
|
|
8
8
|
|
|
9
9
|
entities:
|
|
10
10
|
- logical_name: 商品
|
|
11
11
|
physical_name: product
|
|
12
|
-
description:
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
12
|
+
description: >-
|
|
13
|
+
店舗で販売対象として管理する商品の種類。一個ずつの現物や販売時の明細とは区別する。
|
|
14
|
+
商品・売上記録・売上明細は実装前の業務モデルとして本辞書で定義し、管理単位と関連は [[specdojo:ccd-sample|概念クラス図 サンプル]] に合わせる。
|
|
15
|
+
用語参照は [[specdojo:gl-sample|用語集 在庫・調達]] を対象とする。
|
|
16
|
+
related_terms: [tm-standard-product]
|
|
17
|
+
key_fields: [product_id]
|
|
16
18
|
fields:
|
|
17
|
-
- logical_name:
|
|
18
|
-
physical_name:
|
|
19
|
-
glossary_term_id: tm-product-code
|
|
19
|
+
- logical_name: 商品ID
|
|
20
|
+
physical_name: product_id
|
|
20
21
|
type: string
|
|
21
|
-
description:
|
|
22
|
+
description: 商品名や価格を変更しても同じ商品を追跡するための識別子。商品名をキーにしない。
|
|
22
23
|
constraints:
|
|
23
24
|
required: true
|
|
24
25
|
unique: true
|
|
25
|
-
example:
|
|
26
|
+
example: PRD-001
|
|
26
27
|
- logical_name: 商品名
|
|
27
28
|
physical_name: product_name
|
|
28
29
|
type: string
|
|
29
|
-
|
|
30
|
-
description: おばあちゃんやお客さんが読める商品名
|
|
30
|
+
description: 店主代表と来店客が商品を見分けるための表示名。同名の商品があっても識別は商品IDで行う。
|
|
31
31
|
constraints:
|
|
32
32
|
required: true
|
|
33
33
|
example: うまか棒 たこ焼き味
|
|
34
|
-
- logical_name:
|
|
35
|
-
physical_name:
|
|
36
|
-
type:
|
|
37
|
-
|
|
38
|
-
description: 商品の販売価格(税抜き)
|
|
34
|
+
- logical_name: 標準販売価格
|
|
35
|
+
physical_name: standard_price
|
|
36
|
+
type: money
|
|
37
|
+
description: 現在の商品案内に使う税抜価格。過去の売上明細に残す販売単価とは区別する。
|
|
39
38
|
unit: 円
|
|
40
39
|
constraints:
|
|
41
40
|
required: true
|
|
42
41
|
example: 100
|
|
42
|
+
- logical_name: 発注点
|
|
43
|
+
physical_name: reorder_point
|
|
44
|
+
glossary_term_id: tm-reorder-point
|
|
45
|
+
type: integer
|
|
46
|
+
description: >-
|
|
47
|
+
定番商品で在庫不足判定に使う基準数量。未設定はゼロを意味しない。
|
|
48
|
+
判定と入力不備の扱いは [[specdojo:br-sample|在庫不足判定]] に従う。
|
|
49
|
+
unit: 個
|
|
50
|
+
constraints:
|
|
51
|
+
required: false
|
|
52
|
+
min: 0
|
|
53
|
+
example: 10
|
|
43
54
|
|
|
44
|
-
- logical_name:
|
|
45
|
-
physical_name:
|
|
46
|
-
description:
|
|
47
|
-
|
|
48
|
-
|
|
55
|
+
- logical_name: 売上記録
|
|
56
|
+
physical_name: sale
|
|
57
|
+
description: >-
|
|
58
|
+
一回の店頭販売で確定した会計の管理単位。一件以上の売上明細を持ち、入力途中や取り消した取引は含めない。
|
|
59
|
+
顧客が特定されない現金販売も記録する。顧客の基本情報とつけ残高の台帳は本辞書の対象外とする。
|
|
60
|
+
related_terms: [tm-sales, tm-accounts-receivable]
|
|
61
|
+
key_fields: [sale_id]
|
|
49
62
|
fields:
|
|
50
|
-
- logical_name:
|
|
51
|
-
physical_name:
|
|
63
|
+
- logical_name: 売上ID
|
|
64
|
+
physical_name: sale_id
|
|
52
65
|
type: string
|
|
53
|
-
|
|
54
|
-
description: 支払いを一意に識別するID
|
|
66
|
+
description: 一回の販売を識別し、所属する全明細をまとめて確認するための識別子。
|
|
55
67
|
constraints:
|
|
56
68
|
required: true
|
|
57
69
|
unique: true
|
|
58
|
-
example:
|
|
59
|
-
- logical_name:
|
|
60
|
-
physical_name:
|
|
70
|
+
example: SALE-001
|
|
71
|
+
- logical_name: 売上日時
|
|
72
|
+
physical_name: sold_at
|
|
73
|
+
type: datetime
|
|
74
|
+
description: 販売を確定した時点。入力を開始した時点や外部決済の応答時点とは区別する。
|
|
75
|
+
constraints:
|
|
76
|
+
required: true
|
|
77
|
+
example: "2026-11-08T10:00:00+09:00"
|
|
78
|
+
- logical_name: 合計金額
|
|
79
|
+
physical_name: total_amount
|
|
80
|
+
type: money
|
|
81
|
+
description: >-
|
|
82
|
+
この会計で顧客へ請求する税込金額。預かり金や釣銭、顧客の過去のつけ残高を含めない。
|
|
83
|
+
税額と請求額を確認する操作は [[specdojo:clis-sample|販売管理 CLI 仕様]] に従う。
|
|
84
|
+
unit: 円
|
|
85
|
+
constraints:
|
|
86
|
+
required: true
|
|
87
|
+
example: 108
|
|
88
|
+
- logical_name: 支払方法
|
|
89
|
+
physical_name: payment_method
|
|
61
90
|
type: enum
|
|
62
|
-
description:
|
|
91
|
+
description: 販売時に代金を受領するか、顧客のつけとして後日受領するかを区別する。決済サービスの処理状態とは別の判断軸。
|
|
92
|
+
constraints:
|
|
93
|
+
required: true
|
|
94
|
+
allowed_values_detailed:
|
|
95
|
+
- value: cash
|
|
96
|
+
label: 店頭で現金を受領する
|
|
97
|
+
- value: credit
|
|
98
|
+
label: 顧客のつけとして後日受領する
|
|
99
|
+
example: cash
|
|
100
|
+
- logical_name: 顧客ID
|
|
101
|
+
physical_name: customer_id
|
|
102
|
+
type: string
|
|
103
|
+
description: >-
|
|
104
|
+
購入者として特定した顧客の識別子。一見客の現金販売では省略できる。
|
|
105
|
+
つけ販売では請求先を特定するために必要であり、未設定を現金販売と読み替えない。
|
|
106
|
+
constraints:
|
|
107
|
+
required: false
|
|
108
|
+
example: CUS-001
|
|
109
|
+
|
|
110
|
+
- logical_name: 売上明細
|
|
111
|
+
physical_name: sale_line
|
|
112
|
+
description: >-
|
|
113
|
+
一回の販売に含まれる一行分の商品・単価・数量。売上IDと明細番号の組で識別し、売上記録から独立して管理しない。
|
|
114
|
+
商品IDだけでは同じ販売に複数の行がある場合を識別できないため、キーにはしない。
|
|
115
|
+
key_fields: [sale_id, line_number]
|
|
116
|
+
fields:
|
|
117
|
+
- logical_name: 売上ID
|
|
118
|
+
physical_name: sale_id
|
|
119
|
+
type: string
|
|
120
|
+
description: 所属する売上記録の識別子。同じ売上に属する明細は同じ値を持つ。
|
|
63
121
|
constraints:
|
|
64
122
|
required: true
|
|
123
|
+
example: SALE-001
|
|
124
|
+
- logical_name: 明細番号
|
|
125
|
+
physical_name: line_number
|
|
126
|
+
type: integer
|
|
127
|
+
description: 一回の販売の中で行を識別する番号。他の販売で同じ番号を使ってよい。
|
|
128
|
+
constraints:
|
|
129
|
+
required: true
|
|
130
|
+
min: 1
|
|
131
|
+
example: 1
|
|
132
|
+
- logical_name: 商品ID
|
|
133
|
+
physical_name: product_id
|
|
134
|
+
type: string
|
|
135
|
+
description: この行で販売した商品の識別子。商品名の変更後も販売対象を確認できるようにする。
|
|
136
|
+
constraints:
|
|
137
|
+
required: true
|
|
138
|
+
example: PRD-001
|
|
139
|
+
- logical_name: 販売単価
|
|
140
|
+
physical_name: unit_price
|
|
141
|
+
type: money
|
|
142
|
+
description: この販売で適用した一個あたりの税抜価格。販売後に商品の標準販売価格が変わっても変更しない。
|
|
143
|
+
unit: 円
|
|
144
|
+
constraints:
|
|
145
|
+
required: true
|
|
146
|
+
example: 100
|
|
147
|
+
- logical_name: 販売数量
|
|
148
|
+
physical_name: quantity
|
|
149
|
+
type: integer
|
|
150
|
+
description: この行で販売する商品の個数。販売対象のない行や返品の数量は含めない。
|
|
151
|
+
unit: 個
|
|
152
|
+
constraints:
|
|
153
|
+
required: true
|
|
154
|
+
min: 1
|
|
155
|
+
example: 1
|
|
156
|
+
|
|
157
|
+
- logical_name: 支払い
|
|
158
|
+
physical_name: payment
|
|
159
|
+
description: >-
|
|
160
|
+
決済サービス連携を検討する際に扱う支払い応答の管理単位。店頭販売の売上確定やつけ残高の管理とは区別する。
|
|
161
|
+
応答の識別と受領状況の判断に必要な項目のみ注釈し、通信仕様・応答構造は [[specdojo:ifx-api-sample|決済サービスAPI]] を正本とする。
|
|
162
|
+
schema_ref: docs/ja/specdojo/samples/ifx-api-sample.yaml#/components/schemas/CreatePaymentResponse
|
|
163
|
+
key_fields: [payment_id]
|
|
164
|
+
fields:
|
|
165
|
+
- logical_name: 支払ID
|
|
166
|
+
physical_name: payment_id
|
|
167
|
+
description: 決済サービス側で支払いを識別する番号。店舗の売上IDとは別の識別子として照合に使う。
|
|
168
|
+
- logical_name: 支払ステータス
|
|
169
|
+
physical_name: status
|
|
170
|
+
description: >-
|
|
171
|
+
決済サービスが返す支払いの処理結果。未処理や失敗を支払済みと扱わず、売上の確定とは別に確認する。
|
|
172
|
+
許容値は応答スキーマに合わせ、ここでは業務上の意味を対応付ける。
|
|
65
173
|
allowed_values_detailed:
|
|
66
174
|
- value: PENDING
|
|
67
|
-
label:
|
|
175
|
+
label: 未処理で支払済みを確認できない
|
|
68
176
|
- value: PAID
|
|
69
|
-
label:
|
|
70
|
-
- value:
|
|
71
|
-
label:
|
|
177
|
+
label: 決済サービスで支払済みと確認された
|
|
178
|
+
- value: FAILED
|
|
179
|
+
label: 決済処理に失敗し支払済みを確認できない
|
|
@@ -2,37 +2,103 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:bds-sample
|
|
4
4
|
type: ui
|
|
5
|
-
status:
|
|
5
|
+
status: ready
|
|
6
6
|
rulebook: specdojo:bds-rulebook
|
|
7
|
+
based_on:
|
|
8
|
+
- specdojo:bes-sample
|
|
9
|
+
- specdojo:cdsd-sample
|
|
7
10
|
---
|
|
8
11
|
|
|
9
|
-
#
|
|
12
|
+
# 帳票仕様(週次販売・欠品報告)
|
|
10
13
|
|
|
11
|
-
## 1.
|
|
14
|
+
## 1. 概要
|
|
12
15
|
|
|
13
|
-
|
|
16
|
+
駄菓子屋きぬやの 1 週間分の販売記録と在庫記録から、商品別の販売数・欠品の発生・翌週の補充候補をまとめた報告である。店主代表はこの報告で欠品の傾向を確かめ、翌週の仕入れ数量を判断する。欠品回数の削減の測定にも使う。
|
|
14
17
|
|
|
15
|
-
## 2.
|
|
18
|
+
## 2. 読み手と利用目的
|
|
16
19
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
+
| 読み手 | 利用目的 | 帳票から判断すること |
|
|
21
|
+
| -------------------- | ---------------------------------------------- | -------------------------------------------------- |
|
|
22
|
+
| 店主代表 | 翌週の仕入れ前に、売れ筋と欠品を確かめる | 仕入れ数量を増やす商品、仕入れを見送る商品 |
|
|
23
|
+
| 家族利用者代表 | 店番のときに品切れしやすい商品を知る | 店番中に在庫を確かめる商品、店主代表へ知らせる事項 |
|
|
24
|
+
| 店舗運営アドバイザー | 欠品と記録漏れの傾向から運用の改善点を見つける | 記録の付け方や補充のタイミングの見直しが要る点 |
|
|
20
25
|
|
|
21
|
-
|
|
26
|
+
対象外の用途: つけ残高の確認と会計の締めには使わない。それぞれつけ台帳と、[[specdojo:cdsd-sample|概念データストア定義]] の日次締め記録を見る。
|
|
22
27
|
|
|
23
|
-
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
28
|
+
## 3. 出力の時期と契機
|
|
25
29
|
|
|
26
|
-
|
|
30
|
+
- 契機: 日曜の日次締め記録の確定後に自動で作る。日曜の締めがない週は、日曜 24 時を過ぎて端末が最初に起動したときに作る。店主代表は手動でも作れる。
|
|
31
|
+
- 対象期間: 月曜 0 時から日曜 24 時(日本時間)。休業日があっても変えない。
|
|
32
|
+
- 取りこぼし: 端末を起動しなかった週は、次の起動時に 1 週ずつ作る。
|
|
33
|
+
- 再出力: 同じ週の報告を作り直し、報告を増やさない。作り直す前の報告は残さない。販売数(印を含む)か販売件数の不一致の日が変わり、翌週の報告が作成済みなら、翌週も再出力する。変わらなかった週か作成済みの最新の週で止め、各週の前週比が前週の報告の販売数との差と一致すれば完了とする。
|
|
27
34
|
|
|
28
|
-
|
|
29
|
-
| ------------ | ---------------------------------------------------- | ------------------------------------ |
|
|
30
|
-
| ドキュメント | [帳票仕様](../rulebooks/bds-rulebook.md) | 最小サンプル |
|
|
31
|
-
| 目的 | 業務ユーザー視点の帳票の利用目的や表示項目を定義する | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | 帳票概要、利用目的、表示項目、出力タイミング など | 要点のみ記載 |
|
|
35
|
+
## 4. 出力形式と提供方法
|
|
33
36
|
|
|
34
|
-
|
|
37
|
+
- 形式: タブレットの画面表示と印刷用の PDF。日付は `YYYY-MM-DD`、値は整数。機械で読む形式は出さない。
|
|
38
|
+
- 単位と提供方法: 1 週 1 件。店主代表が報告一覧から開き、印刷は仕入れノートに綴じる。
|
|
39
|
+
- 閲覧範囲: 店主代表と家族利用者代表に限る。店舗運営アドバイザーには店内で印刷を見せる。購入者名・つけ残高は載せない。
|
|
40
|
+
- 保存期間: 欠品回数の年間比較のため 1 年分を残す。
|
|
41
|
+
- 本文構成: 別の rulebook はなく、本書の「表示項目」を正とする。
|
|
35
42
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
43
|
+
## 5. 対象範囲と元にする記録
|
|
44
|
+
|
|
45
|
+
対象は単一店舗の店頭販売とし、つけ販売を含め、取り消した販売を除く。EC、発注、廃棄・値引きは対象外とし、在庫の過不足は月次報告で扱う。店番ノートの手書きの控えは報告から読めないため、例外時に店主代表が照合する資料とする。
|
|
46
|
+
|
|
47
|
+
| 記録 | 用途 | 正本 | 欠けるときの扱い |
|
|
48
|
+
| ------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
|
|
49
|
+
| 日次締め記録 | 営業日の特定、販売件数の照合 | [[specdojo:cdsd-sample\|概念データストア定義]] の日次締め記録の確定した確認版と、その版が参照する日次販売集計 | 締め記録・締め案・販売記録のない日は休業日、確定した版のない日は締め未確定とする。締め記録を読めなければ報告を保留する |
|
|
50
|
+
| 販売記録 | 商品別の販売数 | [[specdojo:cdsd-sample\|概念データストア定義]] の販売記録、[[specdojo:bes-sample\|業務イベント: 店頭の現金会計の確定]] | 締めの販売件数と一致しない日は「集計・算出ルール」の「不完全」「不明」で示し、0 とみなさない |
|
|
51
|
+
| 欠品の記録 | 欠品の発生日と商品 | `bes-stock-out-recorded`(未同梱) | 記録がない週は欠品 0 件とし、「欠品の記録なし」と注記する |
|
|
52
|
+
| 商品台帳 | 商品名と商品区分 | [[specdojo:cdsd-sample\|概念データストア定義]] の商品台帳 | 台帳にない商品は商品コードで表示し、店主代表へ確認を促す |
|
|
53
|
+
| 前週の報告 | 前週からの販売数の増減 | 前週の本報告 | 「集計・算出ルール」の前週比に従う |
|
|
54
|
+
|
|
55
|
+
## 6. 表示項目
|
|
56
|
+
|
|
57
|
+
| No | 区分 | 項目名 | 意味・定義 | 元にする記録 | 記録からの確かめ方 |
|
|
58
|
+
| --- | ------ | ---------------- | ------------------------------------------------------------ | ---------------------------------- | ---------------------------------------------------------------------- |
|
|
59
|
+
| 1 | 見出し | 対象週 | 対象期間の開始日(月曜)と終了日(日曜) | 出力の契機 | 出力を求めた週の月曜と日曜(日本時間)に一致する |
|
|
60
|
+
| 2 | 見出し | 営業日数 | 期間内で日次締め記録の確定した確認版がある日の数 | 日次締め記録 | 確定した確認版の対象日の数と一致する |
|
|
61
|
+
| 3 | 明細 | 商品名 | 期間内に販売数か欠品回数が 1 以上の商品の名前 | 商品台帳、販売記録、欠品の記録 | 販売か欠品の記録がある商品だけが載り、名前が商品台帳と一致する |
|
|
62
|
+
| 4 | 明細 | 販売数 | 期間内に販売した個数。確かめられないときは「不完全」「不明」 | 販売記録、日次締め記録 | 「集計・算出ルール」の締めの版と販売数で数え直した値・印と一致する |
|
|
63
|
+
| 5 | 明細 | 前週比 | 販売数の前週との差(増加は `+`)。出せないときは理由の表示 | 前週の報告 | 今週の販売数から前週の報告の販売数を引いた値と一致する |
|
|
64
|
+
| 6 | 明細 | 欠品回数 | 期間内に欠品を記録した日数 | 欠品の記録 | 欠品の記録がある日付の数と一致する |
|
|
65
|
+
| 7 | 明細 | 補充候補 | 欠品回数が 1 以上の商品に付ける印 | 欠品の記録 | 欠品回数が 1 以上の商品にだけ印がある |
|
|
66
|
+
| 8 | 集計 | 欠品回数の合計 | 全商品の欠品回数の合計 | 欠品の記録 | 明細の欠品回数の合計と一致する |
|
|
67
|
+
| 9 | 注記 | 記録の注意 | 記録の欠け・不一致・締め未確定、前週比を出せない理由 | 「対象範囲と元にする記録」の各記録 | 「対象範囲と元にする記録」と「例外と注意事項」に該当する事項だけが載る |
|
|
68
|
+
| 10 | 注記 | 参照した締めの版 | 日ごとに使った日次締め記録の確認版(ない日は「なし」) | 日次締め記録 | 出力時点で確定していた最新の確認版と一致する |
|
|
69
|
+
|
|
70
|
+
並び順は販売数の多い順、同数は商品名の五十音順とする。「不完全」は数値で並べ、「不明」は数値を持つ商品の後に五十音順で並べる。
|
|
71
|
+
|
|
72
|
+
## 7. 集計・算出ルール
|
|
73
|
+
|
|
74
|
+
- 期間への割り当て: 販売記録の会計確定日時を日本時間で判定する。
|
|
75
|
+
- 営業日: 日次締め記録の確定した確認版がある日とする。締め案だけの日は締め未確定とし、数えない。確定した締めの販売件数が 0 で販売記録もない日は販売 0 の営業日とし、注記しない。
|
|
76
|
+
- 締めの版: 各日について、出力時点で PO が確定した最新の確認版を使い、その版の日次販売集計の販売集合(売上 ID の集合)を基準時点の状態で合計する。基準時点の後の訂正は、新しい確認版の確定まで含めない。同じ版からの再出力は同じ値になる。確定した版がない日は出力時点の販売記録で数える。再出力では前回の値を引き継がず数え直す。
|
|
77
|
+
- 販売数: 販売明細の数量を商品ごとに合計し、取り消した販売を除く。版の販売件数と、その販売集合のうち読める売上の件数が一致しない日があれば、その週の合計に「不完全」と付け、販売記録がない商品は「不明」とする。
|
|
78
|
+
- 欠品回数: 同じ日の同じ商品の欠品は 1 回と数える。
|
|
79
|
+
- 前週比: 前週の報告にない商品は前週を 0 とする。初回は「前週なし」とする。前週の報告がない・読めない場合、今週か前週が「不完全」「不明」の場合、前週に販売件数の不一致の日があり前週の明細にない商品は「比較不可」とし、差を出さない。
|
|
80
|
+
- 補充候補: 欠品回数が 1 以上の商品に印を付け、仕入れ数量は算出しない。
|
|
81
|
+
- 端数・割合: 値は整数で端数は出ない。分母を定めていないため割合は出さない。
|
|
82
|
+
|
|
83
|
+
## 8. 例外と注意事項
|
|
84
|
+
|
|
85
|
+
| 状況 | 報告の扱い | 次の手 |
|
|
86
|
+
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
|
|
87
|
+
| 期間内に販売記録が 1 件もない | 締めの販売件数がすべて 0 なら欠品の商品を販売数 0 で載せ、なければ「明細なし」。1 以上の日があれば「不明」とする | 店主代表が締め記録と照合し、記録漏れなら DEV へ知らせる |
|
|
88
|
+
| 締め記録・締め案・販売記録がない(全休の週) | 見出しに「休業週」、営業日数 0 と表示し、欠品の商品だけを販売数 0 で載せる | 店主代表が休業の予定と照合し、合わなければ DEV へ知らせる |
|
|
89
|
+
| 確定した締めがない日に販売記録か締め案がある | 販売数に含め、記録の注意に「締め未確定」と日付を載せる。全日がそうなら見出しに「締め未確定」と表示する | 店主代表が締めを確定し、再出力する |
|
|
90
|
+
| 締めの販売件数と販売記録が一致しない日がある | 記録の注意に日付と両方の件数を載せる | 店主代表がノートの控えと照合し、記録を直して再出力する |
|
|
91
|
+
| 締めの確定後に販売記録の訂正・追加がある | 記録の注意に日付と「締め後の訂正あり」を載せる | 店主代表が新しい確認版を確定し、再出力する |
|
|
92
|
+
| 前週の報告がない・読めない | 記録の注意に理由を載せる | DEV が前週を再出力し、続けて本週を再出力する |
|
|
93
|
+
| 日次締め記録を読めない・自動作成が失敗した | 報告を作らず、締め記録を読めないときは一覧に「保留」と表示する | DEV が原因を解消し、再出力する |
|
|
94
|
+
| 日曜の締めの前に手動で出力した | 見出しに「締め前」と表示する | 仕入れ判断には締めの後に再出力した報告を使う |
|
|
95
|
+
|
|
96
|
+
## 9. メモ / 将来課題
|
|
97
|
+
|
|
98
|
+
| 項目 | 未整備事項と影響 |
|
|
99
|
+
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
100
|
+
| 根拠の業務イベント | つけ販売の確定と欠品の記録(`bes-stock-out-recorded`)が未同梱で `based_on` に接続していない。境界を確かめるまで全面受入はせず、限定受入では欠品回数と補充候補を参考表示とし、仕入れ数量の根拠にしない |
|
|
101
|
+
| 補充候補の基準 | `_UNDECIDED_`: 1 回でも候補とするか 2 回以上に絞るか。初回の報告を見て決め、決まるまでは 1 回以上とする |
|
|
102
|
+
| 欠品削減の測定 | 欠品回数の月間 50% 削減の判定に要る月間の集計は含めない。月次報告の帳票仕様で本報告を元にする記録とする |
|
|
103
|
+
| 上位の索引 | `bds-index` が未作成で、時刻の基準や閲覧範囲などの共通事項を本書に書いている。索引を作ったら本書は差分だけにする |
|
|
104
|
+
| 本書の変更 | 表示項目・算出ルール・契機を変えると、定期処理、過去の週の再出力(「出力の時期と契機」)、前週比、綴じた報告との比較に影響する。反映後に直近の週を再出力し、前週比を照合する |
|
|
@@ -4,35 +4,57 @@ specdojo:
|
|
|
4
4
|
type: requirement
|
|
5
5
|
status: draft
|
|
6
6
|
rulebook: specdojo:bes-index-rulebook
|
|
7
|
+
based_on:
|
|
8
|
+
- specdojo:cdfd-overview-sample
|
|
9
|
+
supersedes: []
|
|
7
10
|
---
|
|
8
11
|
|
|
9
|
-
#
|
|
12
|
+
# 業務イベント一覧: 駄菓子屋きぬや販売管理
|
|
10
13
|
|
|
11
|
-
|
|
14
|
+
駄菓子屋きぬやの店舗運営で、各プロセス領域を起動する業務上の出来事を一覧で定義する。対象は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の「プロセス領域」に挙げた仕入・販売・在庫・顧客・締めの 10 領域の起点イベントであり、領域 ID・領域名・起点イベントの文言は同書を正本とする。
|
|
12
15
|
|
|
13
|
-
|
|
16
|
+
販売・入荷・つけをいつ記録するかを揃え、購入の申し出と会計確定、納品と検品後の入荷記録を区別して記録漏れや二重計上を防ぐ。BPS・UI・テスト仕様は本一覧の行を出来事の単位とする。受けた後の手順は BPS、金額計算は [[specdojo:br-sample|販売金額計算の業務ルール]]、取引の状態は状態定義、事実データの値・構文・構造はデータモデル・schema に委ねる。
|
|
14
17
|
|
|
15
|
-
|
|
18
|
+
_ASSUMPTION_: 事実データは、上位文書の「データストア」の記録から発生時点で観測できる情報を概念名で挙げた。
|
|
16
19
|
|
|
17
|
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/bes-index-rulebook.md`
|
|
20
|
+
## 1. 業務イベント一覧
|
|
20
21
|
|
|
21
|
-
|
|
22
|
+
<!-- prettier-ignore -->
|
|
23
|
+
| イベントID | イベント名 | 起点領域 | 何が起きたか | いつ | 誰が/何が | 発生条件 | 事実データ |
|
|
24
|
+
| --- | --- | --- | --- | --- | --- | --- | --- |
|
|
25
|
+
| `bes-restock-requested` | 在庫から補充依頼を受けた | `P-01` | 補充判断で決まった補充対象と数量が、仕入計画へ渡された。 | 仕入計画が補充依頼を受けた時点。発注の時点ではない。 | 店主代表 | 補充対象の商品と数量が特定されている。 | 商品、補充数量、依頼時点 |
|
|
26
|
+
| `bes-goods-delivered` | 仕入先から商品が納品された | `P-02` | 発注した商品が店に届いた。 | 店番担当が納品を受け取った時点。検品の完了時点ではない。 | 仕入先が届け、店番担当が受け取る | 対応する発注がある(発注のない納品は「未決事項」)。 | 仕入先、商品、納品数量、受取時点、受取担当 |
|
|
27
|
+
| `bes-cash-sale-confirmed` | 顧客が商品を購入した | `P-03` | 顧客が店頭で商品を現金で購入した。 | 販売管理システムが会計確定を記録した時点。控えの印字は待たない。 | 店番担当が現金受領を確認し、販売管理システムが確定を記録する | 現金取引で明細・請求金額を確認し、受領金額が請求金額以上で、未確定の会計である。つけは `bes-credit-sale-requested`。 | 取引番号、商品明細、請求金額、受領金額、釣銭金額、支払区分、会計確定時点、確定担当 |
|
|
28
|
+
| `bes-credit-sale-requested` | 常連客がつけでの購入を依頼した | `P-04` | 登録済みの常連客が、代金を後払いにする購入を申し出た。 | 上限内は店番担当が申し出を受けた時点(超過は「未決事項」)。 | 常連客 | 申し出た人が顧客台帳に登録されている。 | 顧客、商品、数量、請求金額、申出時点、受付担当 |
|
|
29
|
+
| `bes-stock-movement-recorded` | 販売または入荷が記録された | `P-05` | 在庫を増減させる販売または入荷の記録が成立した。 | 販売の確定、または検品後の入荷の記録が成立した時点。 | 販売・入荷の記録を受けた販売管理システム | 販売の確定、または検品済みの入荷のどちらかである。 | 商品、増減の区分(販売・入荷)、数量、記録時点、元の取引 |
|
|
30
|
+
| `bes-stock-below-threshold` | 在庫が補充基準を下回った | `P-06` | 商品の現在庫が、商品台帳の補充基準より少なくなった。 | 在庫の記録で基準を下回った時点。棚を目で見た時点ではない。 | 在庫の記録を保つ販売管理システム | 対象の商品に補充基準が定められている。 | 商品、現在庫、補充基準、下回った時点 |
|
|
31
|
+
| `bes-credit-use-requested` | 常連客がつけの利用を申し出た | `P-07` | まだ登録のない客が、つけを使いたいと申し出た。 | 店主代表が申し出を受けた時点。登録の完了時点ではない。 | 客 | 申し出た人が顧客台帳に登録されていない。 | 申出者の連絡先、希望するつけ上限、申出時点 |
|
|
32
|
+
| `bes-credit-payment-offered` | 常連客がつけの支払を申し出た | `P-08` | 常連客が、つけ残高の全部または一部を払うと申し出た。 | 店主代表が申し出を受けた時点。残高の更新時点ではない。 | 常連客 | 申し出た客につけ残高がある。 | 顧客、支払額、申出時点、受付担当 |
|
|
33
|
+
| `bes-store-closed` | 閉店した | `P-09` | その日の営業が終わった。 | 店主代表が閉店とした時点。閉店時刻を過ぎても営業中なら発生しない。 | 店主代表 | その日に営業している。 | 営業日、閉店時点 |
|
|
34
|
+
| `bes-month-end-closed` | 月末の締めが確定した | `P-10` | 対象月の締めが確定した。 | 店主代表が対象月の締めを確定した時点。暦上の月末到来だけでは発生しない。 | 店主代表 | 対象月が特定されている(日次締めとの関係は「未決事項」)。 | 対象月、締めの確定時点 |
|
|
22
35
|
|
|
23
|
-
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
36
|
+
## 2. 個別仕様への詳細化
|
|
25
37
|
|
|
26
|
-
|
|
38
|
+
| イベントID | 個別仕様 | 詳細化する範囲 | 詳細化の理由 |
|
|
39
|
+
| --------------------------- | ----------------------------------------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------- |
|
|
40
|
+
| `bes-cash-sale-confirmed` | [[specdojo:bes-sample\|業務イベント: 店頭の現金会計の確定]] | 行の全体 | 明細追加・金額確認・再表示・印字と確定の境界、一取引での発生回数と明細の対応を詳細化する |
|
|
41
|
+
| `bes-credit-sale-requested` | `bes-credit-sale-over-limit`(未作成) | つけ上限を超える申し出を受けた場合 | 上限超過時に、申し出の受付と店主代表の承認のどちらで成立するかが割れる |
|
|
27
42
|
|
|
28
|
-
|
|
29
|
-
| ------------ | ------------------------------------------------------------------------------ | ------------------------------------ |
|
|
30
|
-
| ドキュメント | [業務イベント / 業務イベント仕様 全体構成](../rulebooks/bes-index-rulebook.md) | 最小サンプル |
|
|
31
|
-
| 目的 | 業務上で発生する主要なイベントを一覧で定義する | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | イベントID、イベント名、何が起きたか、いつ、発生条件 など | 要点のみ記載 |
|
|
43
|
+
## 3. 未決事項と承認条件
|
|
33
44
|
|
|
34
|
-
|
|
45
|
+
### 3.1. 未決事項
|
|
35
46
|
|
|
36
|
-
|
|
37
|
-
|
|
|
38
|
-
|
|
|
47
|
+
<!-- prettier-ignore -->
|
|
48
|
+
| 論点 | 影響と当面の扱い |
|
|
49
|
+
| --- | --- |
|
|
50
|
+
| _UNDECIDED_: 発注のない納品を `bes-goods-delivered` に含めるか | 現定義では発生しない。決まるまで発注外納品の BPS・UI・テストを確定しない。決まったら `bes-goods-delivered` の発生条件を直すか、上位 CDFD と照合して行を足す |
|
|
51
|
+
| _UNDECIDED_: つけ上限超過は受付と店主代表の承認のどちらで成立するか | 上限内は一覧の定義で扱う。超過の経路は個別仕様(「個別仕様への詳細化」)で決まるまで確定入力にしない。決まったら `bes-credit-sale-requested` の行と、つけ販売の BPS・BR・UI・テストの期待結果を直す |
|
|
52
|
+
| _ASSUMPTION_: 閉店は店主代表の宣言時点とした。月末の締めと最終営業日の日次締めの関係は未確認 | 日次・月次の起動時点が変わり得る。営業延長日と月末休業日の例で決まったら、上位 CDFD と `bes-store-closed`・`bes-month-end-closed` の行を直す |
|
|
53
|
+
| _ASSUMPTION_: 事実データが販売記録・在庫記録・つけ台帳のデータモデルと未照合 | 照合まで事実データ列を確定入力にしない。発生時点で情報がそろわない、または発生後の結果を含む行は直す |
|
|
54
|
+
| 一覧の範囲は 10 領域の起点イベントだけとした | 値引き・取消・返品は領域内部の出来事として含めない(業務の対象外ではない)。起点を足すなら先に上位 CDFD を見直す |
|
|
55
|
+
|
|
56
|
+
### 3.2. 確定入力として扱う条件
|
|
57
|
+
|
|
58
|
+
- 上位 CDFD の 10 領域に有効な 10 行が対応し、出典のない行・空欄、イベント ID の形式違反・重複(廃止行を含む)が 0 件である。
|
|
59
|
+
- 現金受領不足・明細確認中は現金会計の確定なし、確定後の再表示・再印字では追加の確定なしと判定できる。納品受取と検品後の入荷記録、閉店宣言と閉店時刻到来も区別できる。個別の判定例は個別 BES に委ねる。
|
|
60
|
+
- 「個別仕様への詳細化」の対応範囲と個別 BES からの参照が一致する。「未決事項」の範囲は解消まで除く。
|
|
@@ -2,37 +2,86 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:bes-sample
|
|
4
4
|
type: requirement
|
|
5
|
-
status:
|
|
5
|
+
status: ready
|
|
6
6
|
rulebook: specdojo:bes-rulebook
|
|
7
|
+
based_on: []
|
|
8
|
+
supersedes: []
|
|
7
9
|
---
|
|
8
10
|
|
|
9
|
-
#
|
|
11
|
+
# 業務イベント: 店頭の現金会計の確定
|
|
10
12
|
|
|
11
|
-
|
|
13
|
+
駄菓子屋きぬやで、入力途中の取引や金額の確認を販売実績と混同しないため、一取引の現金会計が確定した事実を定義する。利用できる基準は、「発生条件」の場面から発生有無と回数を決められ、「事実データ」から同じ取引の明細と金額を対応付けられることである。
|
|
12
14
|
|
|
13
|
-
|
|
15
|
+
_ASSUMPTION_: 単一店舗・一台のタブレットでの店頭現金販売を扱う。つけ販売、返品、取消、日次締めは別の出来事とする。
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
本書は [[specdojo:bes-index-sample|業務イベント一覧]] の `bes-cash-sale-confirmed`(「顧客が商品を購入した」、起点領域 `P-03`)の購入の成立を、現金会計の確定として詳細化する。
|
|
16
18
|
|
|
17
|
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/bes-rulebook.md`
|
|
19
|
+
## 1. 何が起きたか
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
一つの取引について、店番担当が購入明細・請求金額・現金の受領を確認し、会計を確定した。
|
|
22
22
|
|
|
23
|
-
-
|
|
24
|
-
-
|
|
23
|
+
- 一取引の確定につき一回発生する。明細ごとには発生しない。
|
|
24
|
+
- 商品の追加、数量の修正、合計金額の表示だけでは発生しない。
|
|
25
|
+
- 控えの印字や在庫への反映は、この出来事の後の業務である。
|
|
25
26
|
|
|
26
|
-
##
|
|
27
|
+
## 2. いつ
|
|
27
28
|
|
|
28
|
-
|
|
29
|
-
| ------------ | --------------------------------------------------------------- | ------------------------------------ |
|
|
30
|
-
| ドキュメント | [業務イベント / 業務イベント仕様](../rulebooks/bes-rulebook.md) | 最小サンプル |
|
|
31
|
-
| 目的 | 業務上で発生する主要なイベントを個別に定義する | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | イベントID、イベント名、何が起きたか、いつ、発生条件 など | 要点のみ記載 |
|
|
29
|
+
販売管理システムが対象取引の会計確定を記録した時点を発生時点とする。顧客が現金を渡した時刻、画面の参照や控えの再印字の時刻、日次締めの確定時刻では置き換えない。
|
|
33
30
|
|
|
34
|
-
##
|
|
31
|
+
## 3. 誰が/何が
|
|
35
32
|
|
|
36
|
-
|
|
|
37
|
-
| -------------- |
|
|
38
|
-
|
|
|
33
|
+
| 起点区分 | 確定を要求する主体 | 確定を記録する主体 | 主体ごとの責務 |
|
|
34
|
+
| -------------- | ------------------ | ------------------ | -------------------------------------------------------- |
|
|
35
|
+
| 店主による店番 | 店主代表 | 販売管理システム | 明細・請求金額・現金の受領・釣銭を確認して確定を要求する |
|
|
36
|
+
| 家族による店番 | 家族利用者代表 | 販売管理システム | 店主代表と同じ確認を行い、確定を要求する |
|
|
37
|
+
|
|
38
|
+
- 二つの役割を本書では「店番担当」と呼ぶ。誰が店番しても発生境界は同じである。
|
|
39
|
+
- 顧客は現金を渡す主体であり、システムへ会計確定を要求する主体ではない。
|
|
40
|
+
|
|
41
|
+
## 4. 発生条件
|
|
42
|
+
|
|
43
|
+
次の条件がすべて成立したときに発生する。
|
|
44
|
+
|
|
45
|
+
1. 店頭の現金取引で、会計がまだ確定していない(取引状態 `payment_status` が `unconfirmed`。仮置き ID `cdsd-order-status`)。
|
|
46
|
+
2. 一件以上の商品明細があり、店番担当が購入内容と請求金額を確認している。
|
|
47
|
+
3. 受領金額が請求金額以上で、店番担当が受領と釣銭を確認している。
|
|
48
|
+
4. 店番担当の確定要求により、会計確定が記録された。
|
|
49
|
+
|
|
50
|
+
金額計算と端数処理は [[specdojo:br-sample|販売金額計算の業務ルールサンプル]]、確定後の控え・在庫反映と事実の照合・復旧は販売プロセス(仮置き ID `bps-sales-order-flow`)へ委ねる。
|
|
51
|
+
|
|
52
|
+
| 場面 | 発生有無・回数 | 判断根拠 |
|
|
53
|
+
| ---------------------------------------- | ---------------------- | -------------------------------- |
|
|
54
|
+
| 複数の商品明細を一つの取引として確定 | 一回 | 単位は取引の確定である |
|
|
55
|
+
| 受領金額が請求金額未満 | 発生しない | 条件 3 を満たさない |
|
|
56
|
+
| 現金の受領後、確定前に入力を見直し中 | 発生しない | 確定の記録がない |
|
|
57
|
+
| 確定の記録が成立したか分からないまま停止 | 発生しない | 受領だけから発生済みと推定しない |
|
|
58
|
+
| 確定済み取引の控えを再印字 | 新たには発生しない | 同じ取引の参照である |
|
|
59
|
+
| 確定後に控えの印字が失敗 | 確定時の一回のまま | 印字は確定後の処理である |
|
|
60
|
+
| つけでの購入を受け付ける | 本イベントは発生しない | 現金取引の範囲外である |
|
|
61
|
+
|
|
62
|
+
_UNDECIDED_: 仮置き ID の文書は未作成で、状態値と項目名を正本と照合できていない。当面は本書の条件と場面の表で判定し、正本が定まったら条件 1 と「事実データ」の項目を見直す。
|
|
63
|
+
|
|
64
|
+
## 5. 事実データ
|
|
65
|
+
|
|
66
|
+
型・形式・構造は販売記録のデータモデル(仮置き ID `bdd-sales-record`)へ委ねる。
|
|
67
|
+
|
|
68
|
+
| 項目 | 業務上の意味 | 必要になる条件 |
|
|
69
|
+
| ------------ | ------------------------------------------ | ---------------------------- |
|
|
70
|
+
| 取引番号 | 確定した一つの販売取引を識別する | 常に必要 |
|
|
71
|
+
| 会計確定時点 | 「いつ」で定義した成立時点 | 常に必要 |
|
|
72
|
+
| 確定担当 | 確定を要求した実際の店番担当 | 常に必要 |
|
|
73
|
+
| 商品明細 | 商品・数量と、会計確定時点の販売金額の内訳 | 常に必要 |
|
|
74
|
+
| 請求金額 | 顧客に請求した金額 | 常に必要 |
|
|
75
|
+
| 受領金額 | 店番担当が受領を確認した現金の額 | 常に必要 |
|
|
76
|
+
| 釣銭金額 | 当該会計で確認した釣銭の額 | 常に必要。釣銭なしも識別する |
|
|
77
|
+
| 支払区分 | 現金会計であることを示す情報 | 常に必要 |
|
|
78
|
+
|
|
79
|
+
### 5.1. 取引との対応の確認例
|
|
80
|
+
|
|
81
|
+
取引番号で会計確定と明細・金額を対応付ける。一括・並列の要求は扱わないため、要求を束ねる識別子は持たない。
|
|
82
|
+
|
|
83
|
+
| 確認対象 | 確認する事実 |
|
|
84
|
+
| ---------------------------------- | ---------------------------------------------------------------- |
|
|
85
|
+
| 取引 `TX-A` に二つの商品明細がある | 一回の確定に両明細が含まれ、どちらも `TX-A` の請求金額へたどれる |
|
|
86
|
+
| 続けて別の取引 `TX-B` を確定する | 明細・受領金額・釣銭金額が混ざらず、確定はそれぞれ一回となる |
|
|
87
|
+
| `TX-A` の控えを再印字する | 同じ取引番号を参照し、新しい会計確定として数えない |
|