Files

T

simone f7eb7eec23 docs(planning): archivia v2.1/v2.2/v2.3 e documenta v2.4

.planning/ documentava in dettaglio cio che era vecchio e per niente cio
che e in produzione: le fasi 11-22 (v2.1 e v2.2, chiuse a giugno) erano
ancora in phases/ mentre v1.0 e v2.0 stavano gia in milestones/, e il
lavoro degli ultimi due mesi - gate OTP e ciclo di vita dei retainer, cioe
quello che gira su hub.iamcavalli.net - non aveva nessuna cartella.

- phases/{11,12,14} -> milestones/v2.1-phases/, phases/{18..22} ->
  milestones/v2.2-phases/. Ora phases/ contiene solo la milestone in
  corso, che e quello che state.cjs conta per il progresso
- v2.1-ROADMAP.md ricostruito: era l'unica milestone senza archivio,
  interrotta dal reset del 19/06 e mai chiusa formalmente
- v2.3-ROADMAP.md + v2.3-REQUIREMENTS.md: v2.3 e stata eseguita fuori dal
  ciclo GSD, non esistono PLAN/SUMMARY per fase. L'archivio E la doc
- REQUIREMENTS.md riscritto per v2.4 con il backlog reale
- phases/13 e phases/26: SUMMARY ricostruiti da commit, migration e
  STATUS.md. 26 e il primo numero libero
- research/: cancellate 4 varianti dello stesso PITFALLS e FEATURES/
  SUMMARY, superati da PROJECT.md. Diverse anti-feature erano ormai
  contraddette dai fatti (il Kanban e stato costruito in Phase 19,
  l'email in v2.3, il time tracking esiste)
- cancellati UI-RULES.md e DESIGN-SYSTEM.md (CLAUDE.md li dichiara
  superseded: impongono l'inverso della regola attuale) e HANDOFF.md,
  fermo al 13/06
- SECURITY-*.md -> security/: audit chiuso, ma i report restano la doc di
  cosa e stato ruotato e perche
- PROJECT.md/MILESTONES.md/ROADMAP.md allineati: milestone corrente v2.4,
  sessione OTP 90gg non 30, migrazioni fino alla 0016

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

2026-08-08 22:38:36 +02:00

3.0 KiB

Raw Blame History

phase, plan, status, completed_at, requirements_satisfied, known_gaps

phase

plan

status

completed_at

requirements_satisfied

known_gaps

22-pagina-pubblica-preventivo

complete

2026-06-20

PUB-01

PUB-02

PUB-03 (email Resend — non implementata, deferred to backlog)

Plan 22-01 Summary: Pagina Pubblica Preventivo + Deck

What Was Built

Pagina pubblica /preventivo/[slug] che presenta la proposta generata come deck interattivo di 20+ slide navigabili (frecce, tasti keyboard, dot navigator). Il cliente sceglie il tier A/B/C e accetta/rifiuta dalla pagina; l'esito si riflette nel DB con accepted_at immutabile. PUB-03 (invio email Resend) non implementato — il link va condiviso manualmente.

Key Files

Created

src/app/preventivo/[slug]/page.tsx — server component pubblico; gestisce stati: draft (blocca accesso), published (mostra + accept), accepted/rejected (mostra con stato)
src/app/preventivo/[slug]/actions.ts — acceptProposal (guard accepted_at immutabile + selected_tier validato A/B/C), rejectProposal
src/components/public/proposal/ProposalDeck.tsx — deck client component: navigazione keyboard (←/→), dot cliccabili, topbar fissa (titolo + counter), bottombar fissa (frecce + dots); h-screen overflow-hidden per 100vh per slide
src/components/public/proposal/sections/ — 20 componenti slide:
- CoverSection, VisionSection, IndexSection
- ChapterDivider (×5), StrategistSection, FactsSection, TestimonialsSection
- ProblemNodeSection, SynthesisDiagramSection
- SolutionNodeSection, SolutionSynthesisSection
- ScopeSection, DeliverablesSection, TimelineSection
- PricingSection, StagesRecapSection, ComparisonMatrixSection
- NextStepsSection, AcceptSection, ClosingSection

Architecture Decisions

Decisione	Scelta	Motivo
Layout	`h-screen overflow-hidden` per slide	Nessun scroll di pagina, navigazione slide-by-slide
Navigazione	Keyboard + dots + click frecce	Universale, funziona su desktop e touch
Accettazione	`accepted_at` immutabile (guard server action)	Pattern coerente con `deliverables.approved_at`
Tier selezione	Radio A/B/C prima dell'accettazione	Cliente sceglie l'opzione, l'esito è univoco
Email	Non implementata (PUB-03)	Scope minimo, link condiviso manualmente per ora

Requirements Verified

PUB-01: ✅ Proposta visibile come pagina pubblica HTML a /preventivo/[slug], deck 20+ slide
PUB-02: ✅ Cliente accetta/rifiuta dalla pagina; state + accepted_at + selected_tier aggiornati nel DB; admin vede esito nella lista preventivi

Known Gap

PUB-03 — Email Resend: il link preventivo non viene inviato automaticamente. Va copiato dall'admin e condiviso manualmente (es. via WhatsApp/email). Da implementare nella prossima milestone come prima feature.

Fix Post-Deploy

2026-06-20: fix h-screen overflow-hidden su tutte le slide (erano min-h-screen, causavano scroll di pagina)
2026-06-20: ANTHROPIC_API_KEY mancante in Coolify — aggiunta via PHP artisan + redeploy

3.0 KiB Raw Blame History Unescape Escape