Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
4.5 KiB
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 su sottodominio
welcomeclient.iamcavalli.net - Dominio: sottodominio di iamcavalli.net — richiede configurazione DNS su dominio esistente
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):
- Requirements invalidated? → Move to Out of Scope with reason
- Requirements validated? → Move to Validated with phase reference
- New requirements emerged? → Add to Active
- Decisions to log? → Add to Key Decisions
- "What This Is" still accurate? → Update if drifted
After each milestone (via /gsd-complete-milestone):
- Full review of all sections
- Core Value check — still the right priority?
- Audit Out of Scope — reasons still valid?
- Update Context with current state
Last updated: 2026-05-15 — Phase 2 complete (admin area + client interactions)