Files

T

simone f7eb7eec23 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>

2026-08-08 22:38:36 +02:00

3.1 KiB

Raw Blame History

Archivio milestone v2.1 — Offer Studio + CRM

Fasi previste: 11–17 · 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/. 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 11–15) prima di Proposal AI (fasi 16–17): 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)
16–17	Proposal AI (impianto originale)	—	♻️ Ri-scopate in v2.2 (fasi 21–22)

Documentazione di dettaglio (PLAN, SUMMARY, RESEARCH, VERIFICATION) in 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:

L'URL del preventivo è /preventivo/[slug], pubblico.
Si tagliano Forecast, quote builder manuale e Phase 15; /admin/analytics viene fusa nella Dashboard.
Il portale post-vendita resta core e non si tocca (Phase 13 congelata).
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.

3.1 KiB Raw Blame History Unescape Escape