Flusso completo
Profilo, esercitazione, invio, correzione e rilancio sul topic debole.
Demo MVP
GuidaFacile ti porta da pratica a review senza uscire dall'app.
Onboarding essenziale, sessioni pratica sul dataset ministeriale importato, correzione finale, topic deboli e spiegazioni assistite da fallback locale. Integrazioni esterne ancora separate.
Week 1 MVPUn solo percorso demo, dall'ingresso al review
Dataset importJSON importato da domande AB italiano 23 04 2025.pdf
Email auth + StripeConfig checks presenti, flussi live non inclusi nel demo
MVP scopeDemo flow attivo
5 pillars
- Onboarding con categoria patente, obiettivo e ritmo di studio
- Practice dal dataset ministeriale importato
- Review con correzione, topic e spiegazioni
- Tracking delle debolezze tra le sessioni
- Billing e auth lasciati fuori dal percorso demo
Stack pragmatica
Next.js 16, TypeScript, route handlers e stato locale sostituibile da Postgres.
Dataset reale
7.090 domande importate dal PDF ministeriale AB e servite direttamente all'app.
Architecture
Un'unica app demoabile oggi, senza dipendere da integrazioni non pronte.
Frontend
Landing, dashboard, practice e review nello stesso App Router.
Backend
Route handlers per onboarding, submit sessione, explain e health.
Domain layer
Modelli tipizzati per domande, sessioni, learner e topic performance.
Data path
Storage locale ora, adattatore pronto per Postgres quando serviranno account reali.
Default stack
Scelte per mostrare un MVP funzionante, non per simulare il futuro.
Perche Next.js 16
1 app
- Percorso lineare da landing a prodotto
- Logica server e client nello stesso repo
- Deploy semplice quando il demo va online
Perche TypeScript + adapter
swap later
- Dataset reale oggi, swap di storage domani
- Billing e AI isolati senza finti end-to-end
- Basso rischio di riscrittura quando arrivano le integrazioni
Post-MVP
Quello che resta fuori dal demo ma ha gia un punto di aggancio.
1. Auth email
Provider e contratto env presenti; emissione token e callback da completare.
2. Stripe
Check di configurazione presenti; checkout e webhook restano da implementare.
3. OpenAI live
La route di explain esiste ma usa fallback locale finche prompt, logging e guardrail non sono approvati.
4. Multi-user persistence
Lo store locale funziona per demo; account veri richiedono auth e storage condiviso.