# 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*