specdojo 0.7.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +3 -2
- package/CHANGELOG.md +153 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/init.js +5 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +153 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +48 -25
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +188 -36
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +6 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +4 -4
- package/dist/exec/run/schedule-prepare.js +201 -59
- package/dist/exec/run/schedule-task.js +129 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +43 -9
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git.js +142 -15
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +47 -16
- package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +70 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +79 -64
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +132 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +164 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -3,11 +3,11 @@ specdojo:
|
|
|
3
3
|
id: specdojo:ccd-mermaid-rulebook
|
|
4
4
|
type: rulebook
|
|
5
5
|
deliverable_type: data
|
|
6
|
-
status:
|
|
6
|
+
status: ready
|
|
7
7
|
target_format: markdown
|
|
8
|
-
recipe:
|
|
8
|
+
recipe: not-needed
|
|
9
9
|
sample: specdojo:ccd-sample
|
|
10
|
-
template:
|
|
10
|
+
template: not-needed
|
|
11
11
|
based_on:
|
|
12
12
|
- specdojo:rulebook-authoring-standard
|
|
13
13
|
---
|
|
@@ -16,265 +16,180 @@ specdojo:
|
|
|
16
16
|
|
|
17
17
|
Conceptual Class Diagram (CCD) Rules using Mermaid
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
|
|
19
|
+
業務分析・要求定義で用いる概念クラス図(CCD)の内容要件と判断基準を定義します。
|
|
20
|
+
Mermaid の `classDiagram` で主キーと関連を表し、業務データ辞書(BDD)と照合できる概念モデルを作ります。
|
|
21
21
|
|
|
22
22
|
## 1. 全体方針
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
24
|
+
- BA・業務担当者が対象概念と関連の意味を合意し、ARC・DEV が設計の入力、QE が整合性検証の入力として使えることを必須とします。
|
|
25
|
+
- クラスの属性は主キー(PK)のみとし、そのほかの属性は BDD に委ねます。型・可視性・メソッドなどの実装詳細は対象外です。
|
|
26
|
+
- 図は関係種別・役割名・多重度を示し、本文はその業務上の根拠と成立条件を補います。線を文章でなぞるだけの説明は置きません。
|
|
27
|
+
- 対象領域と、初期状態・確定後など図が扱う時点を定めます。同じ関係でも状態によって必要数が異なる場合は、適用条件を本文で区別します。
|
|
28
28
|
|
|
29
|
-
## 2.
|
|
29
|
+
## 2. 位置づけと用語定義
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
- **クラス名は日本語の単数形**を基本とする。
|
|
33
|
-
- 属性は改行で列挙する。
|
|
34
|
-
- 型・可視性(+ - #)・セミコロンなどは書かない。
|
|
31
|
+
### 2.1. 成果物としての位置づけ
|
|
35
32
|
|
|
36
|
-
|
|
33
|
+
CCD は業務仕様のデータモデルを扱い、BDD はエンティティの属性の業務的意味を扱います。BDD の記述責務は [[specdojo:bdd-rulebook|業務データ辞書 作成ルール]] に従い、値・型・構造の詳細は BDD が参照する schema・型定義・リファレンスを正本とします。
|
|
37
34
|
|
|
38
|
-
|
|
39
|
-
classDiagram
|
|
40
|
-
class 商品 {
|
|
41
|
-
商品ID: PK
|
|
42
|
-
商品名
|
|
43
|
-
価格
|
|
44
|
-
}
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
## 3. 属性のルール
|
|
35
|
+
メタ情報とリンクの共通規約は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]]、配置・命名の共通事項は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] を正本とし、本書では CCD 固有の判断だけを定めます。
|
|
48
36
|
|
|
49
|
-
|
|
50
|
-
- 可視性(+ - #)は記述しない。
|
|
51
|
-
- 属性の順序は自由だが、キーは先頭に置くことを推奨。
|
|
52
|
-
- 外部キー項目は属性としてではなく、クラス間の関連(--> や --)で表す。
|
|
37
|
+
### 2.2. 用語定義
|
|
53
38
|
|
|
54
|
-
|
|
39
|
+
| 用語 | 定義 |
|
|
40
|
+
| -------------------------- | -------------------------------------------------------------------------------------------- |
|
|
41
|
+
| エンティティ(概念クラス) | 業務上管理すべき独立した概念のまとまり。CCD ではクラスとして表現する |
|
|
42
|
+
| 主キー(PK) | エンティティの各インスタンスを一意に識別する属性。CCD に記載する唯一の属性 |
|
|
43
|
+
| 継承関係(is-a) | 上位概念(汎化)と下位概念(特化)の階層関係。下位は上位の性質を引き継ぐ |
|
|
44
|
+
| 親子関係(part-of) | 業務上の所有・構造。子は親のまとまりに属して成立する。物理ファイルの削除連動とは別に判断する |
|
|
45
|
+
| 参照関係(reference) | 対象を別の管理単位として追跡し、所属の変更と対象の廃棄を分けて判断できる関係 |
|
|
46
|
+
| 役割名(関係名) | 接続線が表す業務上の関係の意味(例: `構成する`、`参照する`、`種類`) |
|
|
47
|
+
| 多重度 | 関連するエンティティのインスタンス数の制約(例: `1`、`0..1`、`1..*`、`0..*`) |
|
|
55
48
|
|
|
56
|
-
|
|
57
|
-
- 複合キーは複数行で記述可能。
|
|
49
|
+
## 3. ファイル命名・ID規則
|
|
58
50
|
|
|
59
|
-
|
|
51
|
+
- ファイル名は `ccd-<term>.md` とし、`<term>` は対象業務領域を表す kebab-case とします(例: `ccd-project-planning.md`)。
|
|
52
|
+
- プロジェクト成果物の文書 ID は `<project-id>:ccd-<term>` とし、同じ主題のファイル名と対応させます。
|
|
53
|
+
- 配置は成果物カタログで宣言したパスに従います。カタログの分類は `kind: work`、成果物の種別は `data` とします。
|
|
60
54
|
|
|
61
|
-
|
|
62
|
-
classDiagram
|
|
63
|
-
class 売上明細 {
|
|
64
|
-
伝票番号: PK
|
|
65
|
-
行番号: PK
|
|
66
|
-
商品ID
|
|
67
|
-
数量
|
|
68
|
-
金額
|
|
69
|
-
}
|
|
70
|
-
```
|
|
55
|
+
## 4. 推奨 Frontmatter 項目
|
|
71
56
|
|
|
72
|
-
|
|
57
|
+
必須項目・許可キー・型はドキュメントメタ情報標準と `docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml` に従い、`specdojo:` 配下に記述します。
|
|
73
58
|
|
|
74
|
-
-
|
|
75
|
-
-
|
|
59
|
+
- `type` は `data`、`rulebook` は `specdojo:ccd-mermaid-rulebook` とします。
|
|
60
|
+
- `based_on` には、実際に読み直接の根拠とした作成済み辞書を記録します。カタログがある場合は `depends_on` の推移閉包内に限定し、未作成辞書や単なる参照候補を追加しません。直接の根拠がなければ省略できます。
|
|
61
|
+
- 成果物の依存はカタログの `depends_on` に置き、CCD の Frontmatter には追加しません。`based_on` を依存一覧の代用にしません。
|
|
76
62
|
|
|
77
|
-
##
|
|
63
|
+
## 5. 本文要件
|
|
78
64
|
|
|
79
|
-
|
|
65
|
+
CCD 成果物(`ccd-<term>.md`)は以下の章構成を標準とします。
|
|
80
66
|
|
|
81
|
-
|
|
67
|
+
| 章番号 | 章タイトル | 必須 | 内容・受入条件 |
|
|
68
|
+
| ------ | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
|
|
69
|
+
| 1 | 目的と適用範囲 | 必須 | 利用目的、対象領域・対象外、扱う時点を示す。領域の境界や規則は正本へ参照できること |
|
|
70
|
+
| 2 | 概念クラス図 | 必須 | Mermaid `classDiagram` に概念・主キー・関連を示す。継承したキーや抽象概念など、図だけでは誤解する点は短く補足すること |
|
|
71
|
+
| 3 | 関連定義と多重度の根拠 | 必須 | 図中の全関連を表で網羅し、両端の必要数、関係種別、役割名を業務上の理由から説明できること |
|
|
72
|
+
| 4 | 参照業務データ辞書 | 必須 | 全エンティティと辞書の対応、主キーの対応名・識別範囲を示す。未作成・未照合を区別すること |
|
|
73
|
+
| 5 | 未解決事項 | 条件付き | 未作成辞書・根拠不足・文書間矛盾がある場合は必須。影響、現在の扱い、解消責務・確認条件を示す。なければ省略または「なし」とする |
|
|
82
74
|
|
|
83
|
-
|
|
84
|
-
| ---------- | -------------------------- | -------------------------------------------------------- | ------------------------------------ | ------------- |
|
|
85
|
-
| 継承関係 | is-a(一般化) | 上位概念を継承し、下位概念は特殊化された種類を表す | 共通属性を上位にまとめ階層構造を作る | 商品 → お菓子 |
|
|
86
|
-
| 親子関係 | parent-child(所有・構造) | 親が子を束ねる「構造上のまとまり」を表す | 子は親と一体的/単独では意味が薄い | 伝票 → 明細 |
|
|
87
|
-
| 参照関係 | reference(関連) | ゆるやかに関連する概念同士のつながりで、参照・依存を示す | 双方向・単方向どちらも可 | 明細 → 商品 |
|
|
75
|
+
各章の見出しは `## 1.` から連番とし、小節にも階層ごとの連番を付けます。
|
|
88
76
|
|
|
89
|
-
|
|
77
|
+
## 6. 記述ガイド
|
|
90
78
|
|
|
91
|
-
|
|
92
|
-
| -------- | ------------------------------------------------------ |
|
|
93
|
-
| 継承 | 種類 / 分類 / 区分 |
|
|
94
|
-
| 親子 | 構成する / 保有する / 含む / 明細 / 行 / 履歴 |
|
|
95
|
-
| 参照 | 参照する / 対象 / 元伝票 / 請求先 / 商品 / 起点 / 出典 |
|
|
79
|
+
### 6.1. 目的と適用範囲
|
|
96
80
|
|
|
97
|
-
|
|
81
|
+
| 判断の基準 | 良い例 | 悪い例 |
|
|
82
|
+
| ------------------------------ | ---------------------------------------------------------------------- | ---------------------------------------- |
|
|
83
|
+
| 誰が何の判断に使うかを示す | 「担当交代時に計画対象と作業責務を引き継ぐため、概念間の関係を定める」 | 「データを図にする」のみ |
|
|
84
|
+
| 含める概念と対象外を区別する | 「成果物定義を扱い、成果物本体と実行記録は対象外とする」 | 関連する保存ファイルをすべてクラスにする |
|
|
85
|
+
| 多重度が成立する時点を特定する | 「立上げ途中の未展開状態を含む」 | 確定後の必須数を初期状態にも適用する |
|
|
98
86
|
|
|
99
|
-
### 6.
|
|
87
|
+
### 6.2. 概念クラス図
|
|
100
88
|
|
|
101
|
-
|
|
102
|
-
| -------- | ------------- | ----------------------- |
|
|
103
|
-
| 継承関係 | `子 <\|-- 親` | is-a(一般化・特化) |
|
|
104
|
-
| 親子関係 | `親 *-- 子` | 所有・構造(part-of) |
|
|
105
|
-
| 参照関係 | `A --> B` | ゆるい関連(reference) |
|
|
89
|
+
#### 6.2.1. クラスと主キー
|
|
106
90
|
|
|
107
|
-
|
|
91
|
+
- クラス名は日本語の単数形とし、BDD の論理名と対応させます。抽象概念を置く場合は、共通化する識別・関連と、独立した保存対象かどうかを補足します。
|
|
92
|
+
- 主キーの各属性行に `: PK` を付け、複合主キーは構成項目ごとに分けます。親からキーを継承する下位クラスは `class お菓子 {}` のように空の属性ブロックとし、継承元を本文または辞書対応表で示します。
|
|
93
|
+
- 同じキー構成でも、役割と変更・参照の単位が異なれば別概念にできます。同じ名前の識別子でも一意性の範囲が異なれば、必要な文脈をキーに含めます。
|
|
108
94
|
|
|
109
|
-
|
|
110
|
-
|
|
95
|
+
| 判断の基準 | 良い例 | 悪い例 |
|
|
96
|
+
| ------------------------------ | ------------------------------------------------------------ | -------------------------------------------------- |
|
|
97
|
+
| 業務上の識別単位を表す | 明細に「売上ID」と「明細番号」をそれぞれ PK として記載 | 明細番号だけで全売上の明細を識別する |
|
|
98
|
+
| 実装構造から独立させる | 計画要素をタスク・節目の識別と依存を共通化する概念として説明 | 共通の保存ファイルがないという理由だけで概念を除く |
|
|
99
|
+
| 個々の属性の定義を辞書へ委ねる | 主キーだけを図示し、名称・単価の意味は BDD へ参照する | 型・桁数・enum 一覧をクラス内に書く |
|
|
111
100
|
|
|
112
|
-
|
|
101
|
+
#### 6.2.2. 関係種別と役割名
|
|
113
102
|
|
|
114
|
-
|
|
103
|
+
次の三種を使い分けます。全線に短い日本語の役割名を付け、親子・参照の両端には引用符付きの多重度を必須とします。継承には多重度を付けません。
|
|
115
104
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
105
|
+
| 関係種別・記法 | 選ぶ基準 | 良い例 | 悪い例 |
|
|
106
|
+
| ------------------ | ---------------------------------------- | ---------------------------------------- | -------------------------------------------------- |
|
|
107
|
+
| 継承 `親 <\|-- 子` | 下位概念が上位概念の識別と性質を引き継ぐ | 商品からお菓子へ「種類」の関係を置く | 所属するだけの明細を伝票の下位概念にする |
|
|
108
|
+
| 親子 `親 *-- 子` | 子が親の業務上のまとまりに属して成立する | 伝票が明細を「構成する」 | 同じファイルに保存するという理由だけで親子にする |
|
|
109
|
+
| 参照 `A --> B` | 参照先を別の管理単位として追跡する | 明細から商品を「対象商品」として参照する | 構成から参照を外すと参照先も廃棄されると決めつける |
|
|
119
110
|
|
|
120
|
-
|
|
111
|
+
同じクラス間の複数の関連や自己関連は、役割名で意味を区別します。例えば登録項目の「起票元をたどる」と「先行項目の完了を必要とする」は別の関連です。「関連」「リンク」だけのラベルや、起票元から実行順序を推測する表現では区別できません。
|
|
121
112
|
|
|
122
|
-
|
|
123
|
-
| ------------- | --------------------- | -------------------------- |
|
|
124
|
-
| 1件のみ | `"1"` | 常に1つ |
|
|
125
|
-
| 0または1 | `"0..1"` | 任意、存在しない場合もある |
|
|
126
|
-
| 複数(1以上) | `"1..*"` | 最低1つは存在 |
|
|
127
|
-
| 複数(0以上) | `"0..*"` または `"*"` | 数の制約なし |
|
|
128
|
-
|
|
129
|
-
#### 記述例(親子)
|
|
130
|
-
|
|
131
|
-
```plaintext
|
|
132
|
-
売上記録 "1" *-- "0..*" 販売明細 : 構成する
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
#### 記述例(参照)
|
|
136
|
-
|
|
137
|
-
```plaintext
|
|
138
|
-
販売明細 "*" --> "1" 商品 : 商品を参照
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
#### 例
|
|
142
|
-
|
|
143
|
-
```mermaid
|
|
144
|
-
classDiagram
|
|
145
|
-
direction LR
|
|
146
|
-
商品 <|-- お菓子 : 種類
|
|
147
|
-
伝票 *-- 明細 : 構成する
|
|
148
|
-
明細 --> 商品 : 商品を参照
|
|
149
|
-
```
|
|
113
|
+
### 6.3. 関連定義と多重度の根拠
|
|
150
114
|
|
|
151
|
-
|
|
115
|
+
関連表は次のカラムを持ちます。起点・先が同じ関連も、役割名ごとに一行を設けます。
|
|
152
116
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
-
|
|
117
|
+
| カラム | 記載する判断情報 |
|
|
118
|
+
| ------------------ | ------------------------------------------------------------------------ |
|
|
119
|
+
| 関連(起点 - 先) | 図のクラス名と向きを一致させる |
|
|
120
|
+
| 関係種別 | 継承・親子・参照の選択 |
|
|
121
|
+
| 多重度 | 起点側・先側の順で表示する。継承は「—」など数を定めない表記とする |
|
|
122
|
+
| 役割名 | 図のラベルと一致させ、同じクラス間の関連を識別する |
|
|
123
|
+
| 業務上の理由・根拠 | 両端の最小・最大数が成立する理由、状態・例外、必要なら規則の正本への参照 |
|
|
156
124
|
|
|
157
|
-
|
|
|
158
|
-
|
|
|
159
|
-
|
|
|
160
|
-
|
|
|
161
|
-
|
|
|
125
|
+
| 判断の基準 | 良い例 | 悪い例 |
|
|
126
|
+
| ------------------------------ | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
|
|
127
|
+
| 両端の制約を説明できる | 「明細は必ず一つの商品を指す。未販売の商品も同じ商品を扱う複数明細もあるため、明細側は0件以上」 | 「多対一だから」のみ |
|
|
128
|
+
| 状態による最小数の違いを示す | 「伝票は一時保存時に明細0件を許す。確定時は1件以上を別途必須とする」 | 理由なく `0..*` とする、または一時保存にも `1..*` を強制する |
|
|
129
|
+
| 任意の対応を両方向から確認する | 「戦略作成後の未展開期間と、戦略を持たない既存トラックを許すため、両端を `0..1` とする」 | 「対応する戦略は一つ」で逆側の任意性を説明しない |
|
|
162
130
|
|
|
163
|
-
|
|
131
|
+
一意性の範囲、参照先の存在、循環の可否など、線だけでは示せない整合性条件はこの章に補います。先行依存の循環禁止など業務ごとの規則は正本を参照し、すべての自己関連を一律に禁止しません。
|
|
164
132
|
|
|
165
|
-
|
|
133
|
+
### 6.4. 参照業務データ辞書
|
|
166
134
|
|
|
167
|
-
-
|
|
168
|
-
-
|
|
169
|
-
-
|
|
135
|
+
- 対応表は「エンティティ」「主キーの対応」「参照先業務データ辞書」を持ちます。キーを継承する下位概念はまとめて記載できますが、図の全クラスを照合できることを必須とします。
|
|
136
|
+
- キーの対応には BDD のフィールド名と、全体・project 内・親の内部など識別範囲を示します。図の日本語名と辞書の物理名が異なる場合に対応を省きません。
|
|
137
|
+
- 作成済み辞書は project 修飾 ID のリンク、未作成辞書は予定 ID のコード表記と「未作成」で示します。未作成・未読の辞書を確認済みの根拠にはしません。
|
|
170
138
|
|
|
171
|
-
|
|
139
|
+
| 判断の基準 | 良い例 | 悪い例 |
|
|
140
|
+
| ------------------------ | --------------------------------------------------------------- | ----------------------------------------------- |
|
|
141
|
+
| 識別範囲を追跡できる | 「成果物定義は project の識別子と `local_id` で識別する」 | `local_id` が全 project で一意と読み取れる記載 |
|
|
142
|
+
| 未作成を未照合として扱う | 予定 ID に「未作成」を添え、未解決事項に照合担当と条件を残す | 存在しない辞書へリンクし、属性の一致を断定する |
|
|
143
|
+
| 定義の正本を一つに保つ | 対応名だけを示し、属性の意味・許容値は BDD とその参照先に委ねる | schema のキー一覧・構文・制約を対応表に複写する |
|
|
172
144
|
|
|
173
|
-
|
|
145
|
+
### 6.5. 未解決事項
|
|
174
146
|
|
|
175
|
-
|
|
|
176
|
-
|
|
|
177
|
-
|
|
|
178
|
-
|
|
|
179
|
-
|
|
|
180
|
-
| 再利用性 | 子は親に密結合 | 子は他コンテキストでも再利用 | 共通属性を上位へ抽象化 |
|
|
181
|
-
| 変更影響 | 親変更は子へ波及 | 親変更影響は限定的 | 上位変更は全下位へ波及 |
|
|
147
|
+
| 判断の基準 | 良い例 | 悪い例 |
|
|
148
|
+
| ---------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------- |
|
|
149
|
+
| 不足根拠と影響を限定する | 「未作成辞書とのキー対応は未照合。図には主キー以外を追加しない」 | 不足を隠して「すべて整合」とする |
|
|
150
|
+
| 次に誰が何を確認するかを示す | 「辞書作成後に BA が名称・識別範囲・関連を照合する」 | 「後で確認」のみ |
|
|
151
|
+
| 矛盾・未確認・乖離を区別する | 文書 ID と相反する記述を示し、現時点で採用する根拠と確認責務を記す | 調査対象がコマンド入口だけなのに実装全体との一致・乖離を断定する |
|
|
182
152
|
|
|
183
|
-
|
|
153
|
+
未確定の前提・判断はドキュメントメタ情報標準の共通ラベルで区別します。解消した論点は本文へ反映し、未解決事項として残し続けません。
|
|
184
154
|
|
|
185
|
-
|
|
186
|
-
- 継承は濫用しない(2階層程度を推奨)。属性共通率が低いなら参照で表現。
|
|
155
|
+
### 6.6. 検証と改訂時の確認
|
|
187
156
|
|
|
188
|
-
|
|
157
|
+
成果物を作成・改訂した際は、機械検証(静的検査)と手動照合の両方で判定します。
|
|
189
158
|
|
|
190
|
-
|
|
159
|
+
#### 6.6.1. 静的検査の手順とコマンド
|
|
191
160
|
|
|
192
|
-
|
|
193
|
-
2. 将来的に下位種類が増加する見込みが高い。
|
|
194
|
-
3. 上位概念が「分類語(種別、タイプ、カテゴリ)」として自然言語上認知されている。
|
|
195
|
-
4. ビジネスルールが上位で一括説明でき、下位差分だけが重要。
|
|
161
|
+
作成先リポジトリに設定された Markdown・Frontmatter・Mermaid の静的検査を実施します。SpecDojo 同梱リポジトリでの実行コマンド例を以下に示します。移行先リポジトリに同等の検証コマンドが定義されている場合は、その設定に従い相当するコマンドを実行できます。
|
|
196
162
|
|
|
197
|
-
|
|
163
|
+
```bash
|
|
164
|
+
# Markdown 構文・スタイルの検査
|
|
165
|
+
npm run lint:md
|
|
198
166
|
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
- 実装都合(ORM最適化等)だけが理由
|
|
167
|
+
# Frontmatter の構造・メタデータ検査
|
|
168
|
+
npm run lint:fm
|
|
202
169
|
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
次の記述は概念モデルルールに反するため禁止:
|
|
206
|
-
|
|
207
|
-
- 型・可視性(public / private / `+` `-` `#`)
|
|
208
|
-
- メソッド定義(`calculateTotal()` 等)
|
|
209
|
-
- テーブル設計専用のカラム(`created_at` など技術的属性)を概念に含めること
|
|
210
|
-
- DTO/API リクエスト構造そのもののクラス化
|
|
211
|
-
- 英語と日本語のランダム混在
|
|
212
|
-
- 過剰な階層継承(3階層以上)
|
|
213
|
-
- 関係線ラベル未記載、または曖昧語(「関連」「関係」)のみ
|
|
214
|
-
|
|
215
|
-
## 11. サンプル
|
|
216
|
-
|
|
217
|
-
```mermaid
|
|
218
|
-
classDiagram
|
|
219
|
-
direction LR
|
|
220
|
-
|
|
221
|
-
class 伝票 {
|
|
222
|
-
伝票番号: PK
|
|
223
|
-
日付
|
|
224
|
-
}
|
|
225
|
-
|
|
226
|
-
class 明細 {
|
|
227
|
-
行番号: PK
|
|
228
|
-
数量
|
|
229
|
-
小計
|
|
230
|
-
}
|
|
231
|
-
|
|
232
|
-
class 商品 {
|
|
233
|
-
商品ID: PK
|
|
234
|
-
商品名
|
|
235
|
-
価格
|
|
236
|
-
}
|
|
237
|
-
|
|
238
|
-
伝票 "1" *-- "0..*" 明細 : 構成する
|
|
239
|
-
明細 "*" --> "1" 商品 : 商品を参照
|
|
170
|
+
# Mermaid 構文の検査
|
|
171
|
+
npm run lint:mermaid
|
|
240
172
|
```
|
|
241
173
|
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
```mermaid
|
|
245
|
-
classDiagram
|
|
174
|
+
- **期待結果**: 各静的検査がエラーなく終了コード 0 で完了すること。個別ファイルを対象とする場合は、各ツールにファイルパスを渡して実行します。
|
|
175
|
+
- **検証の限界**: 構文検査の合格だけで、キーや多重度の業務上の妥当性を確認済みとしません。以下の手動照合とあわせて合否を判定します。
|
|
246
176
|
|
|
247
|
-
|
|
248
|
-
ID: PK
|
|
249
|
-
名称
|
|
250
|
-
}
|
|
177
|
+
#### 6.6.2. 整合性の手動照合と改訂時の確認
|
|
251
178
|
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
}
|
|
179
|
+
- 図の全クラスと辞書対応表、全関連と根拠表を突き合わせ、名前・向き・種別・役割名・多重度が一致することを確認します。多重度は両方向から読み、最小数と上限を業務条件に照らします。
|
|
180
|
+
- BDD のキー・識別範囲、業務フローや業務規則の変更時は、該当するクラスと関連の根拠を再確認します。実装との照合を行う場合は、確認した範囲と不足根拠を分けて記録します。
|
|
181
|
+
- 公開前に BA・ARC が業務上の根拠と辞書との対応、QE が検証可能性を確認します。人間の PO が未解決事項の影響も含めて公開可否を最終判断し、agent は `ready` への昇格を行いません。
|
|
256
182
|
|
|
257
|
-
|
|
258
|
-
親ID: PK
|
|
259
|
-
親名称
|
|
260
|
-
}
|
|
183
|
+
## 7. 禁止事項
|
|
261
184
|
|
|
262
|
-
|
|
263
|
-
子ID: PK
|
|
264
|
-
子名称
|
|
265
|
-
}
|
|
185
|
+
以下の記述は概念クラス図のルールに反するため **禁止** します。
|
|
266
186
|
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
上位分類 <|-- 下位分類 : 継承(一般化)
|
|
278
|
-
親 "1" *-- "0..*" 子 : 所有(構造)
|
|
279
|
-
A "*" --> "1" B : 参照(関連)
|
|
280
|
-
```
|
|
187
|
+
- **主キー以外の属性の記述**: 名称・金額・日付・状態などの一般属性を含めること(業務データ辞書 bdd を参照すること)。
|
|
188
|
+
- **メソッドの記述**: `calculateTotal()`、`updateStatus()` などの操作・メソッド定義を含めること(例外なく全面禁止)。
|
|
189
|
+
- **型・可視性の記述**: `+`, `-`, `#` や `string`, `number` などの言語・実装依存の型定義。
|
|
190
|
+
- **実装・技術的要素の記述**: `created_at`、`updated_at`、`is_deleted` 等のシステム管理カラムや DTO のクラス化、schema・リファレンスの値・構文・構造詳細の再掲。
|
|
191
|
+
- **関係線ラベルの省略・曖昧語**: ラベル未記載、または「関係」「リンク」などの意味不明なラベル。
|
|
192
|
+
- **多重度の省略**: 親子関係・参照関係において多重度を記載しないこと。
|
|
193
|
+
- **継承関係への多重度付与**: 継承関係(is-a)に多重度を付けること。
|
|
194
|
+
- **継承記法の配置逆転**: `親 <|-- 子` の方向を誤り、子を親として描画すること。
|
|
195
|
+
- **過剰な継承階層**: 3 階層以上の過度な継承関係を作ること。
|