docs: reset milestone v2.2 "Sales Loop"

Strategic reset after articulating the real sales flow (piano in .claude/plans/glittery-sprouting-pudding.md). v2.1 delivered Offer Studio (Phase 11+12) + CRM Attio (Phase 14); residual phases re-scoped: - Phase 13 (Servizi Attivi) → frozen (touches post-sale portal, kept as-is) - Phase 15 (Dashboard Revenue) → dropped (analytics merges into dashboard) - Phase 16/17 (Proposal AI) → re-scoped into v2.2 with transcripts added New milestone v2.2 = sales loop, Phase 18→22 (R1→R5): - R1 Cleanup: remove forecast + manual quote builder, merge analytics into dashboard - R2 Pipeline CRM Kanban (Pipedrive-style) - R3 Knowledge Base (dated call transcripts per lead/client) - R4 AI agent (admin picks offer, Claude personalizes proposal from transcripts) - R5 Public /preventivo/[slug] page + email New requirements: CLEAN-01..04, PIPE-01/02, KB-01/02, AI-01/02, PUB-01/02/03. Updated ROADMAP, REQUIREMENTS, STATE, PROJECT. No code changed. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-19 11:37:08 +02:00
parent 43238341c1
commit 10a390239a
4 changed files with 241 additions and 85 deletions
@@ -1,23 +1,32 @@
-# Roadmap: ClientHub v2.1 Offer Studio + Proposal AI
+# Roadmap: ClientHub — v2.1 (chiuso) → v2.2 Sales Loop

 ## Overview

 **v2.0 (Phases 1–10, Complete)**: ClientHub è una suite operativa completa — catalogo servizi unificato, offerte con fasi, preventivo pubblico (`/quote/[token]`), CRM pipeline lead con activity log. Archiviato in `.planning/milestones/v2.0-ROADMAP.md`.

-**v2.1 (Phases 11–17, Planning)**: Rifare la UX di catalogo/offerte in stile database-view (Notion-like), ristrutturare il workspace progetto (Preventivo → Servizi Attivi, rimozione Forecast), ricostruire il CRM in stile Attio/Pipedrive (inline edit, tag, fix bug residui), e chiudere il loop commerciale con un builder preventivi AI + invio email + auto-provisioning. Numerazione fasi: v2.0 ha chiuso a Phase 10; v2.1 parte da Phase 11.
+**v2.1 (Phases 11–17) — PARZIALE / CHIUSO dal reset 2026-06-19**: ha consegnato Offer Studio (Phase 11 catalogo database-view + Phase 12 offer editor tier A/B/C) e CRM Attio-style (Phase 14). Le fasi residue **13/15/16/17 sono congelate/abbandonate/ri-scopate** (vedi sotto).
+
+**v2.2 (Phases 18–22, Sales Loop) — ATTIVO**: dopo che l'utente ha articolato il flusso commerciale reale (piano `.claude/plans/glittery-sprouting-pudding.md`), il focus diventa il **loop di vendita**: cleanup dei doppioni → pipeline CRM Kanban (Pipedrive-style) → knowledge base transcript per cliente → agente AI che genera il preventivo → pagina pubblica `/preventivo/[slug]` + email. Numerazione GSD continua: v2.2 parte da Phase 18. Le fasi R1–R5 mappano su Phase 18–22.

 ## Phases

 - [x] **Phase 11: Catalog Database-View UX & Legacy Consolidation** - Catalogo `services` come tabella con inline edit, tag multi-select, quick-add, ricerca istantanea; consolidamento `service_catalog`/`offer_services` → `services`
- [x] **Phase 12: Offer Editor — Tier A/B/C, Tag & Prezzo Pubblico** - Editor offerte completo: lista filtrabile + 3 tier (A/B/C) via matrice checkbox sui servizi `services`, totale live per tier, prezzo pubblico manuale, tag multi-dimensione, promessa di trasformazione (import CSV/Notion rimandato) (completed 2026-06-15)
- [ ] **Phase 13: Workspace — Servizi Attivi** - Tab "Preventivo" rimossa (UI-only), "Offerte" → "Servizi attivi" (one-shot/ricorrenti + tracking incassi mensili), rimozione pagina Forecast
+- [x] **Phase 12: Offer Editor — Tier A/B/C, Tag & Prezzo Pubblico** - Editor offerte completo: lista filtrabile + 3 tier (A/B/C) via matrice checkbox sui servizi `services`, totale live per tier, prezzo pubblico manuale, tag multi-dimensione, promessa di trasformazione (completed 2026-06-18)
+- [~] **Phase 13: Workspace — Servizi Attivi** - ❌ CONGELATA (reset 2026-06-19): tocca il post-vendita lasciato invariato; ripescabile in futuro
 - [x] **Phase 14: CRM Attio-style & Fix** - Redesign `/admin/leads` stile Attio/Pipedrive (inline edit + tag), fix FollowUpWidget IT / LeadForm types / SendQuoteModal rami irraggiungibili (completed 2026-06-14)
- [ ] **Phase 15: Dashboard Revenue Stats** - Dashboard admin mostra statistiche revenue mensile (ex `/admin/forecast`) da `project_offers` — **BLOCCATA**, attesa mockup utente
- [ ] **Phase 16: Proposal AI — Data Foundations & Auto-Provisioning** - Campo Stripe Payment Link su offerte/preventivi + auto-provisioning (client+progetto+fasi+pagamenti) all'accettazione
- [ ] **Phase 17: Proposal AI — Builder, Pagina Pubblica & Email** - Builder AI proposta da cliente+offerta+note, redesign `/quote/[token]`, invio email Resend con link proposta
+- [~] **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 (R1): Cleanup & Consolidamento** - Rimuovi Forecast + quote builder manuale; fondi `/admin/analytics` nella dashboard; archivia fasi residue v2.1
+- [ ] **Phase 19 (R2): Pipeline CRM Kanban** - Board lead stile Pipedrive con colonne per stage + drag-drop; vinto/perso come cambio-colonna manuale
+- [ ] **Phase 20 (R3): Knowledge Base Cliente (transcript)** - Schema additivo + UI per incollare transcript datati multipli per lead/cliente
+- [ ] **Phase 21 (R4): Agente AI — generazione preventivo** - Builder: admin sceglie cliente+offerta, l'AI (Claude) legge transcript + offerta e genera bozza preventivo; admin revisiona
+- [ ] **Phase 22 (R5): Pagina pubblica `/preventivo/[slug]` + email** - Pagina pubblica HTML/CSS, accept/reject → CRM, invio link via email (Resend)

 ## Phase Details

+> **Reset 2026-06-19**: i dettagli delle fasi 13/15/16/17 sotto sono conservati per storico ma quelle fasi sono **cancellate/congelate** (vedi checklist Phases sopra e Progress sotto). Le fasi attive sono **18–22 (R1–R5)**, in fondo a questa sezione.
+
 ### Phase 11: Catalog Database-View UX & Legacy Consolidation
 **Goal**: L'utente vede ed edita il catalogo servizi come una tabella stile database (Notion-like) — inline editing, tag multi-select, quick-add, ricerca istantanea — su un'unica tabella `services` consolidata senza perdita di dati legacy
 **Mode:** migration + ui
@@ -137,14 +146,80 @@ Plans:
 **UI hint**: yes
 **Status**: Pending planning

+---
+
+## v2.2 — Sales Loop (fasi attive)
+
+### Phase 18 (R1): Cleanup & Consolidamento
+**Goal**: Sgomberare il campo dai doppioni e dal peso morto prima di costruire il loop di vendita, senza perdere dati.
+**Mode:** ui (solo rimozioni/rotte, nessun drop di tabelle)
+**Depends on**: nessuna (può partire subito)
+**Requirements**: CLEAN-01, CLEAN-02, CLEAN-03, CLEAN-04
+**Success Criteria** (what must be TRUE):
+  1. La pagina Forecast (`/admin/forecast`) e la sua voce di sidebar non esistono più
+  2. Il quote builder manuale (`/admin/quotes/new`) e il suo entry point non esistono più
+  3. Le statistiche annuali di `/admin/analytics` sono visibili nella Dashboard `/admin` come vista unica; la rotta `/admin/analytics` è eliminata (nessun doppione)
+  4. Le fasi v2.1 residue (13/15/16/17) sono marcate cancellate/congelate nel planning
+**Status**: Pending planning — `/gsd-plan-phase 18`
+
+### Phase 19 (R2): 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.
+**Mode:** ui
+**Depends on**: Phase 14 (CRM lead esistente). Riusa `@dnd-kit` (pattern KanbanBoard progetti).
+**Requirements**: PIPE-01, PIPE-02
+**Success Criteria** (what must be TRUE):
+  1. I lead sono mostrati in colonne per stage (contacted → qualified → proposal_sent → negotiating → won/lost) con drag-drop che aggiorna `leads.status`
+  2. La tabella inline-edit esistente resta disponibile come vista alternativa
+  3. Spostare un lead su "Vinto"/"Perso" è l'azione manuale che ne registra l'esito
+**Status**: Pending planning — `/gsd-plan-phase 19`
+
+### Phase 20 (R3): Knowledge Base Cliente (transcript)
+**Goal**: Memorizzare i transcript datati delle call (multipli per lead/cliente) e mostrarli nel profilo, pronti per essere dati in pasto all'AI.
+**Mode:** schema + ui
+**Depends on**: Phase 14 (lead) / clienti. Migration a prod via SSH PRIMA del codice dipendente.
+**Requirements**: KB-01, KB-02
+**Success Criteria** (what must be TRUE):
+  1. Esiste uno schema additivo `client_transcripts` (lead_id/client_id, testo, data, titolo/tipo, created_at)
+  2. L'admin incolla un transcript con data dal dettaglio lead/cliente
+  3. I transcript sono elencati in ordine cronologico nel profilo
+**Status**: Pending planning — `/gsd-plan-phase 20`
+
+### Phase 21 (R4): Agente AI — generazione preventivo
+**Goal**: L'admin seleziona cliente + offerta; l'agente AI (Claude) legge i transcript + i dati dell'offerta e genera una bozza di preventivo personalizzata, che l'admin può rivedere ed editare.
+**Mode:** ai + ui
+**Depends on**: Phase 20 (transcript) + DB Offerte (Phase 11/12, fatto)
+**Requirements**: AI-01, AI-02
+**Success Criteria** (what must be TRUE):
+  1. Dal builder l'admin sceglie cliente + offerta e lancia la generazione
+  2. L'AI produce una bozza di preventivo che riflette i transcript del cliente e i contenuti dell'offerta
+  3. L'admin rivede/edita la bozza prima di pubblicarla
+**Note**: decisioni di design AI (modello Claude, prompt, storage output) in fase di planning dedicata
+**Status**: Pending planning — `/gsd-plan-phase 21`
+
+### Phase 22 (R5): Pagina pubblica `/preventivo/[slug]` + email
+**Goal**: Pubblicare la proposta come pagina pubblica a `/preventivo/[slug]`, con accept/reject che si riflette nel CRM, e inviare il link via email.
+**Mode:** ui
+**Depends on**: Phase 21 (modello dati proposta). Evolve la meccanica di `/quote/[token]`.
+**Requirements**: PUB-01, PUB-02, PUB-03
+**Success Criteria** (what must be TRUE):
+  1. La proposta generata è visibile come pagina pubblica HTML/CSS a `/preventivo/[slug]`
+  2. Il cliente accetta/rifiuta dalla pagina; l'esito è disponibile lato admin per la conferma vinto/perso nel CRM
+  3. Il link della proposta viene inviato al lead via email (Resend)
+**Status**: Pending planning — `/gsd-plan-phase 22`
+
 ## Progress

 | Phase | Plans | Status | Completed |
 |-------|-------|--------|-----------|
 | 11. Catalog Database-View UX & Legacy Consolidation | 4/4 | ✅ Done | 2026-06-13 |
-| 12. Offer Editor — Tier A/B/C, Tag & Prezzo Pubblico | 5/5 | Complete   | 2026-06-18 |
-| 13. Workspace — Servizi Attivi | — | Pending planning | — |
-| 14. CRM Attio-style & Fix | 3/3 | Complete    | 2026-06-14 |
-| 15. Dashboard Revenue Stats | — | Blocked (mockup utente) | — |
-| 16. Proposal AI — Data Foundations & Auto-Provisioning | — | Pending planning | — |
-| 17. Proposal AI — Builder, Pagina Pubblica & Email | — | Pending planning | — |
+| 12. Offer Editor — Tier A/B/C, Tag & Prezzo Pubblico | 5/5 | ✅ Done | 2026-06-18 |
+| 13. Workspace — Servizi Attivi | — | ❌ Congelata (v2.2) | — |
+| 14. CRM Attio-style & Fix | 3/3 | ✅ Done | 2026-06-14 |
+| 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 | — |
+| 19 (R2). Pipeline CRM Kanban | — | Pending planning | — |
+| 20 (R3). Knowledge Base Cliente (transcript) | — | Pending planning | — |
+| 21 (R4). Agente AI — generazione preventivo | — | Pending planning | — |
+| 22 (R5). Pagina pubblica preventivo + email | — | Pending planning | — |