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	v2.5	Audit	executing	v2.5 in PAUSA. Modifiche hub: A, B, C1 e le due rifiniture del 2026-08-20 in prod; C2 (TidyCal) bloccato sulle credenziali API.	2026-08-20T22:45:00.000Z	2026-08-20 -- tab pagamenti (ordine, rinomina, override) e riordino task (1fa8e1a)	total_phases completed_phases total_plans completed_plans percent 4 0 4 0 25

Project State

Digest breve, per orientarsi. Narrativa e lezioni → STATUS.md (root); requisiti → REQUIREMENTS.md; tutte le fasi → ROADMAP.md. Questo file resta sotto le 100 righe: lo impone il template GSD.

Project Reference

See: .planning/PROJECT.md · Core value: il cliente apre il link e vede a che punto è il suo progetto, senza scrivere email. · Current focus: modifiche hub (v2.5 in pausa).

Current Position

v2.5 è in pausa per scelta (2026-08-19): prima le modifiche all'hub, poi il motore. Phase 27 resta a metà — schema e fonti in prod, resto da scrivere.

Blocco (modifiche hub)	Stato
A — Progetti (via commenti/timer, riepilogo, timer per task)	✅ in produzione 2026-08-19
B — Dashboard (inbox, linee di prodotto, timeline consegne)	✅ in produzione 2026-08-19
C1 — POST /api/webhooks/lead	✅ in produzione, provato contro il DB vero
C2 — TidyCal	⛔ [BLOCCANTE] vedi sotto
C3 — Alleggerire l'hub	⏸️ senza perimetro
Rifiniture — rinomina tassonomie, stato task "In revisione"	✅ in prod 2026-08-20
Tab pagamenti (ordine stabile, rinomina, override) + riordino task	✅ in prod 2026-08-20, migration 0019
D — Whop → audit	⏸️ dipende dal motore v2.5

Progress: [███░░░░░░░] 25% (v2.5)

Dove sta cosa

Fuori dal repo, e senza questi niente è ricostruibile: i piani in ~/.claude/plans/ — …woolly-puddle.md (documento audit), …radiant-valley.md (motore), sei-arrivato-qua-search-recursive-kettle.md (modifiche hub).

Cosa (audit)	Dove	Stato
Schema, 7 tabelle + rubrica 264 voci	0017_audits.sql, checklist_items	in produzione
Fonti del motore (5 moduli)	src/lib/audit/sources/	in prod ma inerte: nessuna route lo chiama
Agent, sintetizzatore, pipeline, editor, pagina	src/lib/audit/, src/app/{admin/audit,audit}	da scrivere
L'unico audit prodotto finora	spike-audit-giojello.com.json (gitignorato)	spike 2026-08-16, zero rilevazioni

Come funziona il motore

Raccolta in parallelo (nessun LLM, nessun browser headless) → quattro sub-agent → sintetizzatore che incrocia le osservazioni in massimo 10 finding. Vincolo che regge tutto: un numero entra solo se misurato, rintracciabile in audit_runs.raw. Passo per passo in STATUS.md e in …radiant-valley.md.

Performance Metrics

Velocity: 21 plans (v2.1–v2.4). Phase 27: spike ~1h, schema ~1h, fonti ~2h. Modifiche hub: A+B+C1 in una sessione.

Accumulated Context

Decisions

Log completo in PROJECT.md. Vive per il lavoro corrente:

• [2026-08-20] Gli importi scritti a mano non si ricalcolano — amount_locked esclude la riga da rescalePayments, e lo scarto fra somma rate e totale si dichiara invece di aggiustarlo. Il backfill dell'ordine rate va per percent DESC, non per ctid: 3 progetti su 5 erano già scombinati e l'ordine fisico avrebbe fissato l'errore.
• [2026-08-20] Rinominare una fase rinomina anche le fasi dei progetti — non c'è FK fra tassonomia e phases: importOfferIntoProject riconosce una fase solo dal titolo (offer_phase_id non viene mai popolata). Senza propagazione, il re-import di un'offerta crea una fase duplicata accanto a quella vecchia. È l'unico rename che scrive fuori dal catalogo, quindi l'unico con conferma.
• [2026-08-19] Prima l'hub, poi il motore — le modifiche all'hub sono indipendenti e a basso rischio, il motore no. Il Whop → audit resta ultimo perché dipende dal motore.
• [2026-08-19] L'incassato non attribuibile si mostra, non si spalma — i pagamenti stanno sul progetto, non sull'offerta. Un progetto senza offerta finisce in una riga "Senza offerta" separata: spalmarlo darebbe un totale che quadra e righe che mentono.
• [2026-08-19] Il tempo lavorato sopravvive alla cancellazione del task — ON DELETE SET NULL, mai cascade: con cascade, ripulire una fase abbasserebbe in silenzio il fatturato tracciato.
• [2026-08-18] Audit: design system dell'area admin; nessun renderer headless (il VPS non regge Chromium); laboratorio ≠ campo, quindi nomi distinti per Lighthouse e CrUX; la checklist alimenta il motore, non il documento. Per esteso in STATUS.md.

Blockers/Concerns

• [BLOCCANTE] TidyCal non ha webhook (verificato 2026-08-19 sulla loro FAQ; la via suggerita è Zapier/Make). La REST API c'è, con Personal Access Token su tutti i piani, ma path, filtri e paginazione stanno dietro il login. Sblocca: l'utente apre tidycal.com/integrations → API Keys e passa token o documentazione. Non dedurre la forma dell'API dai docs.
• [BLOCCANTE] LEAD_WEBHOOK_SECRET non è su Coolify: finché manca, /api/webhooks/lead risponde 403 a tutti (fallimento chiuso voluto). Sblocca: l'utente la imposta.
• Il 100% dell'incassato è "Senza offerta" — Caruso Speaker e Protocollo Estetico: 5.300 € senza offerte assegnate. Si sistema assegnandole dai rispettivi progetti. Il payload Elementor, intanto, non è ancora verificato sul campo: gestito in modo difensivo, serve un invio vero.
• Il copy fisso del template v1 non ha una fonte nel repo — il prototipo Giojello non c'è: testi e gerarchia dei blocchi vanno recuperati prima di Phase 30.
• Audit, da vedere sul campo: il caso "zero dati CrUX" (test 5) e quanto del 52% non verificabile da HTML statico recuperi Lighthouse (test 3). Whitelist portale vuota per 3 clienti su 4 — si popola da /admin/clients/<id>.
• .env.local punta al DB di PRODUZIONE (non allineato a Coolify per ADMIN_PASSWORD/NEXTAUTH_SECRET), e la porta 54321 non è pubblica: per provare in locale serve il tunnel SSH.
• Ogni fase con schema: migration applicata a prod prima del push del codice.
• Debito design (DEBT-01) — ~40 file, ~450 occorrenze. Dettaglio in STATUS.md.

Deferred Items — vedi REQUIREMENTS.md § Backlog e § Rinviati da v2.5.

Session Continuity

Last session: 2026-08-19 Stopped at: modifiche hub, blocchi A + B + C1 in produzione (commit 19ed377, migration 0018 applicata prima del push). C2 fermo sulle credenziali TidyCal. Next: (1) sbloccare TidyCal con token o documentazione; (2) confermare il payload Elementor con un invio vero; (3) impostare LEAD_WEBHOOK_SECRET su Coolify — finché manca la route risponde 403 a tutti; (4) poi riprendere v2.5 da src/lib/audit/schema.ts + agents/. Resume file: None