Web App AI
Tutor AI
Una piattaforma web intelligente per la generazione istantanea di materiale didattico personalizzato, basata su Google Gemini.
- Tipologia: Tool AI per l'istruzione
- Ruolo: Sviluppatore Full-Stack (Progetto accademico)
- Istituto: ITS Academy Adriano Olivetti
- Stato: Concluso
- Anno: 2026
Contesto e Obiettivi
Il progetto nasce all'interno dell'ITS Academy per risolvere una sfida concreta e sentita nel mondo scolastico: ottimizzare i tempi di preparazione delle lezioni.
Il Problema
I docenti impiegano ore per creare manualmente verifiche, riassunti e quiz. Inoltre, fornire materiali personalizzati su misura per studenti con Bisogni Educativi Speciali (BES) o Disturbi Specifici dell'Apprendimento (DSA) risulta estremamente difficile senza un supporto automatizzato.
L'Obiettivo
Mettere a disposizione uno strumento web intuitivo che sfrutti i modelli linguistici di ultima generazione (LLM) per generare verifiche ed esercizi coerenti con il livello scolastico, con esportazione PDF pronta per la stampa.
Il mio ruolo
Essendo un progetto accademico individuale, mi sono occupato dell'intero ciclo di vita dell'applicazione, end-to-end:
- Progettazione del design di interfaccia con focus su accessibilità e Glassmorphism.
- Implementazione del frontend responsivo (HTML/CSS/JS) e animazioni.
- Sviluppo backend in PHP, gestione sessioni e Storage JSON.
- Integrazione e tuning dell'API Google Gemini tramite cURL.
- Integrazione libreria TCPDF per la stampa di report professionali.
Architettura
L'infrastruttura segue un pattern classico client-server, sfruttando una persistenza dati "flat file" e chiamate asincrone per non bloccare l'interfaccia utente durante l'inferenza AI.
Schema architetturale: interazione client asincrona (AJAX), orchestrazione backend PHP, inferenza Google Gemini API e persistenza locale su file JSON.
Funzionalità Core
Generazione Dinamica AI
Il docente seleziona livello scolastico, materia e tipo di output. Il backend costruisce dinamicamente un prompt contestuale ottimizzato per gemini-3-flash-preview.
Esportazione PDF Avanzata
Integrazione TCPDF per stampare verifiche su carta intestata personalizzata, con metadati formattati, margini calcolati automaticamente e numerazione di pagina.
Archivio Personale Persistente
Sistema di filtri e ricerca per gestire i documenti generati passati, salvati su uno storage JSON compatto, in modo da evitare la complessità (e i costi) di un database relazionale per un prototipo accademico.
Statistiche e Analytics
Dashboard integrata che conteggia il risparmio di tempo stimato per ogni professore, materie preferite e documenti generati nel mese.
Sfide & Soluzioni
Persistenza flat-file e CRUD
Sfida: Sviluppare persistenza dati per un prototipo senza database SQL.
Soluzione: Manipolazione sicura di JSON lato PHP tramite json_encode/decode con gestione esplicita dei permessi di sistema e prevenzione della corruzione dei dati durante le scritture concorrenti.
Prompt Engineering Robusto
Sfida: L'AI necessitava di un contesto rigoroso per evitare allucinazioni sulle verifiche di scuola primaria.
Soluzione: Inject di costanti di sistema nascoste che obbligano Gemini al ruolo di "docente esperto", filtrando output troppo complessi basandosi strictamente sul livello d'età selezionato dall'utente.
Interfacce & Showcase
Sviluppato come prototipo accademico full-stack eseguito in locale, di seguito è possibile esplorare le schermate principali del flusso operativo dell'applicazione:
Design moderno con estetica glassmorphic e presentazione interattiva della proposta didattica.
Approfondimento dei percorsi personalizzati per studenti DSA/BES e statistiche animate sull'efficacia dello studio.
Configurazione parametri per materia, livello scolastico e obiettivo con prompting contestuale verso Google Gemini.
Anteprima immediata della verifica con pulsanti di esportazione rapida in PDF professionale tramite TCPDF.
Gestione e consultazione di tutti i documenti salvati con filtri per materia, date e anteprime rapide.