Files
Simone Cavalli 80d93993a9 docs(phase-02): evolve PROJECT.md after phase completion
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-15 21:55:53 +02:00

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):

  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)