Open data · Scuola

Cruscotto Comune a scuola

Un percorso sui dati aperti che può finire con un cruscotto vero, online, per il comune della scuola.

Otto lezioni da due ore, in due binari. Il primo si fa con un browser e un foglio di calcolo; il secondo pubblica un cruscotto, con gli account del docente. Si può fare in 4, 8, 16 ore, o in un PCTO. Non serve saper programmare: il cruscotto si personalizza compilando un file. L'ho messo a punto partendo da Cruscotto Comune e da San Vincenzo, il primo che ho fatto.

Quale cruscotto si costruisce in classe. Nel binario B la classe parte dal template magiaslab/cruscotto-comune: una copia sull’account GitHub del docente, poi pubblicata su Vercel. Questo sito e i cruscotti già online (San Vincenzo per primo) non si copiano. San Vincenzo serve nel binario A come oggetto di lettura: è lo stesso programma, già configurato su un comune reale. Apri il template su GitHub.

Cosa si porta a casa la classe

Due binari

Il binario A sta in piedi da solo. Non è il riscaldamento del B.

• Solo A — qualsiasi ordine di scuola, educazione civica, italiano, geografia, diritto.
• Solo B — se la classe ha già lavorato sui dati (per esempio ha fatto ASOC) e vuole il prodotto.
• A + B — il percorso completo da 16 ore. È la combinazione che consigliamo.

Quante ore servono

Dove si incastra nel curricolo

Le otto lezioni

1. 1. Che cos'è un dato apertoLezione 1 · Binario A · 120 minuti · Distinguere un dato da un'informazione e da un'opinione; riconoscere le quattro condizioni che rendono un dato aperto; leggere una licenza; collocare un dataset sulla scala delle cinque stelle.
2. 2. Dove stanno i dati del tuo comuneLezione 2 · Binario A · 120 minuti · Nominare le principali fonti pubbliche italiane, distinguere fonte primaria e derivata, leggere i metadati, capire la differenza fra dato aggiornato e dato recente.
3. 3. Leggere un cruscotto senza farsi fregareLezione 3 · Binario A · 120 minuti · Scomporre un indicatore, scegliere comuni comparabili, riconoscere trappole (percentuali su numeri piccoli, media e mediana, asse troncato, periodo scelto ad arte) e riscrivere un titolo tendenzioso.
4. 4. Il dato che mancaLezione 4 · Binario A · 120 minuti · Valutare la qualità di un dato, distinguere obblighi di pubblicazione e diritto di accesso, scrivere una richiesta di accesso civico generalizzato corretta.
5. 5. Dal fork al sito onlineLezione 5 · Binario B · 120 minuti · Copia del template, pubblicazione su Vercel, controllo su /api/kpi. Non si scrive codice. Account del docente o della scuola.
6. 6. Configurare l'identità del comuneLezione 6 · Binario B · 120 minuti · Leggere e modificare JSON, trovare codice ISTAT e catastale, decidere quali moduli accendere, citare il progetto originale.
7. 7. Verificare: dati, accessibilità, menzioniLezione 7 · Binario B · 120 minuti · Audit di tre numeri contro la fonte primaria, quattro controlli di accessibilità, verifica delle menzioni, eventuale issue sul repository originale.
8. 8. Raccontare i datiLezione 8 · Binario B · 120 minuti · Data story in sei mosse, presentazione di cinque minuti a gruppo, cruscotto pubblicato, segnalazione alla vetrina delle classi.

Materiali

Guide, schede studente, rubrica, glossario e modelli. Formati aperti (Markdown su GitHub). Licenza CC BY-SA 4.0: Si può modificare, tradurre, adattare e ridistribuire, citando la fonte e mantenendo la stessa licenza.

• Guida docente (guida)
• Binario A — lezioni 1–4 e schede studente (scheda)
• Binario B — lezioni 5–8 e schede studente (scheda)
• Rubrica di valutazione (rubrica)
• Glossario (guida)
• Modelli, checklist e kit dati offline (modello)

Apri i materiali didattici →

Prima di iniziare

1. Account e minorenni. I termini di servizio di GitHub richiedono almeno 13 anni; quelli di Vercel almeno 16. In una classe del biennio una parte degli studenti non ha l'età per aprire un account Vercel. Nel binario B, quindi, l'account è del docente o della scuola e gli studenti lavorano come collaboratori del repository. Non far creare account personali agli studenti: non serve, e sposta su di loro una responsabilità che non è la loro.
2. Rete. Non fidarti del wifi della scuola e non fidarti delle API in diretta. Il kit dati offline esiste per questo: si scarica tutto il giorno prima e la lezione funziona anche se la connessione cade. Per il binario B, verifica con il referente IT almeno una settimana prima che github.com e vercel.com non siano bloccati dal filtro della scuola: è la causa numero uno di lezioni saltate.
3. Costi. GitHub, Vercel nel piano gratuito e le fonti nazionali sono gratis. Nessuna attività del percorso richiede una carta di credito. Se una guida te la chiede, sei fuori percorso.
4. Supporto. Asincrono e best effort, via issue su GitHub o mail. Non c'è assistenza in diretta: preparati a risolvere in autonomia, usando la sezione «cosa può andare storto» di ogni lezione.
5. Non è ufficiale. Il cruscotto della classe non rappresenta il comune e deve dichiararlo, come fa il progetto originale. È anche una lezione di deontologia: chi pubblica dati dice chi è, da dove vengono i numeri e cosa non sa.

Segnalare un cruscotto

Se la classe pubblica un cruscotto, segnalalo per la vetrina delle classi: scuola, comune, anno scolastico e URL. Niente nomi né foto di studenti.

cipriani.alessandro@gmail.com

Progetto indipendente, non ufficiale. Non affiliato ad AgID, al Governo italiano o a un ente locale.