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
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
id: specdojo:pm-roles-sample
|
|
3
3
|
type: project
|
|
4
4
|
status: ready
|
|
5
|
-
title:
|
|
5
|
+
title: "ロール定義: 駄菓子屋きぬや 販売管理システム"
|
|
6
6
|
rulebook: specdojo:pm-roles-rulebook
|
|
7
7
|
based_on:
|
|
8
8
|
- specdojo:people-and-organization-definition-standard
|
|
@@ -10,32 +10,33 @@ based_on:
|
|
|
10
10
|
version: 1
|
|
11
11
|
project_id: prj-0001
|
|
12
12
|
|
|
13
|
-
#
|
|
14
|
-
#
|
|
15
|
-
#
|
|
13
|
+
# 単一店舗・タブレット1台での初期リリースと店頭試用に用いる、採用済み8ロールの一覧。
|
|
14
|
+
# 採用判断・Schedule の owner 使用可否・見直し条件の正本: [[specdojo:pm-organization-sample|組織定義]]。
|
|
15
|
+
# 人間の実行主体と兼務: [[specdojo:pm-members-sample|メンバー定義]]。agent は利用先の .specdojo/agent-members.yaml で管理する。
|
|
16
|
+
# 成果物・主要判断の責任分担: [[specdojo:pm-raci-sample|RACI]]。共通責務は based_on の上位標準を参照する。
|
|
16
17
|
|
|
17
18
|
roles:
|
|
18
19
|
- code: PO
|
|
19
20
|
name: Project Owner
|
|
20
|
-
project_note:
|
|
21
|
+
project_note: 店頭運用を大きく変えない範囲で販売・在庫・つけの記録を優先し、人間が範囲・費用・参加時間の上限、受入、公開・継続を最終判断する。
|
|
21
22
|
- code: PM
|
|
22
23
|
name: Project Manager
|
|
23
|
-
project_note:
|
|
24
|
+
project_note: 店頭試用までの作業順序と参加負荷を週次で確認する。兼務による期限超過は課題化し、分担変更と追従タスクを整理して、上限変更は PO に判断を求める。
|
|
24
25
|
- code: BA
|
|
25
26
|
name: Business Analyst
|
|
26
|
-
project_note:
|
|
27
|
+
project_note: 店主以外の家族も同じ手順で販売・在庫・つけを確認できるよう、利用者確認を主導し、操作説明への UX の助言を受入条件へ反映する。
|
|
27
28
|
- code: ARC
|
|
28
29
|
name: Architect
|
|
29
|
-
project_note:
|
|
30
|
+
project_note: タブレット1台の構成・データ管理方針を専門支援として検討し、DEV が主導する設計へ助言する。初期は独立タスクの主責任を持たない。
|
|
30
31
|
- code: DEV
|
|
31
32
|
name: Developer
|
|
32
|
-
project_note:
|
|
33
|
+
project_note: 販売・在庫・つけの実装・データ設計と技術的な是正を主導し、店頭試用で見つかった記録漏れや残高誤りの修正結果を QE の再確認へ渡す。
|
|
33
34
|
- code: QE
|
|
34
35
|
name: Quality Engineer
|
|
35
|
-
project_note:
|
|
36
|
+
project_note: 人気商品の欠品、つけの記録漏れ・残高誤り、家族の店番時の操作を実装作業と分けて確認し、試験結果と未解消事項を PO の受入判断へ渡す。
|
|
36
37
|
- code: UX
|
|
37
38
|
name: UX / Documentation Designer
|
|
38
|
-
project_note:
|
|
39
|
+
project_note: 店主・家族向けの画面文言と操作説明を専門支援として検討し、BA が主導する利用者確認へ助言する。独立タスク化は組織定義の見直し後とする。
|
|
39
40
|
- code: OPS
|
|
40
41
|
name: Operations / Release Manager
|
|
41
|
-
project_note:
|
|
42
|
+
project_note: 導入・障害時対応・引き継ぎを専門支援として準備し、PM が主導するリリース準備へ取り込む。初期は独立した Schedule タスクの主責任を持たず、公開・継続の最終判断は人間の PO に残す。
|
|
@@ -6,52 +6,76 @@ specdojo:
|
|
|
6
6
|
rulebook: specdojo:prj-assumptions-constraints-dependencies-rulebook
|
|
7
7
|
based_on:
|
|
8
8
|
- specdojo:prj-scope-sample
|
|
9
|
+
- specdojo:prj-charter-sample
|
|
9
10
|
supersedes: []
|
|
10
11
|
---
|
|
11
12
|
|
|
12
13
|
# 前提・制約・依存関係: 駄菓子屋きぬや 販売管理システム
|
|
13
14
|
|
|
14
|
-
|
|
15
|
+
本書は、駄菓子屋きぬやの初期リリース準備から店頭試用までに、作業の開始・保留・再判断に使う前提、制約、依存を整理する完成例である。未確認の条件と受領済みの判断を分け、各項目 ID から確認責任、影響作業、変更記録を追跡する。
|
|
15
16
|
|
|
16
17
|
## 1. 前提条件
|
|
17
18
|
|
|
18
|
-
|
|
19
|
+
対象業務と単一店舗の境界は [[specdojo:prj-scope-sample|プロジェクトスコープ]] の「対象業務」「スコープ外」を正とする。ここでは、それを実行する際に確認が必要な条件だけを登録する。
|
|
19
20
|
|
|
20
|
-
| ID | 内容
|
|
21
|
-
| ------- |
|
|
22
|
-
| ACD-A01 |
|
|
23
|
-
| ACD-A02 |
|
|
21
|
+
| ID | 内容 | 根拠 | 影響 | 監視・確認方法 | 変化のトリガー | 所有者 | 対応方針 |
|
|
22
|
+
| ------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ----------------- | ------------------------------------------------------------------------------------------------------------ |
|
|
23
|
+
| ACD-A01 | _ASSUMPTION_: 店舗の運用体制を大きく変えず、現行手順に近い操作なら店主代表と家族利用者代表が記録を継続できる。 | スコープの「境界の判断基準」が示す操作の単純化を、習熟負荷と継続性の仮説として確認する。 | 仮説が外れれば、操作手順の再設計と再説明が必要になり、受入・試用開始が遅れる。 | 開発担当が新機能の操作確認時に現行手順と比べた支援・迷いを記録する。試用中は成功条件の SC-02・SC-03 の記録を参照する。 | 必須操作を続けられない、または記録・確認の負担が許容範囲を超えた。 | 開発担当(`PM`) | 操作の簡素化と確認対象の縮小を提案し、店主代表が優先順位と再確認日を判断する。範囲変更は変更要求として扱う。 |
|
|
24
|
+
| ACD-A02 | _ASSUMPTION_: 店頭では通信断が起き得る。発生頻度と記録への影響は未確認である。 | [[specdojo:prj-charter-sample\|プロジェクト憲章]] の「未決事項」でオフライン時の扱いが残っている。安定稼働の実測証跡はない。 | 通信断時の未記録・重複記録を照合できず、販売・在庫・つけ残高が一致しなくなる。 | 開発担当が店頭試用の準備時に接続を確認し、試用中の通信断と影響操作を `kinuya-technical-dependency-log` に記録する。 | 記録操作が通信断で停止した、または接続条件が変わった。 | 開発担当(`DEV`) | 発生済みの支障を課題にし、ACD-D03 の判断材料へ渡す。未検証のオフライン記録・同期が使えるとみなさない。 |
|
|
24
25
|
|
|
25
26
|
## 2. 制約事項
|
|
26
27
|
|
|
27
|
-
|
|
28
|
+
対象外と業務判断の境界は [[specdojo:prj-scope-sample|プロジェクトスコープ]] の「対象システム」「スコープ外」「境界の判断基準」へ委譲する。以下は [[specdojo:prj-charter-sample|プロジェクト憲章]] の「主要前提・制約」が結論だけを示す支出・公開情報の制約に、監視と逸脱時対応を補ったものである。憲章の GO / Not GO 判断ゲートは再登録しない。
|
|
28
29
|
|
|
29
|
-
| ID | 内容
|
|
30
|
-
| ------- |
|
|
31
|
-
| ACD-
|
|
32
|
-
| ACD-
|
|
30
|
+
| ID | 内容 | 適用範囲 | 影響 | 監視・確認方法 | 逸脱のトリガー | 所有者 | 対応方針 |
|
|
31
|
+
| ------- | ------------------------------------------------------------------------------------------ | ------------------------------ | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
|
32
|
+
| ACD-C02 | 費用上限は _UNDECIDED_: 管理計画 U-01 で店主代表が承認する。承認前に外部支出を開始しない。 | 機材購入、有償利用、外部契約 | 未承認の支出と継続費用が発生し、準備・開発の計画を維持できなくなる。 | 開発担当が購入・契約・有償利用の開始前に `kinuya-cost-and-effort-log` の上限・対象支出・承認証跡を照合する。 | 上限未承認、または対象支出の承認証跡がないまま着手しようとした。 | 開発担当(`PM`) | 着手を保留し、必要額・継続負担・無償代替を店主代表へ提示する。実施済みなら課題として影響と是正案を報告する。 |
|
|
33
|
+
| ACD-C03 | 公開する説明資料・操作例に、実顧客の個人情報、秘密情報、非公開の店舗情報を含めない。 | 公開文書、画面画像、添付データ | 顧客や店舗の情報が漏れ、公開を継続できなくなる。 | 開発担当が公開候補の本文・画像・添付を点検し、同行レビュー担当が架空データへの置換結果を再確認する。 | 実データの混入、または公開してよいか判断できない情報を検知した。 | 開発担当(`PM`) | 該当資料の公開を保留して公開候補から分離する。削除・架空データへの置換と影響確認を行い、再レビュー後に店主代表が公開・再開を判断する。 |
|
|
33
34
|
|
|
34
|
-
|
|
35
|
+
費用上限の判断時期と承認記録は [[specdojo:pm-plan-sample|プロジェクト管理計画]] の「未決事項」U-01 を正とする。廃止した ACD-C01(業務判断の境界)は章冒頭の参照へ統合し、ID は再利用しない。
|
|
35
36
|
|
|
36
|
-
|
|
37
|
+
## 3. 依存関係
|
|
37
38
|
|
|
38
|
-
|
|
39
|
-
| ------- | -------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------ | -------- | ---------------------------------------------------------------------------- |
|
|
40
|
-
| ACD-D01 | 店頭で使用するタブレット 1 台 | 販売・在庫・つけの記録を店頭で行うため。 | 営業時間中に、店主代表または家族利用者代表が利用できる。 | 端末を利用できない、または台数を変更する。 | 開発担当 | 代替記録手順を確認し、端末条件が変わる場合は対象範囲を見直す。 |
|
|
41
|
-
| ACD-D02 | 技術メンターによる設計・実装方針の助言 | 開発担当が一人で判断せず、設計・実装上の技術的な課題を解決するため。 | 開発期間中、必要なタイミングで技術メンターの助言を受けられる。 | 技術メンターの都合がつかない、または助言を受けられない期間が続く。 | 開発担当 | 助言なしで判断できる範囲を見極め、優先度の低い判断は次回の助言まで保留する。 |
|
|
39
|
+
スコープと憲章は本書の直接根拠であり、それだけを理由に依存先へ登録しない。受入判定の正本は [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]](本書では「成功条件」)とし、店頭試用開始に必要な提供物、助言、判断を以下で管理する。
|
|
42
40
|
|
|
43
|
-
|
|
41
|
+
| ID | 依存先・条件 | 必要となる理由 | 受領・成立条件 | 変化のトリガー | 所有者 | 対応方針 |
|
|
42
|
+
| ------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
43
|
+
| ACD-D01 | 店頭で使うタブレット1台の継続提供 | 店主代表と家族利用者代表が記録するため。利用不能なら店頭試用を継続できない。 | 開発担当が試用開始前に対象版で記録・確認操作を実施し、以後は店番担当が営業開始前に利用可能性を確認する。結果を `kinuya-technical-dependency-log` の本 ID に残す。 | 端末の利用不能、交換、台数・接続条件の変更 | 開発担当(`DEV`) | 影響操作と復旧見込みを確認し、代替端末は対象版で再確認する。店主代表が再開を判断するまで、利用不能な経路の試用を保留する。 |
|
|
44
|
+
| ACD-D02 | 技術メンターから受ける設計・実装方針への助言 | データの不整合や回復不能につながる技術判断を確認するため。助言待ちなら該当設計の確定が遅れる。 | 開発担当が該当設計の確定前に論点への回答と未解決事項を受領し、`kinuya-technical-dependency-log` に確認日・助言内容・採否理由を記録する。未回答なら成立扱いにしない。 | 助言を受けられない、または前提が変わり回答を適用できない。 | 開発担当(`DEV`) | 回答期限と保留対象を Schedule に残す。技術メンターと再確認日を調整し、期日に影響する場合は店主代表へ順序変更・延期案を提示する。 |
|
|
45
|
+
| ACD-D03 | 店主代表によるオフライン時の運用方針の決定(`PJR-KN01`) | 通信断時に記録をどう扱うか確定するため。未決の経路は受入条件と運用手順をそろえられない。 | 開発担当が初期運用開始前に `PJR-KN01` の判断証跡と成功条件の「例外条件と未解決事項」を照合する。運用方針、追加受入条件、確認結果がそろうまで当該経路は未成立とする。 | 店主代表が方針を決定・変更した、または追加した受入条件に未達がある。 | 開発担当(`PM`) | 初期受入の対象外とする扱いは決定済み。記録方法は _UNDECIDED_: 開発担当が代替案と負荷を提示し、店主代表が初期運用開始前に判断する。部分決定だけで依存を解消しない。 |
|
|
46
|
+
| ACD-D04 | 対象版・操作メモを特定した初期受入判定 | 店頭試用を開始できる品質か確かめるため。証跡不足・不合格なら試用開始を判断できない。 | [[specdojo:prj-success-criteria-and-acceptance-criteria-sample\|成功基準と受入条件]] の SC-01・AC-01〜AC-04 を正とする。初期リリースゲート前に同行レビュー担当が `kinuya-acceptance-record` の対象文書 ID・対象版・条件 ID・確認日・確認者・結果を照合し、店主代表の受入判断を確認する。 | 対象版・操作メモ・受入条件の変更、不合格、確認結果の欠落 | 開発担当(`PM`) | 不足する条件と証跡を特定し、是正・再確認を先行作業にする。SC-02 以降の将来測定を初期受入済みの証拠に使わない。 |
|
|
44
47
|
|
|
45
48
|
## 4. 影響評価と対応方針
|
|
46
49
|
|
|
47
|
-
| 変化の種別 | 主な影響領域
|
|
48
|
-
| ---------------- |
|
|
49
|
-
| 前提が崩れた |
|
|
50
|
-
| 制約に抵触した |
|
|
51
|
-
| 依存先が変化した |
|
|
50
|
+
| 変化の種別 | 主な影響領域 | 最初に確認すること | 一次対応・判断 | 対応方針 |
|
|
51
|
+
| ---------------- | -------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
|
|
52
|
+
| 前提が崩れた | 受入日程、記録品質、操作確認の有効性 | ACD-A01・A02 の変化が、どの操作確認・記録に及んだか | 開発担当が操作確認・試用結果、接続記録と影響作業を調べ、家族利用者代表へ店番への支障を確認する。 | 軽減案として確認日程・操作手順を見直す。受入・試用開始日の変更は店主代表が再判断する。 |
|
|
53
|
+
| 制約に抵触した | 支出、公開適性、後戻り作業 | ACD-C02・C03 の抵触が未実施か実施済みか、影響する契約・公開物は何か | 開発担当が対象行為を止め、是正と影響確認を課題にする。 | 原因を除去し、承認証跡または公開前の再レビューをそろえる。再開・公開は店主代表が判断する。 |
|
|
54
|
+
| 依存先が変化した | 設計の確定、受入、店頭試用の開始・継続 | ACD-D01〜D04 の未成立部分、影響する対象版・条件 ID・作業 | 所有者が不足材料と回復見込みを特定し、開発担当が代替案と残作業の見積もりをまとめる。 | 代替策で軽減するか順序・期日・範囲を再判断する。店主代表の判断後に計画と受入対象を更新する。 |
|
|
55
|
+
|
|
56
|
+
作業順序・判断ゲートは [[specdojo:pm-plan-sample|プロジェクト管理計画]] を正とする。開発担当(`PM`)は変更記録から対象文書 ID、ACD 項目 ID、影響する条件 ID を結び、是正・再確認・再判断の順に `kinuya-schedule` へ担当 Role、依存先、見積もり、期限、確認担当を置く。
|
|
52
57
|
|
|
53
58
|
## 5. 監視・変更管理
|
|
54
59
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
60
|
+
### 5.1. 見直し契機と記録
|
|
61
|
+
|
|
62
|
+
開発担当(`PM`)は週次の進捗確認に加え、スコープ・憲章・受入条件の改訂、参加不可の申出、通信断・端末交換、支出・公開の提案、助言・決定の受領、各判断ゲートの準備開始時に本書を確認する。
|
|
63
|
+
|
|
64
|
+
変更記録には文書 ID と項目 ID、変化内容、影響する作業・条件 ID、一次対応者、判断者、判断根拠、対応状況、再確認時期、転送先の記録 ID を残す。ACD-C01 の廃止理由と参照への統合も同じ記録で追跡する。
|
|
65
|
+
|
|
66
|
+
本例では意思決定待ちの ACD-D03 をプロジェクト登録簿の `PJR-KN01` に登録した想定とする。`PJR-KN01` と `kinuya-project-register` は未同梱の架空の項目・記録名であり、実際の登録・承認の証跡ではない。`kinuya-schedule`、`kinuya-technical-dependency-log`、`kinuya-cost-and-effort-log`、`kinuya-acceptance-record` も未同梱で、[[specdojo:pm-plan-sample|プロジェクト管理計画]] の記録先を使う例である。実案件では各記録の整備を先行作業にし、証跡が参照できるまで成立扱いにしない。
|
|
67
|
+
|
|
68
|
+
### 5.2. 管理・報告への接続
|
|
69
|
+
|
|
70
|
+
| 検知したこと | 記録先と追跡方法 | 報告・判断 |
|
|
71
|
+
| ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
|
|
72
|
+
| 通信断による未記録、端末利用不能、確認期限超過など発生済みの支障 | [[specdojo:pm-issue-log-sample\|課題ログ]] へ ACD 項目 ID、是正担当、期限を付けて記録する。 | 所有者が開発担当(`PM`)へ報告し、開始・継続に影響すれば店主代表へ判断を求める。 |
|
|
73
|
+
| 確認参加者の不足、助言遅延など将来の不確実な影響 | [[specdojo:pm-risk-register-sample\|リスク登録簿]] に兆候と軽減策を記録する。顕在化したら元の記録 ID を付けて課題へ移す。 | 開発担当(`PM`)が週次と兆候検知時に店主代表へ影響と対策を報告する。 |
|
|
74
|
+
| 承認済みの対象範囲、費用・時間上限、期日の変更案 | [[specdojo:pm-change-request-log-sample\|変更要求ログ]] に代替案・影響・ACD 項目 ID を残す。 | 開発担当(`PM`)が起案し、店主代表(`PO`)が承認・却下・保留を判断する。 |
|
|
75
|
+
| 未決事項の解消、採用案、延期・再開の判断 | 意思決定待ちは `kinuya-project-register` の項目で追跡する。判断結果は該当 PJR・課題・変更要求へ判断者・理由・判断日・証跡を付記し、独立した決定台帳へ二重転記しない。 | 開発担当(`PM`)が本書と Schedule の追従を確認し、次の影響作業の開始前に店主代表へ完了を報告する。 |
|
|
76
|
+
|
|
77
|
+
### 5.3. 追従と責任
|
|
78
|
+
|
|
79
|
+
責任境界は [[specdojo:pm-organization-sample|組織定義]] に従う。開発担当(`PM`)が計画・Schedule・PJR の追従を管理し、`ARC` が文書構造・配置・命名・技術制約・参照の整合を支援、`QE` が受入条件と再確認結果を照合する。実行主体と兼務は [[specdojo:pm-members-sample|メンバー定義]] で管理する。専門支援を独立した Schedule の作業にする場合は、組織定義で `owner` の使用可否を見直す。
|
|
80
|
+
|
|
81
|
+
店主代表(人間の `PO`)が範囲・費用・公開・受入・運用継続を最終判断する。AI Agent に承認を委ねない。文書の置き換え・廃止と参照元への追従は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従い、開発担当(`PM`)が移行期限と未完了作業を追跡する。
|
|
@@ -13,93 +13,120 @@ specdojo:
|
|
|
13
13
|
|
|
14
14
|
# 代替案比較: 駄菓子屋きぬや 販売管理システム
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
販売・在庫・つけの記録を店主代表以外の店番でも継続できるよう、解決方式を比較する。人間の `PO` が方式と試行対象を判断し、`PM` が未決事項と後続作業を計画へ渡すための完成例である。
|
|
17
17
|
|
|
18
18
|
## 1. 比較目的と前提条件
|
|
19
19
|
|
|
20
|
-
| 決定ID | 比較レイヤー | 決定すること
|
|
21
|
-
| ------ | ---------------------- |
|
|
22
|
-
| D-01 | 業務・システム解決方式 | P-01〜P-03
|
|
20
|
+
| 決定ID | 比較レイヤー | 決定すること | 決定しないこと |
|
|
21
|
+
| ------ | ---------------------- | ----------------------------------- | ---------------------------------- |
|
|
22
|
+
| D-01 | 業務・システム解決方式 | P-01〜P-03 を改善する方式と試行対象 | 個別製品、開発手法、作業管理ツール |
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
根拠資料:
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
- [[specdojo:prj-scope-sample|プロジェクトスコープ]]: 販売・在庫・つけと簡易一覧を初期対象とし、EC、本格会計、仕入れ先連携、複数店舗管理を除外する。
|
|
27
|
+
- [[specdojo:prj-issues-and-approach-sample|プロジェクト課題と解決アプローチ]]: P-01 は記録不統一、P-02 は残高確認の負荷、P-03 は在庫過不足。記録手段と日次確認・引き継ぎを一式で比較する。
|
|
28
|
+
- [[specdojo:prj-assumptions-constraints-dependencies-sample|前提・制約・依存関係]]: タブレット1台、現行手順に近い操作、費用承認、通信断時の方針決定を成立条件とする。
|
|
27
29
|
|
|
28
|
-
-
|
|
29
|
-
- 2 週間以内に店頭で試行でき、営業日の 90% 以上で記録を継続できること。
|
|
30
|
-
- EC、本格会計、仕入れ先連携、複数店舗管理は扱わないこと。
|
|
31
|
-
- 通信断時の運用を残し、つけ残高など既存ノートの情報を移行できること。
|
|
30
|
+
_ASSUMPTION_: 本比較の期間評価では、準備着手の承認から2週間以内に試行候補を用意できることを目安とする。初期リリース日を確定したものではない。現金支出・参加者別作業時間の上限と具体日は [[specdojo:pm-plan-sample|プロジェクト管理計画]] の U-01〜U-03 で判断し、未承認の支出・作業を開始しない。
|
|
32
31
|
|
|
33
|
-
|
|
32
|
+
| 候補カテゴリ | 候補に含める基準 |
|
|
33
|
+
| ------------------ | ---------------------------------------------------------------- |
|
|
34
|
+
| 非システム対応 | 紙の記録と手順だけで P-01〜P-03 を改善できる |
|
|
35
|
+
| 汎用デジタルツール | 専用システムを構築せず、タブレットで記録・検索・集計できる |
|
|
36
|
+
| 既存製品・サービス | 販売・在庫を既存機能で扱い、つけ管理を含む一式の運用を構成できる |
|
|
37
|
+
| 個別構築 | 店舗固有の手順と初期対象に合わせた最小機能を構築できる |
|
|
34
38
|
|
|
35
|
-
|
|
36
|
-
| ------------------ | ---------------------------------------------------------- |
|
|
37
|
-
| 非システム対応 | 紙の記録と手順だけで P-01〜P-03 を改善できる |
|
|
38
|
-
| 汎用デジタルツール | 専用システムを構築せず、タブレットで記録・検索・集計できる |
|
|
39
|
-
| 既存製品・サービス | 販売・在庫・つけ管理の主要部分を既存機能で実現できる |
|
|
40
|
-
| 個別構築 | 店舗固有の手順と初期対象に合わせた最小機能を構築できる |
|
|
41
|
-
|
|
42
|
-
本比較は購入 / 構築を含む解決方式を決めるもので、既存製品の個別銘柄は比較しない。既存製品案が残った場合に限り、機能、料金、データ移行、解約時の取り出しを別の製品比較で確認する。
|
|
39
|
+
外部候補は、[Google スプレッドシートの公式ヘルプ](https://support.google.com/docs/answer/6000292?co=GENIE.Platform%3DAndroid&hl=ja) でタブレットでの編集と書き出し、[Square の公式ヘルプ](https://squareup.com/help/jp/ja/article/8331-set-up-inventory-tracking) で販売に伴う在庫更新と商品情報の入出力を確認し、ALT-02・ALT-03 に含めた(資料確認日: 2026-11-13)。これはカテゴリの成立根拠であり、市場代表・店舗適合の証明ではない。端末の OS、費用、つけ管理、保管先・権限、全記録の取り出しは個別確認を残す。既存サービス案が残った時点で別レイヤーの製品比較へ進む。
|
|
43
40
|
|
|
44
41
|
## 2. 比較対象案
|
|
45
42
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
| ALT-
|
|
51
|
-
| ALT-
|
|
43
|
+
### 2.1. D-01: 業務・システム解決方式
|
|
44
|
+
|
|
45
|
+
| 案ID | 案 | カテゴリ | 課題解決への道筋 | 主な構成要素 | 対象範囲 |
|
|
46
|
+
| ------ | -------------------------------- | ------------------ | ---------------------------------------------------- | ---------------------------------------------- | -------------------- |
|
|
47
|
+
| ALT-01 | 紙帳票と手順の標準化 | 非システム対応 | 帳票と日次確認を統一し、店番交代時のばらつきを減らす | 統一帳票、操作メモ、手計算による残高・在庫確認 | 初期対象の記録と一覧 |
|
|
48
|
+
| ALT-02 | 共有表計算による簡易管理 | 汎用デジタルツール | 共有表への記録と数式集計で残高・在庫を確認する | 販売・在庫・つけ台帳、入力規則、日次確認 | 初期対象の記録と一覧 |
|
|
49
|
+
| ALT-03 | 既存 POS・在庫管理サービスの利用 | 既存製品・サービス | 既存の販売・在庫機能とつけの補助手段で一式を構成する | POS、在庫、つけ補助台帳、照合・引き継ぎ | 初期対象の記録と一覧 |
|
|
50
|
+
| ALT-04 | 最小販売管理システムの個別構築 | 個別構築 | 店舗の記録項目と操作に合わせて一元化する | 販売登録、在庫、つけ残高、簡易一覧、日次確認 | 初期対象の記録と一覧 |
|
|
51
|
+
|
|
52
|
+
ALT-01・ALT-04 は前段の A-02・A-01 に対応し、全案に A-03 の日次確認・引き継ぎを含める。ALT-02・ALT-03 を追加し、前段の採用方針だけで候補を閉じない。
|
|
52
53
|
|
|
53
54
|
## 3. 評価軸と評価基準
|
|
54
55
|
|
|
55
|
-
|
|
56
|
-
| ---------- | ---- | ------------------------------------------------ | -------------------------------- |
|
|
57
|
-
| 効果 | 5 | P-01〜P-03 を横断して改善できるか | 記録不統一、残高確認、在庫過不足 |
|
|
58
|
-
| コスト | 3 | 初期費用と継続費用を小規模店舗で負担できるか | 有償サービス導入前の費用確認 |
|
|
59
|
-
| 期間 | 4 | 2 週間以内に店頭試行を開始できるか | 初期対象期間 |
|
|
60
|
-
| 業務適合 | 5 | 販売・在庫・つけ管理と現行手順に合うか | 対象業務、利用者負荷 |
|
|
61
|
-
| 操作性 | 5 | 店主代表と家族利用者代表が同じ手順で記録できるか | P-01、タブレット 1 台 |
|
|
62
|
-
| データ移行 | 4 | 既存ノートのつけ残高を検証しながら移行できるか | P-02、移行漏れリスク |
|
|
63
|
-
| 継続運用 | 4 | 通信断や障害時にも記録を失わず営業を続けられるか | 通信環境の前提 |
|
|
64
|
-
| 保守性 | 3 | 項目変更、データ出力、障害対応を継続できるか | 小規模な運用体制 |
|
|
56
|
+
D-01 の全案に次の軸を適用する。`High` / `Middle` / `Low` は採択に有利な順で、費用・期間・リスク・負荷は小さい方を高くする。判定材料がない場合は「未判定」とし、中間評価で代用しない。
|
|
65
57
|
|
|
66
|
-
|
|
58
|
+
| 評価軸 | 判定基準(High / Middle / Low) | 根拠となる課題・制約 |
|
|
59
|
+
| ------------------ | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
|
|
60
|
+
| 効果 | 記録統一・残高検索・在庫低下把握の3能力を同じ記録から提供 / 2能力 / 1能力以下 | P-01〜P-03 |
|
|
61
|
+
| コスト | 現金支出・参加者別作業時間がともに承認上限の80%以内 / ともに上限内だが一方が80%超 / 一方でも上限超。上限未決は未判定 | ACD-C02、管理計画 U-01・U-02 |
|
|
62
|
+
| 期間 | 試行候補の準備が7日以内 / 8〜14日 / 14日超。上限承認と参加可能日の確認後の見積もりを使う | 比較上の2週間の目安、管理計画 U-03 |
|
|
63
|
+
| リスク | 誤記録・停止・移行漏れの全経路で照合・回復を検証済み / 対策と担当・確認条件があるが未検証 / 対策のない経路がある | P-01・P-02、ACD-A02・D03 |
|
|
64
|
+
| 業務適合 | 両利用者が必須タスクを支援なしで完了 / 支援付きで完了 / 一つでも完了不能。操作性もこの軸で判定する | P-01、現行手順とタブレット1台 |
|
|
65
|
+
| 技術実現性 | 端末・移行・外部依存の成立を確認済み / 実現経路はあるが検証待ち / 成立しない依存がある | ACD-D01〜D04 |
|
|
66
|
+
| データ移行・可逆性 | 元ノートとの全件照合と取り出し・紙への復元を検証済み / 方法を定義し検証待ち / 残高・履歴を復元する方法がない | P-02、既存ノート |
|
|
67
|
+
| 運用・保守性 | 引き継ぎ・項目変更・回復を後任が単独で完了 / 手順はあるが支援を要する / 担当・手順を用意できない | P-01、小規模体制 |
|
|
68
|
+
|
|
69
|
+
「業務適合」は利用者の手順・体制への適合を指し、継続運用と保守の負荷は「運用・保守性」にまとめる。
|
|
70
|
+
|
|
71
|
+
重み付け・加重合計は用いない。効果・業務適合に `Low` がある案は主方式から外し、残る案を効果、業務適合、リスクの順で比較して試行対象を選ぶ。正式採用は全軸が `Middle` 以上、未判定なし、受入・試用条件合格を必要とする。総合評価は、このゲートの充足状況で示す。
|
|
67
72
|
|
|
68
73
|
## 4. 比較結果と採択理由
|
|
69
74
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
| ALT-02 | Middle | High | High | Middle | Low | Middle | Middle | Low | Middle | 非採択 |
|
|
74
|
-
| ALT-03 | Middle | Low | High | Low | Middle | Low | Low | High | Low | 非採択 |
|
|
75
|
-
| ALT-04 | High | Middle | Middle | High | High | Middle | Middle | Middle | High | 採択 |
|
|
75
|
+
### 4.1. D-01: 業務・システム解決方式
|
|
76
|
+
|
|
77
|
+
本例の机上確認・模擬操作の結果は学習用の架空記録であり、実店舗での検証証跡ではない。効果は記録・一覧の対応、業務適合は両利用者による販売記録・在庫確認・残高確認の計6タスク、運用・保守性は引き継ぎ・項目変更・回復の確認結果から判定した。費用・日程の承認と実機受入は未了として扱う。
|
|
76
78
|
|
|
77
|
-
|
|
79
|
+
| 案ID | 効果 | コスト | 期間 | リスク | 業務適合 | 技術実現性 | データ移行・可逆性 | 運用・保守性 | 総合評価 | 判定 |
|
|
80
|
+
| ------ | ------ | ------ | ------ | ------ | -------- | ---------- | ------------------ | ------------ | ------------------ | -------- |
|
|
81
|
+
| ALT-01 | Low | 未判定 | 未判定 | Middle | High | Middle | Middle | Middle | 主方式の条件未達 | 一部採択 |
|
|
82
|
+
| ALT-02 | Middle | 未判定 | 未判定 | Middle | Low | Middle | Middle | 未判定 | 主方式の条件未達 | 非採択 |
|
|
83
|
+
| ALT-03 | 未判定 | 未判定 | 未判定 | Low | 未判定 | Middle | 未判定 | 未判定 | 材料不足 | 保留 |
|
|
84
|
+
| ALT-04 | High | 未判定 | 未判定 | Middle | High | Middle | Middle | Middle | 正式採用ゲート待ち | 比較試行 |
|
|
78
85
|
|
|
79
|
-
ALT-
|
|
86
|
+
ALT-04 を優先試行対象とし、ALT-01 の統一帳票を切り戻し候補として一部採択する。方式の選択と実運用の承認を分け、未決の費用・時間上限とオフライン方針を解消してから該当作業へ進む。
|
|
80
87
|
|
|
81
|
-
|
|
88
|
+
| 案ID | 評価根拠と採否理由 | 再評価に必要な材料 |
|
|
89
|
+
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
|
|
90
|
+
| ALT-01 | 3能力中、記録統一だけを提供し検索・在庫低下把握は手集計。模擬操作は6/6を自力完了。現行の紙で開始できるが、集計・変更は支援を要する | 検索・集計の負荷を軽減し、効果を2能力以上へ改善できた場合 |
|
|
91
|
+
| ALT-02 | 記録統一と残高検索の2能力を提供。セル操作で1タスクを完了できず、数式の修正も後任単独では完了できなかった。保守性は手順の有効性と支援付きの完了を未確認のため未判定とする | 入力・保守手順と支援担当を用意し、両利用者と後任の同じ課題の完了可否・必要な支援を確認できた場合 |
|
|
92
|
+
| ALT-03 | 公式資料で販売・在庫の実現経路は確認したが、つけ補助台帳との不一致に対策がない。店舗全体の効果・適合、料金、全記録の移行・撤退は未確認 | 費用上限確定後、つけ・照合・取り出しを含む一式の具体候補を確認した場合 |
|
|
93
|
+
| ALT-04 | 記録と一覧の設計で3能力を提供し、操作模型では6/6を自力完了。保守は開発担当の支援を要する。リスク対策と移行・撤退方法は定義済みだが、実機では未検証 | 上限・日程承認後、実機と受入・試用結果で仮説を再判定する |
|
|
82
94
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
|
86
|
-
|
|
|
87
|
-
| ALT-
|
|
88
|
-
| ALT-
|
|
95
|
+
### 4.2. 技術的実現性と影響
|
|
96
|
+
|
|
97
|
+
| 案ID | 技術的実現性・外部依存 | 正本・移行・停止時の扱いと後続作業 |
|
|
98
|
+
| ------ | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
99
|
+
| ALT-01 | 現行の紙を使えるが、統一帳票への残高移行の検証は残る | 統一帳票を正本にする。既存残高を照合して転記し、変更時は帳票を保存して新方式と照合する |
|
|
100
|
+
| ALT-02 | 表計算で構成可能。端末 OS、共有権限と利用条件は実機確認待ち | 共有表を正本にする案。ノートとの照合後に一本化し、停止時は全記録を書き出して紙へ復元する検証が必要 |
|
|
101
|
+
| ALT-03 | 販売・在庫は既存機能を利用可能。つけ補完、端末・接続と契約条件は未確認 | サービスとつけ補助台帳の正本境界・照合方法を製品比較で定義するまで採用しない。商品情報の出力だけで残高・履歴の撤退可能性を保証しない |
|
|
102
|
+
| ALT-04 | 最小機能の構築経路はあるが、ACD-D01〜D04 の確認・判断が残る | 本稼働時はシステム記録を正本にする案。ノート残高を全件照合して移行する。停止時は記録を出力して紙へ復元し、二重入力の照合を検証する。構造・実装詳細は後続設計へ委譲する |
|
|
103
|
+
|
|
104
|
+
### 4.3. 比較試行の完了条件
|
|
105
|
+
|
|
106
|
+
- 入力と範囲: ALT-04 と ALT-01 に同じ架空の販売10件、入荷・在庫確認、つけ残高5件を用いる。`DEV` が候補版と操作メモをそろえ、`QE` が欠落・重複・残高差分と取り出し結果を照合する。
|
|
107
|
+
- 完了と判定: 全件一致、欠落・重複0件、両利用者が必須タスクを完了した時点で机上評価を更新する。未達は是正後に再確認し、期間・承認上限内に解消できなければ `PO` が試行中止または範囲縮小を判断する。通信断・紙への切り戻しは ACD-D03 の運用方針と追加受入条件が決まるまで実運用しない。
|
|
108
|
+
- 正式採用と記録: [[specdojo:prj-success-criteria-and-acceptance-criteria-sample|成功基準と受入条件]] の初期受入と2週間の試用継続条件を各段階で満たすことを確認する。`QE` は `kinuya-acceptance-record`、`BA` は `kinuya-trial-log` に D-01・案 ID・条件 ID・対象版・結果を残し、`PO` が採用・停止を判断する。成功条件の数値・測定方法は参照先を正とする。
|
|
89
109
|
|
|
90
110
|
## 5. リスクとトレードオフ
|
|
91
111
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
94
|
-
|
|
|
95
|
-
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
112
|
+
| 区分・対象 | 内容 | 軽減策・担当・完了条件 |
|
|
113
|
+
| -------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
114
|
+
| トレードオフ・ALT-01 | 検索・集計の手作業を受容する | `BA` が確認時間を試用記録へ残し、記録継続への影響を `PO` が判断する。主方式への転用は効果軸の再評価を条件とする |
|
|
115
|
+
| リスク・ALT-02 | 誤入力・数式破損で残高を誤る | `DEV` が入力制限と保護・復元手順を用意し、`QE` が破損後の復元と元記録の一致を確認するまで採択を再検討しない |
|
|
116
|
+
| リスク・ALT-03 | サービスとつけ補助台帳の不一致、取り出し不能 | `DEV` が候補製品の正本境界・照合・全記録出力を確認し、`QE` が差分0件と紙への復元を確認するまで製品選定を保留する |
|
|
117
|
+
| トレードオフ・ALT-04 | 個別構築で設計・保守負荷を受容し、高度分析・外部連携を延期する | `PM` が初期対象に絞った作業と保守の見積もりを提示し、参加者別上限内・担当合意済みを準備着手の条件とする |
|
|
118
|
+
| リスク・全案 | 記録停止・移行漏れでつけ残高を失う | `DEV` が移行・停止時の照合手順と ALT-01 の帳票控えの別保管を用意し、`QE` が復元後に元ノート全件と残高差分0件を確認する。通信断の扱いは ACD-D03 の判断に従う |
|
|
98
119
|
|
|
99
120
|
## 6. 決定と見直し
|
|
100
121
|
|
|
101
|
-
-
|
|
102
|
-
|
|
103
|
-
-
|
|
104
|
-
|
|
105
|
-
|
|
122
|
+
D-01 の現時点の判定は「比較結果と採択理由」のとおり。最終判断は人間の `PO` が行い、AI Agent は調査・比較分析・検証を支援する。`BA` は業務影響、`ARC` は技術制約、`DEV` は実装・移行、`QE` は条件と証跡を確認し、`PM` が後続作業を管理する。
|
|
123
|
+
|
|
124
|
+
`PM` は上限・日程の決定、試行準備、初期受入、店頭試用、継続判断の順で `kinuya-schedule` に担当 Role・依存先・見積もり・期限・確認担当を置く。オフライン方針の判断待ちは既存の `PJR-KN01` へ接続する。`kinuya-` の記録名と `PJR-KN01` は管理計画・前提条件で用いる未同梱の架空記録であり、整備・承認済みの証跡ではない。
|
|
125
|
+
|
|
126
|
+
| 見直し契機・管理区分 | 記録先と次の判断 |
|
|
127
|
+
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
128
|
+
| 試行・受入での不合格、2週間の記録継続・操作負担条件の未達(課題) | `PM` が [[specdojo:pm-issue-log-sample\|課題ログ]] に D-01・案 ID・是正担当・再確認期限を残し、`PO` が縮小・延期・停止を判断する |
|
|
129
|
+
| 移行漏れ、端末・通信障害、保守担当不在の兆候(リスク) | `PM` が [[specdojo:pm-risk-register-sample\|リスク登録簿]] に対象案・兆候・軽減策を登録し、顕在化時は元の ID を付けて課題へ移す |
|
|
130
|
+
| 承認上限、範囲、利用者・端末、外部依存の変更(変更要求) | `PM` が [[specdojo:pm-change-request-log-sample\|変更要求ログ]] に評価結果・影響・移行撤退方法を残し、該当カテゴリの全案を再比較する。特定製品を自動採用しない |
|
|
131
|
+
|
|
132
|
+
未決事項の判断は管理計画 U-01〜U-03 と `PJR-KN01`、採否・再評価の理由と判断者・判断日は該当する課題・変更要求へ付記し、独立した台帳へ二重転記しない。変更後は `PM` がスコープ、成功条件、設計・検証、Schedule への追従を計画し、次の影響作業の開始前に `QE` が整合を確認する。
|
|
@@ -6,33 +6,102 @@ specdojo:
|
|
|
6
6
|
rulebook: specdojo:sf-index-rulebook
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
#
|
|
9
|
+
# 駄菓子屋きぬや システム化機能一覧(全体構成)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
本書は、駄菓子屋きぬや販売管理システムが店頭のタブレットで実現する機能の全体構成と一覧を定義する。各機能を業務プロセス領域と画面へ対応付け、機能分割・テスト対象の洗い出しと、個別機能仕様への入口として使う。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## 1. 目的と対象範囲
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
販売・在庫・つけ・締めの業務ごとにシステムが担う記録と確認の範囲を確定し、店主代表がスコープを承認でき、業務からの漏れと機能の重なりを一覧で判断できるようにする。これは [[specdojo:prj-overview-sample|プロジェクト概要]] の「まず記録する」方針と、店番が交代しても同じ手順で記録を続ける目標に対応する。
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
- 前提: プロジェクト文脈は handbook の共通方針に準拠する
|
|
19
|
-
- 参照: `../rulebooks/sf-index-rulebook.md`
|
|
17
|
+
### 1.1. 対象の境界
|
|
20
18
|
|
|
21
|
-
|
|
19
|
+
| 区分 | 範囲 |
|
|
20
|
+
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
21
|
+
| 対象 | 単一店舗の店頭タブレットで行う販売・つけ・在庫・締めの記録と確認。業務プロセス領域 `P-02`〜`P-10` のうち、システムが記録・算出・提示する部分 |
|
|
22
|
+
| 対象外 | 仕入先への発注(`P-01`)、補充・つけ上限・売価の最終判断、キャッシュレス決済、本格会計、EC、複数店舗、個別機能の入出力・振る舞いの詳細 |
|
|
22
23
|
|
|
23
|
-
-
|
|
24
|
-
- 必須観点: 対象、条件、判定基準、責任者
|
|
24
|
+
販売・在庫・つけの日々の記録を先行し、補充依頼支援と月次集計の導入時期は `Q-03` で決める。一覧に載せた全機能を初期リリースに含むとはみなさない。通信不能時の営業継続方針はプロジェクト概要の未決事項に従い、本一覧でオフライン販売を保証しない。
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
### 1.2. 読者・確認責任・公開範囲
|
|
27
27
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
28
|
+
| Role | 本一覧の利用・確認責任 |
|
|
29
|
+
| ---- | ---------------------------------------------------------------------------------------------------- |
|
|
30
|
+
| BA | 一覧を保守し、店主代表・家族利用者代表と業務の漏れと人間に残す判断を確認する |
|
|
31
|
+
| DEV | 機能分割と画面・データ設計、実装範囲を確認する。ARC の専門支援を受けて販売・在庫の責務境界を照合する |
|
|
32
|
+
| QE | 機能 ID をテスト対象に対応付け、参照と未決事項の欠落を確認する |
|
|
33
|
+
| PM | 参照先の整備と追従作業を成果物カタログ・Schedule に接続し、判断待ちを管理する |
|
|
34
|
+
| PO | 人間の店主代表がスコープ、導入順序と公開可否を最終判断する |
|
|
33
35
|
|
|
34
|
-
|
|
36
|
+
採用ロールと兼務は [[specdojo:pm-organization-sample|組織定義]]・[[specdojo:pm-members-sample|メンバー定義]]、作業と承認の分担は [[specdojo:pm-raci-sample|RACI]] を正本とする。初期の技術作業は DEV が主導し、ARC を独立した Schedule タスクの主担当にはしない。
|
|
35
37
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
38
|
+
公開対象は店舗内の運用者と開発・レビュー担当とする。本例には実顧客の情報、認証情報、非公開の接続先を含めない。外部公開する場合は BA が匿名化した版を用意し、PO が公開範囲を確認する。
|
|
39
|
+
|
|
40
|
+
### 1.3. 一覧の完成判定
|
|
41
|
+
|
|
42
|
+
次表は内容レビューの合格条件であり、確認済みの結果ではない。確認結果と未充足の条件は `kinuya-sf-review`(本例に未同梱の架空レビュー記録)へ残す。
|
|
43
|
+
|
|
44
|
+
| 確認担当 | 判定条件 | 確認する証跡 |
|
|
45
|
+
| ----------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
|
|
46
|
+
| BA | `P-01`〜`P-10` の全10領域について、機能への割当てまたはシステム化しない理由がある | 概念データフロー図の領域表と本書「機能構成」・主一覧の対応 |
|
|
47
|
+
| DEV(ARC が支援) | 9件の機能 ID が一意で4領域の略号と一致し、販売・入荷から在庫への受け渡しと人間の判断が区別できる | 主一覧と表後の責務境界、個別機能仕様・画面仕様の照合結果 |
|
|
48
|
+
| QE | 主一覧の必須6列が埋まり、実在参照は解決でき、仮置きの参照は `Q-01`・`Q-03` で追跡されている | 文書・参照の検査記録、機能 ID と後続テスト対象の対応 |
|
|
49
|
+
| PM | 未決事項ごとに担当、判断時点、追跡先と保留する作業が特定されている | 未決事項と、整備後の成果物カタログ・Schedule・課題記録 |
|
|
50
|
+
| PO | 各担当の確認結果から対象範囲・人間の判断・公開範囲を確認でき、承認範囲に未合意の責務が残っていない | レビュー記録と承認対象の範囲、除外した範囲の追従先 |
|
|
51
|
+
|
|
52
|
+
文書検査の成功だけでは承認しない。`Q-01`〜`Q-03` が承認対象に影響する間は `draft` を維持し、PO が対象範囲を承認するまで当該範囲の設計・受入を保留する。機能自体の正常・例外・回復の試験条件は個別仕様と後続のテスト仕様で定義する。
|
|
53
|
+
|
|
54
|
+
## 2. 機能構成
|
|
55
|
+
|
|
56
|
+
業務プロセス領域の区分は [[specdojo:cdfd-overview-sample|概念データフロー図(全体概要)]] に従う。入荷の記録(`P-02`)は在庫数量を更新する処理のため、仕入ではなく在庫の領域に含める。
|
|
57
|
+
|
|
58
|
+
| 機能領域 | 略号 | 業務プロセス領域 | システムの責務 | 人間に残す判断 |
|
|
59
|
+
| -------- | ----- | ---------------------- | -------------------------------------------------------------------- | ------------------------------------ |
|
|
60
|
+
| 販売 | `POS` | `P-03` | 現金販売の明細・請求額・釣銭を提示し、販売を記録して在庫へ渡す | 取引の中止 |
|
|
61
|
+
| つけ | `CRD` | `P-04`・`P-07`・`P-08` | 常連客とつけ上限を登録し、つけ販売と精算を記録して残高を提示する | つけ上限の設定、上限超過時の販売可否 |
|
|
62
|
+
| 在庫 | `INV` | `P-02`・`P-05`・`P-06` | 入荷と販売を在庫へ反映し、補充基準を下回った商品と依頼数量を提示する | 補充依頼の承認 |
|
|
63
|
+
| 締め | `CLS` | `P-09`・`P-10` | 当日の販売・入荷・在庫・つけを突き合わせ、差異と月次の集計を提示する | 締めの確定、売価・補充基準の見直し |
|
|
64
|
+
|
|
65
|
+
仕入計画(`P-01`)はシステム化しない。仕入先とのシステム連携を初期リリースの対象外としたため、店主代表が補充依頼を基に発注する。
|
|
66
|
+
|
|
67
|
+
## 3. システム化機能一覧
|
|
68
|
+
|
|
69
|
+
| 機能 ID | 機能名 | 概要 | 業務プロセス仕様 | 画面 | 個別仕様 |
|
|
70
|
+
| ----------- | ------------ | -------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------- | ---------------------------------------- |
|
|
71
|
+
| `SF-POS-01` | 店頭商品販売 | 商品と数量から請求額・釣銭を提示し、現金の受領確認を受けて販売を記録する | `P-03` / `bps-sales-order-flow` | [[specdojo:uis-sample\|販売登録画面]] | [[specdojo:sf-sample\|商品販売機能仕様]] |
|
|
72
|
+
| `SF-CRD-01` | つけ販売 | つけ上限と残高を確認して、つけでの販売を記録し、更新後の残高を提示する | `P-04` / `bps-credit-sale` | `uis-credit-sale` | 一覧行で要約 |
|
|
73
|
+
| `SF-CRD-02` | 常連客登録 | 常連客の識別情報とつけ上限を登録・変更し、つけ販売の可否判定に使えるようにする | `P-07` / `bps-customer-registration` | `uis-customer` | 一覧行で要約 |
|
|
74
|
+
| `SF-CRD-03` | つけ精算 | 支払額を受け付けてつけ残高を減らし、精算後の残高を提示する | `P-08` / `bps-credit-settlement` | `uis-credit-sale` | 一覧行で要約 |
|
|
75
|
+
| `SF-INV-01` | 在庫確認 | 販売と入荷を在庫数量へ反映し、商品ごとの現在庫を提示する | `P-05` / `bps-inventory-check` | `uis-inventory` | `sf-inventory`(作成候補、`Q-03`) |
|
|
76
|
+
| `SF-INV-02` | 入荷記録 | 検品済みの商品と数量を入荷として記録し、在庫確認へ渡す | `P-02` / `bps-receiving` | `uis-inventory` | 一覧行で要約 |
|
|
77
|
+
| `SF-INV-03` | 補充依頼支援 | 補充基準を下回った商品と、発注単位に合わせた依頼数量を提示し、承認された依頼を記録する | `P-06` / [[specdojo:bps-sample\|補充依頼確定]] | `uis-inventory` | 一覧行で要約 |
|
|
78
|
+
| `SF-CLS-01` | 日次締め照合 | 当日の販売・入荷・在庫・つけの記録を突き合わせ、差異を提示して締めの確定を記録する | `P-09` / `bps-daily-closing` | `uis-closing` | 一覧行で要約 |
|
|
79
|
+
| `SF-CLS-02` | 月次集計報告 | 月次の売上・欠品回数・つけ残高を集計し、見直しの判断材料として提示する | `P-10` / `bps-monthly-review` | `uis-closing` | 一覧行で要約 |
|
|
80
|
+
|
|
81
|
+
- `uis-credit-sale` はつけ販売とつけ精算(`SF-CRD-01`・`SF-CRD-03`)にまたがる。`uis-inventory` は在庫の 3 機能にまたがる。
|
|
82
|
+
- `uis-closing` は日次締めと月次集計にまたがる。画面の数を機能数とせず、業務上の責務で行を分ける。
|
|
83
|
+
- `SF-POS-01`・`SF-CRD-01` と `SF-INV-02` は、販売の払出数量と入荷数量を `SF-INV-01` へ渡す。在庫の算出・反映は在庫確認、現金販売の完了通知は店頭商品販売が担い、在庫未反映・結果不明を販売完了とは通知しない。詳細な回復条件は [[specdojo:sf-sample|商品販売機能仕様]] を正とする。
|
|
84
|
+
- つけ上限超過時の販売可否、補充依頼の承認、締めの確定は店主代表に残す。システムは判断材料と判断結果を記録し、上限超過を自動承認する機能は数えない(`Q-02`)。
|
|
85
|
+
- 個別仕様の完成例は店頭商品販売を参照し、在庫確認は作成候補とする。カタログ登録が未確認のため、作成判断と登録を `Q-03` で追跡する。その他は一覧行の要約を正とし、詳細化が必要になった時点でカタログへ登録してから作成する。
|
|
86
|
+
|
|
87
|
+
画面配置・入力形式は画面仕様、入出力・振る舞い・機能の受入条件は個別仕様、値・物理構造はデータの正本・schema へ委ねる。通常利用の接点は GUI とし、別の操作例である販売管理 CLI をこの一覧の利用接点には含めない。
|
|
88
|
+
|
|
89
|
+
## 4. 未決事項
|
|
90
|
+
|
|
91
|
+
### 4.1. 未照合・未決の対応
|
|
92
|
+
|
|
93
|
+
主一覧のリンクがない仕様 ID と以下の `kinuya-` で始まる参照名は、本例に未同梱の架空文書・記録である。追跡先は整備時の記録名を示す。PM が初回の範囲レビュー前に用意し、後続作業の担当・順序・期限は `kinuya-schedule` へ接続する。
|
|
94
|
+
|
|
95
|
+
| ID | 論点と影響範囲 | 担当 / 判断者 | 判断時点・次アクション | 追跡先・承認への影響 |
|
|
96
|
+
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
|
|
97
|
+
| `Q-01` | _TODO_: 補充依頼確定以外の BPS と販売登録画面以外の画面仕様は未作成。全9機能の業務・接点対応は領域単位の暫定であり、商品販売機能仕様の上位一覧参照も未接続 | BA / PO(技術照合は DEV、ARC が支援) | 各 BPS・画面の作成時かつ当該機能の設計着手前に、概要と処理ステップを照合する。販売機能の上位一覧参照も接続する | `kinuya-issue-log/SF-01`。対応が未照合の機能の責務承認と設計着手を保留 |
|
|
98
|
+
| `Q-02` | _UNDECIDED_: つけ上限を超える販売を店主代表の承認で許すか、システムで拒否するかが未決であり、`SF-CRD-01` の責務境界が確定しない | BA / PO | つけ販売の画面設計前に PO が運用方針を決定し、BA が BPS・本書の概要・人間に残す判断を更新する | `kinuya-issue-log/SF-02`。上限超過経路の設計・受入を保留 |
|
|
99
|
+
| `Q-03` | _TODO_: 本一覧を管理する `kinuya-function-catalog` は未同梱であり、個別仕様の登録と導入順序が未確認。`sf-inventory` は候補で、補充依頼支援・月次集計の初期導入は未決 | PM・BA / PO(技術確認は DEV) | 初回の範囲レビュー前に PM がカタログと追跡先を整備し、BA が全機能の依存・個別仕様の要否を確認する。PO が初期と後続の範囲を分ける | `kinuya-issue-log/SF-03`。登録前の個別仕様作成と、導入範囲の承認を保留 |
|
|
100
|
+
|
|
101
|
+
### 4.2. 再照合と申し送り
|
|
102
|
+
|
|
103
|
+
上流 BPS・画面の作成や改訂、機能の追加・廃止・統合、個別仕様の追加を受けて BA が該当機能 ID を再照合する。販売・在庫の境界変更では DEV が ARC の支援を受けて画面・データ設計・schema・実装への影響を、QE がテスト対象と受入条件への影響を特定する。OPS の運用手順への助言は PM が取り込む。影響しない参照先にも非該当の理由をレビュー記録へ残す。
|
|
104
|
+
|
|
105
|
+
判断待ちで後続作業が止まる場合は、BA が機能 ID、影響する成果物・タスクと再開条件を PM へ渡す。PM は課題を `kinuya-issue-log`、範囲変更を `kinuya-change-request-log`、追従作業を `kinuya-schedule` で追跡し、本書には対応する参照を残す。
|
|
106
|
+
|
|
107
|
+
廃止・統合時も機能 ID は再利用せず、旧 ID、理由、後継機能と参照元の付替え先をレビュー記録へ残す。文書の置き換え・廃止は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] に従う。公開後の参照切れは BA、技術境界の矛盾は DEV・ARC、計画への影響は PM、スコープ・公開範囲の変更は PO に引き継ぐ。
|