From b79fb4347a639abae4bd9a4c500fd1efc42242f5 Mon Sep 17 00:00:00 2001 From: Simone Cavalli Date: Sat, 9 May 2026 21:08:07 +0200 Subject: [PATCH] docs: initialize project --- .planning/PROJECT.md | 95 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 .planning/PROJECT.md diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md new file mode 100644 index 0000000..25e8000 --- /dev/null +++ b/.planning/PROJECT.md @@ -0,0 +1,95 @@ +# ClientHub — Gestione Clienti & Dashboard + +## What This Is + +Strumento personale in due parti per gestire i clienti di consulenza: una dashboard web (Vercel) dove ogni cliente accede con un link segreto per vedere il suo progetto, e un flusso Claude per aggiungere clienti step-by-step e generare piani + preventivi. Fatto per un professionista del personal branding con clienti attivi da gestire subito. + +## Core Value + +Il cliente apre il link e vede esattamente a che punto è il suo progetto, cosa deve ancora succedere e cosa ha già approvato — senza dover scrivere email per chiedere aggiornamenti. + +## Requirements + +### Validated + +(None yet — ship to validate) + +### Active + +**Dashboard cliente (priorità v1):** +- [ ] Ogni cliente ha un URL segreto univoco (nessun login richiesto) +- [ ] La dashboard mostra nome cliente, nome brand, brief del progetto e stato attuale +- [ ] Il piano è strutturato per fasi con milestone e task all'interno di ogni fase +- [ ] I task hanno stato visibile (da fare / in corso / fatto) +- [ ] Il cliente può approvare i deliverable dalla sua area +- [ ] Il cliente può lasciare commenti su task e deliverable +- [ ] Il cliente vede solo il totale del preventivo accettato (non i prezzi dei singoli servizi) +- [ ] Il cliente vede lo stato dei pagamenti: acconto 50% (da saldare / inviata / saldato) e saldo 50% (da saldare / inviata / saldato) +- [ ] Link a documenti e file (Google Drive, PDF, deliverable) +- [ ] Storico note e decisioni prese nel tempo + +**Area amministratore (tu):** +- [ ] Vista di tutti i clienti con stato sintetico +- [ ] Gestione completa di ogni cliente: fasi, task, documenti, pagamenti +- [ ] Preventivo completo con dettaglio servizi (non visibile al cliente) + +**Catalogo servizi:** +- [ ] File/database dei servizi con prezzi e cosa è incluso +- [ ] Usato come base per la generazione assistita dei preventivi + +**Flusso Claude (v2):** +- [ ] Onboarding guidato step-by-step via chat per aggiungere un nuovo cliente +- [ ] Generazione del piano a fasi basato sul brief +- [ ] Generazione preventivo assistita (Claude suggerisce, tu approvi prima di finalizzare) + +### Out of Scope + +- Fatturazione e invio fatture — la gestione contabile resta fuori, solo stato pagamenti +- App mobile nativa — solo web responsive +- Multi-utente con team — solo tu come admin per ora +- Prezzi singoli visibili al cliente — vede solo il totale accettato + +## Context + +- Il professionista lavora nel personal branding e content creation (cfr. SparklingOrbit) +- Ha clienti attivi ora — la dashboard è la priorità immediata prima del flusso Claude +- I clienti accedono via link segreto fisso (no account, no password) per semplicità massima +- Il preventivo ha sempre struttura acconto 50% + saldo 50% +- Il catalogo servizi va costruito da zero durante il progetto +- Piattaforma di deploy: Vercel + +## Constraints + +- **Urgenza**: Clienti attivi da gestire subito — la dashboard cliente deve arrivare per prima +- **Semplicità accesso cliente**: Link segreto senza login — nessuna friction per il cliente +- **Privacy preventivo**: Il cliente vede solo il totale, mai il dettaglio dei servizi +- **Deploy**: Vercel — vincolo tecnico già deciso + +## Key Decisions + +| Decision | Rationale | Outcome | +|----------|-----------|---------| +| Link segreto senza login per i clienti | Massima semplicità — nessun account da creare, zero friction | — Pending | +| Dashboard prima del flusso Claude | Clienti attivi ora, la visibilità al cliente è il valore immediato | — Pending | +| Preventivo: cliente vede solo il totale | Il dettaglio dei prezzi è informazione commerciale riservata | — Pending | +| Catalogo servizi da costruire da zero | Nessun listino esistente — parte del progetto stesso | — Pending | + +## Evolution + +This document evolves at phase transitions and milestone boundaries. + +**After each phase transition** (via `/gsd-transition`): +1. Requirements invalidated? → Move to Out of Scope with reason +2. Requirements validated? → Move to Validated with phase reference +3. New requirements emerged? → Add to Active +4. Decisions to log? → Add to Key Decisions +5. "What This Is" still accurate? → Update if drifted + +**After each milestone** (via `/gsd-complete-milestone`): +1. Full review of all sections +2. Core Value check — still the right priority? +3. Audit Out of Scope — reasons still valid? +4. Update Context with current state + +--- +*Last updated: 2026-05-09 after initialization*