golem15/summercms
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8c3e13111183c30d4936c0c14dd06221734f2f4a
summercms/.planning/phases/10-admin-vue-spa/10-VALIDATION.md
Jakub Zych 8c3e131111 docs(10): create phase plan
2026-09-27 14:11:07 +02:00

9.7 KiB
Raw Blame History

phase, slug, status, nyquist_compliant, wave_0_complete, created
phase slug status nyquist_compliant wave_0_complete created
10 admin-vue-spa draft false false 2026-09-27

Phase 10 — Validation Strategy

Per-phase validation contract for feedback sampling during execution.

Test Infrastructure

Property Value
Framework Go 1.27 testing + testify (Testcontainers Postgres harness); Vitest ^3.2 + @vue/test-utils + happy-dom for the SPA
Config file none for Go; admin/vitest.config.ts (Wave 0 installs)
Quick run command go test ./cabana ./bouncer ./phrasebook ./boardwalk -count=1 / (cd admin && npx vitest run --reporter=dot)
Full suite command go vet ./... && go test ./... && (cd ../fonoteka.go && go vet ./... && go test ./...) && (cd admin && npm run typecheck && npm test)
Estimated runtime ~180 seconds (Postgres-backed suites dominate)

Sampling Rate

  • After every task commit: narrowest Go package test + go vet ./... in the touched repo; for SPA tasks npx vitest run <dir> + npm run typecheck
  • After every plan wave: full suite in both repos + cd admin && npm run build + scripts/check-admin-dist.sh + scripts/check-admin-openapi.sh
  • Before /gsd-verify-work: scripts/check-phase10.sh --all must be green
  • Max feedback latency: 180 seconds

Per-Task Verification Map

Filled by the planner from each PLAN.md <verify> block (cwd = summercms.go; the app repo is reached via (cd ../fonoteka.go && ...)). Plan 10-05 Task 3 replaces statuses with the final gate result.

Task ID Plan Wave Requirement / Decisions Threat Ref Test Type Automated Command File Exists Status
10-01-T1 01 1 ADMIN-06 (package gate) T-10-SC human (blocking-human) n/a — npm package legitimacy checkpoint before install n/a ⬜ pending
10-01-T2 01 1 ADMIN-06 SC1, SC4; D-01 D-02 D-03 D-06 D-07 D-10 D-11 D-15 D-16 D-19 T-10-01 T-10-02 T-10-03 T-10-04 T-10-17 assembled Postgres + unit + smoke + script (cd ../fonoteka.go && go test ./plugins/golem15/fonoteka -run '^TestPhase10TracerSPA$' -count=1 -v) && go vet ./... && go test ./cabana ./bouncer ./boardwalk -count=1 && npm --prefix admin run typecheck && npm --prefix admin test -- tests/smoke && scripts/check-admin-openapi.sh --check ❌ W0 (created by task) ⬜ pending
10-01-T3 01 1 ADMIN-06 SC1; D-04 D-11 D-19 D-25 T-10-05 T-10-06 T-10-07 T-10-08 unit + assembled + script go test ./cabana -run '^TestPhase10(CookieAuth|CSRF|Prefix)$' -count=1 -v && go test ./surf -run '^TestPhase10AdminPrefixCollision$' -count=1 -v && go test ./boardwalk -count=1 -v && (cd ../fonoteka.go && go test ./plugins/golem15/fonoteka -run '^(TestPhase10AdminAuth|TestPhase10LangCatalog|TestAdminMetadataNavigation)$' -count=1 -v) && npm --prefix admin test -- tests/smoke && scripts/check-admin-dist.sh && scripts/check-phase9.sh --security ❌ W0 (created by task) ⬜ pending
10-02-T1 02 2 ADMIN-06 SC2; D-17 D-18 D-26 T-10-09 T-10-10 T-10-11 unit + assembled Postgres go test ./cabana -run '^TestPhase10Relation(Options|Save|ForgedID|Boot)$|^TestPhase09(PermissionMatrix|ContractInventory)$' -count=1 -v && (cd ../fonoteka.go && go test ./plugins/golem15/fonoteka -run '^(TestPhase10AlbumRelations|TestPhase10CollectionOwnerReadOnly|TestAlbumsAdmin.*|TestCollectionsAdmin.*)$' -count=1) && scripts/check-admin-openapi.sh --check ❌ W0 (created by task) ⬜ pending
10-02-T2 02 2 ADMIN-06 SC2; D-13 D-14 D-20 D-24 T-10-12 T-10-13 unit + assembled go test ./phrasebook ./cabana -run '^TestPhase10(Forms|LangOverride|SPAKeysResolve|Bundle|Messages|Toolbar)$|^TestPhase09(PermissionMatrix|ContractInventory)$' -count=1 -v && go test ./internal/build -run '^Test.*AdminController' -count=1 && (cd ../fonoteka.go && go test ./plugins/golem15/fonoteka -run '^(TestPhase10ControllerCopy|TestPhase10LangCatalog)$' -count=1 -v) && scripts/check-admin-openapi.sh --check ❌ W0 (created by task) ⬜ pending
10-02-T3 02 2 ADMIN-06 SC2, SC4; D-08 D-15 D-16 D-27 T-10-14 T-10-15 unit + assembled + script go test ./cabana -run '^TestPhase10(FilterOptions|OpenAPIConformance)$|^TestPhase09(PermissionMatrix|ContractInventory)$' -count=1 -v && scripts/check-admin-openapi.sh --check && npm --prefix admin run typecheck && scripts/check-admin-dist.sh && (cd ../fonoteka.go && go test ./plugins/golem15/fonoteka -run '^TestPhase10Controllers$' -count=1 -v) && go vet ./... && go test ./... && (cd ../fonoteka.go && go vet ./... && go test ./...) ❌ W0 (created by task) ⬜ pending
10-03-T1 03 3 ADMIN-06 SC2; D-05 D-09 D-10 D-18 D-20 D-24 T-10-16 T-10-20 smoke + unit + script npm --prefix admin run typecheck && npm --prefix admin test -- tests/smoke/edit.smoke.test.ts && go test ./phrasebook -run '^TestPhase10SPAKeysResolve$' -count=1 -v && scripts/check-admin-dist.sh ❌ W0 (created by task) ⬜ pending
10-03-T2 03 3 ADMIN-06 SC2; D-12 D-13 D-14 D-22 D-27 T-10-16 T-10-19 smoke + unit + script npm --prefix admin run typecheck && npm --prefix admin test -- tests/smoke/list.smoke.test.ts && go test ./phrasebook -run '^TestPhase10SPAKeysResolve$' -count=1 -v && scripts/check-admin-dist.sh ❌ W0 (created by task) ⬜ pending
10-03-T3 03 3 ADMIN-06 SC2; D-05 D-17 D-18 D-21 D-26 T-10-18 smoke + unit + script + assembled npm --prefix admin run typecheck && npm --prefix admin test -- tests/smoke && go test ./phrasebook -run '^TestPhase10SPAKeysResolve$' -count=1 -v && scripts/check-admin-dist.sh && (cd ../fonoteka.go && go test ./plugins/golem15/fonoteka -run '^TestPhase10Controllers$' -count=1 -v) + human-check (five controllers in a browser) ❌ W0 (created by task) ⬜ pending
10-04-T1 04 4 ADMIN-06 SC3; D-05 D-06 T-10-21 smoke + assembled + script npm --prefix admin run typecheck && npm --prefix admin test -- tests/smoke/relation.smoke.test.ts && go test ./phrasebook -run '^TestPhase10SPAKeysResolve$' -count=1 -v && scripts/check-admin-dist.sh && (cd ../fonoteka.go && go test ./plugins/golem15/fonoteka -run '^TestCollectionsAdmin(RelationSchema|Link|Unlink|CrossScope|RelationEdges)$' -count=1 -v) + human-check (editors link/unlink in a browser) ❌ W0 (created by task) ⬜ pending
10-04-T2 04 4 ADMIN-06 SC1; D-06 D-10 T-10-22 T-10-23 smoke + script npm --prefix admin run typecheck && npm --prefix admin test -- tests/smoke && go test ./phrasebook -run '^TestPhase10SPAKeysResolve$' -count=1 -v && scripts/check-admin-dist.sh + human-check (visual fidelity, limited vs superuser rail) ❌ W0 (created by task) ⬜ pending
10-05-T1 05 5 ADMIN-06 SC1-SC4; D-08 D-23 T-10-25 component + unit npm --prefix admin run typecheck && npm --prefix admin test -- tests/app tests/state tests/shell tests/list tests/form tests/relation tests/views tests/smoke ❌ W0 (created by task) ⬜ pending
10-05-T2 05 5 ADMIN-06 SC1-SC4; D-23 T-10-24 unit + assembled Postgres go vet ./... && go test ./boardwalk ./bouncer ./cabana ./phrasebook ./surf ./internal/tools/swagger2openapi -count=1 && (cd ../fonoteka.go && go vet ./... && go test ./plugins/golem15/fonoteka -run '^TestPhase10AssembledAcceptance$' -count=1 -v && go test ./... -count=1) ❌ W0 (created by task) ⬜ pending
10-05-T3 05 5 ADMIN-06 (phase gate) T-10-24 T-10-25 gate script scripts/check-phase10.sh --self-test && scripts/check-phase10.sh --all ❌ W0 (created by task) ⬜ pending

Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky

Wave 0 Requirements

  • admin/package.json scripts: dev, build, typecheck, test, gen:api — Plan 10-01 Task 2
  • admin/vitest.config.ts + admin/tests/setup.ts (fetch mock for openapi-fetch) — Plan 10-01 Task 2 (extended in 10-05 Task 1)
  • admin/tests/fixtures/ — neutral schema fixtures (tabs, all field types, unsupported type, three filter shapes) — Plans 10-01, 10-03, 10-04 (completed in 10-05 Task 1)
  • boardwalk/boardwalk_test.go — Plan 10-01 Task 3 (extended in 10-05 Task 2)
  • scripts/check-admin-openapi.sh (10-01 Task 2), scripts/check-admin-dist.sh (10-01 Task 3), scripts/check-phase10.sh (10-05 Task 3)
  • Go test helper adminAPI(rel) for prefix-relative admin API paths in cabana and fonoteka admin tests — Plan 10-01 Task 2

Manual-Only Verifications

Behavior Requirement Why Manual Test Instructions
Visual fidelity to Direction C v2 (tokens, dark mode, collapse below ~1100px) ADMIN-06 (D-06) No browser e2e in Phase 10 (D-23) Human-check in 10-04 Task 2: run summer serve for fonoteka, open {backend.uri}, compare screens against design/Direction C v2.dc.html in light and dark mode at desktop and tablet widths
Full login → navigate → edit → relation link flow in a real browser ADMIN-06 SC1–SC3 Playwright deferred Human-checks in 10-03 Task 3 (five controllers) and 10-04 Tasks 1-2 (editors link/unlink; limited admin vs superuser rail)

Validation Sign-Off

  • All tasks have <automated> verify or Wave 0 dependencies
  • Sampling continuity: no 3 consecutive tasks without automated verify
  • Wave 0 covers all MISSING references
  • No watch-mode flags
  • Feedback latency < 180s
  • nyquist_compliant: true set in frontmatter

Approval: pending

Reference in New Issue View Git Blame Copy Permalink