docs: apre v2.5 "Audit" e rimette in pari roadmap e requisiti

La roadmap era ferma al 2026-08-08 e diceva ancora "nessuna fase aperta" mentre v2.5 era gia' partita e Phase 27 era a meta'; REQUIREMENTS.md era ancora quello di v2.4. STATE.md invece era corretto — segno che aggiornare solo quello non basta. Da qui la divisione dei ruoli, ora esplicita in testa a ogni file: - STATE.md orientamento breve (99 righe): dove sta cosa, come funziona il motore, i blocchi vivi. Niente narrativa. - ROADMAP.md tutte le fasi 1->30, con lo stato di ciascuna - REQUIREMENTS.md i 25 requisiti di v2.5 (AUD-01..25) e il backlog - STATUS.md l'unica narrativa lunga: lezioni e note tecniche v2.4 chiusa e archiviata in milestones/v2.4-REQUIREMENTS.md. Decisione nuova: il documento di restituzione usa il design system dell'area admin ("Quiet Luxury"), non una tipografia sua — token semantici, Plus Jakarta Sans, Geist Mono per metriche e date, StatusBadge per gli impatti. Sostituisce la deroga tipografica prevista dal piano. I font sono gia' self-hostati da next/font/google, quindi la CSP font-src 'self' e' soddisfatta senza lavoro, e il documento non aggiunge debito a DEBT-01 perche' nasce gia' a token. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:48:46 +02:00
parent 24213e7251
commit 8000d562dc
5 changed files with 278 additions and 104 deletions
@@ -7,7 +7,8 @@
 - ✅ **v2.1 Offer Studio + CRM** — Phases 11, 12, 14 (chiusa per reset 2026-06-19) — [archive](milestones/v2.1-ROADMAP.md)
 - ✅ **v2.2 Sales Loop** — Phases 18–22 (shipped 2026-06-20) — [archive](milestones/v2.2-ROADMAP.md)
 - ✅ **v2.3 Email & Accesso** — Phases 23–25 (shipped 2026-07-29) — [archive](milestones/v2.3-ROADMAP.md)
- 🔨 **v2.4 Post-vendita** — Phases 13 + 26 (entrambe in produzione)
+- ✅ **v2.4 Post-vendita** — Phases 13 + 26 (entrambe in produzione, 2026-08-01 / 2026-08-08)
+- 🔨 **v2.5 Audit** — Phases 27–30 — documento di restituzione del servizio di analisi sito

 ## Phases

@@ -47,22 +48,50 @@ Archivio completo: [milestones/v2.3-ROADMAP.md](milestones/v2.3-ROADMAP.md)

 </details>

-### 🔨 v2.4 — Post-vendita (Phases 13 + 26)
+### ✅ v2.4 — Post-vendita (Phases 13 + 26)

 - [x] **Phase 13: Ciclo di vita dei servizi ricorrenti** — `project_offers.status` + `end_date` (migr. 0016), forecast che si ferma davvero, comandi Sospendi/Riattiva/Cessa nella tab Offerte, stato dell'abbonamento visibile al cliente. ✅ **prod 2026-08-01** (`5177a37`) — [13-SUMMARY.md](phases/13-ciclo-vita-servizi-ricorrenti/13-SUMMARY.md)
 - [x] **Phase 26: Anteprima admin del portale + toggle password** — `?preview=1` con sessione Auth.js valida apre il portale di un cliente in sola lettura, senza gate OTP. ✅ **prod 2026-08-08** (`09a5b1f`, `187550f`) — [26-SUMMARY.md](phases/26-anteprima-admin-e-login/26-SUMMARY.md)

-**Nessuna fase aperta.** Il prossimo lavoro va scelto dal backlog in
-[REQUIREMENTS.md](REQUIREMENTS.md) — i candidati principali sono RET-06 (canoni
-mensili tracciabili, richiede una tabella nuova perché `payments` è protetta) e
-DEBT-01 (debito design, ~40 file).
+### 🔨 v2.5 — Audit (Phases 27–30) · *in corso*
+
+Il servizio di analisi sito (tre livelli: **Radiografia / Prima-Dopo / Rotta**) diventa
+un documento privato su `/audit/[slug]`, generato da un motore multi-agente e rifinito a
+mano prima della consegna. Piano approvato il 2026-08-16, motore ripianificato il
+2026-08-18.
+
+- [ ] **Phase 27: Motore di analisi** — *in corso, ~50%*
+  - [x] Migration `0017_audits.sql` (7 tabelle additive) — **applicata in prod 2026-08-18**
+  - [x] `checklist_items` seminata, 264 voci — **in prod**
+  - [x] `src/lib/audit/sources/` — 5 moduli, **provati sul campo su giojello.com** (73 s, tutte le fonti hanno risposto). *Scritti, non pushati.*
+  - [ ] `src/lib/audit/schema.ts` + `agents/` (checklist, visual, history, technical, synthesis) con validazione Zod dura
+  - [ ] `src/lib/audit/pipeline.ts` con heartbeat su `audit_runs`
+- [ ] **Phase 28: Storage immagini** — volume persistente Coolify, `ImageUploadField`, `/api/uploads/[...path]` con guardia sul path traversal. ⚠️ **Checkpoint bloccante: il volume va creato in Coolify PRIMA del deploy**, altrimenti gli upload si perdono a ogni redeploy.
+- [ ] **Phase 29: Editor admin** — lista audit, editor a payload intero (modello: `admin/offers/actions.ts`), riordino finding e ottimizzazioni con `@dnd-kit/sortable`, registro visite
+- [ ] **Phase 30: Pagina pubblica + PDF + tracciamento** — `/audit/[slug]`, blocchi condizionali per livello, print CSS per il PDF, `<AuditVisitTracker>` che non conta le aperture da admin loggato
+
+> I nomi di 28–30 sono **derivati dalle sezioni §7/§8/§9 del piano approvato**, non ancora
+> passati da `/gsd-plan-phase`. La numerazione riprende da 27 perché 15–17 sono state
+> abbandonate o ri-scopate.
+
+**Ingresso Whop**: predisposto nello schema (`origin`, `external_ref`), **non costruito** —
+è fase 2, fuori da v2.5.

 ## Progress

+Tutte le fasi del progetto, dalla 1 alla 30. La numerazione è **progressiva e mai
+riusata**: i buchi (15–17) sono fasi abbandonate o ri-scopate, non fasi mancanti.
+
 | Phase | Milestone | Plans | Status | Completed |
 |-------|-----------|-------|--------|-----------|
-| 1–6. Foundation → UX Overhaul | v1.0 | 24/24 | ✅ Done | 2026-06-10 |
-| 7–10. Unified Catalog → CRM Pipeline | v2.0 | 12/12 | ✅ Done | 2026-06-13 |
+| 1. Foundation & Client Dashboard | v1.0 | — | ✅ Done | 2026-06 |
+| 2. Admin Area & Interactive Features | v1.0 | — | ✅ Done | 2026-06 |
+| 3. Service Catalog & Quote Builder | v1.0 | — | ✅ Done | 2026-06 |
+| 4. Progetti — Multi-Project per Cliente | v1.0 | — | ✅ Done | 2026-06 |
+| 5. Offer System | v1.0 | — | ✅ Done | 2026-06 |
+| 6. UX Overhaul — Sidebar + Dashboard | v1.0 | 24/24 tot. | ✅ Done | 2026-06-10 |
+| 7. Claude AI Onboarding (v2) | v2.0 | — | ✅ Done | 2026-06 |
+| 8–10. Unified Catalog → CRM Pipeline | v2.0 | 12/12 tot. | ✅ Done | 2026-06-13 |
 | 11. Catalog Database-View UX | v2.1 | 4/4 | ✅ Done | 2026-06-13 |
 | 12. Offer Editor Tier A/B/C | v2.1 | 5/5 | ✅ Done | 2026-06-18 |
 | 14. CRM Attio-style & Fix | v2.1 | 3/3 | ✅ Done | 2026-06-14 |
@@ -78,7 +107,12 @@ DEBT-01 (debito design, ~40 file).
 | 25. OTP Gate + Sessione | v2.3 | 1/1 | ✅ Done | 2026-07-29 |
 | 13. Ciclo di vita servizi ricorrenti | v2.4 | 1/1 | ✅ Done | 2026-08-01 |
 | 26. Anteprima admin + login | v2.4 | 1/1 | ✅ Done | 2026-08-08 |
+| 27. Motore di analisi | v2.5 | 0/1 | 🔨 In corso (~50%) | — |
+| 28. Storage immagini | v2.5 | 0/1 | ⏳ Da pianificare | — |
+| 29. Editor admin | v2.5 | 0/1 | ⏳ Da pianificare | — |
+| 30. Pagina pubblica + PDF | v2.5 | 0/1 | ⏳ Da pianificare | — |

 ---
-*Roadmap aggiornata: 2026-08-08 — v2.3 archiviata, v2.4 documentata a posteriori*
+*Roadmap aggiornata: 2026-08-18 — v2.4 chiusa, v2.5 "Audit" aperta (era assente: la roadmap
+è rimasta ferma al 2026-08-08 mentre v2.5 partiva e Phase 27 arrivava a metà).*