From 77cf27eb24d3f1275f59e53fbbdd6a97b4b4eb0b Mon Sep 17 00:00:00 2001 From: Jakub Zych Date: Wed, 21 Oct 2026 18:16:34 +0200 Subject: [PATCH] docs(phase-19.6.1): add validation strategy --- .../19.6.1-VALIDATION.md | 80 +++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 .planning/phases/19.6.1-backend-administrators-screen/19.6.1-VALIDATION.md diff --git a/.planning/phases/19.6.1-backend-administrators-screen/19.6.1-VALIDATION.md b/.planning/phases/19.6.1-backend-administrators-screen/19.6.1-VALIDATION.md new file mode 100644 index 00000000..ff30b434 --- /dev/null +++ b/.planning/phases/19.6.1-backend-administrators-screen/19.6.1-VALIDATION.md @@ -0,0 +1,80 @@ +--- +phase: "19.6.1" +slug: "backend-administrators-screen" +# 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-21" +--- + +# Phase 19.6.1 — Validation Strategy + +> Per-phase validation contract for feedback sampling during execution. + +--- + +## Test Infrastructure + +| Property | Value | +|----------|-------| +| **Framework** | Go `testing`; testcontainers-go Postgres via `adminGorm(t)` (skips under `-short`) | +| **Config file** | none — package helpers `adminGorm`, `adminHandler`, `insertAdmin` in `modules/cabana/auth_test.go` | +| **Quick run command** | `go vet ./modules/cabana ./modules/pact && go test -short ./modules/cabana ./modules/pact ./modules/surf` | +| **Full suite command** | `go vet ./... && go test ./... && (cd examples/hello && go test ./...) && go test ./cmd/summer -run TestDocsTree && go run ./cmd/summer docs:build --check` | +| **Estimated runtime** | ~180 seconds (Docker-backed) | + +--- + +## Sampling Rate + +- **After every task commit:** Run the quick run command +- **After every plan wave:** `go test ./modules/cabana ./modules/surf` (Docker) + `cd examples/hello && go test ./...` +- **Before `/msd-verify-work`:** Full suite must be green +- **Max feedback latency:** 180 seconds + +--- + +## Per-Task Verification Map + +Filled by the planner per task; the decision → test map lives in `19.6.1-RESEARCH.md` § Validation Architecture. + +| Task ID | Plan | Wave | Requirement | Threat Ref | Secure Behavior | Test Type | Automated Command | File Exists | Status | +|---------|------|------|-------------|------------|-----------------|-----------|-------------------|-------------|--------| +| 19.6.1-01-* | 01 | 1 | D-03..D-17 | T-19.6.1-* | privilege rules enforced server-side | smoke | per plan | ❌ W0 | ⬜ pending | +| 19.6.1-02-* | 02 | 2 | D-03..D-17 | T-19.6.1-* | privilege rules covered by tests | unit/Postgres | per plan | ❌ W0 | ⬜ pending | + +*Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky* + +--- + +## Wave 0 Requirements + +- [ ] `modules/cabana/backend_screens_test.go` — activation and schema (`-short`) +- [ ] `modules/cabana/action_extensions_test.go` — D-14 boot and run +- [ ] `modules/cabana/backend_privileges_internal_test.go` — subset/ceiling helpers (`package cabana`) +- [ ] `modules/cabana/administrators_postgres_test.go` — D-03..D-12 at HTTP level +- [ ] `modules/cabana/roles_postgres_test.go` — D-16/D-17 +- [ ] superuser-capable `insertAdmin` helper + +--- + +## Manual-Only Verifications + +| Behavior | Requirement | Why Manual | Test Instructions | +|----------|-------------|------------|-------------------| +| Administrators/Roles screens render and save in the admin SPA | SC-1 | visual SPA check | log in as superuser and as a limited admin, open Settings → Administrators / Roles, create, edit, deactivate | + +--- + +## Validation Sign-Off + +- [ ] All tasks have `` 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