specdojo 0.7.0 → 0.8.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 +3 -2
- package/CHANGELOG.md +153 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/init.js +5 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- 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 +153 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +48 -25
- 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/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +188 -36
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +6 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +4 -4
- package/dist/exec/run/schedule-prepare.js +201 -59
- package/dist/exec/run/schedule-task.js +129 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- 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 +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- 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 +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- 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 +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +43 -9
- 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 +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- 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 +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- 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.js +142 -15
- package/dist/shared/grade-result.js +17 -1
- 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 +39 -21
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -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 +47 -16
- package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- 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 +70 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
- 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 +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- 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/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +79 -64
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- 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 +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -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/cdsd-sample.md +89 -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 +132 -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/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-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/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -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 +164 -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/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/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 +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -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/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -4,35 +4,104 @@ specdojo:
|
|
|
4
4
|
type: data
|
|
5
5
|
status: draft
|
|
6
6
|
rulebook: specdojo:cdsd-rulebook
|
|
7
|
+
based_on:
|
|
8
|
+
- specdojo:cdfd-overview-sample
|
|
9
|
+
- specdojo:bdd-sample
|
|
10
|
+
- specdojo:ccd-sample
|
|
7
11
|
---
|
|
8
12
|
|
|
9
|
-
#
|
|
13
|
+
# 概念データストア定義(駄菓子屋きぬやの販売と締め)
|
|
10
14
|
|
|
11
|
-
## 1.
|
|
15
|
+
## 1. 概要
|
|
12
16
|
|
|
13
|
-
|
|
17
|
+
店主代表と家族の店番担当が、販売の記録漏れと締めの差異を同じ根拠で確認できるよう、販売から日次・月次の確認に使う情報の管理境界を定める。販売明細と締めの判断を同じ欄で上書きすると、差異の発生元と誰が確認したかを追えなくなるため、取引の正本、再生成する集計、人が確定する記録を分ける。
|
|
14
18
|
|
|
15
|
-
|
|
19
|
+
BA は店主代表と対象・用途を確認し、ARC・DEV は更新元と参照先を設計へ接続する。QE は一覧と検証対象の対応を確認する。店主代表は PO として業務範囲と公開可否を最終判断する。店番担当は OPS として日々の入力・照合を担い、仕様上の問い合わせは BA、記録の不整合・再生成の相談は OPS が受ける。
|
|
16
20
|
|
|
17
|
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/cdsd-rulebook.md`
|
|
21
|
+
### 1.1. 対象と隣接領域
|
|
20
22
|
|
|
21
|
-
|
|
23
|
+
範囲の根拠は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] の販売・締め領域である。販売に必要な商品台帳と、締めの内訳確認に使う日次販売集計を含む。
|
|
22
24
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
+
| 区分 | 管理境界と理由 |
|
|
26
|
+
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------- |
|
|
27
|
+
| 本書で定義 | 商品台帳、販売記録、日次販売集計、日次締め記録、月次報告の5単位。取引の入力から締めの判断までを追う |
|
|
28
|
+
| 隣接領域から参照 | 顧客台帳・つけ台帳は購入者と未収金、仕入記録・在庫記録は締めの差異確認に利用する。各台帳の更新責務は顧客・仕入・在庫領域へ委ねる |
|
|
29
|
+
| 対象外 | 売場棚の現物管理、EC、複数店舗、本格会計、仕入先との通信。全体概要の領域分担に従い、販売・締めの記録と混在させない |
|
|
25
30
|
|
|
26
|
-
|
|
31
|
+
項目の意味は [[specdojo:bdd-sample|販売管理の業務データ辞書]]、識別と関連は [[specdojo:ccd-sample|概念クラス図]] を参照する。以下の数値は照合方法を示す例示データであり、実績や検証成功の記録ではない。
|
|
27
32
|
|
|
28
|
-
|
|
29
|
-
| ------------ | ----------------------------------------------------------------------- | ------------------------------------ |
|
|
30
|
-
| ドキュメント | [業務データ辞書 / 概念データストア定義](../rulebooks/cdsd-rulebook.md) | 最小サンプル |
|
|
31
|
-
| 目的 | 概念データストア(情報の保管場所)を一覧で定義する | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | データストア名、対応プロセス、内容、更新タイミング、粒度、主な用途 など | 要点のみ記載 |
|
|
33
|
+
## 2. 概念データストア一覧
|
|
33
34
|
|
|
34
|
-
|
|
35
|
+
| データストア名 | 対応プロセス | 主な内容 | 更新タイミング | 粒度 | 主な用途 |
|
|
36
|
+
| -------------- | ------------------------------ | -------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------- |
|
|
37
|
+
| 商品台帳 | 店頭販売、つけ販売、月次見直し | 商品の識別、表示名、標準販売価格、補充基準 | 随時(商品の登録・売価や補充基準の承認済み変更時) | 店舗で扱う商品種類毎。現物一個毎ではない | 店番担当が販売対象と現在の価格を確認し、店主代表が売価・補充基準を見直す |
|
|
38
|
+
| 販売記録 | 店頭販売、つけ販売、日次締め | 確定した売上記録と所属する売上明細、支払方法、購入者の参照 | イベント(会計確定時・承認済み訂正時) | 売上ID毎。明細は売上IDと明細番号の組で識別 | 店番担当が会計の記録漏れを確認し、店主代表が現金販売とつけ販売を区別する |
|
|
39
|
+
| 日次販売集計 | 日次締め | 対象日の販売件数、請求金額合計、支払方法別内訳、集計の基準時点 | 日次(閉店後)、イベント(対象日の販売訂正後) | 店舗・対象日・基準時点毎 | 店番担当が元の販売を辿って集計漏れ・重複を調べ、店主代表が締めの販売額を確認する |
|
|
40
|
+
| 日次締め記録 | 日次締め、月次見直し | 日次販売集計の参照、仕入額・在庫差異・つけ残高の確認結果、判断理由、確認者 | 日次(閉店時の照合後)、イベント(締めの再確認時) | 店舗・対象日・確認版毎 | 店主代表が差異と対応を確認し、その日の締めを確定できるか判断する |
|
|
41
|
+
| 月次報告 | 月次見直し | 対象月の売上・欠品・つけ残高の根拠、比較結果、見直しの判断と担当 | 月次(月末の締め確認後)、イベント(根拠の訂正に伴う再確認時) | 店舗・対象月・報告版毎 | 店主代表が売価・補充基準・つけ上限の見直しを判断し、家族の店番担当へ申し送る |
|
|
35
42
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
43
|
+
販売記録の「売上記録」は辞書の会計単位、「売上明細」はその内訳に対応する。明細用ファイルが別でも独立した管理単位には分割しない。日次販売集計は販売記録から作る参照ビューであり、全体概要の「日次締め記録」とは更新責務が異なるため区別する。
|
|
44
|
+
|
|
45
|
+
## 3. 正本区分と更新責務
|
|
46
|
+
|
|
47
|
+
### 3.1. 生成元と利用制約
|
|
48
|
+
|
|
49
|
+
更新・確認担当は業務上の責務を示す。システムによる保存・集計を用いる場合も、入力内容の責任は担当 Role code に残る。
|
|
50
|
+
|
|
51
|
+
| データストア名 | 正本区分・生成元 | 更新契機・扱いの制約 | 更新担当 | 確認担当 |
|
|
52
|
+
| -------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------- | -------- |
|
|
53
|
+
| 商品台帳 | 商品種類と現在の販売条件の正本。店主代表の承認内容を反映 | 承認後に OPS が更新する。価格変更を過去の販売単価へ遡及させない | OPS | PO、BA |
|
|
54
|
+
| 販売記録 | 確定した会計と明細の正本。販売プロセスの確定結果を保存 | 入力途中・取消済み取引を含めない。訂正は元の売上を特定し、PO が承認した販売側の訂正手順で行う | OPS | PO、QE |
|
|
55
|
+
| 日次販売集計 | 販売記録から再生成する派生情報 | 対象日と基準時点の販売集合を記録して再生成する。集計値を直接訂正せず、元の販売記録を確認する | OPS | QE |
|
|
56
|
+
| 日次締め記録 | PO が確定する日ごとの照合・判断の正本。販売集計と隣接台帳を根拠に作成 | 参照した版・基準時点を固定する。元データの訂正後は再確認し、以前の判断を黙って上書きしない | OPS(案作成)、PO(確定) | BA、QE |
|
|
57
|
+
| 月次報告 | PO が確定する月ごとの判断記録。日次締め記録と隣接台帳の確認結果を参照 | 根拠となる対象日と版を識別する。報告の見直し案から商品台帳やつけ上限へ自動的に書き戻さず、承認後に各領域へ更新を依頼する | BA(案作成)、PO(確定) | QE、OPS |
|
|
58
|
+
|
|
59
|
+
### 3.2. 訂正・不整合時の扱い
|
|
60
|
+
|
|
61
|
+
| 場面 | 確認と次の行動 | 受け付ける担当・復旧の参照先 |
|
|
62
|
+
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
|
63
|
+
| 商品の価格変更後に過去の売上が変わる | 販売当時の単価との不一致として扱う。現在の商品台帳から過去の請求額を計算し直さない | BA・DEV が [[specdojo:bdd-sample\|販売管理の辞書]] の標準販売価格と販売単価の区別を照合する |
|
|
64
|
+
| 販売集計と元記録が合わない | OPS が対象日・基準時点と販売集合を照合する。元記録に誤りがあれば販売側で訂正し、QE の再照合後に締めへ渡す | OPS。訂正・再生成の詳細手順は予定文書 `specdojo:cop-sales-reconciliation`。未整備中は「確認事項と変更影響」の制約に従う |
|
|
65
|
+
| 締め確定後に販売を訂正する | 旧締めの参照元と判断を保持し、再生成した集計で PO が締めの新しい確認版を判断する。該当月次報告への影響も BA が確認する | OPS・PO。予定手順 `specdojo:cop-sales-reconciliation` |
|
|
66
|
+
| つけ台帳や在庫記録を取得できない | 未取得を残高0・差異なしと読み替えない。取得できた範囲だけを記録し、PO に締めの確定保留を提示する | OPS が各台帳の更新担当へ確認を依頼する。受け渡しの境界は [[specdojo:cdfd-overview-sample\|全体概要]] |
|
|
67
|
+
| 月次報告に根拠のない見直し案がある | BA が対象月・根拠版・判断理由を補い、PO の判断後に更新依頼先と担当を記録する | BA・PM。未合意の変更は変更要求、採用した方針と理由は決定記録へつなぐ |
|
|
68
|
+
|
|
69
|
+
## 4. 関連仕様と検証
|
|
70
|
+
|
|
71
|
+
### 4.1. 管理単位ごとの参照対応
|
|
72
|
+
|
|
73
|
+
| データストア名 | 根拠・参照先 | 照合する内容と検証対象 |
|
|
74
|
+
| -------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|
|
75
|
+
| 商品台帳 | [[specdojo:bdd-sample\|販売管理の辞書]] の商品、[[specdojo:ccd-sample\|概念クラス図]] | 商品の識別・現在価格と販売時単価の区別。補充基準の全項目は辞書の既定範囲を超えて本書に追加しない |
|
|
76
|
+
| 販売記録 | [[specdojo:bdd-sample\|販売管理の辞書]] の売上記録・売上明細、[[specdojo:ccd-sample\|概念クラス図]] | 売上と明細の所属・粒度、商品参照、つけ販売時の購入者。会計確定までの操作は [[specdojo:clis-sample\|販売管理 CLI 仕様]] を参照する |
|
|
77
|
+
| 日次販売集計 | 本書の販売記録、予定仕様 `specdojo:bdd-sales-summary` | 対象日・基準時点に含めた売上の集合と支払方法別の集計。保存形式は未確定。仕様整備までは次節の手動照合を使う |
|
|
78
|
+
| 日次締め記録 | [[specdojo:cdfd-overview-sample\|全体概要]] の日次締め、予定仕様 `specdojo:bdd-closing` | 販売記録との販売額照合、仕入・在庫・つけ台帳からの確認結果、PO の判断と参照版。販売側の一致だけで全体の締めを確定しない |
|
|
79
|
+
| 月次報告 | [[specdojo:cdfd-overview-sample\|全体概要]] の月次見直し、予定仕様 `specdojo:bdd-monthly-report` | 対象月の日次締め記録の網羅、売上・欠品・つけ残高の根拠、判断と更新依頼先。台帳の未取得・未確定日は明示する |
|
|
80
|
+
|
|
81
|
+
項目・値・構造の検証は各辞書が参照する schema・外部 I/F を正本とし、CDSD で別の制約を作らない。販売・締めの詳細 CDFD は予定 ID `specdojo:cdfd-sales`・`specdojo:cdfd-closing`、保管場所一覧は `specdojo:sll-sales-closing` として未作成である。確認できる管理境界と未確定の保存・復旧方式を区別し、後者の整備責務を「確認事項と変更影響」で追跡する。
|
|
82
|
+
|
|
83
|
+
### 4.2. 照合手順と受入条件
|
|
84
|
+
|
|
85
|
+
BA が「対象と隣接領域」の5単位を一覧・更新責務・参照対応と照合し、欠落・重複が0件であることを確認する。ARC・DEV が正本区分と生成元を確認した後、QE が次の手動照合を行う。未作成 schema の検証を実施済みとは扱わない。
|
|
86
|
+
|
|
87
|
+
| 対象 | 確認手順・例示データ | 合格条件 | 不一致時 |
|
|
88
|
+
| ------------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
|
|
89
|
+
| 商品台帳 | 同じ商品の価格変更前後で商品IDを照合し、変更前に確定した売上明細と比較する | 商品IDが維持され、過去の販売単価・請求額が変わらない | BA・DEV へ差し戻す |
|
|
90
|
+
| 販売記録 | 確定済み・入力途中・取消済みの取引を一つずつ用意し、保存された売上と明細の所属を確認する | 確定済みだけが販売記録に存在する。明細の所属する売上・参照商品が存在し、つけ販売には購入者参照がある | OPS が元取引を確認し、訂正方式が未整備なら本番データを変更しない |
|
|
91
|
+
| 日次販売集計 | 同じ対象日の現金販売108円とつけ販売216円を集計し、元の売上IDの集合と照合する。入力途中・取消済みは含めない | 販売2件・請求合計324円、内訳108円・216円で元集合と一致する。つけ精算の入金を新たな売上に含めない | OPS が基準時点と入力を確認し、再生成後に QE が再照合する |
|
|
92
|
+
| 日次締め記録 | 上記集計を使った締め案と、つけ残高が取得できない締め案を比較する | 集計の基準時点と各台帳の参照を追える。未取得がある案は確定保留となり、確認者と次の行動が残る | PO に保留理由を示し、OPS が不足根拠を集める |
|
|
93
|
+
| 月次報告 | 対象月の日次締め記録と報告の根拠一覧を照合し、締め訂正前の版を参照する報告も確認する | 対象日の欠落・重複が0件。未確定日・旧版参照があれば影響と PO の再判断が明示され、無断で台帳へ反映しない | BA が根拠と影響を修正し、PO が再判断する |
|
|
94
|
+
|
|
95
|
+
QE は文書の整形・Markdown・Frontmatter 検査も実施し、手動照合と区別してコマンド・対象・結果を実行記録に残す。導入済みの Prettier と lint のコマンドは [[specdojo:cdsd-rulebook|概念データストア定義 作成ルール]] の「検証と受入条件」を参照する。失敗があれば該当担当へ差し戻し、再確認する。
|
|
96
|
+
|
|
97
|
+
## 5. 確認事項と変更影響
|
|
98
|
+
|
|
99
|
+
未整備の参照先と条件付きの変更を次の単位で追跡する。追跡先は未作成の候補 ID とし、登録済みとは扱わない。
|
|
100
|
+
|
|
101
|
+
| 論点・区分 | 現在の判断・影響 | 担当・判断時期・次の行動 | 追跡先候補 |
|
|
102
|
+
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
|
|
103
|
+
| 集計・締め・報告の辞書と詳細プロセスの欠落(課題) | 管理境界と手動照合の基準までを採用し、保存形式や締めの全項目は確定しない。未整備のまま実装すると、異なる基準時点の情報を混在させる懸念がある | BA が各辞書・詳細 CDFD を作成し、ARC・DEV が参照対応、QE が受入条件を確認する。PM は辞書→プロセス→実装・検証の順に計画し、PO が設計着手前に範囲を判断する | `specdojo:pjr-sales-closing-specs` |
|
|
104
|
+
| 保管先・訂正と再生成手順が未確定(意思決定・運用上の制約) | _UNDECIDED_: システム化後の保存・保持・復旧方式。現行の販売ノートは明細欄と締め欄を分けて扱う。手動照合で調査できるが、システム上の訂正・再生成は本番実施しない | OPS・DEV が `specdojo:sll-sales-closing` と `specdojo:cop-sales-reconciliation` を整備し、ARC が正本保持、QE が復旧後の照合を確認する。PM が PO へ報告し、運用開始前に PO が採用方針と公開範囲を決める | `specdojo:pjr-sales-storage` |
|
|
105
|
+
| 販売の訂正方式や粒度を変える場合(変更要求) | 販売記録、辞書・概念クラス図、販売プロセス、集計、締め、月次報告と既存記録の再照合へ波及する | BA が差分と移行対象を整理し、ARC・DEV が schema・型・生成処理への影響を特定する。QE が再検証範囲、PM が担当・移行順・期限を計画し、PO が実施前に承認する。採用理由は決定記録へ残す | `specdojo:pjr-sales-correction-change` |
|
|
106
|
+
|
|
107
|
+
公開前に BA・ARC・QE が管理境界と受入条件を確認し、OPS が保管・復旧手順と閲覧範囲を確認する。人間の PO は未解決事項、顧客参照・つけ情報の公開範囲、実データが混入していないことを確認し、承認・保留・差し戻しを判断する。未整備の手順に依存する運用は保留し、agent は `draft` を維持する。
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:cdt-sample
|
|
4
|
+
type: data
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cdt-rulebook
|
|
7
|
+
supersedes:
|
|
8
|
+
- specdojo:cld-sample
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# 商品区分
|
|
12
|
+
|
|
13
|
+
駄菓子屋の店主代表と家族利用者代表が、商品の棚割り・仕入れ方針・棚札を同じ基準で選ぶための分類を定義する。
|
|
14
|
+
|
|
15
|
+
## 1. 概要
|
|
16
|
+
|
|
17
|
+
- 業務目的: 商品の種類と仕入れ方針を分け、季節商品を定番商品と同じ基準で補充する誤りや、棚札の表記ゆれを防ぐ。
|
|
18
|
+
- 対象エンティティ: 商品(`product`)。商品の管理単位と識別は [[specdojo:bdd-sample|業務データ辞書(駄菓子屋の販売管理)]] に合わせる。
|
|
19
|
+
- 適用範囲: 店舗の商品台帳と棚札で使う「商品区分」「取扱区分」「棚札タグ」。商品区分と取扱区分はそれぞれ一つを選び、棚札タグは必要な場合だけ複数付けられる。
|
|
20
|
+
- 主担当ロール: BA が判断境界を整理し、PO を担う店主代表が区分の意味と各商品の分類を決める。家族利用者代表は仕入れや店番で参照し、QE は境界事例を確認する。
|
|
21
|
+
- 責務の境界: これらは実装前の店舗運営上の分類であり、業務データ辞書に未定義の属性を実装済みとは扱わない。税区分・保管温度・賞味期限は商品ごとに確認し、本分類だけから税率や保管方法を決定しない。
|
|
22
|
+
|
|
23
|
+
## 2. 分類定義
|
|
24
|
+
|
|
25
|
+
### 2.1. 商品区分
|
|
26
|
+
|
|
27
|
+
| 定義項目 | 内容 |
|
|
28
|
+
| ---------------- | ---------------------------------------------------------------------------------- |
|
|
29
|
+
| 対象エンティティ | 商品(`product`) |
|
|
30
|
+
| 分類定義名 | 商品区分(`product_type`) |
|
|
31
|
+
| 種別 | 業務分類 |
|
|
32
|
+
| 正本参照(SSOT) | なし(スタンドアロン定義)。本書の「商品区分の選定」を正本とする |
|
|
33
|
+
| 説明 | 店主代表が商品の主な用途で棚割りを決める区分。冷蔵の要否や販売する季節では分けない |
|
|
34
|
+
|
|
35
|
+
### 2.2. 取扱区分
|
|
36
|
+
|
|
37
|
+
| 定義項目 | 内容 |
|
|
38
|
+
| ---------------- | -------------------------------------------------------------------------------------------------- |
|
|
39
|
+
| 対象エンティティ | 商品(`product`) |
|
|
40
|
+
| 分類定義名 | 取扱区分(`handling_type`) |
|
|
41
|
+
| 種別 | 業務分類 |
|
|
42
|
+
| 正本参照(SSOT) | なし(スタンドアロン定義)。本書の「取扱区分の選定」を正本とする |
|
|
43
|
+
| 説明 | 店主代表が継続補充・期間限定・試験導入のどの方針で仕入れるかを決める区分。商品の種類とは独立に選ぶ |
|
|
44
|
+
|
|
45
|
+
### 2.3. 棚札タグ
|
|
46
|
+
|
|
47
|
+
| 定義項目 | 内容 |
|
|
48
|
+
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
|
|
49
|
+
| 対象エンティティ | 商品(`product`) |
|
|
50
|
+
| 分類定義名 | 棚札タグ(`shelf_tags`) |
|
|
51
|
+
| 種別 | 動的分類 |
|
|
52
|
+
| 正本参照(SSOT) | 店主代表が保管する紙の商品台帳の「棚札タグ管理欄」。追加・変更・廃止は本書の「棚札タグの管理」に従う |
|
|
53
|
+
| 説明 | 売場で注目してほしい特徴を示す任意の分類。店主代表が運用中に増減でき、商品区分や取扱区分の代わりには使わない |
|
|
54
|
+
|
|
55
|
+
この三つの属性名は商品台帳の分類軸を識別するための呼称であり、データ構造は定義しない。商品区分・取扱区分には実装やスキーマによる許容値の定義がなく、本書が業務上の正本を担う。棚札タグの現行値は商品台帳で管理し、本書には固定の値一覧を置かない。
|
|
56
|
+
|
|
57
|
+
## 3. 値の業務的意味と使い分け
|
|
58
|
+
|
|
59
|
+
### 3.1. 商品区分の選定
|
|
60
|
+
|
|
61
|
+
| 値 | 分類名 | 表示名 | 説明・成立条件 |
|
|
62
|
+
| ------- | ------ | ------ | ------------------------------------------------------------------------------------------------------------------ |
|
|
63
|
+
| `snack` | お菓子 | お菓子 | 食べることを主な用途とする駄菓子・菓子類。飲む商品は `drink` とし、包装の絵柄や冷蔵の有無では区分を変えない |
|
|
64
|
+
| `toy` | 玩具 | 玩具 | 遊ぶことを主な用途とする非食品。シール・こま・花火などを含む。食べる商品に景品が付くことだけを理由に玩具とはしない |
|
|
65
|
+
| `drink` | 飲料 | 飲料 | 飲むことを主な用途とする清涼飲料・瓶ジュース類。常温で販売する飲料も含み、冷蔵した菓子を含めない |
|
|
66
|
+
|
|
67
|
+
菓子と玩具が一体の商品は、商品説明と売場での案内から主な用途を店主代表が確認する。用途を一つに決められない場合は、家族利用者代表が推測で区分を付けず、店主代表が扱いを決めるまで棚割りを保留する。既存の三分類に当てはまらない商品も、便宜的にいずれかへ入れず、分類の追加要否を確認する。
|
|
68
|
+
|
|
69
|
+
### 3.2. 取扱区分の選定
|
|
70
|
+
|
|
71
|
+
| 値 | 分類名 | 表示名 | 説明・成立条件 |
|
|
72
|
+
| -------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------- |
|
|
73
|
+
| `staple` | 定番商品 | ★定番 | 店主代表が通年で棚に置き、継続して補充すると決めた商品。発注点を設定する対象。売れ行きが良いだけでは自動で定番にしない |
|
|
74
|
+
| `seasonal` | 季節商品 | 季節限定 | 店主代表が販売期間を定め、その期間内だけ仕入れる商品。期間終了時は追加仕入れを止め、残品の扱いを店主代表が決める |
|
|
75
|
+
| `experimental` | 試験商品 | お試し | 継続取扱の判断材料を集めるために初回導入する商品。入荷後30日間の売れ行きを確認して、店主代表が継続方針を決める |
|
|
76
|
+
|
|
77
|
+
#### 3.2.1. 条件が重なる場合
|
|
78
|
+
|
|
79
|
+
1. 販売期間を限定している商品は、新規導入でも `seasonal` を優先する。期間を延ばす場合も、通年補充の決定がなければ `staple` にしない。
|
|
80
|
+
2. 期間限定ではなく、継続取扱が未決定の新商品は `experimental` とする。入荷後30日を過ぎただけでは `staple` に変えず、判断待ちの間は追加仕入れを保留する。
|
|
81
|
+
3. 店主代表が通年補充を決定した時点で `staple` とする。商品の新旧や販売量だけでは選ばない。
|
|
82
|
+
|
|
83
|
+
#### 3.2.2. 区分を変更する場合
|
|
84
|
+
|
|
85
|
+
- 店主代表は変更理由と適用日を商品台帳に残し、家族利用者代表に新しい補充方針を伝える。商品IDは変えない。取扱区分の変更適用日までに、店番担当(店主代表または家族利用者代表)は店頭の棚札表示(表示名: `★定番` / `季節限定` / `お試し`)を新しい取扱区分に合わせて貼り替える。
|
|
86
|
+
- `experimental` から `staple` に変更する場合は発注点の設定を確認する。未設定をゼロと読み替えて補充判断を進めない。
|
|
87
|
+
- 継続取扱をやめる場合は、無理に別区分へ移さず追加仕入れを止める。取扱終了は商品の種類ではなく販売対象の管理として扱い、過去の記録を残す。
|
|
88
|
+
|
|
89
|
+
### 3.3. 棚札タグの管理
|
|
90
|
+
|
|
91
|
+
| 管理項目 | 規約 |
|
|
92
|
+
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
93
|
+
| 管理元 | 紙の商品台帳の棚札タグ管理欄を正本とし、棚札へ同じ名称を転記する。棚札だけに新しいタグを作らない |
|
|
94
|
+
| 作成・変更権限 | 店主代表が追加・改名・アーカイブを決める。家族利用者代表は登録済みの有効なタグを商品へ付け外しでき、新設や統合が必要な場合は店主代表へ依頼する |
|
|
95
|
+
| 命名規約 | 来店客が特徴を理解できる短い日本語名とし、商品名・人物名を使わない。同義のタグは新設せず既存名に揃える。「定番」「季節限定」「お試し」は取扱区分の表示と混同するため使わない |
|
|
96
|
+
| 改名・統合 | 同じ意味の改名は既存の参照を引き継ぎ、商品台帳と棚札を揃える。意味を変える場合は別タグを作り、旧タグを同じ意味だったように書き換えない |
|
|
97
|
+
| 削除・アーカイブ | 商品や過去の記録から参照されたタグは削除せずアーカイブする。以後の新規付与を止め、既存の参照と当時の意味は確認できるよう残す。未使用の誤登録だけ削除できる |
|
|
98
|
+
|
|
99
|
+
例えば「小分け」は少量ずつ分けて渡せる商品への棚札表現として店主代表が登録できるが、必須のタグではない。タグが付いていなくても商品区分・取扱区分の選定には影響しない。
|
|
100
|
+
|
|
101
|
+
### 3.4. 判断境界の具体例
|
|
102
|
+
|
|
103
|
+
| 場面 | 選定結果・次の判断 | 境界の根拠 |
|
|
104
|
+
| -------------------------------------------- | ------------------------ | ---------------------------------------------------------------- |
|
|
105
|
+
| 通年補充する瓶ジュースを常温棚で売る | `drink` / `staple` | 飲む用途と通年補充の方針で選ぶ。保管温度は商品ごとに確認する |
|
|
106
|
+
| 夏季だけ販売する花火を初めて仕入れる | `toy` / `seasonal` | 非食品で遊ぶ用途。新規導入でも期間限定が優先される |
|
|
107
|
+
| 継続取扱を決めていない新しい駄菓子を導入する | `snack` / `experimental` | 食べる用途。入荷後30日間の確認を経て店主代表が継続方針を判断する |
|
|
108
|
+
|
|
109
|
+
## 4. 関連仕様との関係
|
|
110
|
+
|
|
111
|
+
| 関連仕様 | 分類との関係・変更時に確認すること |
|
|
112
|
+
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
113
|
+
| [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] | 商品(`product`)と発注点(`reorder_point`)を参照する。本書の分類属性やタグの管理構造は同辞書に未定義。システム化する際は辞書へ構造を定義し、許容値を実装・スキーマに持たせる場合は本書の正本参照方式を切り替える |
|
|
114
|
+
| [[specdojo:gl-sample\|用語集 在庫・調達]] | 「定番商品」と「発注点」の語義を参照する。定番の成立条件を変える場合は、通年で棚に置く方針および発注点の利用対象と矛盾しないか確認する |
|
|
115
|
+
| [[specdojo:br-sample\|在庫不足判定]] | 定番商品で発注点に基づく不足判定を行う際に参照する。計算式と入力不備の扱いは同ルールに委ねる。季節・試験商品の追加仕入れは店主代表が取扱方針に沿って判断する |
|
|
116
|
+
| [[specdojo:uis-sample\|販売登録画面 画面仕様]] | 販売する商品の識別と会計操作を参照する。本書は商品分類の編集画面や税率の算出を定義しない。分類の変更を会計へ反映する場合は、商品ごとの税区分との関係を別途確認する |
|
|
@@ -2,37 +2,10 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:cld-sample
|
|
4
4
|
type: data
|
|
5
|
-
status:
|
|
5
|
+
status: deprecated
|
|
6
6
|
rulebook: specdojo:cld-rulebook
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
#
|
|
9
|
+
# 分類一覧(CLD)サンプル(非推奨)
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
本書は、業務上の分類(カテゴリ、種別、区分など)を一覧で定義するための最小サンプルである。
|
|
14
|
-
|
|
15
|
-
## 2. 入力情報
|
|
16
|
-
|
|
17
|
-
- 対象: 駄菓子屋の販売管理システム
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/cld-rulebook.md`
|
|
20
|
-
|
|
21
|
-
## 3. 記述内容
|
|
22
|
-
|
|
23
|
-
- 主な内容: 分類定義名、種別、分類名、説明など
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
25
|
-
|
|
26
|
-
## 4. 最小記述例
|
|
27
|
-
|
|
28
|
-
| 項目 | 値 | 備考 |
|
|
29
|
-
| ------------ | --------------------------------------------------------- | ------------------------------------ |
|
|
30
|
-
| ドキュメント | [業務データ辞書 / 分類定義](../rulebooks/cld-rulebook.md) | 最小サンプル |
|
|
31
|
-
| 目的 | 業務上の分類(カテゴリ、種別、区分など)を一覧で定義する | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | 分類定義名、種別、分類名、説明など | 要点のみ記載 |
|
|
33
|
-
|
|
34
|
-
## 5. 未解決事項
|
|
35
|
-
|
|
36
|
-
| 論点 | 処理方針 |
|
|
37
|
-
| -------------- | ------------------------ |
|
|
38
|
-
| 要件詳細の補強 | 実案件適用時に具体化する |
|
|
11
|
+
この sample は非推奨です。後継の完成例は [[specdojo:cdt-sample|CDT サンプル]] を参照してください。
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
---
|
|
2
|
+
specdojo:
|
|
3
|
+
id: specdojo:clis-sample
|
|
4
|
+
type: ui
|
|
5
|
+
status: draft
|
|
6
|
+
rulebook: specdojo:clis-rulebook
|
|
7
|
+
part_of: []
|
|
8
|
+
based_on: []
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# 駄菓子屋きぬや 販売管理 CLI 仕様
|
|
12
|
+
|
|
13
|
+
## 1. 概要
|
|
14
|
+
|
|
15
|
+
店主代表と家族利用者代表が、購入明細と請求額を確認して現金販売を記録し、釣銭とレシートを来店客へ渡すための CLI コマンド群である。会計と印字の結果を区別して残し、店番の交代時にも未完了の取引を引き継げるようにする。
|
|
16
|
+
|
|
17
|
+
## 2. 利用目的と対象ユーザー
|
|
18
|
+
|
|
19
|
+
| 対象者 | 解決する課題・達成する結果 | 確認・合意する内容 |
|
|
20
|
+
| -------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------- |
|
|
21
|
+
| 店主代表 | 暗算やノートへの転記に頼らず、売上を記録して店番を引き継ぐ | 会計の確定条件、取消可能な範囲、障害時の照合結果を最終判断する |
|
|
22
|
+
| 家族利用者代表 | 店主不在でも同じ手順で商品を登録し、請求額と釣銭を提示する | 開始から会計完了までの操作と、保留時に店主へ渡す情報を確認する |
|
|
23
|
+
| 開発担当・同行レビュー担当 | 正常終了と警告・異常を識別し、二重会計を避ける | 入出力の正本、保存される記録、回復後の期待結果を照合する |
|
|
24
|
+
|
|
25
|
+
日々の販売記録を継続する目的は [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針に対応する。対象は単一店舗・現金販売の開始、明細追加、金額確認、会計確定、確定前の取消とする。確定後の返品・訂正は店主代表の照合手順へ引き渡し、つけ販売、キャッシュレス決済、仕入れ、在庫調整は対象外とする。
|
|
26
|
+
|
|
27
|
+
_ASSUMPTION_: 本例は店舗端末1台を人が操作する学習用 CLI とし、商品マスタの取得と売上登録に本部 API を利用する。通常利用のタブレット画面とは別の操作例であり、自動会計・無人運転や通信不能時の販売継続は扱わない。架空のコマンド構文・データ契約の参照名は「メモ / 将来課題」で未同梱と区別する。
|
|
28
|
+
|
|
29
|
+
## 3. 操作の流れ
|
|
30
|
+
|
|
31
|
+
1. **取引を開始する**: 店番担当(店主代表または家族利用者代表)は、前の取引に未解決の会計がないことを確認して `sales start` を実行する。表示された取引番号を以後の照合に使う。既存取引があれば新規取引を重ねず、その明細と確定状態を確認する。
|
|
32
|
+
2. **明細をそろえる**: `sales add` で商品コードと数量を指定する。追加結果の商品名・数量・金額を現物と照合し、必要な商品分を繰り返す。商品マスタの取得失敗時は追加されていない明細を確認してから再試行する。誤登録をやり直す場合は、確定前に `sales cancel` で取引全体を取り消す。
|
|
33
|
+
3. **金額を提示する**: `sales total` で明細・税額・請求額を確認する。明細が空なら会計へ進まず商品を追加し、購入中止なら取り消す。来店客と金額が合意できた後に現金を受け取る。
|
|
34
|
+
4. **会計を確定する**: `sales complete` の対話で預かり金額を入力する。入力不正・不足は同じ対話で修正する。会計確定の通知、販売実績の保存、本部の受付結果を照合して釣銭を渡す。印字は会計確定後に行い、印字未完了の警告は会計の取消とみなさない。
|
|
35
|
+
5. **結果を引き継ぐ**: 店番担当は完了した取引番号とレシートを確認する。未印字・結果不明・保存失敗があれば、取引番号と保持された記録を店主代表へ渡す。店主代表は未解決事項の有無を確認してから次の店番へ引き継ぐ。
|
|
36
|
+
|
|
37
|
+
会計要求前の中断では保存済みの同じ取引を `sales total` で確認して続けるか、`sales cancel` で取り消す。会計要求後に中断した場合は、先に「代表的な表示と利用者の次の手」に従って本部とローカルの確定状態を照合する。新しい取引で同じ販売を登録し直すことと、元の取引の確認・回復を区別する。
|
|
38
|
+
|
|
39
|
+
## 4. 操作とコマンド参照
|
|
40
|
+
|
|
41
|
+
構文・引数・オプションの正本は `kinuya-cli-reference` とする。下表の参照名は未同梱の架空リファレンスの節を示す。
|
|
42
|
+
|
|
43
|
+
| 操作 | 対象コマンド | 正本リファレンス |
|
|
44
|
+
| ---------------------- | ---------------- | ------------------------------------- |
|
|
45
|
+
| 取引開始 | `sales start` | `kinuya-cli-reference#sales-start` |
|
|
46
|
+
| 明細追加 | `sales add` | `kinuya-cli-reference#sales-add` |
|
|
47
|
+
| 明細・合計確認 | `sales total` | `kinuya-cli-reference#sales-total` |
|
|
48
|
+
| 会計確定 | `sales complete` | `kinuya-cli-reference#sales-complete` |
|
|
49
|
+
| 確定前の取引全体の取消 | `sales cancel` | `kinuya-cli-reference#sales-cancel` |
|
|
50
|
+
|
|
51
|
+
再印刷は保存済みのレシートを使う運用手順へ引き渡す。印刷のために `sales complete` を再実行しない。外部印刷コマンドの起動方法は [[specdojo:ifx-cmd-sample|レシート印刷コマンド連携仕様]] を正本とする。
|
|
52
|
+
|
|
53
|
+
## 5. 入力と出力の要点
|
|
54
|
+
|
|
55
|
+
未同梱の正本は参照名をインラインコードで示す。「本書」は、CLI 内で完結する表示・対話であり、独立したデータ契約を設けないことを意味する。
|
|
56
|
+
|
|
57
|
+
### 5.1. 入力情報
|
|
58
|
+
|
|
59
|
+
| コマンド | 種類 | 対象 | 役割 | 正本の参照 | ない/壊れている/届かないときの扱い |
|
|
60
|
+
| --------------------------------------------------- | ---------------------- | -------------------------- | ---------------------------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
61
|
+
| `sales start`・`add`・`total`・`complete` | ファイル | `config/store-config.yaml` | 店舗・税計算・本部接続の条件を解決する | `kinuya-store-config-schema` | 欠落時は既定設定で進む。破損時は「店舗設定不正」として停止する |
|
|
62
|
+
| `sales add`・`complete` | 環境変数 | `KINUYA_API_KEY` | 本部 API の認証に使う。値は表示・記録しない | `kinuya-cli-reference` の「認証設定」 | 未設定なら「認証設定不足」で停止。認証拒否は各 API の拒否として扱う |
|
|
63
|
+
| `sales add` | 外部 API の応答 | 本部商品マスタ | 商品名・販売単価・税区分を取得する | `ifx-api-kinuya-products.yaml` | 接続不能・時間切れ・拒否は「商品マスタ取得失敗」で停止し、明細を追加しない。未登録商品は「商品コード未登録」とする |
|
|
64
|
+
| `sales start`・`add`・`total`・`complete`・`cancel` | ファイル | `.session/current-tx.json` | 既存取引の有無を確認し、同じ取引の明細と確定状態を引き継ぐ | `kinuya-session-schema` | `start` では欠落時に新規作成し、既存取引があれば「取引二重開始」で停止する。他の操作では欠落を「取引未開始」、全操作で破損を「取引記録破損」として停止する |
|
|
65
|
+
| `sales complete` | 対話での入力 | 預かり金額 | 受領した現金と請求額を照合する | 本書「操作の流れ」「代表的な表示と利用者の次の手」 | 不足・不正は再入力を促す。入力中断なら「預かり金入力中断」として会計要求前に停止する |
|
|
66
|
+
| `sales complete` | 外部 API の応答 | 本部売上登録の受付結果 | 同じ取引の登録結果を確認する | `ifx-api-kinuya-sales.yaml` | 接続不能・時間切れ・拒否は「売上登録失敗」として停止。送信内容をローカルに保持し、結果不明を完了扱いにしない |
|
|
67
|
+
| `sales complete` | 外部コマンドの実行結果 | `receipt-print` の印字結果 | 対象取引のレシートが印字されたか判断する | [[specdojo:ifx-cmd-sample\|レシート印刷コマンド連携仕様]] | 失敗・時間切れ・結果不正は「印字未完了」の警告で会計を維持し、控えを保持する |
|
|
68
|
+
|
|
69
|
+
### 5.2. 出力情報
|
|
70
|
+
|
|
71
|
+
| コマンド | 種類 | 対象 | 役割 | 正本の参照 |
|
|
72
|
+
| ------------------------------------------ | -------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
|
|
73
|
+
| `sales start`・`cancel` | 標準出力 | 取引開始・取消の通知 | 対象取引と、開始済み/取消済みを確認する | 本書「操作の流れ」 |
|
|
74
|
+
| `sales add`・`total` | 標準出力 | 追加明細・取引集計 | 商品・数量・金額の照合と、来店客への請求額の提示に使う | 本書「操作の流れ」 |
|
|
75
|
+
| `sales complete` | 標準出力 | 会計確定サマリー | 取引番号・請求額・預かり金・釣銭と会計確定を確認する。印字結果は別に識別する | 本書「操作の流れ」 |
|
|
76
|
+
| `sales complete` | 標準エラー | 再入力の案内・印字警告 | 対話での修正と、会計後に残る印字対応を識別する | 本書「代表的な表示と利用者の次の手」 |
|
|
77
|
+
| 全コマンド | 標準エラー | 停止理由と回復案内 | 対象取引・原因・保持記録から次の手を選ぶ | 本書「代表的な表示と利用者の次の手」 |
|
|
78
|
+
| `sales start`・`add`・`complete`・`cancel` | 作る/変えるファイル | `.session/current-tx.json` | 取引の開始・明細追加を保存し、会計完了または確定前の取消で終了する。会計が未解決なら保持する | `kinuya-session-schema` |
|
|
79
|
+
| `sales add` | 外部 API への送信 | 本部商品マスタへの照会 | 指定商品を取得する。商品マスタは更新しない | `ifx-api-kinuya-products.yaml` |
|
|
80
|
+
| `sales complete` | 外部 API への送信 | 本部売上登録 | 同じ取引の販売実績を渡す。受付応答は入力情報で扱う | `ifx-api-kinuya-sales.yaml` |
|
|
81
|
+
| `sales complete` | 作る/変えるファイル | `data/sales/TX-YYYYMMDD-NNNN.json` | 販売実績のローカル控えと送信結果を残し、通信失敗時も照合に使う | `kinuya-sales-record-schema` |
|
|
82
|
+
| `sales complete` | 作る/変えるファイル | `receipts/receipt-YYYYMMDD-NNNN.txt` | 確定済み会計のレシートを保存し、未印字時の確認・再印刷に使う | `kinuya-receipt-format-schema` |
|
|
83
|
+
| `sales complete` | 外部コマンドの起動 | `receipt-print` | 保存済みレシートを渡して印字を依頼する。売上登録は委ねない | [[specdojo:ifx-cmd-sample\|レシート印刷コマンド連携仕様]] |
|
|
84
|
+
|
|
85
|
+
## 6. 終了コードとエラー表示・利用者の次の手
|
|
86
|
+
|
|
87
|
+
### 6.1. 終了時の判断
|
|
88
|
+
|
|
89
|
+
本例の CLI の終了コード区分は次表とし、値の正本は `kinuya-cli-reference` の「終了コード」とする。外部印刷コマンドの終了コードを販売 CLI 全体へそのまま伝播しない。
|
|
90
|
+
|
|
91
|
+
| 終了コード | 区分 | 利用者が確認する結果 |
|
|
92
|
+
| ---------- | ------------------ | ------------------------------------------------------------------------------------------ |
|
|
93
|
+
| `0` | 正常終了・警告継続 | 要求した操作の結果を確認する。会計確定後の印字警告を含むため、レシート発行済みとは限らない |
|
|
94
|
+
| `1` | 入力の誤り・中断 | 入力を訂正または再開する。会計要求前の明細は保持されている |
|
|
95
|
+
| `2` | 取引状態の不整合 | 既存取引・確定状態を確認する。新規取引でのやり直しを先行させない |
|
|
96
|
+
| `3` | 本部 API の失敗 | 接続・認証と取引の受付結果を確認する。売上登録の結果不明を未登録と断定しない |
|
|
97
|
+
| `4` | 設定・保存先の障害 | 開発担当へ環境復旧と保存状態の照合を依頼する |
|
|
98
|
+
|
|
99
|
+
### 6.2. 代表的な表示と利用者の次の手
|
|
100
|
+
|
|
101
|
+
表示要点は全文の固定文言ではなく、利用者が事象を識別する内容を示す。停止・警告・再入力の案内は標準エラーへ、成功結果は標準出力へ出す。
|
|
102
|
+
|
|
103
|
+
| 事象・条件 | 終了コード | 表示要点 | 利用者の次の手・回復の確認 |
|
|
104
|
+
| ------------------------------------ | --------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
105
|
+
| 正常な取引開始・明細追加・確認・取消 | `0` | 対象取引、操作結果、明細または取消済みの通知 | 店番担当が現物・購入意思と結果を照合し、「操作の流れ」の次の操作へ進む |
|
|
106
|
+
| 会計確定・印字完了 | `0` | 会計確定、釣銭、対象取引の印字完了 | 店番担当が取引番号とレシートを照合し、釣銭とレシートを渡す |
|
|
107
|
+
| 店舗設定不正 | `4` | 設定ファイルと不正の理由 | 開発担当が正本に従って訂正し、店主代表が店舗条件を確認する。設定を削除して回避しない |
|
|
108
|
+
| 認証設定不足 | `1` | `KINUYA_API_KEY` の未設定。値は表示しない | 開発担当へ設定を依頼し、元の操作を再試行する |
|
|
109
|
+
| 商品コード未登録・数量不正 | `1` | 対象コードまたは数量と訂正が必要な理由 | 店番担当が商品と指定値を確認して追加し直し、表示明細に1回だけ反映されたことを確認する。数量の許容範囲はリファレンスに従う |
|
|
110
|
+
| 商品マスタ取得失敗 | `3` | 対象商品、接続不能/時間切れ/拒否の別、追加未実施 | 店番担当が接続を確認し、拒否なら開発担当へ認証・権限確認を依頼する。復旧後に同じ取引へ追加する |
|
|
111
|
+
| 預かり金額不足・入力不正 | 入力待ちのため未終了 | 請求額・不足額または入力訂正の案内 | 店番担当が実際の受領額を確認して同じ対話で再入力する。この段階では本部へ会計要求を送らない |
|
|
112
|
+
| 預かり金入力中断 | `1` | 会計未要求、明細保持、対象取引 | 店番担当が `sales total` で明細を確認し、同じ取引の会計を再開するか確定前に取り消す |
|
|
113
|
+
| 取引未開始・取引二重開始 | `2` | 未開始または既存取引番号 | 未開始なら `sales start`、二重開始なら店番担当が既存取引の明細を確認する。未解決の会計がある間は取り消さない |
|
|
114
|
+
| 明細なし | `2` | 会計対象の商品なし、会計未実施 | 店番担当が商品を追加するか取り消す。対象なしの停止を販売完了と数えない |
|
|
115
|
+
| 取引記録破損・確定後の取消要求 | `2` | 対象取引、取消・継続できない理由 | 店主代表と開発担当が本部受付と保存記録を照合する。ファイル削除や `sales cancel` による強制初期化は行わない |
|
|
116
|
+
| 売上登録失敗 | `3` | 接続不能/時間切れ/拒否の別、取引番号、保持記録、受付結果不明の有無 | 店主代表が本部受付とローカル記録を照合する。受付済みなら同じ取引の記録を回復し、未受付と確認できた場合だけ回復手順に従って送信を再開する。確認できなければ保留し、会計・取消を繰り返さない |
|
|
117
|
+
| 印字未完了 | `0`(会計は確定済み) | 警告、対象取引、未印字/結果不明の別、控えの保存先 | 店番担当が紙面とプリンタを確認する。開発担当が接続・用紙・権限を復旧し、必要なら保存済みレシートだけを手動再印刷する。二重印字の可能性を確認し、売上は再送しない |
|
|
118
|
+
| 売上・レシートファイル保存失敗 | `4` | 対象パス、取引番号、保存できた範囲、受付状態 | 開発担当が容量・権限を復旧し、店主代表が本部受付と保持記録を照合する。確定済み売上は再登録せず、記録・控えの回復後に結果を確認する |
|
|
119
|
+
|
|
120
|
+
_ASSUMPTION_: 会計確定の通知は、本部受付とローカル販売実績の保存を確認してから行う。会計要求後の停止・応答欠落では、未確定と即断せず照合待ちとして保持する。本部登録の重複排除や照会・回復の詳細は連携契約へ委ね、契約未整備のまま自動再送を許可しない。
|
|
121
|
+
|
|
122
|
+
## 7. メモ / 将来課題
|
|
123
|
+
|
|
124
|
+
| 項目 | 未整備事項と影響 | 担当・解消条件・引き継ぎ先 |
|
|
125
|
+
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
126
|
+
| 上位の操作体系 | `kinuya-clis-index`、CLI 用の業務プロセス・システム化機能は未作成。`part_of`・`based_on` は未接続 | BA が対象範囲と依存関係を確認して接続する。通常利用を GUI とする機能仕様を CLI の直接根拠として流用しない |
|
|
127
|
+
| 構文・設定・記録の正本 | `kinuya-cli-reference`、`kinuya-store-config-schema`、`kinuya-session-schema`、`kinuya-sales-record-schema`、`kinuya-receipt-format-schema` は未同梱の架空参照名 | 開発担当が構文・値・構造を各正本へ定義し、同行レビュー担当がコマンド表と終了コード、保存結果を照合する |
|
|
128
|
+
| 本部との契約・障害回復 | `ifx-api-kinuya-products.yaml`・`ifx-api-kinuya-sales.yaml` は未同梱。受付照会・重複排除・保存失敗後の回復方法は未確定で、結果不明の取引を自動処理できない | 技術メンターと開発担当が契約と照合・回復手順を整え、店主代表が取引の保留と確定の判断を確認する。同行レビュー担当が応答欠落・受付済み・未受付の期待結果を確認するまで当該経路の受入を保留する |
|
|
129
|
+
| 印字経路の受入 | 印刷契約の完成例は [[specdojo:ifx-cmd-sample\|レシート印刷コマンド連携仕様]]。実機での印字結果不明・二重印字の確認は未実施 | 開発担当と店番担当が警告、控え保持、紙面確認後の再印刷を検証し、同行レビュー担当が会計・売上の再実行がないことを確認する |
|
|
130
|
+
| 確定・公開の判断 | 本例の参照名と前提は実案件での合意済み仕様を表さない | 店主代表が正常会計、入力訂正、確定前取消、通信失敗、未印字の各結果と引き継ぎ手順を確認し、正本・回復経路の整備後に実運用の可否を判断する |
|
|
131
|
+
|
|
132
|
+
オフライン同期 `sales sync`、連続スキャン `sales scan`、キャッシュレス決済は将来の拡張候補であり、現行の回復操作には使わない。店主代表が必要性を判断した時点で BA が別の要求へ整理する。
|