Open data · Scuola

Cruscotto Comune a scuola

Percorso didattico sui dati aperti che finisce con un cruscotto vero, online, per il comune della scuola.

Otto lezioni da due ore, divise in due binari indipendenti. Destinatari: secondaria di primo grado (binario A) e secondaria di secondo grado (entrambi). Durata: 4, 8, 16 o 33 ore secondo il formato scelto, oppure PCTO da 30–60 ore. Prodotto finale: un data report, oppure un cruscotto pubblicato online per il proprio comune. Costo: zero. Serve saper programmare? No. Il cruscotto si personalizza compilando un file di configurazione. Il percorso nasce da Cruscotto Comune, template open source per dashboard di dati aperti comunali, e dal suo primo esemplare, Cruscotto San Vincenzo.

Quale dashboard si forka. La dashboard da costruire in classe è il template vuoto magiaslab/cruscotto-comune. Non si forka questo minisito (è l'hub di divulgazione) e non si forkano i cruscotti già esistenti: oggi sono tre, il primo è San Vincenzo. San Vincenzo si usa nel binario A come oggetto di lettura: è un esemplare già online, lo stesso programma con un'altra configurazione. Apri il template su GitHub.

Cosa si porta a casa la classe

Due binari

Il binario A è un percorso completo anche da solo. Non è il riscaldamento del binario 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 · Fork del template, deploy su Vercel, smoke test sull'endpoint /api/kpi. Zero righe di 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. Zero. GitHub, Vercel nel piano gratuito e tutte le fonti del nucleo nazionale sono gratuiti. Nessuna attività del percorso richiede servizi a pagamento. Se una guida ti chiede una carta di credito, 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.