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 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.

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. Fork del template vuoto github.com/magiaslab/cruscotto-comune. Non forkare questo minisito (è l'hub) né i cruscotti già esistenti: oggi sono tre, il primo è San Vincenzo. Non account studente: i termini di servizio richiedono almeno 13 anni.
Account Vercel del docente o della scuola. Deploy 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.
Dominio	Perché
github.com	Fork e repository del template (binario B).
vercel.com	Deploy del cruscotto (binario B).
dati.gov.it	Caccia al dato, catalogo nazionale (binario A).
istat.it	esploradati.istat.it e fonti ISTAT (binario A).
openstreetmap.org	Mappe, civici, farmacie, percorsi.
cruscotto-italia.dati.gov.it	MCP 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.