clienthub/.planning/STATE.md

gsd_state_version, milestone, milestone_name, status, stopped_at, last_updated, last_activity, progress

gsd_state_version	milestone	milestone_name	status	stopped_at	last_updated	last_activity	progress
1.0	v1.0	milestone	completed	Phase 5 fully executed — Offer System live on hub.iamcavalli.net	2026-05-30	2026-05-30 -- Phase 5 confirmed complete (05-01 through 05-04)	total_phases completed_phases total_plans completed_plans percent 5 5 21 21 100

Project State

Project Reference

See: .planning/PROJECT.md (updated 2026-05-09)

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.

Current Position

Phase: 5 — COMPLETE Plan: All plans done (05-01 through 05-04) Status: Production ready — deploy pending

What Was Built (Phase 5)

• 05-01: Schema migration — 5 nuove tabelle offer in DB + tipi TypeScript
• 05-02: /admin/offers CRUD — macro, micro, servizi + assegnazione checkbox
• 05-03: OffersTab nel workspace progetto + getClientActiveOffers() + sezione Offerte Attive nel dettaglio cliente
• 05-04: OffersSection nella dashboard cliente (solo public_name) + /admin/forecast 12 mesi

What Was Built (Phase 4)

• 04-00: Infra — route /c/ → /client/, Dockerfile, deploy Gitea → Coolify
• 04-01: DB schema migration — projects, settings, FK pivot
• 04-02: Admin projects list + client detail project cards
• 04-03: Project workspace + timer analytics + settings page
• 04-04: Slug resolution + multi-project client dashboard + slug edit
• 04-05/06: Post-deploy bug fixes
• 04-07: Debug code removed, public page restored
• security: Full hardening — auth guards, rate limiting, security headers
• payments: Init payments + split payment in project workspace

Production State

• App: hub.iamcavalli.net (Coolify, Hetzner)
• DB: Postgres self-hosted on Coolify
• Auth: Auth.js (admin) + token middleware (clients)
• Routes: /admin/* (admin), /client/[token]/* (clients)

Decisions (All Phases)

• clients.token è campo separato (non la PK) — rotazionabile via single UPDATE
• clients.accepted_total denormalizzato — client API non tocca mai quote_items
• deliverables.approved_at immutabile — audit trail dal giorno uno
• Edge middleware (proxy.ts) usa fetch() a route interna — postgres-js non può girare nell'Edge runtime
• Tailwind v4 auto-detection allargata — aggiunto @source not per escludere .01_projects/ e .claude/
• Authelia va solo davanti ad /admin — /client/[token] deve bypassare per accesso via link token

Deferred Items

Category	Item	Status
v2	Claude AI onboarding (CLAUDE-01, CLAUDE-02, CLAUDE-03)	Backlog
Infrastructure	Authelia SSO davanti ad /admin	After Phase 4 (now ready)
Infrastructure	Higgsfield clone deploy (nuovo progetto Coolify)	Pending
SEO	WordPress auto-publish articoli	Mentioned, not planned

Session Continuity

Last session: 2026-05-27 All Phase 4 plans complete. Next: Authelia infra or new feature scope.