specdojo 0.6.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 +193 -0
- package/README.md +2 -2
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +6 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/orchestrator.js +10 -1
- 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/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +22 -3
- 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/antigravity-session.js +154 -0
- 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 +160 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +52 -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 +69 -42
- 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 +264 -43
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +12 -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 +26 -6
- package/dist/exec/run/schedule-prepare.js +228 -45
- package/dist/exec/run/schedule-task.js +132 -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 +118 -59
- package/dist/exec/worktree-ops-lifecycle.js +77 -44
- 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 +74 -32
- 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 +149 -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/provider-scaffold.js +2 -0
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -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 +48 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
- package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- 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 +589 -807
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
- 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 +41 -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 +471 -74
- 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-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
- 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 +146 -99
- 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-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
- 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-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
- 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-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
- 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 +54 -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/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +6 -3
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- 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/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -3,36 +3,142 @@ specdojo:
|
|
|
3
3
|
id: specdojo:cnd-sample
|
|
4
4
|
type: architecture
|
|
5
5
|
status: draft
|
|
6
|
-
rulebook: specdojo:cnd-
|
|
6
|
+
rulebook: specdojo:cnd-rulebook
|
|
7
|
+
part_of: []
|
|
8
|
+
based_on: []
|
|
9
|
+
supersedes: []
|
|
7
10
|
---
|
|
8
11
|
|
|
9
|
-
#
|
|
12
|
+
# 駄菓子屋きぬや 販売管理システム C4コンテナ図
|
|
10
13
|
|
|
11
|
-
## 1.
|
|
14
|
+
## 1. 概要
|
|
12
15
|
|
|
13
|
-
|
|
16
|
+
ノートと店主の記憶に頼る販売記録は、家族が店番を代わると記録漏れや確認の手間が生じる。[[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針を受け、店主代表と家族利用者代表が同じ手順で現金販売を記録し、販売結果とレシート発行状況を引き継ぐための構成を示す。入力、永続記録、物理印字の境界を定義し、配備設計と結合検証へ渡す。
|
|
14
17
|
|
|
15
|
-
|
|
18
|
+
単一店舗・タブレット1台を対象とする学習用の完成例である。在庫・つけ管理への拡張、EC、本格会計、仕入れ先との連携、キャッシュレス決済は本図の対象外とする。構文・データ項目・物理ホストの設計は各詳細仕様へ委ねる。
|
|
16
19
|
|
|
17
|
-
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/cnd-mermaid-rulebook.md`
|
|
20
|
+
上位図 `cxd-kinuya-sales-web` は未同梱であり、`based_on` は未接続とする。[[specdojo:cxd-sample|販売管理 CLI のコンテキスト図]] と [[specdojo:clis-sample|販売管理 CLI 仕様]] は本部 API を利用する別の学習用構成で、本図のタブレット画面と店舗側保存の直接の設計根拠にはしない。
|
|
20
21
|
|
|
21
|
-
|
|
22
|
+
ARC が構成案を担当し、BA は両利用者と販売・引き継ぎの場面、DEV は実行単位と接続、QE は観測結果、OPS は店舗への配備と運用条件を確認する。PO を担う店主代表が対象範囲と残るリスクを判断する。実行・配備と接続の仮定は「Container(コンテナ)」と「Relationship(関係・連携契約)」に示し、店舗で合意した実構成とは扱わない。
|
|
22
23
|
|
|
23
|
-
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
24
|
+
## 2. C4コンテナ図(Mermaid)
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
```mermaid
|
|
27
|
+
flowchart LR
|
|
28
|
+
店主代表["👤 店主代表"]
|
|
29
|
+
家族利用者代表["👤 家族利用者代表"]
|
|
27
30
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
31
|
+
subgraph 境界["駄菓子屋きぬや 販売管理システム"]
|
|
32
|
+
販売画面("販売画面<br>(タブレットのブラウザ)")
|
|
33
|
+
販売処理("販売処理サービス")
|
|
34
|
+
販売記録[("販売記録ストア")]
|
|
35
|
+
end
|
|
33
36
|
|
|
34
|
-
|
|
37
|
+
印刷基盤["レシート印刷基盤"]
|
|
35
38
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
+
店主代表 -->|"現金販売の入力・結果確認"| 販売画面
|
|
40
|
+
家族利用者代表 -->|"現金販売の入力・引き継ぎ確認"| 販売画面
|
|
41
|
+
販売画面 -->|"販売記録依頼・結果取得"| 販売処理
|
|
42
|
+
販売処理 -->|"商品参照・販売と控えの保存"| 販売記録
|
|
43
|
+
販売処理 -->|"印字依頼・結果取得"| 印刷基盤
|
|
44
|
+
|
|
45
|
+
classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
|
|
46
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
47
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
48
|
+
class 店主代表,家族利用者代表 person;
|
|
49
|
+
class 販売画面,販売処理,販売記録 system;
|
|
50
|
+
class 印刷基盤 external;
|
|
51
|
+
style 境界 fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
矢印は主たる利用・依頼・参照の向きで、返される結果も同じ関係に含む。来店客への商品の引き渡しと現金授受は店番担当が行い、来店客は画面を直接操作しないため Person に含めない。
|
|
55
|
+
|
|
56
|
+
## 3. 要素と境界の定義
|
|
57
|
+
|
|
58
|
+
### 3.1. 対象システムとシステム境界
|
|
59
|
+
|
|
60
|
+
境界内は販売操作の受付、金額計算、商品参照、販売と控えの保存、会計・印字結果の表示を担う。物理印字と機器制御はレシート印刷基盤へ、現金授受と保留取引の判断は店番担当・店主代表へ委ねる。ネットワークや機器を所有する範囲と、この責務の境界を混同しない。
|
|
61
|
+
|
|
62
|
+
### 3.2. Person(人・ロール)
|
|
63
|
+
|
|
64
|
+
| Person(図中ラベル) | 利用目的・接点 | 判断・確認の責務 |
|
|
65
|
+
| -------------------- | ------------------------------------------------ | ------------------------------------------------------------------ |
|
|
66
|
+
| 店主代表 | 販売画面で販売を記録し、保留取引を確認する | 現金と記録を照合し、結果不明や確定後の訂正を判断する |
|
|
67
|
+
| 家族利用者代表 | 同じ販売画面で店番を引き継ぎ、購入明細を入力する | 商品、請求額、釣銭、印字状態を確認し、未解決の取引を店主代表へ渡す |
|
|
68
|
+
|
|
69
|
+
開発担当と同行レビュー担当は設計・検証に関わるが、通常の店頭操作の Person には含めない。
|
|
70
|
+
|
|
71
|
+
### 3.3. Container(コンテナ)
|
|
72
|
+
|
|
73
|
+
| コンテナ(図中ラベル) | 責務 | 技術区分・実行配備の前提 |
|
|
74
|
+
| -------------------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
|
|
75
|
+
| 販売画面(タブレットのブラウザ) | 明細・預かり金の入力を受け、会計と印字の結果を表示する | ブラウザアプリ。表示中の明細だけを販売成立の根拠にしない。構築した画面資材をタブレットから利用する |
|
|
76
|
+
| 販売処理サービス | 金額を計算し、販売記録と控えを保存して印字を依頼する | _ASSUMPTION_: 店舗側で動くサービス。画面からは HTTP で利用し、ストアへはファイル入出力、印刷基盤へは外部コマンドで接続する |
|
|
77
|
+
|
|
78
|
+
販売画面と販売処理サービスは異なる実行単位である。商品検索・金額計算・保存はサービス内部の責務であり、本図では別コンテナに分割しない。具体的な言語・ライブラリ・バージョンは選定しない。
|
|
79
|
+
|
|
80
|
+
### 3.4. Data Store(データストア)
|
|
81
|
+
|
|
82
|
+
| ストア(図中ラベル) | 保持する情報・正本 | アクセスと生成物の境界 |
|
|
83
|
+
| -------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
84
|
+
| 販売記録ストア | 商品情報、販売実績、レシート控え、印字結果の記録。販売と印字の照合に使う店舗側の記録 | _ASSUMPTION_: 販売処理サービスが読み書きするファイル群。画面と印刷基盤は直接更新しない。控えは販売実績から作る派生物で、控えの再印刷を販売の再登録としない |
|
|
85
|
+
|
|
86
|
+
商品情報の更新・取込経路とバックアップは本例では設計していない。既存ノートの移行、他システムと共有する DB・schema、本部 API との統合はこの案に含めない。保存場所・アクセス条件は `kinuya-infra-design`、記録構造は `kinuya-record-schema` へ引き継ぐ。
|
|
87
|
+
|
|
88
|
+
### 3.5. External Software System(外部システム)
|
|
89
|
+
|
|
90
|
+
| 外部システム(図中ラベル) | 利用条件・責任分界 | 不在・障害時の影響 |
|
|
91
|
+
| -------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
|
|
92
|
+
| レシート印刷基盤 | 保存済み控えの印字時だけ使用する店舗側の外部コマンド・ドライバ。プリンタ制御と物理印字を担う | 未印字または印字結果不明になり得る。印字失敗だけで販売記録を取り消さず、店番担当が控えと紙面を照合する |
|
|
93
|
+
|
|
94
|
+
印刷基盤は販売処理サービスと同じ実行環境に置く案だが、管理する責務が異なるため境界外とする。外部決済・会計サービスへの接続は本図にはない。
|
|
95
|
+
|
|
96
|
+
### 3.6. Relationship(関係・連携契約)
|
|
97
|
+
|
|
98
|
+
正本欄の参照名は、本例の詳細設計へ渡す未同梱の架空文書名である。
|
|
99
|
+
|
|
100
|
+
| 関係 ID | 起点 → 終点 | 図中ラベル | 方式・条件と情報の要点 | 詳細の正本 |
|
|
101
|
+
| -------- | --------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------- | ------------------------------- |
|
|
102
|
+
| `REL-01` | 店主代表 → 販売画面(タブレットのブラウザ) | 現金販売の入力・結果確認 | タブレットでの操作。明細・預かり金を入力し、会計・印字結果を確認する | `kinuya-sales-screen` |
|
|
103
|
+
| `REL-02` | 家族利用者代表 → 販売画面(タブレットのブラウザ) | 現金販売の入力・引き継ぎ確認 | 同じ画面を交代して利用。未解決の取引と記録を確認する | `kinuya-sales-screen` |
|
|
104
|
+
| `REL-03` | 販売画面(タブレットのブラウザ) → 販売処理サービス | 販売記録依頼・結果取得 | _ASSUMPTION_: 店内 HTTP。明細と会計要求を渡し、取引の記録・印字状態を受け取る | `kinuya-sales-api` |
|
|
105
|
+
| `REL-04` | 販売処理サービス → 販売記録ストア | 商品参照・販売と控えの保存 | _ASSUMPTION_: ローカルファイル入出力。商品を参照し、販売と控え・印字状態を保存する | `kinuya-record-schema` |
|
|
106
|
+
| `REL-05` | 販売処理サービス → レシート印刷基盤 | 印字依頼・結果取得 | _ASSUMPTION_: 外部コマンド。保存した控えを渡して印字結果を受け取る | `kinuya-print-command-contract` |
|
|
107
|
+
|
|
108
|
+
## 4. 技術前提・制約と検証観点
|
|
109
|
+
|
|
110
|
+
### 4.1. 技術前提・制約
|
|
111
|
+
|
|
112
|
+
- _ASSUMPTION_: 販売成立はサービス側で販売実績の保存を確認して判断する。画面の表示更新、販売の保存、物理印字は別の結果として扱う。
|
|
113
|
+
- 画面資材を構築・配布する工程と、営業中に `REL-03`〜`REL-05` を通る工程を区別する。営業中の構築ツール起動は想定しない。
|
|
114
|
+
- 応答欠落では受付済みの可能性があるため、自動再送や画面での再入力によって二重販売を作らない契約が必要である。オフライン同期・再試行・排他制御の保証は本図では置かない。
|
|
115
|
+
- 店舗側サービスとファイル保存先への到達性を通常販売の前提とする。通信不能時の販売継続、HTTP の認証・保護、印刷コマンドの機器アクセス権は未確定であり、「メモ / 将来課題」で判断までの利用制限を扱う。
|
|
116
|
+
|
|
117
|
+
### 4.2. コンテナ間・外部依存の検証対象
|
|
118
|
+
|
|
119
|
+
以下は検証設計へ渡す期待結果であり、実装・実機で確認済みの保証ではない。QE は同じ取引を画面、保存実績、控え、紙面で照合する。各行の条件をすべて満たせば Pass、違反があれば Fail とし、観測方法や回復契約が未整備なら未判定として受入を保留する。
|
|
120
|
+
|
|
121
|
+
| 確認区分 | 対象関係・境界 | 観測する結果 | 主確認ロール |
|
|
122
|
+
| ------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ |
|
|
123
|
+
| 正常販売と引き継ぎ | `REL-01`〜`REL-04` | 両利用者が同じ購入明細を入力すると、参照した商品・単価に基づく請求額と保存実績が一致する。交代後も同じ取引の成立・印字状態を確認できる | BA / QE |
|
|
124
|
+
| 正常印字 | `REL-05` | 保存済み控えと紙面の取引・明細・請求額が一致し、画面で販売成立と印字完了を別々に識別できる | QE / DEV |
|
|
125
|
+
| 通信の応答欠落 | `REL-03` | 保存後に応答を失っても未受付・完了と断定せず、対象取引と照合待ちを表示する。同じ販売を自動再送せず、店主代表へ取引を引き継げる | QE / ARC |
|
|
126
|
+
| 保存先の障害 | `REL-04` | 読取不能時は商品を取得できたと扱わない。書込不能・中断時は販売成立を通知せず、対象取引と保存できた範囲を識別する。途中保存の照合・回復方式は課題へ渡す | QE / DEV |
|
|
127
|
+
| 印刷基盤の不在・結果不明 | `REL-05` | 未導入は未印字、送信後の時間切れは結果不明として通知し、販売成立と控えを維持する。店番担当が紙面を照合し、控えの手動再印刷で販売実績が増えない | QE / DEV |
|
|
128
|
+
|
|
129
|
+
文書検査は [[specdojo:cnd-rulebook|C4コンテナ図作成ルール]] の「検証・承認前の確認」に従い、`<対象.md>` を `docs/ja/specdojo/samples/cnd-sample.md` として実行する。QE は終了コード、全図の検査結果、生成 SVG の文字・矢印・境界の目視結果をレビューへ残す。内容面では、境界を含む全要素の定義と `REL-01`〜`REL-05` の端点・ラベルが図と表で一致すれば Pass とし、欠落・余剰・不一致は Fail とする。
|
|
130
|
+
|
|
131
|
+
## 5. メモ / 将来課題
|
|
132
|
+
|
|
133
|
+
| 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
|
|
134
|
+
| ---------------------- | ------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
135
|
+
| 上位図・配備案との照合 | 上位図と実配置が未確認。`based_on` は未接続 | ARC | `kinuya:pjr-a001-sales-placement` へ引き継ぐ。配備設計着手前に `cxd-kinuya-sales-web` と `kinuya-infra-design` でタブレット・店舗側サービス・印刷基盤の境界と配置を照合し、DEV / OPS が店舗での実行可能性を確認、PO が採用案を判断する |
|
|
136
|
+
| 入出力と記録の正本 | `REL-01`〜`REL-05`。画面、API、記録、印刷の契約が未同梱 | DEV | `kinuya:pjr-a002-sales-contracts` へ引き継ぐ。結合実装着手前に `kinuya-sales-screen`、`kinuya-sales-api`、`kinuya-record-schema`、`kinuya-print-command-contract` を整備し、ARC が各端点の責務と図の整合を確認すれば完了。構文・設定値・記録項目は各正本に置く |
|
|
137
|
+
| 応答欠落・保存中断 | `REL-03`・`REL-04`。取引識別、重複排除、照会、途中記録の扱いが未確定 | ARC | `kinuya:pjr-a003-sales-recovery` へ引き継ぐ。契約整備後、受入開始前に DEV と照合・回復方式を定め、QE が受付済み・未受付・不明の期待結果を検証設計へ反映する。PO の判断までは結果不明の取引を自動再送せず、当該経路の受入を保留する |
|
|
138
|
+
| 運用と接続条件 | 商品情報の更新、バックアップ、HTTP の保護、機器接続、通信不能時の店頭対応 | OPS | `kinuya:pjr-a004-sales-operations` へ引き継ぐ。店舗試行前に ARC / DEV と `kinuya-infra-design`・`kinuya-sales-operations` を整え、復元・接続不能・二重印字の確認結果を示す。BA が店番担当の引き継ぎを確認し、PO が営業への影響を許容するまで実運用を開始しない |
|
|
139
|
+
|
|
140
|
+
表の文書名と課題 ID は未同梱の架空の引き継ぎ先である。PM は各作業を上表の判断時点までに計画し、PO の採用・保留・差し戻しを `kinuya:pjr-a005-sales-approval` に集約する。本例では未決事項が残り、構成案として `draft` を維持する。
|
|
141
|
+
|
|
142
|
+
承認前に ARC は上位境界と詳細契約の照合結果、QE は文書検査・描画確認と結合対象の判定、BA は両利用者の正常販売・保留時の引き継ぎの確認結果、OPS は配備・復旧条件をそろえる。PO が残る仮定の影響と後続作業の制限を含めて承認を記録した後、人間が `ready` への昇格を判断する。OPS は承認対象と公開対象の一致を確認する。文書の承認と店舗での実運用開始はそれぞれ判断する。
|
|
143
|
+
|
|
144
|
+
構成・接続の変更時の窓口は ARC とする。ARC が上位図、`cpd-kinuya-sales-service`、`kinuya-infra-design` と本図を照合し、DEV が関係表の詳細契約、QE が該当する検証対象を追従させる。PM は課題と承認記録を更新し、QE は変更した Mermaid を正本として「検証・承認前の確認」の検査・SVG 再生成を行う。PO の再判断後、OPS が承認済みの版を公開する。
|
|
@@ -2,37 +2,151 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:cpd-sample
|
|
4
4
|
type: architecture
|
|
5
|
-
status:
|
|
6
|
-
|
|
5
|
+
status: ready
|
|
6
|
+
owner: ARC
|
|
7
|
+
rulebook: specdojo:cpd-rulebook
|
|
8
|
+
part_of: []
|
|
9
|
+
based_on:
|
|
10
|
+
- specdojo:cnd-sample
|
|
11
|
+
supersedes: []
|
|
7
12
|
---
|
|
8
13
|
|
|
9
|
-
#
|
|
14
|
+
# 駄菓子屋きぬや 販売処理サービス C4コンポーネント図
|
|
10
15
|
|
|
11
|
-
## 1.
|
|
16
|
+
## 1. 概要
|
|
12
17
|
|
|
13
|
-
|
|
18
|
+
[[specdojo:cnd-sample|販売管理システム C4コンテナ図]] の販売処理サービス内部を分割し、販売結果の保持と印字の失敗を分けて扱う境界を実装配置と結合テストの設計へ渡す。店主代表と家族利用者代表が、記憶やノートだけに頼らず同じ手順で現金販売を記録し、交代時に販売結果と発行状況を確認できるようにする。
|
|
14
19
|
|
|
15
|
-
|
|
20
|
+
業務目的と成功基準は [[specdojo:prj-overview-sample|プロジェクト概要]] の「基本的な考え方」「期待効果」を根拠とする。本分割は、販売記録の完遂と両利用者の確認結果の一致を支える。正常販売では同じ明細・請求額・販売結果を確認でき、保存失敗・未印字・結果不明では未完了の取引を店主代表へ引き継げることを確認対象とする。在庫・つけを含むプロジェクト全体の成功は、本図だけでは判定しない。
|
|
16
21
|
|
|
17
|
-
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/cpd-mermaid-rulebook.md`
|
|
22
|
+
_ASSUMPTION_: 上位図の単一店舗・タブレット1台・店舗側サービスを引き継ぐ学習用の論理分割案であり、実装確認済みの構成ではない。対象は現金販売の明細確認から記録・控えの保存と印字依頼までとし、在庫更新、つけ管理、EC、本格会計、仕入れ先連携は扱わない。CLI と本部 API を使う [[specdojo:clis-sample|販売管理 CLI 仕様]] は別構成の例であり、本サービスの直接の設計根拠にはしない。
|
|
20
23
|
|
|
21
|
-
|
|
24
|
+
本例の役割割当ては、開発担当が ARC / DEV、技術メンターがアーキテクチャ確認、同行レビュー担当が QE、店舗運営アドバイザーが OPS、店主代表が人間の PO を担う想定とする。BA は両利用者との業務確認、PM は後続作業と未決事項の管理を担当する。合意対象は内部の責務・依存方向と失敗時の分界であり、PO が最終合意、店舗運用の可否、公開可否と説明責任を担う。公開候補は本書の本文・図・ラベル・参照先で、学習用ドキュメントサイトの読者に示す範囲とする。技術検査の成功を公開許可とは扱わない。
|
|
22
25
|
|
|
23
|
-
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
26
|
+
## 2. C4コンポーネント図(Mermaid)
|
|
25
27
|
|
|
26
|
-
|
|
28
|
+
```mermaid
|
|
29
|
+
flowchart LR
|
|
30
|
+
販売画面["販売画面<br>(別コンテナ)"]
|
|
31
|
+
販売記録[("販売記録ストア")]
|
|
32
|
+
印刷基盤["レシート印刷基盤"]
|
|
27
33
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
34
|
+
subgraph 境界["販売処理サービス"]
|
|
35
|
+
受付("販売受付")
|
|
36
|
+
明細確認("明細確認")
|
|
37
|
+
会計("会計処理")
|
|
38
|
+
保存("記録アクセス")
|
|
39
|
+
印字("印字連携")
|
|
40
|
+
end
|
|
33
41
|
|
|
34
|
-
|
|
42
|
+
販売画面 -->|"REL-01 販売依頼・結果取得"| 受付
|
|
43
|
+
受付 -->|"REL-02 商品・数量の確認依頼"| 明細確認
|
|
44
|
+
明細確認 -->|"REL-03 商品の参照"| 保存
|
|
45
|
+
受付 -->|"REL-04 確認済み明細の会計依頼"| 会計
|
|
46
|
+
会計 -->|"REL-05 販売結果・控えの保存"| 保存
|
|
47
|
+
保存 -->|"REL-06 商品参照・販売と控えの保存"| 販売記録
|
|
48
|
+
会計 -->|"REL-07 保存済み控えの印字依頼"| 印字
|
|
49
|
+
印字 -->|"REL-08 印字依頼・発行結果取得"| 印刷基盤
|
|
50
|
+
印字 -->|"REL-09 発行状況の記録"| 保存
|
|
35
51
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
52
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
53
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
54
|
+
class 受付,明細確認,会計,保存,印字 system;
|
|
55
|
+
class 販売画面,販売記録,印刷基盤 external;
|
|
56
|
+
style 境界 fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
矢印は主たる依頼・参照の向きで、応答を含む。販売と控えの保存を確認してから印字を依頼する案であり、すべての矢印が毎回通るという意味ではない。画面内の操作手順とサービス内の全呼び出しは省略する。
|
|
60
|
+
|
|
61
|
+
## 3. 要素と境界の定義
|
|
62
|
+
|
|
63
|
+
### 3.1. 対象コンテナ境界と利用者
|
|
64
|
+
|
|
65
|
+
境界内は販売依頼の受付、明細の確認、会計結果の組立て、記録へのアクセス、印字の委譲である。販売画面、永続記録、物理印字は外側に置く。内部の五つの責務は同じサービスの論理的な配置であり、五つの別プロセスを要求しない。
|
|
66
|
+
|
|
67
|
+
Person は直接サービスを操作しないため図では非該当とし、直接の呼出元である販売画面だけを描く。
|
|
68
|
+
|
|
69
|
+
| 上位図の Person | 本図の接点と確認する結果 |
|
|
70
|
+
| --------------- | -------------------------------------------------------------------- |
|
|
71
|
+
| 店主代表 | 販売画面を介し、会計結果と未印字・結果不明の取引を確認する |
|
|
72
|
+
| 家族利用者代表 | 同じ画面で販売を記録し、交代時に対象取引と未完了の発行状況を引き継ぐ |
|
|
73
|
+
|
|
74
|
+
### 3.2. コンポーネントと論理配置
|
|
75
|
+
|
|
76
|
+
| コンポーネント | 固有の責務 | 主な入力 → 出力 | 論理配置・境界 |
|
|
77
|
+
| -------------- | ------------------------------------------------------------ | ------------------------------------------- | ---------------------------------------------------- |
|
|
78
|
+
| 販売受付 | 画面からの依頼を受け、確認・会計の結果を返す | 販売依頼 → 明細・会計結果・発行状況 | 入力境界。取引の更新判断を独自に持たない |
|
|
79
|
+
| 明細確認 | 商品と数量を照合し、会計対象の明細を組み立てる | 商品指定・数量 → 確認済み明細または訂正理由 | 会計の前段。物理印字は扱わない |
|
|
80
|
+
| 会計処理 | 確認済み明細から販売結果と控えを作り、保存後に印字を依頼する | 明細・支払情報 → 販売結果・控え・印字依頼 | 販売結果を作る責務。発行状況の管理は印字連携へ委ねる |
|
|
81
|
+
| 記録アクセス | 商品を参照し、販売結果・控え・発行状況を保持する | 参照・保存要求 → 内容・保存結果 | 共通の記録接点。販売可否を判断しない |
|
|
82
|
+
| 印字連携 | 保存済み控えを印刷基盤へ渡し、発行状況を記録する | 控え → 発行結果または結果不明の通知 | 外部接点。販売を再登録しない |
|
|
83
|
+
|
|
84
|
+
会計処理と印字連携を分ける理由は、印字障害で保存済み販売をやり直さず、交代時に未印字だけを引き継げるようにするためである。明細確認は入力訂正を保存前に返すため会計から分離し、記録アクセスは商品参照・販売保存・発行状況保存の接点を集約する。販売可否の判断を共通の記録接点へ移さない。ソース配置は未確認で、DEV の詳細設計へ引き継ぐ。
|
|
85
|
+
|
|
86
|
+
### 3.3. ストアと外部依存
|
|
87
|
+
|
|
88
|
+
| 要素・区分 | 保持内容または委ねる責務 | 利用条件・失敗の影響 |
|
|
89
|
+
| -------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------ |
|
|
90
|
+
| 販売画面(別コンテナ) | 店番担当による入力と結果確認 | 直接の呼出元。応答欠落時に画面の未表示だけで販売未実施と判断できない |
|
|
91
|
+
| 販売記録ストア(ストア) | 商品参照用情報、販売結果、控え、発行状況 | 記録アクセスから利用する。保存失敗時は残った記録と対象取引の照合が必要 |
|
|
92
|
+
| レシート印刷基盤(外部システム) | 控えの物理印字と発行結果の通知 | 保存済み控えの印字時に利用する。用紙切れ・接続断・応答欠落は販売結果と区別する |
|
|
93
|
+
|
|
94
|
+
### 3.4. 関係と詳細の正本
|
|
95
|
+
|
|
96
|
+
正本欄は未同梱の架空参照名である。外部接点は上位図の詳細化先を引き継ぎ、内部関係のみ `kinuya-sales-component-design` で補う。データ項目・構文・再実行条件は本図で規定しない。本図の `REL-01`・`REL-06`・`REL-08` は、それぞれ上位図の `REL-03`・`REL-04`・`REL-05` のサービス側接点を具体化する。
|
|
97
|
+
|
|
98
|
+
| 関係 ID | 起点 → 終点 | 授受情報・条件 | 詳細の正本 |
|
|
99
|
+
| -------- | ----------------------------- | ---------------------------------------------------- | ------------------------------- |
|
|
100
|
+
| `REL-01` | 販売画面 → 販売受付 | 販売依頼と対象取引の結果。応答欠落時は取引を照合する | `kinuya-sales-api` |
|
|
101
|
+
| `REL-02` | 販売受付 → 明細確認 | 商品と数量の確認依頼、明細または訂正理由 | `kinuya-sales-component-design` |
|
|
102
|
+
| `REL-03` | 明細確認 → 記録アクセス | 商品の参照依頼と参照結果 | 同上 |
|
|
103
|
+
| `REL-04` | 販売受付 → 会計処理 | 確認済み明細と支払情報、販売結果と発行状況 | 同上 |
|
|
104
|
+
| `REL-05` | 会計処理 → 記録アクセス | 販売結果・控えの保存依頼と保存結果 | `kinuya-sales-component-design` |
|
|
105
|
+
| `REL-06` | 記録アクセス → 販売記録ストア | 商品の参照、販売結果・控え・発行状況の保存 | `kinuya-record-schema` |
|
|
106
|
+
| `REL-07` | 会計処理 → 印字連携 | 保存済み控えの印字依頼と発行状況 | `kinuya-sales-component-design` |
|
|
107
|
+
| `REL-08` | 印字連携 → レシート印刷基盤 | 控えの印字依頼と発行結果。販売の再登録は含めない | `kinuya-print-command-contract` |
|
|
108
|
+
| `REL-09` | 印字連携 → 記録アクセス | 対象取引の発行状況と保存結果 | `kinuya-sales-component-design` |
|
|
109
|
+
|
|
110
|
+
## 4. 技術前提・制約と検証観点
|
|
111
|
+
|
|
112
|
+
### 4.1. 技術前提・制約
|
|
113
|
+
|
|
114
|
+
- 受付から明細確認・会計処理へ、各処理から記録アクセス・印字連携へ依存する。共通の記録アクセスから販売受付への逆依存は設けない。
|
|
115
|
+
- _ASSUMPTION_: 上位図に従い、画面からは店内 HTTP、記録ストアへはローカルファイル入出力、印刷基盤へは外部コマンドで接続する。販売処理サービスのランタイム・バージョン、保存先と権限、機器接続条件は `kinuya-infra-design` へ委ね、DB 製品の導入を前提にしない。通常販売には店舗側サービスと保存先への到達性が必要である。
|
|
116
|
+
- 販売結果・保存済み控え・発行状況は照合の根拠である。画面の表示と物理紙面はそれらの確認対象で、表示を更新しても保存成功の代わりにはならない。印字内容は保存済み控えから作り、再印刷を新規販売登録にしない。
|
|
117
|
+
- _ASSUMPTION_: 販売結果と控えの保存が確認できるまで印字を依頼しない。保存の原子性や途中失敗後の回復は未確定で、詳細の記録契約へ委ねる。
|
|
118
|
+
- 印字失敗だけで保存済み販売を取り消さない。応答欠落時に無条件で販売または印字を繰り返さず、店主代表と開発担当が残った記録・紙面を照合する。
|
|
119
|
+
- 店主代表が販売・保留・回復の判断を担う。サービスの成功通知や印字結果だけで、実際の現金授受や運用承認を保証しない。
|
|
120
|
+
|
|
121
|
+
### 4.2. コンポーネント間の検証対象
|
|
122
|
+
|
|
123
|
+
以下は結合テスト設計への入力であり、店舗での確認済み結果を示すものではない。QE / DEV が同じ取引の依頼・保存記録・控え・発行状況と紙面を照合する。各行の観測結果をすべて満たせば Pass、違反すれば Fail、契約や観測方法が未整備なら未判定として当該経路の受入を保留する。
|
|
124
|
+
|
|
125
|
+
| 対象関係 | 条件 | 観測する結果 |
|
|
126
|
+
| ------------------ | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
|
|
127
|
+
| `REL-01`〜`REL-09` | 有効な明細・支払情報で販売し、保存と印字が成功する | 両利用者が同じ明細・請求額・販売結果を確認でき、保存済み控えと紙面が一致する。販売と発行状況を別々に確認できること |
|
|
128
|
+
| `REL-02`〜`REL-04` | 未登録商品や訂正が必要な数量を入力する | 訂正理由が返り、未確認明細が会計へ渡らないこと |
|
|
129
|
+
| `REL-03`・`REL-06` | 商品の参照が失敗する | 参照失敗と未登録商品を区別し、未確認の商品・単価で会計しないこと |
|
|
130
|
+
| `REL-05`〜`REL-07` | 販売結果または控えの保存が失敗する | 販売成立を通知せず、保存できた範囲を識別し、確認前に印字を依頼しないこと |
|
|
131
|
+
| `REL-07`・`REL-08` | 保存成功後に印刷基盤が失敗・応答欠落する | 販売結果を保持し、発行失敗と結果不明を区別すること |
|
|
132
|
+
| `REL-09` | 印字後の発行状況保存が失敗する | 紙面が存在し得ることと、記録が未確認であることを販売受付側へ渡せること |
|
|
133
|
+
| `REL-01` | 会計要求後に画面への応答が欠ける | 同じ取引の照合へ引き継ぎ、新規の販売登録を先行させないこと |
|
|
134
|
+
|
|
135
|
+
文書検査は [[specdojo:cpd-rulebook|CPD 作成ルール]] の「検証と合意の判定」に従い、`<対象.md>` を `docs/ja/specdojo/samples/cpd-sample.md` とする。QE は全8要素(内部5、外部3)と境界の定義、全9関係の ID・端点・ラベルの対応を照合し、欠落・不一致を Fail とする。メタ情報・参照・構文の検査結果と SVG の文字・矢印・境界の描画確認を実行記録へ残す。コマンドと構文は rulebook とリポジトリ設定を参照し、ここへ再掲しない。
|
|
136
|
+
|
|
137
|
+
## 5. メモ / 将来課題
|
|
138
|
+
|
|
139
|
+
以下の PJR 名は未起票の架空の登録候補である。上位図で同じ対象を追跡する候補へ集約し、PM が詳細設計の計画時に起票・担当割当てと Schedule への反映を行う。ARC は調査結果を PM へ報告し、構成・業務・公開判断に影響する残件は人間の PO へ上げる。
|
|
140
|
+
|
|
141
|
+
| 対象・区分 | 影響と後続成果物 | 担当・判断者 | 判断タイミング | 次アクション・解消条件 | 承認への影響・引き継ぎ先 |
|
|
142
|
+
| ------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
143
|
+
| 内部配置の仮定・確認課題 | 全5コンポーネント。実装配置・内部設計は未確認 | ARC / DEV が整理、技術メンターが確認、PO が採用判断 | 詳細設計への引き渡し前 | 上位 CND の販売処理サービス内に収まる配置を DEV が示し、ARC が責務と依存方向を照合する | 未解消なら構成の確定を保留。`kinuya:pjr-a001-sales-placement` に内部の配置確認を追加 |
|
|
144
|
+
| 詳細契約の未整備・課題 | `REL-01`〜`REL-09`。API、記録 schema、印刷契約と内部設計が未同梱 | DEV が整備、ARC / QE が照合、PO が残る制限を判断 | 結合実装着手前 | 関係表の4正本で入出力・保存結果・発行状況を定義し、QE が観測方法を結合テスト設計へ接続する | 契約を調べる作業は進め、当該結合実装は保留。`kinuya:pjr-a002-sales-contracts` に集約 |
|
|
145
|
+
| 保存中断・印字応答欠落のリスク | `REL-05`〜`REL-09`。販売の二重登録・二重印字の懸念。回復条件が未確定 | ARC / DEV が案を作成、QE が検証、PO が業務上の採否を判断 | 契約整備後、受入開始前 | 保存済み・未保存・結果不明の照合と控えだけの再印刷条件を定め、紙面と記録を比較できる期待値を示す | 自動再送を認めず、当該経路の受入を保留。PM が `kinuya:pjr-a003-sales-recovery` を追跡 |
|
|
146
|
+
| _UNDECIDED_: 店舗運用・公開範囲 | 正常販売と保留・引き継ぎ、接続不能時の扱い、公開用図。実機・業務確認は未実施 | BA / OPS が両利用者と確認、QE が証跡を照合、人間の PO が最終判断 | 店舗試行・公開前 | `kinuya-infra-design`・`kinuya-sales-operations` で接続・回復条件を整え、OPS が公開対象の本文・図・ラベル・参照先を確認する | 運用未確認は店舗試行を、公開判断未了は公開を保留。PM が `kinuya:pjr-a004-sales-operations` と `kinuya:pjr-a005-sales-approval` へ接続 |
|
|
147
|
+
|
|
148
|
+
PM は「配置の照合 → 契約整備 → 結合検証 → 店舗試行・公開判断」の順で作業を割り当て、関係数と回復条件の未確定範囲から見積もる。日付は未設定であり、各判断時点を満たせない場合は後続開始を延期し、上表の担当・解消条件を進捗確認に使う。構成の採否、販売・保留・回復の条件、公開範囲の判断結果は `kinuya:pjr-a005-sales-approval` に残す想定とする。
|
|
149
|
+
|
|
150
|
+
PO の合意依頼には ARC の境界・契約の照合、DEV の実装対応、QE の文書検査・描画確認と結合観測点、BA の両利用者による正常・保留時の確認、OPS の運用・公開前確認をそろえる。OPS は個人情報、認証情報、実店舗の内部接続先を公開候補から除外し、確認範囲と残る懸念を合意記録へ渡す。本例は架空の役割名・構成と仮参照名だけを扱う。PO が承認・保留・差し戻しと公開先・可否を記録し、人間が `ready` への昇格を判断する。境界・責務・受け渡し・成功基準に影響する上表の残件がある現状は `draft` を維持する。
|
|
151
|
+
|
|
152
|
+
保守・問い合わせの窓口は ARC とし、上位 CND、保存責務、印刷契約または実装の変更を契機に再照合する。例えば保存責務を変える場合、ARC が `REL-05`・`REL-06`・`REL-09` と図・定義表、DEV が `kinuya-record-schema`・内部設計・実装、QE が保存失敗の結合観測点、OPS が回復手順を確認する。PM は更新要否と理由・担当を PJR に残し、後続作業の開始条件を Schedule へ反映する。境界が変われば上位 CND も改訂し、変わらなければ更新不要の理由を記録する。OPS が Mermaid から SVG を再生成し、QE が変更箇所の再検査・描画を確認した後、人間の PO が再合意・公開を判断する。
|
|
@@ -2,37 +2,123 @@
|
|
|
2
2
|
specdojo:
|
|
3
3
|
id: specdojo:cxd-sample
|
|
4
4
|
type: architecture
|
|
5
|
-
status:
|
|
6
|
-
rulebook: specdojo:cxd-
|
|
5
|
+
status: ready
|
|
6
|
+
rulebook: specdojo:cxd-rulebook
|
|
7
|
+
part_of: []
|
|
8
|
+
based_on: []
|
|
7
9
|
---
|
|
8
10
|
|
|
9
|
-
#
|
|
11
|
+
# 駄菓子屋きぬや 販売管理 CLI C4コンテキスト図
|
|
10
12
|
|
|
11
|
-
## 1.
|
|
13
|
+
## 1. 概要
|
|
12
14
|
|
|
13
|
-
|
|
15
|
+
店主代表と家族利用者代表が現金販売を記録し、会計と印字の結果を次の店番へ引き継ぐための販売管理 CLI を対象とする。店頭での操作、商品・売上の外部管理、レシート印刷の責任分界を定義し、通信や印字の失敗を会計のやり直しと混同しないようにする。本図は [[specdojo:clis-sample|販売管理 CLI 仕様]] と同じ学習用の構成を扱い、通常利用のタブレット画面、在庫調整、つけ管理、仕入れ、キャッシュレス決済は対象外とする。
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
| 対象者 | 課題・関心事 | 本図で確認する内容 |
|
|
18
|
+
| ---------------------- | ---------------------------------------------- | ------------------------------------------------------ |
|
|
19
|
+
| 店主代表 | 暗算やノートへの転記に頼らず販売結果を把握する | 会計の判断を人間が担い、外部連携の失敗を区別できること |
|
|
20
|
+
| 家族利用者代表 | 店主不在でも同じ境界と手順で店番を続ける | 自分が操作する範囲と、保留時に店主へ戻す判断 |
|
|
21
|
+
| 技術メンター・開発担当 | CLI と外部基盤の責務を分ける | 商品・売上の管理主体、会計と印刷の分界 |
|
|
22
|
+
| 同行レビュー担当 | 二重会計と結果不明の見落としを防ぐ | 境界テストの対象と、契約未整備の経路 |
|
|
16
23
|
|
|
17
|
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/cxd-mermaid-rulebook.md`
|
|
24
|
+
_ASSUMPTION_: 店舗端末1台から人が操作し、商品照会と売上登録には本部商品・売上管理基盤を使う。これは学習用 CLI に限った外部 API の仮定であり、複数店舗展開や本格会計を初期範囲に加えるものではない。
|
|
20
25
|
|
|
21
|
-
##
|
|
26
|
+
## 2. C4コンテキスト図(Mermaid)
|
|
22
27
|
|
|
23
|
-
|
|
24
|
-
|
|
28
|
+
```mermaid
|
|
29
|
+
flowchart LR
|
|
30
|
+
店主代表["👤 店主代表"]
|
|
31
|
+
家族利用者代表["👤 家族利用者代表"]
|
|
25
32
|
|
|
26
|
-
|
|
33
|
+
subgraph 境界["対象システム"]
|
|
34
|
+
販売管理CLI("駄菓子屋きぬや<br>販売管理 CLI")
|
|
35
|
+
end
|
|
27
36
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
| ドキュメント | [C4コンテキスト図](../rulebooks/cxd-rulebook.md) | 最小サンプル |
|
|
31
|
-
| 目的 | 対象システムと「境界外」の人・外部システムとの関係を俯瞰的に定義する | specdojo:deliverables-reference 準拠 |
|
|
32
|
-
| 主な内容 | ユーザー、外部システム、本システムの関係図 | 要点のみ記載 |
|
|
37
|
+
本部基盤["本部商品・売上管理基盤"]
|
|
38
|
+
印刷基盤["レシート印刷基盤"]
|
|
33
39
|
|
|
34
|
-
|
|
40
|
+
店主代表 -->|"現金販売の記録・結果確認"| 販売管理CLI
|
|
41
|
+
家族利用者代表 -->|"現金販売の記録・引き継ぎ確認"| 販売管理CLI
|
|
42
|
+
販売管理CLI -->|"商品照会・売上登録"| 本部基盤
|
|
43
|
+
販売管理CLI -->|"印字依頼・結果取得"| 印刷基盤
|
|
35
44
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
45
|
+
classDef person fill:#fff3bf,stroke:#f08c00,color:#000;
|
|
46
|
+
classDef system fill:#d0ebff,stroke:#1c7ed6,color:#000;
|
|
47
|
+
classDef external fill:#e9ecef,stroke:#495057,color:#000;
|
|
48
|
+
class 店主代表,家族利用者代表 person;
|
|
49
|
+
class 販売管理CLI system;
|
|
50
|
+
class 本部基盤,印刷基盤 external;
|
|
51
|
+
style 境界 fill:#ffffff,fill-opacity:0,stroke:#868e96,stroke-width:1px,stroke-dasharray: 5 5;
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
矢印は主たる操作・依頼の方向を表し、照会結果や受付応答は同じ関係に含む。来店客は店番担当を介して現金とレシートを受け渡し、CLI を直接操作しないため Person に含めない。
|
|
55
|
+
|
|
56
|
+
## 3. 要素と境界の定義
|
|
57
|
+
|
|
58
|
+
### 3.1. 対象システムとシステム境界
|
|
59
|
+
|
|
60
|
+
| 項目 | 内容 |
|
|
61
|
+
| ------------------ | -------------------------------------------------------------------------------------------------------------- |
|
|
62
|
+
| システム名 | 駄菓子屋きぬや 販売管理 CLI |
|
|
63
|
+
| 提供する中核責務 | 取引開始、明細追加、請求額確認、現金会計の確定、確定前取消、会計・印字結果の表示と記録 |
|
|
64
|
+
| 境界内に含める範囲 | 人からの操作受付、金額計算、取引状態と販売実績・レシート控えの保持、外部基盤への依頼と応答の取り扱い |
|
|
65
|
+
| 境界外へ委ねる範囲 | 商品マスタと売上受付は本部基盤、機器制御と物理印字は印刷基盤、現金授受と保留取引の業務判断は店番担当・店主代表 |
|
|
66
|
+
|
|
67
|
+
### 3.2. Person(人・ロール)
|
|
68
|
+
|
|
69
|
+
| Person(図中ラベル) | 対応ロール・利用者区分 | 利用目的・主な関わり | 境界上の接点・確認責務 |
|
|
70
|
+
| -------------------- | ---------------------- | ---------------------------------------------------- | -------------------------------------------------------------------------- |
|
|
71
|
+
| 店主代表 | 店舗責任者・店番担当 | 自分で販売を記録し、保留取引と引き継ぎ結果を確認する | CLI の結果と現金・本部受付を照合し、確定後の訂正や結果不明の取引を判断する |
|
|
72
|
+
| 家族利用者代表 | 店番担当 | 現金販売を記録し、請求額と釣銭を提示する | 完了・未印字・結果不明を区別し、未解決の取引番号と記録を店主代表へ渡す |
|
|
73
|
+
|
|
74
|
+
技術メンター・開発担当と同行レビュー担当は本図を設計・検証に用いる関係者であり、店頭販売の直接操作者としては描かない。
|
|
75
|
+
|
|
76
|
+
### 3.3. External Software System(外部システム)
|
|
77
|
+
|
|
78
|
+
| 外部システム(図中ラベル) | 区分・利用条件 | 対象システムとの責任分界 | 不在・障害時の影響と境界上の扱い |
|
|
79
|
+
| -------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
|
|
80
|
+
| 本部商品・売上管理基盤 | 明細追加・会計確定に必須の外部 API | CLI が商品コードや販売実績を渡し、本部側が商品情報の返却と売上受付を担う | 商品照会失敗では明細を追加しない。売上要求後の応答欠落では受付済みの可能性があるため、結果不明を未登録と断定しない |
|
|
81
|
+
| レシート印刷基盤 | 印字時のみ使う店舗端末上の外部コマンド・ドライバ | CLI が保存済みのレシートを渡し、外部基盤がプリンタとの通信と物理印字を担う | 未導入では未印字、送信後の異常終了・時間切れ・結果不正では印字結果不明として通知する。会計を維持し、控えと紙面を確認して再印刷を判断する |
|
|
82
|
+
|
|
83
|
+
印刷基盤は販売管理 CLI と同じ端末で動くが、物理印字を担う別のソフトウェアとして境界外に置く。
|
|
84
|
+
|
|
85
|
+
### 3.4. Relationship(関係・連携契約)
|
|
86
|
+
|
|
87
|
+
| 関係 ID | 起点 → 終点 | 図中ラベル | やり取りする情報・制御の要点 | 連携方式・境界 | 正本・関連仕様 |
|
|
88
|
+
| -------- | ------------------------------------- | ---------------------------- | ---------------------------------------------- | ---------------------------- | --------------------------------------------------------------------- |
|
|
89
|
+
| `REL-01` | 店主代表 → 販売管理 CLI | 現金販売の記録・結果確認 | 購入明細・預かり金の入力、会計・印字状態の確認 | 人間による CLI 操作 | [[specdojo:clis-sample\|販売管理 CLI 仕様]] |
|
|
90
|
+
| `REL-02` | 家族利用者代表 → 販売管理 CLI | 現金販売の記録・引き継ぎ確認 | 販売操作と結果の確認、保留取引の引き継ぎ | 人間による CLI 操作 | [[specdojo:clis-sample\|販売管理 CLI 仕様]] |
|
|
91
|
+
| `REL-03` | 販売管理 CLI → 本部商品・売上管理基盤 | 商品照会・売上登録 | 商品情報の取得、販売実績の送信と受付応答 | 外部 API 呼び出し | `ifx-api-kinuya-products.yaml`、`ifx-api-kinuya-sales.yaml`(未同梱) |
|
|
92
|
+
| `REL-04` | 販売管理 CLI → レシート印刷基盤 | 印字依頼・結果取得 | 保存済みレシートの引き渡しと印字結果の取得 | ローカル外部コマンド呼び出し | [[specdojo:ifx-cmd-sample\|レシート印刷コマンド連携仕様]] |
|
|
93
|
+
|
|
94
|
+
引数、電文、保存ファイルの構造は各操作・連携の正本へ委ねる。本図の外部 API の参照名は架空契約であり、未同梱の状態を実接続可能な保証とは扱わない。
|
|
95
|
+
|
|
96
|
+
## 4. 技術前提・制約と検証観点
|
|
97
|
+
|
|
98
|
+
### 4.1. 技術前提・制約
|
|
99
|
+
|
|
100
|
+
- 単一店舗・単一端末で人が操作し、明細追加・会計確定には本部 API への到達性を要する。無人会計や通信不能時の販売継続は扱わない。
|
|
101
|
+
- 会計確定の通知は本部受付とローカル販売実績の保存を確認してから行うという学習用の前提を置く。応答欠落・保存失敗後の回復方式は「メモ / 将来課題」へ引き継ぐ。
|
|
102
|
+
- 会計確定と物理印字の成否を分ける。印刷のために会計・売上登録を再実行しない。
|
|
103
|
+
- 開発担当が本部 API の認証を実行環境に設定し、CLI は認証不足・拒否を店番担当へ通知する。認証値を仕様・販売記録・レシートへ記載せず、設定方法は CLI 仕様の参照先へ委ねる。USB 直結の印刷基盤には認証情報を渡さず、機器のアクセス権は開発担当が管理する。
|
|
104
|
+
|
|
105
|
+
### 4.2. システム境界・外部依存の検証観点
|
|
106
|
+
|
|
107
|
+
以下は検証設計へ渡す期待結果であり、実装・実機で確認済みの保証ではない。各ケースで取引番号をそろえ、CLI の表示、ローカルの保持記録、本部受付または印字結果を照合する。
|
|
108
|
+
|
|
109
|
+
| 確認区分 | 対象関係・境界 | 検証観点 | 主確認ロール |
|
|
110
|
+
| ------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
|
|
111
|
+
| 正常会計と引き継ぎ | `REL-01`・`REL-02` | 両者の操作で、本部受付・ローカル保存を伴う会計確定と印字結果を別々に確認できるか。保留時に取引番号と保持記録を店主代表へ渡せるか | PO / BA |
|
|
112
|
+
| 商品照会の失敗 | `REL-03` | 接続不能・時間切れ・認証拒否で明細が増えず、追加未実施と原因を表示するか。認証値を表示・記録しないか | QE / DEV |
|
|
113
|
+
| 売上受付の結果不明 | `REL-03` | 本部が受け付けた後に応答を欠落させても、未登録・完了と断定せず取引と送信内容を保持するか。店主代表が照合待ちと判断し、再登録・取消を繰り返さず保留できるか | QE / ARC |
|
|
114
|
+
| 受付後の保存失敗 | `REL-03`・CLI の記録境界 | 本部受付後にローカル保存を失敗させた際、会計確定を通知せず、受付状態と保存できた範囲を識別できるか。売上の再登録で回復しないか | QE / DEV |
|
|
115
|
+
| 印刷基盤の不在 | `REL-04` | 印刷基盤が未導入でも会計は確定したままで、印字未完了の警告と保存済みの控えを確認できるか | QE / DEV |
|
|
116
|
+
| 印字結果の不明 | `REL-04` | 時間切れ・結果不正では自動再印刷せず、警告・控え・紙面を照合して判断できるか。手動再印刷で売上が増えないか | QE / DEV |
|
|
117
|
+
|
|
118
|
+
## 5. メモ / 将来課題
|
|
119
|
+
|
|
120
|
+
| 対象・論点 | 影響範囲 | 担当ロール | 解消条件・引き継ぎ先 |
|
|
121
|
+
| ------------------- | ---------------------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
122
|
+
| 架空の本部 API 契約 | `REL-03`。売上の受付照会・重複排除・保存失敗後の回復 | ARC / DEV | `ifx-api-kinuya-products.yaml`・`ifx-api-kinuya-sales.yaml` の整備時に照合・回復方法を定める。QE が応答欠落・受付済み・未受付の期待結果を確認するまで当該経路の受入を保留し、結果不明の取引を自動再送しない |
|
|
123
|
+
| 印字経路の実機確認 | `REL-04`。未印字と結果不明、二重印字の識別 | DEV / QE | 開発担当と店番担当が紙面・控えの照合と再印刷を確認し、会計を再実行しないことを検証する |
|
|
124
|
+
| 内部構成・配置 | 取引記録と外部連携を担う内部構成 | ARC | 未同梱の `cnd-kinuya-sales-cli`・`ifd-kinuya-sales-cli` で記録と実行環境を詳細化し、本図の外部境界を維持する |
|