76 lines
3.7 KiB
Markdown
76 lines
3.7 KiB
Markdown
---
|
|
phase: 09
|
|
slug: etapes
|
|
status: draft
|
|
nyquist_compliant: true
|
|
wave_0_complete: false
|
|
created: 2026-05-15
|
|
---
|
|
|
|
# Phase 09 - Validation Strategy
|
|
|
|
> Per-phase validation contract for feedback sampling during execution.
|
|
|
|
---
|
|
|
|
## Test Infrastructure
|
|
|
|
| Property | Value |
|
|
|----------|-------|
|
|
| **Framework** | Go test |
|
|
| **Config file** | `backend/sqlc.yaml`, `backend/justfile` |
|
|
| **Quick run command** | `cd backend && go test ./internal/web -count=1` |
|
|
| **Full suite command** | `cd backend && go test ./... -count=1` |
|
|
| **Estimated runtime** | ~30-90 seconds, DB-backed tests skip unless `TEST_DATABASE_URL` is configured |
|
|
|
|
---
|
|
|
|
## Sampling Rate
|
|
|
|
- **After every task commit:** Run `cd backend && go test ./internal/web -count=1`
|
|
- **After every plan wave:** Run `cd backend && go test ./... -count=1`
|
|
- **Before `$gsd-verify-work`:** Full suite must be green
|
|
- **Max feedback latency:** 90 seconds for local non-DB path; DB-backed path depends on `TEST_DATABASE_URL`
|
|
|
|
---
|
|
|
|
## Per-Task Verification Map
|
|
|
|
| Task ID | Plan | Wave | Requirement | Threat Ref | Secure Behavior | Test Type | Automated Command | File Exists | Status |
|
|
|---------|------|------|-------------|------------|-----------------|-----------|-------------------|-------------|--------|
|
|
| 09-01-01 | 01 | 1 | ETAPE-01, ETAPE-06 | T-09-01 | Etapes are tablo-owned rows with no parent relationship | migration/sqlc | `cd backend && just generate && go test ./internal/web -count=1` | yes | pending |
|
|
| 09-01-02 | 01 | 1 | ETAPE-03, ETAPE-04 | T-09-02 | `tasks.etape_id` is nullable and `ON DELETE SET NULL` | migration/sqlc | `cd backend && just generate && go test ./internal/web -count=1` | yes | pending |
|
|
| 09-02-01 | 02 | 2 | ETAPE-01, ETAPE-02 | T-09-03 | Only tablo owners can create/edit/delete/reorder etapes | handler integration | `cd backend && go test ./internal/web -count=1` | yes | pending |
|
|
| 09-03-01 | 03 | 3 | ETAPE-03, ETAPE-05 | T-09-04 | Task assignment rejects etapes outside the task tablo | handler integration | `cd backend && go test ./internal/web -count=1` | yes | pending |
|
|
| 09-04-01 | 04 | 4 | ETAPE-05 | T-09-05 | Reorder preserves `etape_id` and hidden filtered tasks | regression integration | `cd backend && go test ./internal/web -count=1` | yes | pending |
|
|
| 09-04-02 | 04 | 4 | ETAPE-01..06 | - | Full backend suite remains green | full suite | `cd backend && go test ./... -count=1` | yes | pending |
|
|
|
|
---
|
|
|
|
## Wave 0 Requirements
|
|
|
|
- Existing Go test infrastructure covers the phase.
|
|
- Add RED tests before implementation for etape schema behavior, ownership, delete-unassign, assignment, filtering, and reorder preservation.
|
|
- `just generate` must run after migration/query/template changes to refresh sqlc and templ generated code.
|
|
|
|
---
|
|
|
|
## Manual-Only Verifications
|
|
|
|
| Behavior | Requirement | Why Manual | Test Instructions |
|
|
|----------|-------------|------------|-------------------|
|
|
| Top-strip chip interaction and kanban filtering | ETAPE-05 | HTMX/browser interaction and active chip state are easier to confirm visually after automated handler tests pass | Start `cd backend && just dev`, open a tablo, create etapes, assign tasks, click etape and `Unassigned` chips, confirm the existing four kanban columns remain usable |
|
|
| Drag/drop after filtering | ETAPE-05 | Sortable.js behavior depends on browser DOM events | With an etape filter active, drag a task across columns, reload, and confirm status and etape assignment persist |
|
|
|
|
---
|
|
|
|
## Validation Sign-Off
|
|
|
|
- [x] All tasks have automated verify commands or Wave 0 dependencies
|
|
- [x] Sampling continuity: no 3 consecutive tasks without automated verify
|
|
- [x] Wave 0 covers all MISSING references
|
|
- [x] No watch-mode flags
|
|
- [x] Feedback latency target documented
|
|
- [x] `nyquist_compliant: true` set in frontmatter
|
|
|
|
**Approval:** pending
|