simone/clienthub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
571f58bff8f7bf45ecb9fa4438fb76aca90664b9
clienthub/.planning/ROADMAP.md
T
simone 8000d562dc docs: apre v2.5 "Audit" e rimette in pari roadmap e requisiti 
La roadmap era ferma al 2026-08-08 e diceva ancora "nessuna fase aperta" mentre
v2.5 era gia' partita e Phase 27 era a meta'; REQUIREMENTS.md era ancora quello
di v2.4. STATE.md invece era corretto — segno che aggiornare solo quello non
basta. Da qui la divisione dei ruoli, ora esplicita in testa a ogni file:

- STATE.md        orientamento breve (99 righe): dove sta cosa, come funziona il
                  motore, i blocchi vivi. Niente narrativa.
- ROADMAP.md      tutte le fasi 1->30, con lo stato di ciascuna
- REQUIREMENTS.md i 25 requisiti di v2.5 (AUD-01..25) e il backlog
- STATUS.md       l'unica narrativa lunga: lezioni e note tecniche

v2.4 chiusa e archiviata in milestones/v2.4-REQUIREMENTS.md.

Decisione nuova: il documento di restituzione usa il design system dell'area
admin ("Quiet Luxury"), non una tipografia sua — token semantici, Plus Jakarta
Sans, Geist Mono per metriche e date, StatusBadge per gli impatti. Sostituisce
la deroga tipografica prevista dal piano. I font sono gia' self-hostati da
next/font/google, quindi la CSP font-src 'self' e' soddisfatta senza lavoro, e
il documento non aggiunge debito a DEBT-01 perche' nasce gia' a token.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-18 17:48:46 +02:00

7.1 KiB
Raw Blame History

Roadmap: ClientHub

Milestones

  • ✅ v1.0 Client Portal & Offer System — Phases 1–6 (shipped 2026-06-10) — archive
  • ✅ v2.0 Business Operations Suite — Phases 7–10 (shipped 2026-06-13) — archive
  • ✅ v2.1 Offer Studio + CRM — Phases 11, 12, 14 (chiusa per reset 2026-06-19) — archive
  • ✅ v2.2 Sales Loop — Phases 18–22 (shipped 2026-06-20) — archive
  • ✅ v2.3 Email & Accesso — Phases 23–25 (shipped 2026-07-29) — archive
  • ✅ v2.4 Post-vendita — Phases 13 + 26 (entrambe in produzione, 2026-08-01 / 2026-08-08)
  • 🔨 v2.5 Audit — Phases 27–30 — documento di restituzione del servizio di analisi sito

Phases

✅ v1.0 + v2.0 + v2.1 (Phases 1–17) — SHIPPED / CHIUSE

Vedi archivi:

  • milestones/v1.0-ROADMAP.md — Phases 1–6
  • milestones/v2.0-ROADMAP.md — Phases 7–10
  • milestones/v2.1-ROADMAP.md — Phases 11, 12, 14 shipped; 15/16/17 abbandonate o ri-scopate; Phase 13 ripresa in v2.4
✅ v2.2 Sales Loop (Phases 18–22) — SHIPPED 2026-06-20
  • Phase 18: Cleanup & Consolidamento (3/3 plans) — completed 2026-06-19
  • Phase 19: Pipeline CRM Kanban (1/1 plan) — completed 2026-06-19
  • Phase 20: Knowledge Base Cliente (3/3 plans) — completed 2026-06-20
  • Phase 21: Agente AI — generazione preventivo (1/1 plan) — completed 2026-06-20
  • Phase 22: Pagina pubblica preventivo (1/1 plan, PUB-03 deferred) — completed 2026-06-20

Archivio completo: milestones/v2.2-ROADMAP.md

✅ v2.3 Email & Accesso (Phases 23–25) — SHIPPED 2026-07-29
  • Phase 23: Resend Setup — SDK + src/lib/mailer.ts + template OTP (SEND-01/02 rinviati al backlog il 2026-07-28)
  • Phase 24: Schema + Whitelist Admin — client_emails, otp_codes, UI whitelist + revoca sessioni (migr. 0015)
  • Phase 25: OTP Gate + Sessione — gate completo, sessione 90gg, rate limiting, no enumeration

Shipped col commit 27da969, verificata end-to-end su hub.iamcavalli.net. Archivio completo: milestones/v2.3-ROADMAP.md

✅ v2.4 — Post-vendita (Phases 13 + 26)

  • Phase 13: Ciclo di vita dei servizi ricorrenti — project_offers.status + end_date (migr. 0016), forecast che si ferma davvero, comandi Sospendi/Riattiva/Cessa nella tab Offerte, stato dell'abbonamento visibile al cliente. ✅ prod 2026-08-01 (5177a37) — 13-SUMMARY.md
  • Phase 26: Anteprima admin del portale + toggle password — ?preview=1 con sessione Auth.js valida apre il portale di un cliente in sola lettura, senza gate OTP. ✅ prod 2026-08-08 (09a5b1f, 187550f) — 26-SUMMARY.md

🔨 v2.5 — Audit (Phases 27–30) · in corso

Il servizio di analisi sito (tre livelli: Radiografia / Prima-Dopo / Rotta) diventa un documento privato su /audit/[slug], generato da un motore multi-agente e rifinito a mano prima della consegna. Piano approvato il 2026-08-16, motore ripianificato il 2026-08-18.

  • Phase 27: Motore di analisi — in corso, ~50%
    • Migration 0017_audits.sql (7 tabelle additive) — applicata in prod 2026-08-18
    • checklist_items seminata, 264 voci — in prod
    • src/lib/audit/sources/ — 5 moduli, provati sul campo su giojello.com (73 s, tutte le fonti hanno risposto). Scritti, non pushati.
    • src/lib/audit/schema.ts + agents/ (checklist, visual, history, technical, synthesis) con validazione Zod dura
    • src/lib/audit/pipeline.ts con heartbeat su audit_runs
  • Phase 28: Storage immagini — volume persistente Coolify, ImageUploadField, /api/uploads/[...path] con guardia sul path traversal. ⚠️ Checkpoint bloccante: il volume va creato in Coolify PRIMA del deploy, altrimenti gli upload si perdono a ogni redeploy.
  • Phase 29: Editor admin — lista audit, editor a payload intero (modello: admin/offers/actions.ts), riordino finding e ottimizzazioni con @dnd-kit/sortable, registro visite
  • Phase 30: Pagina pubblica + PDF + tracciamento — /audit/[slug], blocchi condizionali per livello, print CSS per il PDF, <AuditVisitTracker> che non conta le aperture da admin loggato

I nomi di 28–30 sono derivati dalle sezioni §7/§8/§9 del piano approvato, non ancora passati da /gsd-plan-phase. La numerazione riprende da 27 perché 15–17 sono state abbandonate o ri-scopate.

Ingresso Whop: predisposto nello schema (origin, external_ref), non costruito — è fase 2, fuori da v2.5.

Progress

Tutte le fasi del progetto, dalla 1 alla 30. La numerazione è progressiva e mai riusata: i buchi (15–17) sono fasi abbandonate o ri-scopate, non fasi mancanti.

Phase Milestone Plans Status Completed
1. Foundation & Client Dashboard v1.0 — ✅ Done 2026-06
2. Admin Area & Interactive Features v1.0 — ✅ Done 2026-06
3. Service Catalog & Quote Builder v1.0 — ✅ Done 2026-06
4. Progetti — Multi-Project per Cliente v1.0 — ✅ Done 2026-06
5. Offer System v1.0 — ✅ Done 2026-06
6. UX Overhaul — Sidebar + Dashboard v1.0 24/24 tot. ✅ Done 2026-06-10
7. Claude AI Onboarding (v2) v2.0 — ✅ Done 2026-06
8–10. Unified Catalog → CRM Pipeline v2.0 12/12 tot. ✅ Done 2026-06-13
11. Catalog Database-View UX v2.1 4/4 ✅ Done 2026-06-13
12. Offer Editor Tier A/B/C v2.1 5/5 ✅ Done 2026-06-18
14. CRM Attio-style & Fix v2.1 3/3 ✅ Done 2026-06-14
15. Dashboard Revenue Stats v2.1 — ❌ Abbandonata —
16–17. Proposal AI originale v2.1 — ♻️ Ri-scopata in v2.2 —
18. Cleanup & Consolidamento v2.2 3/3 ✅ Done 2026-06-19
19. Pipeline CRM Kanban v2.2 1/1 ✅ Done 2026-06-19
20. Knowledge Base Cliente v2.2 3/3 ✅ Done 2026-06-20
21. Agente AI Preventivo v2.2 1/1 ✅ Done 2026-06-20
22. Pagina Pubblica + Deck v2.2 1/1 ✅ Done 2026-06-20
23. Resend Setup v2.3 1/1 ✅ Done 2026-07-28
24. Schema + Whitelist Admin v2.3 1/1 ✅ Done 2026-07-28
25. OTP Gate + Sessione v2.3 1/1 ✅ Done 2026-07-29
13. Ciclo di vita servizi ricorrenti v2.4 1/1 ✅ Done 2026-08-01
26. Anteprima admin + login v2.4 1/1 ✅ Done 2026-08-08
27. Motore di analisi v2.5 0/1 🔨 In corso (~50%) —
28. Storage immagini v2.5 0/1 ⏳ Da pianificare —
29. Editor admin v2.5 0/1 ⏳ Da pianificare —
30. Pagina pubblica + PDF v2.5 0/1 ⏳ Da pianificare —

Roadmap aggiornata: 2026-08-18 — v2.4 chiusa, v2.5 "Audit" aperta (era assente: la roadmap è rimasta ferma al 2026-08-08 mentre v2.5 partiva e Phase 27 arrivava a metà).

Reference in New Issue View Git Blame Copy Permalink