docs(planning): archivia v2.1/v2.2/v2.3 e documenta v2.4

.planning/ documentava in dettaglio cio che era vecchio e per niente cio
che e in produzione: le fasi 11-22 (v2.1 e v2.2, chiuse a giugno) erano
ancora in phases/ mentre v1.0 e v2.0 stavano gia in milestones/, e il
lavoro degli ultimi due mesi - gate OTP e ciclo di vita dei retainer, cioe
quello che gira su hub.iamcavalli.net - non aveva nessuna cartella.

- phases/{11,12,14} -> milestones/v2.1-phases/, phases/{18..22} ->
  milestones/v2.2-phases/. Ora phases/ contiene solo la milestone in
  corso, che e quello che state.cjs conta per il progresso
- v2.1-ROADMAP.md ricostruito: era l'unica milestone senza archivio,
  interrotta dal reset del 19/06 e mai chiusa formalmente
- v2.3-ROADMAP.md + v2.3-REQUIREMENTS.md: v2.3 e stata eseguita fuori dal
  ciclo GSD, non esistono PLAN/SUMMARY per fase. L'archivio E la doc
- REQUIREMENTS.md riscritto per v2.4 con il backlog reale
- phases/13 e phases/26: SUMMARY ricostruiti da commit, migration e
  STATUS.md. 26 e il primo numero libero
- research/: cancellate 4 varianti dello stesso PITFALLS e FEATURES/
  SUMMARY, superati da PROJECT.md. Diverse anti-feature erano ormai
  contraddette dai fatti (il Kanban e stato costruito in Phase 19,
  l'email in v2.3, il time tracking esiste)
- cancellati UI-RULES.md e DESIGN-SYSTEM.md (CLAUDE.md li dichiara
  superseded: impongono l'inverso della regola attuale) e HANDOFF.md,
  fermo al 13/06
- SECURITY-*.md -> security/: audit chiuso, ma i report restano la doc di
  cosa e stato ruotato e perche
- PROJECT.md/MILESTONES.md/ROADMAP.md allineati: milestone corrente v2.4,
  sessione OTP 90gg non 30, migrazioni fino alla 0016

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.planning/milestones/v2.2-phases/20-knowledge-base-cliente/20-02-SUMMARY.md

@@ -0,0 +1,30 @@
+---
+phase: 20-knowledge-base-cliente
+plan: "02"
+status: complete
+completed_at: "2026-06-20"
+---
+
+# Plan 20-02 Summary: Data Layer client_transcripts
+
+## What Was Built
+
+Drizzle schema, query layer e server actions per i transcript delle call.
+
+## Key Files Modified
+
+- `src/db/schema.ts` — tabella `clientTranscripts` + relazioni bidirezionali + TypeScript types
+- `src/lib/lead-service.ts` — `getTranscripts(leadId)` con orderBy call_date DESC
+- `src/app/admin/leads/actions.ts` — `addTranscript` + `deleteTranscript` con requireAdmin
+
+## Self-Check: PASSED
+
+- ✓ `export const clientTranscripts = pgTable("client_transcripts", ...)` in schema.ts
+- ✓ `leadsRelations` aggiornato con `transcripts: many(clientTranscripts)`
+- ✓ `clientsRelations` aggiornato con `transcripts: many(clientTranscripts)`
+- ✓ `clientTranscriptsRelations` con one(leads) + one(clients)
+- ✓ `export type ClientTranscript` e `NewClientTranscript` esportati
+- ✓ `getTranscripts(leadId)` ordinato per `call_date DESC`
+- ✓ `addTranscript` con requireAdmin + Zod + revalidatePath
+- ✓ `deleteTranscript` con requireAdmin + revalidatePath
+- ✓ `npx tsc --noEmit` → no errors