docs(phase-19): complete plan 19-01 — LeadsKanbanBoard + toggle PIPE-01/PIPE-02

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.planning/ROADMAP.md

@@ -17,8 +17,8 @@
 - [~] **Phase 15: Dashboard Revenue Stats** - ❌ ABBANDONATA (reset 2026-06-19): mockup mai arrivato; analytics confluisce nella dashboard via CLEAN-03
 - [~] **Phase 16: Proposal AI — Data Foundations & Auto-Provisioning** - ❌ RI-SCOPATA in v2.2; Stripe Payment Link + auto-provisioning → backlog post-R5
 - [~] **Phase 17: Proposal AI — Builder, Pagina Pubblica & Email** - ❌ RI-SCOPATA in v2.2 (Phase 21/22 con transcript + flusso chiaro)
-- [ ] **Phase 18: Cleanup & Consolidamento** - Rimuovi Forecast + quote builder manuale; fondi `/admin/analytics` nella dashboard; archivia fasi residue v2.1
+- [x] **Phase 18: Cleanup & Consolidamento** - Rimuovi Forecast + quote builder manuale; fondi `/admin/analytics` nella dashboard; archivia fasi residue v2.1
-- [ ] **Phase 19: Pipeline CRM Kanban** - Board lead stile Pipedrive con colonne per stage + drag-drop; vinto/perso come cambio-colonna manuale
+- [x] **Phase 19: Pipeline CRM Kanban** - Board lead stile Pipedrive con colonne per stage + drag-drop; vinto/perso come cambio-colonna manuale
 - [ ] **Phase 20: Knowledge Base Cliente** - Schema additivo + UI per incollare transcript datati multipli per lead/cliente
 - [ ] **Phase 21: Agente AI — generazione preventivo** - Builder: admin sceglie cliente+offerta, l'AI (Claude) legge transcript + offerta e genera bozza preventivo; admin revisiona
 - [ ] **Phase 22: Pagina pubblica preventivo + email** - Pagina pubblica HTML/CSS, accept/reject → CRM, invio link via email (Resend)
@@ -162,10 +162,10 @@ Plans:
   4. Le fasi v2.1 residue (13/15/16/17) sono marcate cancellate/congelate nel planning
 **Plans**: 3 plans
 **Plan list**:
-  - [ ] 18-01-PLAN.md — Rimozione Forecast + Quote Builder manuale (CLEAN-01, CLEAN-02)
+  - [x] 18-01-PLAN.md — Rimozione Forecast + Quote Builder manuale (CLEAN-01, CLEAN-02)
-  - [ ] 18-02-PLAN.md — Fusione analytics nella Dashboard, eliminazione rotta /admin/analytics (CLEAN-03)
+  - [x] 18-02-PLAN.md — Fusione analytics nella Dashboard, eliminazione rotta /admin/analytics (CLEAN-03)
-  - [ ] 18-03-PLAN.md — Verifica CLEAN-04 planning docs + build check + checkpoint visuale
+  - [x] 18-03-PLAN.md — Verifica CLEAN-04 planning docs + build check + checkpoint visuale
-**Status**: Planned — ready for `/gsd-execute-phase 18`
+**Status**: ✅ Complete (2026-06-19) — CLEAN-01..04 verificati, build verde
 
 ### Phase 19: Pipeline CRM Kanban
 **Goal**: I lead si gestiscono in una board Kanban stile Pipedrive con drag-drop tra gli stage; vinto/perso è un cambio-colonna manuale.
@@ -178,8 +178,8 @@ Plans:
   3. Spostare un lead su "Vinto"/"Perso" è l'azione manuale che ne registra l'esito
 **Plans**: 1 plan
 **Plan list**:
-  - [ ] 19-01-PLAN.md — LeadsKanbanBoard + LeadsViewToggle + page wiring (PIPE-01, PIPE-02)
+  - [x] 19-01-PLAN.md — LeadsKanbanBoard + LeadsViewToggle + page wiring (PIPE-01, PIPE-02)
-**Status**: Planned — ready for `/gsd-execute-phase 19`
+**Status**: ✅ Complete (2026-06-19) — board 6 colonne, drag-drop persistente, toggle Lista/Kanban, search integrata
 
 ### Phase 20: Knowledge Base Cliente
 **Goal**: Memorizzare i transcript datati delle call (multipli per lead/cliente) e mostrarli nel profilo, pronti per essere dati in pasto all'AI.
@@ -226,8 +226,8 @@ Plans:
 | 15. Dashboard Revenue Stats | — | ❌ Abbandonata (v2.2) | — |
 | 16. Proposal AI — Data Foundations & Auto-Provisioning | — | ❌ Ri-scopata (v2.2) | — |
 | 17. Proposal AI — Builder, Pagina Pubblica & Email | — | ❌ Ri-scopata (v2.2) | — |
-| 18 (R1). Cleanup & Consolidamento | — | Pending planning | — |
+| 18 (R1). Cleanup & Consolidamento | 3/3 | ✅ Done | 2026-06-19 |
-| 19 (R2). Pipeline CRM Kanban | — | Pending planning | — |
+| 19 (R2). Pipeline CRM Kanban | 1/1 | ✅ Done | 2026-06-19 |
 | 20 (R3). Knowledge Base Cliente (transcript) | — | Pending planning | — |
 | 21 (R4). Agente AI — generazione preventivo | — | Pending planning | — |
 | 22 (R5). Pagina pubblica preventivo + email | — | Pending planning | — |

.planning/STATE.md

@@ -3,15 +3,15 @@ gsd_state_version: 1.0
 milestone: v2.2
 milestone_name: — Sales Loop
 status: executing
-stopped_at: "Phase 18 completa (3/3 piani). Pronta per /gsd-plan-phase 19"
+stopped_at: "Phase 19 completa (19-01 done). Pronta per /gsd-plan-phase 20"
-last_updated: "2026-06-19T16:25:00.000Z"
+last_updated: "2026-06-19T18:05:00.000Z"
-last_activity: 2026-06-19 -- Phase 18 complete (CLEAN-01..04 done, verifica visuale superata)
+last_activity: 2026-06-19 -- Phase 19 complete — LeadsKanbanBoard + LeadsViewToggle (PIPE-01/PIPE-02)
 progress:
   total_phases: 5
-  completed_phases: 1
+  completed_phases: 2
-  total_plans: 3
+  total_plans: 4
-  completed_plans: 3
+  completed_plans: 4
-  percent: 20
+  percent: 40
 ---
 
 # Project State
@@ -22,16 +22,16 @@ See: .planning/PROJECT.md (updated 2026-06-13)
 
 **Core value:** Il cliente apre il link e vede esattamente a che punto è il suo progetto, cosa deve ancora succedere e cosa ha già approvato — senza dover scrivere email per chiedere aggiornamenti.
 
-**Current focus:** Milestone **v2.2 "Sales Loop"** (reset 2026-06-19). North-star: lead in pipeline Kanban → transcript call → agente AI genera preventivo → pagina pubblica `/preventivo/[slug]` → vinto/perso. Piano: `.claude/plans/glittery-sprouting-pudding.md`. Prossimo passo: pianificare Phase 19 (R2) Pipeline CRM Kanban.
+**Current focus:** Milestone **v2.2 "Sales Loop"** (reset 2026-06-19). North-star: lead in pipeline Kanban → transcript call → agente AI genera preventivo → pagina pubblica `/preventivo/[slug]` → vinto/perso. Piano: `.claude/plans/glittery-sprouting-pudding.md`. Prossimo passo: eseguire Phase 19 (R2) Pipeline CRM Kanban.
 
 ## Current Position
 
-Phase: 19 (R2) Pipeline CRM Kanban — ready to plan
+Phase: 20 (R3) Knowledge Base Cliente — pending planning
 Plan: —
 Status: Ready to plan
-Last activity: 2026-06-19 -- Phase 18 complete (CLEAN-01..04 done, verifica visuale superata)
+Last activity: 2026-06-19 -- Phase 19 complete (19-01 done — PIPE-01/PIPE-02 verified)
 
-Progress (v2.2): [██░░░░░░░░] 20% — 1/5 fasi complete
+Progress (v2.2): [████░░░░░░] 40% — 2/5 fasi complete
 
 ### Fasi completate (v2.1, storico)
 
@@ -108,6 +108,6 @@ Items acknowledged and carried forward from previous milestone close:
 
 ## Session Continuity
 
-Last session: 2026-06-19T10:25:00.000Z
+Last session: 2026-06-19T18:05:00.000Z
-Stopped at: Phase 18 Plan 02 complete — CLEAN-03 done. Next: 18-03-PLAN.md
+Stopped at: Phase 19 complete — 19-01-SUMMARY.md scritto, PIPE-01/PIPE-02 verificati, checkpoint umano approvato. Next: /gsd-plan-phase 20
-Resume file: .planning/phases/18-cleanup-consolidamento/18-03-PLAN.md
+Resume file: .planning/phases/19-pipeline-crm-kanban/19-01-SUMMARY.md

.planning/phases/19-pipeline-crm-kanban/19-01-SUMMARY.md

@@ -0,0 +1,95 @@
+---
+phase: 19-pipeline-crm-kanban
+plan: 01
+status: complete
+completed_at: "2026-06-19"
+requirements_satisfied:
+  - PIPE-01
+  - PIPE-02
+commits:
+  - 2c67e6f
+  - 607c257
+  - 34be934
+---
+
+# Plan 19-01 Summary — LeadsKanbanBoard + LeadsViewToggle
+
+## What Was Built
+
+Plan 19-01 aggiunge una vista Kanban stile Pipedrive alla pagina `/admin/leads`, affiancata alla tabella esistente tramite un toggle Lista/Kanban.
+
+### Componenti creati / modificati
+
+| File | Tipo | Descrizione |
+|------|------|-------------|
+| `src/components/admin/leads/LeadsKanbanBoard.tsx` | Nuovo | Board Kanban con 6 colonne stage, drag-drop via @dnd-kit, ottimistic update |
+| `src/components/admin/leads/LeadsViewToggle.tsx` | Nuovo | Client wrapper con `useState<"list" \| "kanban">`, search integrata, pill toggle |
+| `src/app/admin/leads/LeadsSearch.tsx` | Modificato | Svuotato e ri-esporta `LeadsViewToggle as LeadsSearch` per retrocompatibilità |
+| `src/app/admin/leads/page.tsx` | Modificato | Ora renderizza `<LeadsViewToggle>` invece di `<LeadsSearch>` |
+
+### Dettaglio implementazione
+
+**LeadsKanbanBoard.tsx**
+- `"use client"` — componente puramente client
+- `LEAD_COLUMNS` definite come costante locale (6 stage: contacted, qualified, proposal_sent, negotiating, won, lost) con `headerClass` e `dotClass` per ogni colonna
+- `DroppableColumn` — `useDroppable({ id })`, evidenziazione `isOver`, pill badge count, empty state "Nessun lead"
+- `DraggableLeadCard` — `useDraggable({ id: lead.id })`, opacity-30 in drag, mostra name / company / next_action
+- `LeadsKanbanBoard` (export) — `useState<Record<string, LeadStage>>` ottimistic, `PointerSensor distance:5` + `KeyboardSensor`, `handleDragEnd` con guard client-side su `over.id ∈ LEAD_COLUMNS`, `startTransition(async () => { await updateLeadField(leadId, "status", newStage); router.refresh(); })`
+- Layout: `overflow-x-auto` → `grid grid-cols-6 gap-3 min-w-[1080px]`
+- `DragOverlay dropAnimation={null}` con ghost card `rotate-1 border-2 border-[#1A463C] shadow-xl`
+
+**LeadsViewToggle.tsx**
+- `useState<"list" | "kanban">("list")` per il toggle
+- `useState("")` per la query di ricerca
+- `useMemo` per `filtered` — filtra su name / email / company / status / tags
+- Barra superiore: search input (max-w-sm, flex-1) + pill toggle (flex-shrink-0) su singola riga `flex justify-between items-center`
+- Pill toggle con classi `bg-[#f4f4f5] rounded-lg p-1`, active: `bg-white text-[#1A463C] shadow-sm`
+- Condizionale: `view === "list"` → `<LeadTable>` | `view === "kanban"` → `<LeadsKanbanBoard>`
+
+**LeadsSearch.tsx** (ri-esportazione)
+- Ridotto a una singola riga: `export { LeadsViewToggle as LeadsSearch } from "@/components/admin/leads/LeadsViewToggle"`
+- Garantisce zero import-break su eventuali riferimenti residui
+
+**page.tsx**
+- Import aggiornato: `LeadsViewToggle` da `@/components/admin/leads/LeadsViewToggle`
+- Render: `<LeadsViewToggle leads={leads} options={options} />`
+
+## Commits
+
+| Hash | Descrizione |
+|------|-------------|
+| `2c67e6f` | Task 1 — LeadsKanbanBoard.tsx con 6 colonne e drag-drop persistente |
+| `607c257` | Task 2 — LeadsViewToggle.tsx + re-export LeadsSearch |
+| `34be934` | Task 3 — page.tsx aggiornato + build check verde + fix overflow clipping |
+
+> Nota: il commit `34be934` include anche un fix minore all'overflow del dropdown in `LeadTable` (il clipping del `overflow-x-auto` del wrapper Kanban tagliava il menu a tendina delle colonne tabella in vista Lista). Fix non bloccante, risolto nella stessa sessione.
+
+## Requirements Satisfied
+
+| Req | Descrizione | Verifica |
+|-----|-------------|---------|
+| PIPE-01 | Board Kanban 6 colonne con drag-drop che aggiorna `leads.status` | Drag tra colonne → `updateLeadField(id, "status", newStage)` → `router.refresh()` — persistente dopo reload |
+| PIPE-02 | Vinto/Perso come cambio-colonna manuale, nessun modale | Trascinare su colonna "won" o "lost" registra l'esito direttamente |
+
+## Must-Haves Verificati
+
+| Truth | Stato |
+|-------|-------|
+| Board 6 colonne (contacted → qualified → proposal_sent → negotiating → won → lost) | ✅ |
+| Drag-drop aggiorna `leads.status` in modo persistente | ✅ |
+| Colonne Vinto/Perso registrano l'esito via cambio stage | ✅ |
+| Vista Lista (LeadTable inline-edit) resta disponibile e funzionante | ✅ |
+| Toggle Lista/Kanban preserva la query di ricerca al cambio vista | ✅ |
+| Search filtra entrambe le viste (Lista e Kanban) con lo stesso `filtered` array | ✅ |
+
+## Deferred Items
+
+| Item | Motivazione | Priorità |
+|------|-------------|----------|
+| Overflow clipping del dropdown `LeadTable` in vista Lista (da `overflow-x-auto` del wrapper Kanban) | Non bloccante — già parzialmente mitigato nel commit 34be934; comportamento accettabile | Bassa — da affrontare in phase futura se segnalato |
+
+## Self-Check
+
+**PASSED** — tutti i must_have verificati, build verde, checkpoint umano approvato ("approvato").
+
+Durata esecuzione: ~1 sessione sincrona (2026-06-19).