clienthub/.planning/phases/18-cleanup-consolidamento/18-03-PLAN.md

---

phase: 18-cleanup-consolidamento plan: 03 type: execute wave: 2 depends_on:

• "18-01"
• "18-02" autonomous: false files_modified:
• .planning/ROADMAP.md
• .planning/REQUIREMENTS.md requirements:
• CLEAN-04

must_haves: truths: - "Le fasi 13/15/16/17 sono marcate esplicitamente come cancellate/congelate/ri-scopate nel ROADMAP.md" - "REQUIREMENTS.md riflette lo stato aggiornato dei requirement corrispondenti" - "CLEAN-04 è marcato Done in REQUIREMENTS.md" - "La build del progetto passa dopo le rimozioni dei piani precedenti" artifacts: - path: ".planning/ROADMAP.md" provides: "Fasi 13/15/16/17 con status esplicito cancellate/congelate" contains: "CONGELATA|ABBANDONATA|RI-SCOPATA" - path: ".planning/REQUIREMENTS.md" provides: "CLEAN-04 marcato Complete" key_links: - from: "ROADMAP.md fasi 13/15/16/17" to: "STATUS field" via: "checklist e label espliciti" pattern: "Congelata|Abbandonata|Ri-scopata"

Verificare formalmente il completamento di CLEAN-04 e validare la build post-cleanup.

Purpose: CLEAN-04 — le fasi v2.1 residue sono già state archiviate/marcate nel reset 2026-06-19. Questo piano le verifica, le sigla formalmente nel planning e valida che i piani 01/02 non abbiano introdotto errori di build. Output: CLEAN-04 marcato Done, build TypeScript verificata, check umano che la dashboard funziona.

<execution_context> @$HOME/.claude/get-shit-done/workflows/execute-plan.md @$HOME/.claude/get-shit-done/templates/summary.md </execution_context>

@.planning/ROADMAP.md @.planning/REQUIREMENTS.md @.planning/STATE.md Task 1: Verifica CLEAN-04 e aggiorna planning docs

<read_first> - .planning/ROADMAP.md — sezione fasi 13/15/16/17, verifica che abbiano label/status esplicito - .planning/REQUIREMENTS.md — sezione CLEAN-04, verifica stato attuale </read_first>

.planning/ROADMAP.md, .planning/REQUIREMENTS.md STEP 1 — Verifica ROADMAP.md: Leggi le voci delle fasi 13, 15, 16, 17 nel ROADMAP.md. Devono avere tutte uno status esplicito. Controlla che la checklist mostri: - Phase 13: [~] con label "❌ CONGELATA (reset 2026-06-19)" - Phase 15: [~] con label "❌ ABBANDONATA (reset 2026-06-19)" - Phase 16: [~] con label "❌ RI-SCOPATA in v2.2" - Phase 17: [~] con label "❌ RI-SCOPATA in v2.2" Se uno di questi status manca o è incompleto, aggiungilo/completalo. Aggiungi anche una nota nella tabella Progress in fondo con la data di chiusura 2026-06-19 dove mancante.

STEP 2 — Aggiorna REQUIREMENTS.md:
Nella tabella "Cleanup & Consolidamento (Phase 18 / R1)":
- CLEAN-01: cambia Status da "Pending" a "Complete"
- CLEAN-02: cambia Status da "Pending" a "Complete"
- CLEAN-03: cambia Status da "Pending" a "Complete"
- CLEAN-04: cambia Status da "In corso (questo reset)" a "Complete"

Nella tabella Traceability in fondo:
- CLEAN-01 | Phase 18 (R1) | Complete
- CLEAN-02 | Phase 18 (R1) | Complete
- CLEAN-03 | Phase 18 (R1) | Complete
- CLEAN-04 | Phase 18 (R1) | Complete

STEP 3 — Build verification:
Esegui: cd /Users/simonecavalli/Vault/IAMCAVALLI && npm run build
Se la build fallisce:
- Leggi l'output dell'errore
- Identifica il file con import rotto
- Risolvi (probabilmente un import di componente eliminato o una funzione non trovata)
- Ri-esegui npm run build fino a successo
Registra nel SUMMARY se ci sono stati fix necessari.

grep "CLEAN-04" /Users/simonecavalli/Vault/IAMCAVALLI/.planning/REQUIREMENTS.md Risultato atteso: riga contenente "CLEAN-04" e "Complete".

Verifica fasi archiviate:
grep -E "Phase 13|Phase 15|Phase 16|Phase 17" /Users/simonecavalli/Vault/IAMCAVALLI/.planning/ROADMAP.md | grep -E "CONGELATA|ABBANDONATA|RI-SCOPATA" | wc -l
Risultato atteso: 4 (tutte e quattro le fasi con label esplicito).

<acceptance_criteria> - REQUIREMENTS.md: CLEAN-04 è "Complete" - REQUIREMENTS.md: CLEAN-01, CLEAN-02, CLEAN-03 sono "Complete" - ROADMAP.md: fasi 13/15/16/17 hanno label di stato esplicito (CONGELATA/ABBANDONATA/RI-SCOPATA) - npm run build completa senza errori </acceptance_criteria>

Tutti i requisiti CLEAN-01..04 sono marcati Complete nei planning docs. La build TypeScript è pulita. Phase 18 è formalmente chiusa. Checkpoint: Verifica visuale Dashboard e assenza rotte rimosse Piano 01 ha rimosso /admin/forecast e /admin/quotes/new. Piano 02 ha fuso le statistiche di /admin/analytics nella Dashboard /admin e rimosso la rotta /admin/analytics. Il selettore anno nella dashboard naviga a /admin?year=X. 1. Avvia il dev server: `npm run dev` (o `npx next dev`) 2. Vai su http://localhost:3000/admin — verifica: - Sidebar: NON compare la voce "Forecast" - Dashboard: in fondo alla pagina compare la sezione "Statistiche" con selettore anno, MetricCard economiche (Contrattualizzato / Incassato / Da incassare / Clienti acquisiti), grafico mensile a barre, sezione ore per cliente - KPI card esistenti (Clienti attivi, Revenue totale, Progetti in corso, Pagamenti in sospeso) sono ancora presenti in cima - FollowUpWidget e feed attività sono ancora presenti 3. Vai su http://localhost:3000/admin/forecast → deve restituire 404 4. Vai su http://localhost:3000/admin/analytics → deve restituire 404 5. Vai su http://localhost:3000/admin/quotes/new → deve restituire 404 6. Clicca sul selettore anno nella sezione Statistiche → cambia anno e verifica che l'URL diventa /admin?year=XXXX (non /admin/analytics) 7. Nel dettaglio di un lead, apri il modal "Invia preventivo" → verifica che NON compare più il bottone per creare un nuovo preventivo manuale Scrivi "ok" se tutto funziona correttamente. Se trovi problemi, descrivi cosa non funziona e l'esecuzione correggerà prima di chiudere la fase.

<threat_model>

Trust Boundaries

Boundary	Description
planning docs → stato del progetto	Aggiornamento documenti di tracking — nessuna superficie di attacco

STRIDE Threat Register

Threat ID	Category	Component	Disposition	Mitigation Plan
T-18-05	Repudiation	ROADMAP.md / REQUIREMENTS.md	accept	I planning docs sono in git — ogni modifica è tracciata e reversibile
</threat_model>

Al termine del piano: 1. REQUIREMENTS.md: CLEAN-01, CLEAN-02, CLEAN-03, CLEAN-04 → tutti "Complete" 2. ROADMAP.md: fasi 13/15/16/17 con status esplicito 3. npm run build → 0 errori 4. Checkpoint umano superato (Dashboard mostra statistiche, rotte rimosse → 404)

<success_criteria>

• CLEAN-04: fasi v2.1 residue formalmente chiuse nei planning docs
• Planning docs aggiornati con stati finali Phase 18
• Build pulita confermata
• Verifica visuale umana completata </success_criteria>

After completion, create `.planning/phases/18-cleanup-consolidamento/18-03-SUMMARY.md`