specdojo 0.7.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +7 -3
- package/CHANGELOG.md +217 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/catalog.js +16 -14
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +9 -3
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +616 -261
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +11 -12
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +23 -18
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +268 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +31 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +100 -39
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +179 -8
- package/dist/exec/evidence.js +77 -19
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +209 -15
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +45 -19
- package/dist/exec/plans-generation.js +52 -30
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +21 -5
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +106 -25
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +112 -0
- package/dist/exec/run/agent-pipeline.js +78 -8
- package/dist/exec/run/agent.js +32 -13
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +73 -33
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +135 -41
- package/dist/exec/run/lifecycle-commands.js +189 -37
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +14 -15
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +77 -17
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +95 -31
- package/dist/exec/run/register-state.js +23 -15
- package/dist/exec/run/register-worktree.js +184 -139
- package/dist/exec/run/schedule-mode.js +79 -18
- package/dist/exec/run/schedule-prepare.js +204 -59
- package/dist/exec/run/schedule-task.js +203 -49
- package/dist/exec/run/shared.js +9 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +14 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +8 -4
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +38 -17
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +32 -4
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +7 -5
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +7 -1
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +87 -11
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +109 -39
- package/dist/job/noop.js +104 -0
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +6 -3
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -16
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +13 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +189 -71
- package/dist/routine/status.js +62 -0
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +39 -39
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +7 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +186 -16
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +73 -41
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +74 -6
- package/dist/shared/timeline-index.js +2 -0
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
- package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
- package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +303 -148
- package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +87 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
- package/docs/ja/specdojo/samples/bes-sample.md +70 -21
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +57 -15
- package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +125 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
- package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
- package/docs/ja/specdojo/samples/sf-sample.md +109 -21
- package/docs/ja/specdojo/samples/sld-sample.md +88 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +141 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +10 -7
- package/templates/antigravity/orchestrator.md +7 -3
- package/templates/claude/agents/specdojo-orchestrator.md +7 -3
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
- package/templates/codex/orchestrator.md +7 -3
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
|
@@ -2,37 +2,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` で記録と実行環境を詳細化し、本図の外部境界を維持する |
|
|
@@ -1,39 +1,85 @@
|
|
|
1
1
|
# yaml-language-server: $schema=../../../specdojo/schemas/v1/dct-index.schema.yaml
|
|
2
2
|
# dct-index-sample.yaml
|
|
3
|
-
#
|
|
4
|
-
#
|
|
3
|
+
# 駄菓子屋きぬや 販売管理システム構築の成果物カタログ索引。
|
|
4
|
+
# 背景・対象範囲は [[specdojo:sample-authoring-standard|Sample 記述標準]] の共通サンプル文脈に従う。
|
|
5
|
+
# 単一店舗・タブレット1台で、店頭販売、在庫、つけの記録と確認を支援する。
|
|
6
|
+
# EC、本格会計、仕入れ先とのシステム連携は対象外。本部 API を使う CLI 固有の拡張例は含めない。
|
|
7
|
+
# 構造・値の制約は先頭の schema、分類は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] を正本とする。
|
|
8
|
+
#
|
|
9
|
+
# _ASSUMPTION_: 以下は、宣言した全ドメインのカタログを整備した学習用プロジェクトの完成時点を表す。
|
|
10
|
+
# 同梱の [[specdojo:dct-sample|成果物カタログ(ドメイン別)]] は project-definition の記述例に対応する。
|
|
11
|
+
# 他ドメインのカタログ一式は未同梱であり、samples ディレクトリ全体を実在カタログの集合とはみなさない。
|
|
12
|
+
# `project_id` は dct-sample と同じ例示値で、SpecDojo 本体の prj-0001 のドメイン集合を表さない。
|
|
5
13
|
id: specdojo:dct-index-sample
|
|
6
14
|
type: project
|
|
7
|
-
status:
|
|
15
|
+
status: ready
|
|
8
16
|
title: 成果物カタログ
|
|
9
17
|
rulebook: specdojo:dct-index-rulebook
|
|
10
18
|
project_id: prj-0001
|
|
19
|
+
# 店主代表と開発担当が最小限の成果物セットで導入するため small とする。
|
|
20
|
+
# 品質確認や障害時対応のドメインを含めても、scaffold の規模を拡大する判断はしていない。
|
|
11
21
|
size: small
|
|
12
22
|
groups:
|
|
23
|
+
# 店主代表と導入の目的・合意・現状をまとめて確認するため、プロジェクト側は1つの探索単位とする。
|
|
13
24
|
- name: プロジェクト成果物
|
|
14
|
-
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
+
domains:
|
|
26
|
+
- domain: project-definition
|
|
27
|
+
name: プロジェクト定義
|
|
28
|
+
overview: 販売管理システム導入の目的、スコープ、前提条件を管理する。
|
|
29
|
+
- domain: project-management
|
|
30
|
+
name: プロジェクト管理
|
|
31
|
+
overview: 店主との合意事項、課題、進捗を管理する。
|
|
32
|
+
- domain: current-state
|
|
33
|
+
name: 現状
|
|
34
|
+
overview: ノートと暗算に頼る現行の販売・在庫・つけ管理の把握に必要な成果物を管理する。
|
|
35
|
+
# プロダクト側は、業務の確認、設計、受入・検証、稼働後の対応で参照する目的が分かれる。
|
|
36
|
+
# 以後の配列順はその探索順であり、開発担当の着手順は Schedule で管理する。
|
|
25
37
|
- name: プロダクト成果物
|
|
26
38
|
groups:
|
|
27
|
-
- name:
|
|
39
|
+
- name: 業務仕様群
|
|
28
40
|
domains:
|
|
41
|
+
# _ASSUMPTION_: 販売とつけの仕様は `dct-business-sales.yaml` と `dct-business-credit.yaml` に分割済み。
|
|
42
|
+
# 両ファイルの `domain` は business-model のため、索引では1件にまとめる(分割ファイルは未同梱)。
|
|
43
|
+
- domain: business-model
|
|
44
|
+
name: 業務モデル
|
|
45
|
+
overview: 店頭販売、つけ払い、仕入れの業務ルールと流れを管理する。
|
|
29
46
|
- domain: data-flow
|
|
30
47
|
name: データフロー
|
|
31
48
|
overview: 販売、在庫、つけ管理を横断するデータの流れを管理する。
|
|
49
|
+
- domain: data-model
|
|
50
|
+
name: データモデル
|
|
51
|
+
overview: 商品、販売明細、在庫、顧客、つけ残高の関係と状態を表す成果物を管理する。
|
|
52
|
+
- domain: user-interface-model
|
|
53
|
+
name: ユーザーインターフェースモデル
|
|
54
|
+
overview: 店主と家族が同じ手順で記録・確認できるタブレットの画面と操作を管理する。
|
|
32
55
|
- domain: system-functions
|
|
33
56
|
name: システム化機能
|
|
34
|
-
overview:
|
|
35
|
-
|
|
57
|
+
overview: 店頭販売、在庫確認、つけ残高の記録・照会を支援するシステム機能を管理する。
|
|
58
|
+
- domain: glossary
|
|
59
|
+
name: 用語集
|
|
60
|
+
overview: つけ、駄菓子の商品区分など店舗固有の用語と定義を管理する。
|
|
61
|
+
# システム設計は1ドメインでも、開発担当が設計を探す独立した入口として分ける。
|
|
62
|
+
- name: アーキテクチャ・システム設計
|
|
36
63
|
domains:
|
|
37
64
|
- domain: system-design
|
|
38
65
|
name: システム設計
|
|
39
66
|
overview: 店頭タブレットで動作する販売管理システムの設計を管理する。
|
|
67
|
+
- name: 品質保証
|
|
68
|
+
domains:
|
|
69
|
+
# 操作性や顧客情報保護は機能の有無と分けて判断し、品質保証の枠に置く。
|
|
70
|
+
- domain: non-functional-requirements
|
|
71
|
+
name: 非機能要件
|
|
72
|
+
overview: 店番での操作性、記録の保全、顧客情報の保護に関する品質要求を管理する。
|
|
73
|
+
# つけ残高の確認は業務仕様にも関係するが、店主代表の受入判断は品質保証へ1か所だけ置く。
|
|
74
|
+
- domain: business-acceptance-criteria
|
|
75
|
+
name: 業務受入条件
|
|
76
|
+
overview: 店主と家族が日々の店番で使えると判断するための条件を管理する。
|
|
77
|
+
- domain: test-specs
|
|
78
|
+
name: テスト
|
|
79
|
+
overview: 販売・在庫・つけの記録と、入力訂正・端末障害時の振る舞いを検証する成果物を管理する。
|
|
80
|
+
# 端末障害時の業務判断と復旧後の照合は運用へ置き、その検証方法を持つテストとは分ける。
|
|
81
|
+
- name: 運用
|
|
82
|
+
domains:
|
|
83
|
+
- domain: operations
|
|
84
|
+
name: 運用
|
|
85
|
+
overview: 閉店後の売上照合、端末障害時の対応など稼働後の運用成果物を管理する。
|
|
@@ -6,7 +6,7 @@ specdojo:
|
|
|
6
6
|
rulebook: specdojo:dec-rulebook
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
#
|
|
9
|
+
# 決定記録 サンプル
|
|
10
10
|
|
|
11
11
|
## 1. 背景
|
|
12
12
|
|
|
@@ -24,13 +24,12 @@ specdojo:
|
|
|
24
24
|
## 3. 決定内容
|
|
25
25
|
|
|
26
26
|
- 選択肢 C を採択する。
|
|
27
|
-
- 管理画面は既存セッション認証を維持し、外部公開 API のみトークン認証を採用する。
|
|
28
27
|
|
|
29
28
|
## 4. 採択理由
|
|
30
29
|
|
|
31
30
|
- 品質: 管理画面の監査性を維持しつつ、外部連携の拡張性を確保できる。
|
|
32
31
|
- コスト: 既存機能への影響を最小化し、段階的移行が可能である。
|
|
33
|
-
- 運用性:
|
|
32
|
+
- 運用性: 失効制御の運用範囲を API 側に限定できる。
|
|
34
33
|
|
|
35
34
|
## 5. 影響範囲
|
|
36
35
|
|