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

SupportoContatti
Marchio Cruscotto ComuneCruscotto ComuneI cruscotti dati comunali aperti – pronti da usare e facili da replicare

Strumenti

Cosa serve davvero, diviso per binario. Nessun software a pagamento. Nessuna carta di credito. L'editor è opzionale: per il file di configurazione basta l'editor di GitHub nel browser.

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.

Binario A — Leggere i dati

  • Browser. Tutte le lezioni. Un dispositivo ogni due studenti nel binario A; un dispositivo per gruppo nel binario B. Va bene anche lo smartphone per la caccia al dato.
  • Foglio di calcolo (o carta). Confronto fra tre comuni, schede fonti. Se la classe non padroneggia il foglio di calcolo, la tabella si fa su carta: l'obiettivo è il ragionamento, non lo strumento.
  • Proiettore o LIM. Apertura di ogni lezione e confronto in plenaria.
  • Kit dati offline. Piano B se la rete cade. Si prepara il giorno prima: PDF delle pagine, CSV, foglio di confronto. Istruzioni in 05-modelli-e-kit.md.

Binario B — Costruire il cruscotto

  • Browser. Tutte le lezioni. Un dispositivo ogni due studenti nel binario A; un dispositivo per gruppo nel binario B. Va bene anche lo smartphone per la caccia al dato.
  • Proiettore o LIM. Apertura di ogni lezione e confronto in plenaria.
  • Account GitHub del docente o della scuola. Copia del template github.com/magiaslab/cruscotto-comune (un fork: una copia sul GitHub del docente). Non copiare questo sito né i cruscotti già online. Gli account degli studenti non servono: i termini di servizio di GitHub richiedono almeno 13 anni.
  • Account Vercel del docente o della scuola. Pubblicazione del cruscotto. I termini di servizio richiedono almeno 16 anni. Collegato a GitHub prima della lezione 5.
  • Editor di testo (opzionale). Per modificare config/comune.json. Si può anche usare l'editor di GitHub nel browser.
  • Validatore JSON online. Prima di salvare la configurazione. Dice la riga dell'errore.

Requisiti di rete

Verifica con il referente IT almeno una settimana prima. È la causa numero uno di lezioni saltate. Non fidarti del wifi della scuola e non fidarti delle API in diretta.

Domini che la scuola deve consentire.
DominioPerché
github.comFork e repository del template (binario B).
vercel.comDeploy del cruscotto (binario B).
dati.gov.itCaccia al dato, catalogo nazionale (binario A).
istat.itesploradati.istat.it e fonti ISTAT (binario A).
openstreetmap.orgMappe, civici, farmacie, percorsi.
cruscotto-italia.dati.gov.itMCP AgID / Cruscotto Italia, KPI comunali.

Per il binario A tieni pronto il kit dati offline. Per il binario B tieni una registrazione video dei passaggi di fork e deploy, da proiettare se la rete cade.

Progetto indipendente, non ufficiale. Non affiliato ad AgID, al Governo italiano o a un ente locale. Materiali didattici CC BY-SA 4.0.