Studify

Ambiente di studio per chi prepara esami universitari. Parti dai tuoi appunti (testo, .md, PDF) e/o da materiale cercato online dall'AI; ottieni un modulo di studio con argomenti, flashcard, quiz e un piano a ritroso dalla data d'esame, costruito con metodi di studio che hanno evidenza scientifica.

npm install
export ANTHROPIC_API_KEY=sk-ant-...    # facoltativa: senza, l'app parte in "modalità base"
npm start                              # http://127.0.0.1:3000
npm run demo                           # AI simulata + esame demo: per provare tutto senza chiave
npm test

Le stesse prove (più la build della pagina Claude e della versione web) girano su GitHub Actions a ogni pull request e a ogni push su main (.github/workflows/test.yml).

Serve Node ≥ 20 (≥ 22.13 per eseguire i test, che leggono PDF con pdf.js). Nessun build step: il frontend è JavaScript ES modules servito così com'è; pdf.js (pdfjs-dist) viene servito da node_modules solo quando si apre un PDF.

Versione per Claude (senza installare nulla)

Lo stesso Studify si può pubblicare come pagina Claude (artifact): niente Node, niente chiave API. Usa l'account Claude di chi apre la pagina e salva i dati nel suo spazio privato.

npm run build:artifact     # crea dist/studify.html (un solo file, ~2,7 MB: include pdf.js e KaTeX)

Si pubblica con le capacità sample (Claude), db + user (archivio privato per utente) e downloads (backup). Differenze rispetto alla versione con server:

	Server (npm start)	Pagina Claude
Generazione modulo	una richiesta, PDF compresi (anche scansioni)	a passi (schema → carte e domande per argomento); max ~200k caratteri; di un PDF si usa il testo (le scansioni no)
Ricerca web: corsi dell'ateneo, piano di studi, materiali	sì	no (Claude non può navigare): il piano si incolla (letto da Claude) o si scrive; al posto dei materiali web una «traccia dal programma» marcata non verificata
Esami passati	analisi e correzione anche con le prove in PDF (le pagine della prova vanno a Claude); i PDF con più prove si dividono dal testo	prove come testo (anche da PDF); stessa analisi, simulazione e correzione
Dati	IndexedDB nel browser	db privato per utente (non visibile agli altri nemmeno se condividi la pagina); aperta su due dispositivi o in due schede, un salvataggio non cancella quello dell'altro (vedi sotto, «Dati»)
Costo	la tua chiave API	uso del tuo account Claude

npm run build:harness crea dist/harness.html: la pagina con un window.claude finto, per provarla in un browser normale. I moduli public/js/api.js e public/js/backend.js vengono sostituiti da artifact/api.js e artifact/backend.js in fase di build.

Versione web (Vercel + Supabase): account, dati sincronizzati, termini

Per aprire Studify ad altri studenti, con registrazione e accesso:

npm run build:web          # crea dist-web/: index.html (landing), app.html (servita su /app), js/, termini.html, privacy.html, 404.html,
                           # icone, og.png, robots.txt, sitemap.xml, site.webmanifest
node scripts/make-assets.mjs   # rigenera web/assets/ (anteprima social e icone): serve Playwright, solo se cambia il marchio

Landing (web/landing.html, web/landing.css): pagina statica su / (circa 45 KB compressa, senza il codice dell'app), con un'unica azione principale «Inizia gratis» → /app?entra=registrati. Chi ha già una sessione nel browser vede «Apri Studify». Pagine del sito: oltre alla home, /funzionalita (web/funzionalita.html: una sezione per ogni parte dell'app, con l'anteprima accanto e i link per saltare alla sezione) e /prezzi (web/prezzi.html: i piani, la tabella di confronto, cosa succede quando il credito finisce, le domande sul pagamento; esiste solo con BILLING=on). Il menu in alto e il piè di pagina sono gli stessi ovunque e li genera la build (scripts/build-artifact.mjs), con la voce della pagina segnata; sul telefono le voci stanno in «Menu». Gli script comuni (pulsanti per chi ha già l'account, invito fisso sul telefono, entrate allo scorrimento, «Come funziona») sono in web/site.js, inserito in ogni pagina. vercel.json serve /funzionalita e /prezzi senza .html; la sitemap le elenca. La scheda in cima è un piano vero: scegli fra quanti giorni c'è l'esame (5–60) e quante ore al giorno, e vedi le fasi, i prossimi giorni con le date di oggi e la sessione di oggi. Li calcola buildPlan, lo stesso dell'app, con gli argomenti dell'esame demo (web/landing-plan.js, provato in test/landing.test.js; la build lo incorpora nella pagina, circa 3 KB compressi). Con JavaScript una riga invita a provarla («sposta la data dell'esame e cambia le ore»); senza, restano i valori d'esempio, senza comandi. Le domande in fondo rispondono anche a «Cosa mi serve per iniziare?» e «L'intelligenza artificiale può sbagliare?». Scorrendo, le sezioni entrano con una breve dissolvenza; chi ha chiesto meno movimento le vede subito, e ciò che è già in vista all'apertura non si nasconde mai. All'apertura la scheda del piano si compone (i giorni contano fino al valore, la barra delle fasi si riempie, entrano i giorni e le attività di oggi; se muovi il cursore durante il conteggio vale il tuo valore). «Come funziona» ha quattro passi (carica i materiali, argomenti flashcard e quiz, il piano, le simulazioni d'esame): su computer i passi a sinistra e a destra l'app ridisegnata in piccolo con i suoi colori e componenti; i passi avanzano da soli mentre la sezione è in vista (barra sotto il passo attivo), si fermano col mouse o il fuoco sopra e per sempre al primo clic. Sul telefono e senza JavaScript ogni passo ha la sua anteprima sotto. «Cosa ottieni» è una griglia di schede: flashcard con ripasso distribuito, quiz con la fonte, dispensa da stampare, piano nel calendario, interrogazioni. Solo CSS più poche righe di JavaScript, senza librerie; con «movimento ridotto» o senza JavaScript la pagina resta ferma. Sul telefono (sotto 680px), quando i pulsanti in cima escono dallo schermo, compare lo stesso invito fisso in basso; sparisce davanti all'invito finale e al piè di pagina, per non coprirli. Se un link delle email (conferma, recupero password) arriva alla radice invece che su , la landing lo inoltra all'app. La fascia d'apertura indaco scuro (, classe in ) è condivisa con la schermata d'accesso, così il passaggio dalla landing alla registrazione resta nello stesso stile; il marchio (quadrato con il triangolo) è lo stesso in app, landing, pagine legali e icone.

Lancio

• Meta e anteprime: ogni pagina ha titolo, descrizione, canonical, Open Graph e Twitter card con og.png (1200×630). L'indirizzo pubblico viene da STUDIFY_SITE_URL oppure da VERCEL_PROJECT_PRODUCTION_URL. /app ha noindex.
• Icone: favicon.svg, favicon.ico, favicon-32.png, apple-touch-icon.png, icon-192.png, icon-512.png, site.webmanifest.
• Motori di ricerca: robots.txt (esclude /app e /api/) e sitemap.xml con le tre pagine pubbliche.
• Pagina 404 (web/404.html, noindex): Vercel la serve per ogni indirizzo che non esiste, con i link all'app e alla home.
• Moduli d'accesso: i campi sbagliati diventano rossi (aria-invalid, collegati al messaggio d'errore) e il cursore va sul primo; durante l'invio il modulo è bloccato e il pulsante dice che cosa sta succedendo («Accesso in corso…», «Creazione dell'account…»). Dopo la registrazione il messaggio «Ti abbiamo mandato un'email…» fa da pagina di ringraziamento, e alla conferma l'app saluta con «Email confermata: benvenuto in Studify!».
• Statistiche di visita: Vercel Web Analytics, senza cookie, con lo script servito dallo stesso dominio. Lo script è incluso solo nelle build su Vercel; va attivato in Analytics sulla dashboard (non in Speed Insights, che misura solo la velocità) e vale dal deploy successivo: finché /_vercel/insights/script.js risponde 404, serve un nuovo deploy di produzione. Le istruzioni della dashboard (npm i @vercel/analytics, componente <Analytics/>) sono per Next.js e qui non servono. Con STUDIFY_ANALYTICS=off si spegne; con STUDIFY_ANALYTICS=/percorso/script.js si usa il percorso indicato dalla dashboard, se diverso.
• Niente banner dei cookie: il sito non usa cookie, né di profilazione né di statistica, ma solo l'archiviazione tecnica del browser (sessione, file caricati). Per le linee guida del Garante non serve consenso; l'informativa lo spiega.
• Anti-spam: campo trappola nascosto e tempo minimo di compilazione (2 s) nel modulo di registrazione, più la conferma email obbligatoria e i limiti di spesa. Non ferma chi chiama direttamente l'API di Supabase: per quello serve il CAPTCHA di Supabase (Authentication → Attack Protection, per esempio Cloudflare Turnstile), che richiede anche una piccola modifica al modulo.

È la stessa app della pagina Claude, con al posto di window.claude un sostituto (web/claude.js):

	Come funziona
Accesso	Supabase Auth: registrazione con conferma dell'email, accesso, password dimenticata, cambio password, uscita, eliminazione dell'account (web/auth.js, web/gate.js). Con più schede aperte la sessione è una sola: rinnova una scheda alla volta (Web Locks), le altre prendono il token nuovo invece di riusare quello vecchio, che Supabase rifiuterebbe facendo uscire tutte; l'uscita da una scheda vale anche per le altre. La schermata è divisa in due: a sinistra il pannello indaco con la presentazione, a destra il modulo; sul telefono il pannello si riduce a intestazione. In cima al modulo «← Torna al sito», e il logo porta al sito (serve anche dall'app installata, che non ha il tasto «indietro»); «Esci» riporta al sito, non alla schermata d'accesso.
Consenso	Alla registrazione sono obbligatorie tre caselle: Termini, Informativa privacy (compreso l'invio dei materiali a Claude negli USA), maggiore età. Versione e data finiscono nei metadati dell'account e nella tabella consents. Quando l'informativa cambia (PRIVACY_VERSION), chi si era iscritto prima vede una volta, dopo l'accesso, una finestra con il cambiamento in breve (PRIVACY_CHANGES) e il link al testo; «Ho capito» salva privacy_seen nei metadati (presa visione, il consenso iniziale resta com'è).
Dati	Tabella docs su Supabase (progetto studify, Francoforte), con row level security: ognuno legge e scrive solo le proprie righe. Stesso formato a blocchi della pagina Claude (artifact/backend.js, testato in test/sync.test.js): i blocchi cambiati si scrivono con un nome nuovo e l'indice passa ai nuovi in una sola scrittura, che riesce solo se online c'è ancora la revisione letta per ultima (sul sito una sola richiesta a Supabase, condizionata). Così due dispositivi online insieme non si cancellano il lavoro: se un altro ha salvato prima, si rilegge, si unisce e si riprova; tornando su una scheda rimasta aperta si riprende subito il lavoro fatto altrove. Un'interruzione a metà lascia l'ultimo stato intero. I file (PDF, foto) restano nel browser (IndexedDB) e si cancellano all'uscita. Aprendo un esame su un altro dispositivo, i PDF che non ci sono hanno l'avviso «Il PDF è su un altro dispositivo» e il pulsante «Carica di nuovo»; le funzioni che li leggono (simulazione, esercizi, libri) dicono la stessa cosa invece di un errore generico.
Installabile e offline	site.webmanifest più un service worker (web/sw.js, versione e file riempiti dalla build): si installa come app dal browser e si apre anche senza connessione. La pagina passa prima dalla rete (gli aggiornamenti arrivano subito), i moduli dalla cache; Supabase e non passano mai dalla cache. Una resta in IndexedDB (, testato): senza rete si studia con quella, anche con la sessione scaduta, e le modifiche restano segnate «da inviare» finché l'archivio online non risponde. Claude offline dice che manca la connessione. Ogni modifica va subito anche nella copia locale (segnata «da inviare»): chi chiude la pagina prima del salvataggio online, che parte dopo un secondo e mezzo, la ritrova al prossimo accesso. Limiti: serve almeno un accesso con la rete in quel browser; se nel frattempo modifichi lo stesso account da un altro dispositivo, alla riapertura (o al ritorno della rete) le due versioni si uniscono esame per esame (, testato, lo stesso dell'unione online): vale quella cambiata; se lo stesso esame è cambiato da tutte e due le parti si uniscono i campi (i progressi, cioè flashcard, quiz, argomenti studiati, attività e minuti del giorno, voce per voce; il piano si rifà). Solo se cambia lo stesso altro campo (nome, data, materiali, modulo) si tiene l'online e la versione di questo dispositivo diventa una copia «(da questo dispositivo)», con un avviso. L'unione si fa sempre con l'ultima modifica di qui, anche fatta mentre si unisce, e aggiorna gli esami in memoria senza sostituirli: una generazione con Claude ancora in corso scrive nello stato che si salva ( in ). I file condivisi tra le due copie non si cancellano finché uno dei due esami li usa. All'uscita la copia si cancella con i file.

Variabili d'ambiente su Vercel

Variabile	Default	Note
ANTHROPIC_API_KEY	–	Obbligatoria per le funzioni AI (tipo Sensitive). Senza, l'app funziona ma Claude risulta non configurato.
SUPABASE_SERVICE_ROLE_KEY	–	Obbligatoria anche lei (tipo Sensitive, da Supabase: Project Settings → API Keys → secret): con questa la funzione registra il consumo di Claude, che gli utenti non possono scrivere da sé. Senza, Claude risulta non configurato. Mai nel codice né incollata in chat.
ANTHROPIC_MODEL	claude-sonnet-5-5	Costa la metà di claude-opus-5-5 (2/10 $ per milione di token contro 4/20), quindi il credito del mese dura circa il doppio. Per tornare a Opus imposta claude-opus-5-5. La parte fissa dei prompt ripetuti (regole e contesto dell'esame per ogni argomento, materiali per ogni capitolo della dispensa, esercizi svolti) va in cache (cachePrefix): dalla seconda richiesta costa un decimo.
ANTHROPIC_MAX_TOKENS	32000	Tetto di una singola risposta.
USER_MONTHLY_LIMIT_USD / TOTAL_MONTHLY_LIMIT_USD	3 / 30	Credito al mese per utente (piano Gratis: con gli abbonamenti accesi il predefinito scende a 1, quanto basta per un modulo intero) / per tutto il servizio (vale solo per chi non paga).
BILLING	(vuota)	on accende gli abbonamenti: prezzi nella landing, sezione «Abbonamento» nell'account, parti sugli abbonamenti in termini e privacy. Spenta, tutto resta gratis come prima.
STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, STRIPE_PRICE_{BASE,PRO}_{MONTH,YEAR}	—	Solo con BILLING=on: chiavi di Stripe e i 4 prezzi (il webhook scrive gli abbonamenti con SUPABASE_SERVICE_ROLE_KEY). Tutte segrete, solo su Vercel. BASE_MONTHLY_LIMIT_USD / PRO_MONTHLY_LIMIT_USD (3 / 5: ogni piano resta in attivo anche se il credito si usa tutto) cambiano il credito dei piani. Guida passo passo: docs/abbonamenti.md.
SUPABASE_URL /

Supabase (schema in supabase/schema.sql): tabelle docs, ai_usage, consents con RLS, più ai_requests (richieste in corso, solo chiave di servizio); funzioni record_ai_usage_for, begin_ai_request e finish_ai_request (solo chiave di servizio), ai_spend_this_month (all'utente la sua spesa; il totale del mese solo alla chiave di servizio), delete_my_account. In Authentication → URL Configuration vanno impostati Site URL e Redirect URLs con l'indirizzo Vercel, altrimenti i link delle email (conferma, recupero password) portano a localhost. Come Redirect URL conviene https://<dominio>/**, che comprende /app; se è autorizzata solo la radice, la landing inoltra comunque il link. Il server email predefinito di Supabase invia pochissime email l'ora: per un uso reale serve un SMTP proprio (Authentication → Emails → SMTP Settings). I modelli delle email in italiano, con oggetto e istruzioni, sono in supabase/email/ (da incollare in Authentication → Emails → Templates). Per la prima prova con uno studente vero c'è una scaletta in docs/prova-con-uno-studente.md.

vercel.json imposta build, cartella dist-web, regione della funzione (Francoforte, fra1, accanto al database), la rotta /app, durata massima (300 s), intestazioni di sicurezza (CSP, niente iframe) e cache lunga per /js/. Prove: test/web.test.js (funzione, accesso, sample, db, controlli di registrazione).

Come funziona

0. Ateneo, corso di studio, anni e materie (scheda «Ateneo»):
   • scegli l'ateneo (anche con la sigla: UNIBS, POLIMI, UNIBO…);
   • il corso di studio: con l'AI e la ricerca web (versione con server) l'app cerca l'offerta formativa dell'ateneo e ti propone i corsi in un menu (triennali / magistrali / ciclo unico); altrimenti lo scrivi tu;
   • il piano di studi per anno (1°, 2°, 3°…), con gli insegnamenti a scelta (tipici del terzo anno) raggruppati a parte. Tre modi: cercarlo sul sito dell'ateneo (solo versione con server), incollare il piano copiato dal sito/Esse3/PDF (letto dall'AI oppure con la lettura rapida senza AI), o inserire gli insegnamenti a mano. Anno, tipo (obbligatorio / a scelta), CFU e prova si correggono riga per riga.
   • creando un esame scegli anno e insegnamento: CFU, tipo di prova e anno si precompilano.
   • Modalità d'esame dalla scheda dell'insegnamento (versione con server e chiave API): se la modalità di un insegnamento del piano non è nota, scegliendolo parte da sola una ricerca web sulla scheda/syllabus dell'ateneo. Vale solo con una frase copiata dalla pagina e un URL effettivamente visto nella ricerca; il risultato (anche «non trovata») resta nel piano, così non si ripete. Per insegnamenti fuori dal piano c'è un bottone; un tipo scelto a mano non viene sovrascritto. Serve l'ateneo nel profilo.
   • Scheda incollata (ovunque, anche nella pagina Claude che non naviga): incolli la sezione «Modalità di verifica dell'apprendimento» e Claude ne ricava il tipo di prova. La citazione deve comparire davvero nel testo incollato, altrimenti il risultato è scartato; un orale facoltativo non rende l'esame «scritto + orale». Senza AI la lettura è a regole (dichiarata come tale). Il risultato resta nel piano di studi. I dati trovati sul web sono sempre segnalati «da verificare» (a.a., fonti): la prova d'esame resta «Non indicato» se la scheda non la dichiara. 0b. Importa da CSV o Excel (pulsante «Importa CSV / Excel» nella home; sul telefono «Importa da CSV / Excel» nella scheda «Aggiungi un esame»): tre tipi di file, riconosciuti dalle intestazioni (colonne correggibili a mano):
   • appelli d'esame: insegnamento, data, ora, aula, tipo di prova, CFU, anno. Più date per lo stesso insegnamento = più appelli (si sceglie da «Modifica»); le date già passate vengono ignorate; l'esame esistente con lo stesso nome viene aggiornato, non duplicato;
   • piano di studi: insegnamento, anno, CFU, tipo (obbligatorio / a scelta), prova;
   • orari delle lezioni: insegnamento, giorno (lunedì… o una data), inizio e fine (o «09:00-11:00»), aula. Le lezioni riducono il tempo di studio dei giorni in cui cadono (mai sotto 30') e nei giorni quasi pieni non si introducono argomenti nuovi. Le lezioni settimanali valgono fino alla data indicata. Se nel profilo indichi l' e hai il piano di studi, vengono spuntati in automatico solo gli insegnamenti di quell'anno; quelli che il piano mette in altri anni restano da spuntare a mano, quelli che non trova nel piano restano spuntati e segnalati («non nel piano»). Un nuovo orario sostituisce il precedente, previa conferma. creando un esame la cui materia è nell'orario, la data proposta è , una settimana dopo l'ultima lezione (non fra 30 giorni, che cadrebbe in pieno semestre). Home e pagina dell'esame la indicano come tale; quando importi gli appelli la data provvisoria viene sostituita dal primo appello e il piano si ricalcola. Un (esportato da Esse3/CINECA, Google Calendar, Outlook) si importa come orario delle lezioni o come appelli: gli orari in UTC vengono convertiti nell'ora di Roma con l'ora legale, le ricorrenze (, ) espanse, gli eventi annullati e «tutto il giorno» ignorati. Le lezioni sovrapposte sono segnalate e non vengono sottratte due volte al tempo di studio. Si legge (date e orari anche con formato Excel), / (delimitatore e codifica Windows-1252 riconosciuti), e testo copiato da Excel. Titoli e note sopra la tabella vengono saltati. Il vecchio non è supportato. : il testo posizionato viene ricostruito in righe e colonne (intestazioni ripetute a ogni pagina e numeri di pagina esclusi): gli elenchi di appelli si importano così, senza AI. Per gli (giorni in colonna, fasce orarie in riga) e le impaginazioni complesse c'è «Leggi con l'AI», che riceve il testo con le colonne allineate; per i (senza testo) l'AI riceve il PDF (versione con server) o le pagine come immagini (pagina Claude). Il risultato passa dalla stessa anteprima e dagli stessi controlli dei CSV. Un (tabella «SSD | insegnamento | CFU | quadrimestre» con sezioni «INSEGNAMENTI 2° ANNO» e blocco «Altre attività») viene riconosciuto da solo, senza AI: anni, CFU, attività a scelta, corso e anno accademico; la somma dei CFU letti è confrontata con il «Totale» dichiarato dal documento (collaudato sul piano 2026-27 di Economia e analisi dei dati: 24 voci, 180/180 CFU). Ha anche la «lettura rapida» senza AI. Errori e righe scartate sono elencati con il numero di riga del tuo file.

• nell'argomento e nel piano: quali pagine delle dispense leggere («Studia: Elasticità (leggi Dispense Microeconomia cap. 2, pp. 5–6)»); nel piano si legge una fonte sola, le dispense dove ci sono e il libro dove non arrivano;
• nel modulo: i capitoli delle dispense di cui l'AI non ha fatto un argomento, pur avendo ricevuto quelle pagine (accorpati a un altro, o saltati): un controllo che il modulo copra davvero il testo del docente;
• un PDF chiamato «Lezione 4» con poche parole per pagina (almeno 8 pagine) è un pacco di slide: l'app lo segna come tale e lo dice; «riassunti» e «schemi» sono appunti di studenti, non del docente. Nella scheda «Dispensa» l'app ricorda che, se ci sono le dispense del docente, il testo di riferimento restano quelle.

11. Appunti di colleghi (tipo «Appunti di colleghi», riconosciuto da «colleghi», «compagno/a», «amico/a» nel nome): dicono anche loro che cosa ha spiegato e sottolineato il docente, ma sono di seconda mano. L'AI controlla definizioni, formule e risultati su dispense del docente, libro e i tuoi appunti (se contrastano valgono quelli, e lo segnala), e indica tra le lacune gli argomenti che sono solo negli appunti di un collega; nella dispensa li cita [Appunti di un collega]. Come per le sbobine si indica l'anno accademico (arriva a Claude anche per i PDF) e un documento lungo si divide per lezione. Le frasi del docente sull'esame trovate lì entrano nel modulo con la loro fonte: sono riportate, non sentite da te.
12. Quiz del docente su Moodle (tipo «Quiz del docente (Moodle)»): la revisione di un tentativo (su Moodle, dopo aver finito il quiz) copiata tutta (Ctrl+A, Ctrl+C) e incollata, salvata come pagina web (.html) o stampata in PDF. L'app la riconosce anche dal contenuto, qualunque nome abbia il file, e ne legge domande, alternative, risposta corretta e feedback del docente, togliendo punteggi, stato e navigazione. Le domande entrano nel quiz così come sono, con la risposta del docente (a Claude si chiede solo l'argomento): a scelta singola e Vero/Falso restano a scelta multipla, a risposta breve diventano esercizi, con più risposte giuste una domanda «quali?». Le alternative cambiano ordine a ogni tentativo (non Vero/Falso, né quando un'alternativa rimanda alle altre, come «tutte le precedenti»), così non si impara la lettera. L'AI le usa come modello per domande nuove sugli stessi concetti, formulate in un altro modo, e nel piano arriva «Quiz del docente su …» dopo lo studio dell'argomento. Le domande senza la risposta corretta (il docente può non mostrarla nella revisione) restano fuori dal quiz, e l'app lo dice.
13. Tutorati: non sono un tipo a parte (sono esercizi, esercizi svolti, appunti o registrazioni), ma ogni materiale ha la casella «dal tutorato», spuntata da sola se il nome contiene «tutor». Il tutor non è chi fa l'esame: l'AI usa quel materiale per studiare ed esercitarsi ma non come parola del docente (se notazione o procedimento differiscono segue il docente e lo segnala), le sue dispense non passano davanti al libro, e l'app lo dice dove conta: una frase sull'esame trovata in un materiale del tutorato è segnata «detta al tutorato, non dal docente», i metodi ricavati dai suoi esercizi svolti sono «Come lo risolve il tutor», negli esercizi guidati e nel piano «metodo del tutor». Un PDF «Tutorato 3» senza altri indizi è un foglio di esercizi.
14. Studia con il piano: ogni giorno hai una lista di attività; si ricalcola da solo ogni giorno (se salti giorni o finisci prima) e quando cambi data, ore, tipo di prova o materiali. Durante la giornata la sessione di oggi resta ferma mentre la fai: chi la finisce e ha ancora argomenti da studiare trova «Anticipa il prossimo argomento» nel riquadro «Fatto per oggi». Il riepilogo «modulo pronto» (argomenti dal più importante, prima sessione) si riapre dal link in cima alla scheda «Modulo».

• Home: l'esame con l'appello più vicino è in una fascia indaco, con il conto alla rovescia, la preparazione stimata, i prossimi sette giorni (minuti di studio, giorni liberi, l'appello) e la sessione di oggi da spuntare; sotto gli altri esami, ciascuno con i giorni che mancano, e il riepilogo del libretto.
• Oggi (pagina dell'esame): la sessione del giorno con l'attività da fare adesso in evidenza (la prima ancora da fare che si può aprire), i prossimi sei giorni a riquadri con il colore della fase (il resto del piano si apre con «Tutto il piano») e la prossima simulazione; di lato una frase del docente sull'esame (dell'argomento di adesso, se c'è), gli argomenti dove c'è più da guadagnare e le flashcard da ripassare.
• Quiz: una tacca per domanda (giusta, da rivedere, di adesso), alternative con la lettera e, dopo la risposta, «Corretta» / «La tua risposta» e il perché, con la fonte se la domanda è del docente. Da tastiera: A–D (o 1–4) per rispondere, Invio per andare avanti. Flashcard: domanda e risposta sulla stessa carta, quante ricordate e quante da rivedere, valutazione 1–4.
• Movimento (solo senza «movimento ridotto»): la carta nuova entra come se la distribuissi, la risposta compare dal basso, nel quiz l'alternativa giusta fa un piccolo scatto e quella sbagliata trema, e l'attività appena spuntata si colora di verde. Ogni animazione dura meno di mezzo secondo e parte solo in quel momento, non a ogni ridisegno della pagina. Nella home si muove quello che è cambiato: alla prima apertura il numero dei giorni sale, la settimana entra in fila e le barre si riempiono; poi una barra va dal valore di prima a quello nuovo (dopo un quiz la preparazione, a ogni spunta la sessione di oggi), e all'ultima attività del giorno «Fatto per oggi» fa un piccolo scatto. Tornare alla home senza novità non muove niente, e spuntare un'attività non riporta più la pagina in cima.
• Promemoria nel calendario (colonna laterale di «Oggi»): «Scarica per il calendario» crea un file .ics con una sessione per ogni giorno di studio, all'ora scelta (predefinita 18:00, salvata nell'esame) e con le attività nella descrizione, più il giorno dell'appello. Si apre con Google Calendar, Calendario di Apple o Outlook, che mandano l'avviso anche ad app chiusa: è il modo di avere promemoria senza un server di notifiche. Il file è una fotografia del piano: se il piano cambia va riscaricato (gli eventi hanno un UID fisso per giorno, quindi i calendari che lo supportano li aggiornano invece di duplicarli). Logica in public/js/calendar.js (testata); le ore sono «fluttuanti», senza fuso. L'app ricorda che cosa c'era nel file scaricato: se poi il piano cambia (giorni saltati, «Anticipa», nuova data, ora diversa) la scheda dice «Il piano è cambiato» e propone «Riscarica il calendario». Il nuovo file ha un SEQUENCE più alto (i calendari che lo rispettano aggiornano gli eventi) e annulla i giorni che non ci sono più; le app che non lo rispettano possono mostrare doppioni, e la scheda lo dice.

Sessione	Cosa fa
Flashcard	Richiamo attivo con ripasso dilazionato (SM-2 semplificato) che non programma nulla oltre il giorno prima dell'esame. Le carte nuove sono introdotte solo per argomenti già studiati.
Quiz	Errori recenti per primi, argomenti alternati (interleaving). Risposte aperte: spunti i punti della rubrica o chiedi la correzione all'AI.
Simulazione	Con le prove degli anni passati: una prova vera a tempo, senza appunti, corretta da Claude o da te. Senza: quiz a tempo con correzione differita.
Spiega a parole tue	Per scritto aperto/orale: spieghi senza appunti e confronti con i punti chiave. «Simulazione orale» sceglie 3 argomenti pesati per importanza.
Progressi	Stima di preparazione per argomento (flashcard solide + quiz), con i punti dove conviene lavorare.

Ricevimento: le domande da fare al docente

La scheda Ricevimento di ogni esame raccoglie i dubbi che solo il docente può sciogliere, presi da ciò che l'app ha già trovato: com'è fatto l'esame (se il tipo di prova non viene da una fonte), due fonti che non concordano, una soluzione ufficiale che Claude trova sospetta, i capitoli del libro che i materiali non coprono («sono nel programma?»), le domande dei quiz Moodle senza risposta; spenti di partenza, gli argomenti che sono solo sulle slide e quello dove sbagli di più (con il consiglio di portare un esercizio). Si aggiungono domande proprie, si copia l'elenco (per la mail di prenotazione o il telefono) e dopo si scrivono le risposte: diventano il materiale «Ricevimento del …», che l'AI usa come indicazioni del docente di prima mano (sciolgono i dubbi segnati, e ciò che dicono sull'esame finisce tra le sue frasi). Un file con «ricevimento» nel nome è riconosciuto allo stesso modo.

In gruppo: condividere l'esame e interrogarsi a turno

Nel modulo, il riquadro «Studiate in gruppo?»:

• Condividi l'esame con il gruppo salva un file con il modulo (argomenti, flashcard, quiz, frasi del docente), i libri con l'indice e, se si vuole, il testo dei materiali (non i PDF e le foto). Non partono i progressi, il piano, le simulazioni e le bozze del ricevimento. Chi lo riceve lo apre dalla home con «Importa un esame dal gruppo»: un esame suo, con il modulo pronto e i progressi a zero (il nome si distingue se c'è già; un backup completo viene riconosciuto e non importato al posto suo). Così uno prepara il modulo con i materiali di tutti e gli altri non devono rigenerarlo.
• Interrogatevi a turno: dieci domande aperte, prima quelle d'esame vere, poi quelle degli argomenti più importanti, al più due per argomento nel primo giro. Chi risponde parla senza appunti; solo chi interroga apre la traccia (i punti da sentire da spuntare, la risposta modello, la domanda con cui incalzare). Alla fine: quante sapute e quali rivedere. I risultati non entrano nei progressi di chi ha il telefono, perché a rispondere poteva essere un altro.

Libretto: esami superati e da superare

Dal piano di studi (pagina «Ateneo e corso di studio») la pagina Libretto fa la checklist degli insegnamenti per anno: superati con voto e data, da superare con l'esame in preparazione nell'app (data e preparazione) o il pulsante «Prepara», che crea l'esame con CFU e tipo di prova dal piano. In cima: esami e CFU superati sul totale, media ponderata sui CFU (la lode vale 30, le idoneità non contano) e base di laurea stimata (media × 110 / 30), con l'avvertenza che ogni ateneo la calcola a modo suo. Il libretto si incolla da Esse3 (Carriera → Libretto, copia della tabella): si leggono le righe con voto e data, abbinate al piano per nome; quelle che nel piano non ci sono vengono aggiunte. Delle opzioni a scelta contano solo quelle superate o segnate «lo scelgo». Quando la data di un esame dell'app è passata, il libretto chiede com'è andata. In home una riga riassume a che punto sei. Il libretto ufficiale resta quello dell'ateneo: qui si copia, non si sostituisce.

Perché questi metodi (e non gli «stili di apprendimento»)

La scelta dei metodi dipende da tipo di prova, giorni rimasti e livello di partenza (public/js/methods.js), non da «sono visivo/uditivo»: gli studi non mostrano benefici nell'adattare il metodo allo stile dichiarato. Si privilegiano le tecniche ad alta utilità (richiamo attivo, ripasso distribuito, prove pratiche) rispetto a rilettura ed evidenziazione (Dunlosky et al. 2013; Roediger & Karpicke 2006). Per i principianti il piano parte da una prima lettura guidata e da esempi svolti (expertise reversal); con pochi giorni passa in «modalità emergenza» (solo richiamo attivo e prove sugli argomenti più probabili).

Limiti da conoscere

• Il modulo è una bozza, non una verità. L'AI può sbagliare. Ogni argomento indica l'origine (tuoi materiali / web / conoscenza generale dell'AI — da verificare); le lacune sono esplicitate. Confronta con il programma del corso.
• La «preparazione» è una stima, non una previsione del voto: non misura quanto il tuo esame sarà simile ai quiz generati.
• Non c'è un archivio nazionale incorporato dei corsi e dei piani di studio (l'open data del MUR non era raggiungibile dall'ambiente di sviluppo): elenco corsi e piano arrivano dalla ricerca web dell'AI, dal testo che incolli o da ciò che scrivi.
• Piano di studi trovato online: può essere di un anno accademico precedente o di un altro curriculum, e molte guide (Esse3, PDF) non sono raggiungibili dalla ricerca. L'app lo segnala come «da verificare»; se non lo trova, usa l'inserimento manuale. L'elenco atenei è solo per l'autocompletamento: puoi scrivere qualunque ateneo.
• Ricerca online: la qualità dipende da ciò che il web offre sul tuo corso; dispense del tuo docente battono qualsiasi ricerca.
• Privacy: i dati restano nel browser (IndexedDB). Il testo dei materiali viene inviato al server locale e da lì all'API di Anthropic solo quando generi un modulo, cerchi online o fai correggere una risposta.
• Esami passati: la correzione di Claude è una stima, non il voto del tuo docente (che può pesare diversamente procedimento e risultato); con le foto, una cattiva lettura della calligrafia pesa sulla correzione, per questo la trascrizione si controlla prima. La frequenza degli argomenti su poche prove è rumorosa, e prove di un altro docente o di un programma vecchio possono ingannare. Gli elenchi di domande raccolti dagli studenti riflettono ciò che chi li ha scritti ricorda: i conteggi sono indicativi. E sapere a memoria le risposte dell'elenco non basta all'orale, dove il docente incalza.
• Libri consigliati: i capitoli «non coperti» sono quelli che nessun argomento del modulo tratta, non la prova che non li sai; e un argomento collegato a un capitolo non vuol dire che i tuoi materiali lo trattino come il libro. Il tempo di lettura è una stima.
• Dispense del docente: l'indice si ricava da una pagina «Indice» o da titoli come «Capitolo 3»; dispense senza né l'una né gli altri (o una scansione) non danno le pagine da leggere, e un indice ricavato dai titoli va controllato. Il riconoscimento delle slide guarda solo quante parole ci sono per pagina: slide molto fitte restano «dispense» (cambia il tipo a mano). Che le dispense prevalgano sul libro vale per definizioni e notazione; su un fatto o un calcolo un refuso del docente resta un refuso, per questo le differenze vengono segnalate e non risolte in silenzio.

Configurazione

Variabile	Default	Note
ANTHROPIC_API_KEY	–	Senza chiave l'app funziona in modalità base.
STUDIFY_MODEL	claude-opus-5-5	Puoi usare un modello più economico (es. claude-sonnet-5-5).
PORT / HOST	3000 / 127.0.0.1	Con host non-loopback le protezioni same-origin sono disattivate: non esporre il server senza autenticazione, spendi i tuoi crediti API.
STUDIFY_MOCK	–	1 = AI simulata (anche npm run demo).

La generazione di un modulo usa un'unica richiesta (con ragionamento adattivo e output strutturato) e può costare qualche dollaro per materiali molto lunghi: parti da pochi appunti per farti un'idea.

Struttura

server/           index.js (HTTP, job asincroni, sicurezza) · ai.js (Anthropic SDK) · schema.js (zod)
shared/           prompts.js, normalize.js: usati sia dal server sia dalla pagina Claude (nessuna dipendenza)
artifact/         versione pagina Claude: generate.js (sample), backend.js (db), api.js, entry.js, template, fake-claude (prove)
web/              versione web: entry, auth (Supabase Auth), claude (sample/db/user), gate (accesso e account), backend, template, pagine legali
api/              funzioni Vercel: /api/claude (_lib.js: controlli, costi, streaming), /api/billing e /api/stripe-webhook
                  (_billing.js: piani, pagamento, portale, webhook); testate
supabase/         schema.sql (tabelle, RLS, funzioni)
scripts/          build-artifact.mjs (esbuild: pagina Claude, harness, --web)
public/js/        logica pura (testata): dates, methods, srs, planner, progress, local-builder, tabular (CSV/xlsx), importers, timetable,
                  lessons (lezioni e prove), past-exams (prove, frequenze, voto), exam-questions (elenchi di domande d'esame),
                  worked (metodi del docente ed esercizi guidati), exercises (esercitazioni con le soluzioni), books (libri consigliati),
                  dispense (indice delle dispense del docente, slide o dispense), transcripts (sottotitoli e trascrizioni con i tempi),
                  moodle (revisione dei quiz del docente)
                  stato/UI: store (IndexedDB), domain, api, ui, views/*
public/demo/      modulo demo (Microeconomia)
test/             node --test: logica pura + client AI con SDK simulato
demo/             demo guidata (pagina a parte, React + Tailwind): non fa parte dell'app, vedi demo/README.md

Idee per dopo

Import da Notion/Drive, OCR di foto degli appunti, calendario con più esami in competizione per il tempo, calibrazione della fiducia (quanto sei sicuro prima di vedere la risposta), file (PDF, foto) sincronizzati anche nella versione web (Supabase Storage).