La descrizione originale
« Dirigo una piccola scuola di musica: pianoforte, chitarra, canto. Gli allievi si iscrivono a un corso settimanale con un insegnante e una fascia oraria. A ogni lezione annoto i presenti; un'assenza si recupera nel trimestre. Le famiglie pagano a trimestre. Voglio vedere le presenze della settimana, i recuperi in attesa e i pagamenti in ritardo. »
Il piano convalidato prima della generazione
Da questa descrizione, Blueprint Maker propone un piano da rileggere: cinque entità — Allievo, Corso, Fascia oraria, Presenza, Pagamento — e i loro collegamenti: un allievo è iscritto a un corso, un corso ha un insegnante e una fascia oraria, una presenza lega un allievo a una lezione datata, un pagamento lega una famiglia a un trimestre.
Gli stati dedotti dal testo sono posti nel piano: una presenza è presente, assente o recuperata; un pagamento è pagato, in attesa o in ritardo. I tre indicatori richiesti — presenze della settimana, recuperi in attesa, pagamenti in ritardo — vi figurano prima di qualsiasi generazione. È il momento di aggiungere il concetto che mancasse (gli stage estivi, per esempio); poi, ciò che viene costruito è ciò che è stato convalidato.
- Entità: Allievo, Corso, Fascia oraria, Presenza, Pagamento
- Relazioni: allievo → corso; corso → insegnante, fascia oraria; presenza → allievo; pagamento → allievo
- Stati: presente / assente / recuperato; pagato / in attesa / in ritardo
- Indicatori: presenze della settimana, recuperi dovuti, pagamenti in ritardo
La navigazione: la scuola in cinque sezioni
La barra laterale riprende le sezioni: Cruscotto, Allievi, Corsi, Presenze, Pagamenti. L'elenco degli allievi mostra nome, corso seguito, insegnante, fascia oraria — con ricerca istantanea: digitare «Mar» basta a ritrovare Margaux e Martin nel momento in cui un genitore telefona.
L'elenco dei corsi si filtra per disciplina o per insegnante; quello dei pagamenti si filtra per stato, e i badge colorati fanno il resto: un «In ritardo» arancione non passa inosservato tra i «Pagato».
La scheda allievo, con presenze e pagamenti
La scheda di Margaux Lefèvre riunisce ciò che un quaderno disperde: i suoi recapiti e quelli della sua famiglia, il suo corso (chitarra, martedì 17:30, cliccabile verso la scheda del corso), poi due cronologie collegate — le sue presenze lezione per lezione, con le assenze e il loro eventuale recupero, e i suoi pagamenti trimestre per trimestre.
La domanda «a che punto è questa famiglia?» si risolve su una sola schermata: si vede l'assenza del 12 maggio non recuperata e il trimestre di primavera pagato. È il database relazionale che collega tutto — nessun riporto manuale da un quaderno all'altro.
Il foglio presenze: trenta secondi, non di più
La schermata di registrazione delle presenze è pensata per l'aula: si apre la fascia oraria del giorno, l'elenco degli iscritti appare, si spunta presente o assente per ciascuno, si salva. Su telefono o tablet, l'appello sta nei trenta secondi — condizione di sopravvivenza di ogni foglio presenze.
Un'assenza registrata alimenta automaticamente il contatore dei recuperi in attesa; quando la lezione di recupero ha luogo, si porta la presenza allo stato «recuperato» e il contatore scende.
Il cruscotto: le tre domande del direttore
Il cruscotto risponde alle tre domande del quotidiano: il tasso di presenza della settimana, il numero di recuperi in attesa, l'importo dei pagamenti in ritardo — completati dall'organico per disciplina, calcolato sulle iscrizioni.
Ogni cifra è una query sul database: il foglio presenze compilato alle 18:00 si legge nel tasso della settimana alle 18:01. Una ripartizione per disciplina mostra a colpo d'occhio dove la scuola cresce.
I dati dimostrativi: una scuola viva
Pupitre è consegnato popolato: una cinquantina di allievi dai nomi plausibili, tre discipline, insegnanti, fasce orarie distribuite sulla settimana, e soprattutto una cronologia — diversi mesi di presenze con la loro dose di assenze, alcune recuperate e altre no, pagamenti nei tre stati.
Si valuta così l'applicazione a regime, non al primo giorno: gli elenchi sono pieni, i contatori mostrano valori realistici. I dati dimostrativi si cancellano prima della messa in servizio reale. L'applicazione vive sul suo URL dedicato e il suo codice completo si esporta (ZIP, GitHub) — Next.js + Prisma standard.