Simone Cavalli
97 lines
4.5 KiB
Markdown
97 lines
4.5 KiB
Markdown
# 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`):
|
|
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-15 — Phase 2 complete (admin area + client interactions)*
|