Files

T

simone 97cc6460a0 docs: registra le modifiche hub e mette v2.5 in pausa dichiarata

STATE.md diceva "Phase 27, nessun bloccante" mentre v2.5 e' ferma per scelta e
in produzione e' andato altro. Ora dice cosa e' vero: v2.5 in pausa, modifiche
hub in corso, blocchi A/B/C1 in produzione, e due bloccanti scritti con cosa
manca e chi li sblocca — le credenziali API di TidyCal e LEAD_WEBHOOK_SECRET
su Coolify, senza la quale la route rifiuta tutti (fallimento chiuso voluto).

Sta di nuovo sotto le 100 righe: ci e' rientrato togliendo cio' che STATUS.md
gia' racconta per esteso, non accorciando i bloccanti.

REQUIREMENTS.md guadagna HUB-01..13, con lo stato reale: otto fatti, cinque no.
Fra quelli aperti c'e' anche la conferma del payload Elementor, che oggi e'
gestito in modo difensivo e non verificato sul campo — distinguere "scritto" da
"visto funzionare" e' il punto della regola.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-20 10:13:50 +02:00

5.9 KiB

Raw Blame History

gsd_state_version: 1.0 milestone: v2.5 milestone_name: Audit status: executing stopped_at: "v2.5 in PAUSA. In corso le modifiche hub: A e B in prod, C1 in prod, C2 (TidyCal) bloccato sulle credenziali API." last_updated: "2026-08-19T21:15:00.000Z" last_activity: 2026-08-19 -- modifiche hub: progetti, dashboard e ingresso lead in produzione (`19ed377`) progress: total_phases: 4 completed_phases: 0 total_plans: 4 completed_plans: 0 percent: 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 chieste il 2026-08-18, 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, da definire guardando i dati d'uso
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-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 hanno incassato 5.300 € senza offerte assegnate. Si sistema assegnandole dai rispettivi progetti.
Il payload Elementor non è 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% di checklist non verificabile da HTML statico recuperino gli audit 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.
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

5.9 KiB Raw Blame History Unescape Escape