docs(phase-14.2): add validation strategy

.planning/phases/14.2-local-fonoteka-frontend-on-local-summercms-backend/14.2-VALIDATION.md

@@ -0,0 +1,90 @@
+---
+phase: "14.2"
+slug: "local-fonoteka-frontend-on-local-summercms-backend"
+# status lifecycle: draft (seeded by plan-phase) → validated (set by validate-phase §6)
+# audit-milestone §5.5 distinguishes NOT-VALIDATED (draft) from PARTIAL (validated + nyquist_compliant: false) (#2117)
+status: draft
+nyquist_compliant: false
+wave_0_complete: false
+created: "2026-10-07"
+---
+
+# Phase 14.2 — Validation Strategy
+
+> Per-phase validation contract for feedback sampling during execution.
+
+---
+
+## Test Infrastructure
+
+| Property | Value |
+|----------|-------|
+| **Framework** | Go `testing` + testcontainers-go Postgres; Playwright ^1.60 (e2e); `node --test` (Nuxt contracts) |
+| **Config file** | none for Go; `vue-fonoteka-app/playwright.config.ts` |
+| **Quick run command** | `go -C ../fonoteka.go test ./plugins/golem15/fonoteka/console/ -run 'TestDevSeed' -count=1` |
+| **Full suite command** | `bash scripts/check-phase14.2.sh --all` (from `summercms.go`) |
+| **Estimated runtime** | ~300 seconds (full, with e2e); ~30 seconds (quick) |
+
+---
+
+## Sampling Rate
+
+- **After every task commit:** quick `go test` for the touched package plus `go vet` on the touched modules
+- **After every plan wave:** `bash scripts/check-phase14.2.sh --go` (+ `--docs` when framework modules changed)
+- **Before `/gsd-verify-work`:** `bash scripts/check-phase14.2.sh --all` green (services up)
+- **Max feedback latency:** 60 seconds (per-task)
+
+---
+
+## Per-Task Verification Map
+
+Filled in by the planner per task; requirement-level map from RESEARCH.md:
+
+| Behavior | Requirement | Test Type | Automated Command | File Exists | Status |
+|----------|-------------|-----------|-------------------|-------------|--------|
+| `dev:seed` refuses outside local/dev | QA-05 | unit | `go -C ../fonoteka.go test ./plugins/golem15/fonoteka/console/ -run TestDevSeedRefusesProduction -count=1` | ❌ W0 | ⬜ pending |
+| `dev:seed` idempotent | QA-05 | unit (testcontainers) | `… -run TestDevSeedIdempotent` | ❌ W0 | ⬜ pending |
+| `dev:seed` created shape (user, collection, albums+covers, wishlist, `inv_` token, typesense flag) | QA-05 | unit | `… -run TestDevSeedShape` | ❌ W0 | ⬜ pending |
+| seed and reindex open their own DB (G1) | QA-05 | unit | `… -run 'TestDevSeedOpensDatabase|TestReindexOpensDatabase'` | ❌ W0 | ⬜ pending |
+| marker route present in local, absent in production, not in manifest | QA-05 | unit | `go -C ../fonoteka.go test ./plugins/golem15/fonoteka/ -run TestDevMarkerRoute` | ❌ W0 | ⬜ pending |
+| `/storage/app/uploads/public/...` serves public blobs, 404s private/traversal, nosniff (G2) | QA-05 | unit | `go test ./modules/surf/ -run TestUploadsMount` | ❌ W0 | ⬜ pending |
+| access log opt-in, logs pattern+status only (G3) | QA-05 | unit | `go test ./modules/surf/ -run TestAccessLog` | ❌ W0 | ⬜ pending |
+| guard refuses `:8422`, unset internal origin, non-loopback, PHP answer | QA-05 | script | `bash scripts/check-phase14.2.sh --guard` | ❌ W0 | ⬜ pending |
+| runTinker switch: PHP path unchanged when unset | QA-05 | contract | `pnpm test:contracts` | ❌ W0 | ⬜ pending |
+| core flows on Go | QA-05 | e2e | `bash scripts/check-phase14.2.sh --e2e` | ❌ W0 | ⬜ pending |
+
+*Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*
+
+---
+
+## Wave 0 Requirements
+
+- [ ] `fonoteka.go/plugins/golem15/fonoteka/console/dev_seed_test.go` — refusal, idempotency, shape, own-DB
+- [ ] reindex own-DB test in `fonoteka.go/plugins/golem15/fonoteka/console/`
+- [ ] marker route test in the fonoteka plugin package
+- [ ] `summercms.go/modules/surf` tests for access log and uploads mount
+- [ ] `vue-fonoteka-app/tests/contracts/e2e-backend-switch.test.mjs`
+- [ ] `summercms.go/scripts/check-phase14.2.sh`
+
+Framework install: none.
+
+---
+
+## Manual-Only Verifications
+
+| Behavior | Requirement | Why Manual | Test Instructions |
+|----------|-------------|------------|-------------------|
+| Signed-in session covering all core flows, realtime across two browsers, visual cover check | QA-05 | D-13 requires one checklist-driven human session as UAT evidence | Follow the checklist in `14.2-UAT.md` against `scripts/dev-stack.sh up` |
+
+---
+
+## 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 < 60s
+- [ ] `nyquist_compliant: true` set in frontmatter
+
+**Approval:** pending