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>
This commit is contained in:
2026-08-08 22:38:36 +02:00
parent 187550fedf
commit f7eb7eec23
86 changed files with 1659 additions and 2859 deletions
+64
View File
@@ -0,0 +1,64 @@
# Archivio milestone v2.1 — Offer Studio + CRM
**Fasi previste:** 1117 · **Consegnate:** 11, 12, 14 · **Aperta:** 2026-06-13 · **Chiusa per reset:** 2026-06-19
> **Ricostruito a posteriori il 2026-08-08.** v2.1 è l'unica milestone rimasta senza
> archivio: è stata interrotta da un reset di scope e nessuno l'ha chiusa
> formalmente, così le sue fasi sono rimaste in `.planning/phases/` per due mesi.
> Questo file è ricostruito da `MILESTONES.md`, dalla tabella Progress di
> `ROADMAP.md` e dalle cartelle di fase archiviate in [v2.1-phases/](v2.1-phases/).
> Non esiste un `v2.1-REQUIREMENTS.md`: i 23 requisiti originali sono stati
> sovrascritti quando `REQUIREMENTS.md` è stato riscritto per v2.3.
## Obiettivo originale
Offer Studio (fasi 1115) prima di Proposal AI (fasi 1617): prima una UX dati
pulita e veloce, poi il builder AI costruito sopra.
## Esito per fase
| Fase | Titolo | Plans | Esito |
|---|---|---|---|
| 11 | Catalog Database-View UX + consolidamento legacy | 4/4 | ✅ 2026-06-13 |
| 12 | Offer Editor Tier A/B/C | 5/5 | ✅ 2026-06-18 |
| 13 | Workspace — Servizi Attivi | — | ❄️ Congelata → ripresa in **v2.4** |
| 14 | CRM Attio-style & Fix | 3/3 | ✅ 2026-06-14 |
| 15 | Dashboard Revenue Stats | — | ❌ Abbandonata (bloccata su un mockup mai fornito) |
| 1617 | Proposal AI (impianto originale) | — | ♻️ Ri-scopate in v2.2 (fasi 2122) |
Documentazione di dettaglio (PLAN, SUMMARY, RESEARCH, VERIFICATION) in
[v2.1-phases/](v2.1-phases/).
## Cosa è stato consegnato
- **Phase 11 — Catalog Database-View UX** (OFFER-07..10, OFFER-13): il catalogo
`services` come tabella a edit inline, tag multi-select, quick-add, ricerca
istantanea; consolidamento delle tabelle legacy.
- **Phase 12 — Offer Editor Tier A/B/C** (OFFER-11, OFFER-15..18): editor offerte
con matrice checkbox servizi × tier, totale live, prezzo pubblico manuale, tag su
4 dimensioni, promessa di trasformazione. 55 servizi reali caricati.
- **Phase 14 — CRM Attio-style** (CRM-08..12): `/admin/leads` ridisegnata con edit
inline e tag multi-select; FollowUpWidget in italiano; LeadForm tipizzato;
SendQuoteModal ripulita dai rami irraggiungibili.
## Il reset del 2026-06-19
A metà milestone il piano è stato riscritto: la milestone **v2.2 "Sales Loop"**
sostituisce le fasi residue. Decisioni bloccate in quel momento:
1. L'URL del preventivo è `/preventivo/[slug]`, pubblico.
2. Si tagliano Forecast, quote builder manuale e Phase 15; `/admin/analytics` viene
fusa nella Dashboard.
3. Il portale post-vendita resta core e non si tocca (Phase 13 congelata).
4. L'agente AI è "io scelgo l'offerta, l'AI personalizza" leggendo i transcript;
provider Claude.
Phase 13 è poi tornata in vita come **milestone v2.4**, consegnata il 2026-08-01.
## Debito lasciato aperto
- Tabelle legacy `service_catalog` / `offer_services` / `offer_micro_services`
rimaste come deadweight.
- `createService` / `serviceSchema` dead code in `src/app/admin/catalog/actions.ts`
(Phase 11 Plan 04, annotato in `deferred-items.md`).
- `offer_micros` senza `created_at` — nessun "tier più vecchio" affidabile.