La descrizione originale
« Gestisco un’associazione sportiva. Ogni socio ha una scheda con i suoi dati di contatto, una categoria (junior, adulto, famiglia) e la data di scadenza del certificato medico. Le quote associative sono annuali e devo sapere in ogni momento chi è regolare. Organizzo eventi, allenamenti, tornei, assemblea generale, a cui i soci si iscrivono. Voglio visualizzare quanti soci sono regolari, l’importo incassato nella stagione corrente e gli eventi imminenti. »
Il piano approvato prima della generazione
Prima di scrivere anche solo una riga, Blueprint Maker traduce questa descrizione in un piano da approvare. Per AssoRegistre, il piano proposto occupa un’unica schermata: quattro entità, Socio, Quota associativa, Evento, Iscrizione, e le loro relazioni: una quota appartiene a un socio, un’iscrizione collega un socio a un evento.
Anche gli stati dedotti dal testo compaiono nel piano: la quota può trovarsi in stato «in attesa», «incassata» o «esentata»; l’evento può essere «in programma», «concluso» o «annullato». I tre indicatori richiesti (soci regolari, importo incassato nella stagione corrente, prossimi eventi) sono esplicitati nero su bianco. Se manca qualcosa o c’è qualcosa di superfluo, lo si corregge qui: ciò che viene generato corrisponde esattamente a quanto annunciato.
- Entità: Socio, Quota associativa, Evento, Iscrizione
- Relazioni: quota → socio; iscrizione → socio; iscrizione → evento
- Stati: in attesa / incassata / esentata; in programma / concluso / annullato
- Indicatori: soci regolari, importo incassato nella stagione corrente, prossimi eventi
La navigazione: una sezione per ogni entità
L’applicazione generata si apre con una barra laterale sobria: Dashboard, Soci, Quote associative, Eventi, Iscrizioni. Ogni sezione porta a una lista, non a un foglio di calcolo, ma a una vera lista applicativa: campo di ricerca in alto, colonne ordinabili con un clic, paginazione e un contatore che indica quanti risultati soddisfano il filtro corrente.
La lista dei soci mostra nome, categoria, data di scadenza del certificato medico e stato della quota associativa corrente. Accanto al campo di ricerca compaiono un filtro per stato e uno per intervallo temporale. Questi filtri sono integrati nell’URL della pagina: la vista «soci con quota in attesa» può essere salvata come preferita o inviata via messaggio al tesoriere, aprendola, vedrà esattamente ciò che stavi visualizzando.
La barra delle scadenze: ciò che va gestito questa settimana
È l’elemento più utile per un’associazione ed è inserito automaticamente non appena un’entità prevede una data di scadenza. Sopra la lista, l’applicazione mostra una barra che riassume la situazione in una sola riga: quanti certificati medici sono scaduti, quanti scadono oggi e quanti scadranno nei prossimi sette giorni.
Sotto, vengono elencate per nome le cinque scadenze più vicine, ordinate per data, ciascuna con un pulsante «Gestisci» che apre direttamente la scheda corrispondente. Se ce ne sono di più, la barra lo segnala. Una voce il cui stato indica che è stata risolta scompare automaticamente dalla barra: si vede solo ciò che resta da fare.
Nella pratica: aprendo l’applicazione prima di una riunione del consiglio direttivo, si individuano immediatamente i certificati da rinnovare e le quote ancora in attesa, senza dover ordinare, filtrare o calcolare nulla mentalmente.
La scheda del socio, con la sua cronologia
Cliccando su un socio si apre la sua scheda: dati di contatto, categoria, data di scadenza del certificato. Subito sotto compare la parte che cambia tutto rispetto al foglio di calcolo: la cronologia delle quote di QUESTO socio, in forma tabellare con date, la quota della stagione precedente incassata a settembre, quella della stagione in corso ancora in attesa, e l’elenco delle sue iscrizioni agli eventi passati e futuri.
Questo collegamento non è puramente estetico: deriva dal database relazionale generato. Correggere un indirizzo lo aggiorna ovunque, e il numero di iscritti visualizzato su un evento deriva direttamente dalle iscrizioni: nulla viene copiato manualmente.
Eventi in agenda, non in lista
Gli eventi possono essere visualizzati in forma di agenda anziché di lista, con le viste giornaliera, settimanale e mensile. È la lettura più naturale della stagione associativa: si vede il weekend del torneo tra tre settimane e l’assemblea generale nella sua data precisa.
Il modulo di iscrizione è breve perché la struttura fa gran parte del lavoro: il socio viene selezionato da un menu a tendina (nessun nome digitato manualmente, quindi nessun duplicato), lo stesso vale per l’evento, mentre la data è già precompilata. Al salvataggio, la lista delle iscrizioni, la scheda del socio e la dashboard riflettono immediatamente l’inserimento, tutti gli schermi attingono allo stesso database.
La dashboard: i dati richiesti, calcolati direttamente sul database
La dashboard riprende esattamente gli indicatori richiesti nella descrizione: numero di soci regolari, importo incassato nella stagione corrente, prossimi eventi con relativi numeri di iscritti e ripartizione dei soci per categoria.
Questi valori derivano da query sul database, non da inserimenti manuali: ogni quota registrata li aggiorna automaticamente. Inoltre, ogni lista può essere esportata in formato CSV, e l’esportazione contiene esattamente le righe visualizzate a schermo, filtri inclusi, con il numero di elementi indicato direttamente sull’etichetta del pulsante. Basta così per preparare la lista dei presenti all’assemblea generale o trasmettere un rendiconto al tesoriere.
Ciò che l’applicazione non fa, meglio saperlo fin dall’inizio
AssoRegistre tiene il registro: chi è socio, chi è regolare, a quali eventi partecipa. Non incassa però alcun pagamento: non sono previsti pagamenti online, addebiti diretti né riconciliazioni bancarie. L’importo di una quota viene inserito solo dopo che l’incasso è avvenuto altrove.
Non emette nemmeno ricevute fiscali per donazioni né altri documenti obbligatori. E visualizza le scadenze, ma non le notifica: la barra segnala all’apertura dello schermo ciò che è in ritardo e ciò che sta per scadere, senza inviare automaticamente email o SMS ai soci. Si tratta di funzionalità che uno sviluppatore può aggiungere, il codice è esportabile, ma che non fanno parte della generazione automatica.
I dati dimostrativi: valutare su schermate complete
AssoRegistre arriva già popolata: diversi mesi di attività simulata, soci con nomi plausibili distribuiti nelle tre categorie, quote associate in tutti gli stati possibili, eventi passati e futuri con relative iscrizioni, compresi, volutamente, alcuni certificati scaduti e alcune quote ancora in attesa, per mostrare il funzionamento della barra delle scadenze.
Si tratta di una scelta deliberata: uno strumento di gestione non si valuta su tabelle vuote. I dati dimostrativi vengono poi cancellati per lasciare spazio a quelli reali. L’applicazione è accessibile tramite un URL dedicato e il suo codice sorgente completo è esportabile (ZIP o push su GitHub), basato su Next.js + Prisma standard.