Lezione 6 · Binario B

Configurare l'identità del comune

120 minuti

Configurare l'identità del comune. Il programma non sa niente di nessun comune. Sa leggere un file e comportarsi di conseguenza. Cambiare la configurazione non è «programmare meno»: è il modo giusto di far funzionare la stessa cosa in ottomila posti diversi. La classe trova il codice ISTAT, il codice catastale e le coordinate, decide quali moduli hanno senso per il proprio territorio e riconosce l'obbligo di citare il progetto originale. Prerequisito: lezione 5, cruscotto già online. Durata: 120 minuti.

Obiettivi

Al termine della lezione lo studente sa:

• leggere e modificare un file JSON senza romperlo;
• spiegare perché configurazione e codice sono cose separate;
• trovare il codice ISTAT, il codice catastale e le coordinate del proprio comune;
• decidere quali moduli hanno senso per il proprio territorio e quali vanno spenti;
• riconoscere l'obbligo di citare il progetto originale.

Prerequisiti

• Lezione 5. Il cruscotto della classe deve essere già online.

Svolgimento

Materiali. Proiettore · un dispositivo per gruppo · scheda studente 6 · un validatore JSON online · config/comune.example.json proiettato.

1. Apertura — 10 minuti. Proietta config/comune.example.json. È lungo e a prima vista incomprensibile: dillo tu, prima che lo pensino loro. Poi mostra che è fatto di poche cose ripetute: nomi fra virgolette, due punti, valori. Domanda: «Secondo voi quale riga fa comparire il nome del nostro comune?»
2. Mini-lezione — 25 minuti. Che cos'è JSON. Tre regole: le chiavi stanno fra virgolette; i valori possono essere testo, numeri, true/false, elenchi o altri blocchi; niente virgola dopo l'ultimo elemento. Configurazione contro codice. Le chiavi che contano: istat_code, nome, provincia, regione, miur_codice_catastale, farmacie_di_turno_cod, geo.*, brand.*, site.mode, fork.maintainer_*, features.*. Menzioni: src/lib/project-origin.ts non va modificato.
3. Attività 1 — La configurazione su carta — 20 minuti. Prima di toccare il computer, ogni gruppo compila su carta la propria parte (scheda studente 6): chi cerca il codice ISTAT, chi le coordinate, chi decide i moduli, chi scrive i dati del fork. Farlo su carta prima serve a due cose: si divide il lavoro e non si rompe il JSON.
4. Attività 2 — La configurazione vera — 35 minuti. Si mettono insieme i pezzi in config/comune.json (copiato da config/comune.example.json). Si valida il file con un validatore JSON prima di salvarlo. Commit. Vercel ricostruisce da solo.
5. Attività 3 — Gli interruttori — 20 minuti. Guardate insieme la lista features e decidete quali spegnere. Regola d'oro: un modulo acceso senza i dati giusti è peggio di un modulo spento. Un pannello vuoto o con dati di un altro comune fa danno alla credibilità di tutto il cruscotto.

Frase da portare a casa. Confrontate con le tre cose che non vanno bene annotate nella lezione 5: quante sono state risolte?

Cosa può andare storto

• JSON non valido. Virgola di troppo, virgolette sbagliate, parentesi non chiusa. Il validatore dice la riga. Non correggere tu: fallo trovare a loro, è l'esercizio.
• Il comune non compare nei dati. Quasi sempre il codice ISTAT è sbagliato o gli sono stati tolti gli zeri iniziali. Verifica su /api/kpi.
• terrain_sea_side sbagliato. Il rendering del territorio esce strano. Una configurazione sbagliata non dà errore, dà un risultato plausibile ma falso.
• Lo stemma non si può usare. Non forzare. Lasciare il segnaposto è la scelta corretta e didatticamente migliore.

Compito

Scrivere in cinque righe che cosa succederebbe se domani cambiassimo solo il codice ISTAT nel file di configurazione.

Collegamenti disciplinari

• Informatica (formati dati, versionamento)
• geografia (coordinate, confini)
• educazione civica (attribuzione, licenze)

DigComp 2.2

• area 3.1
• area 3.3

Materiali di questa lezione

• Binario B — lezioni 5–8 e schede studente — Markdown su GitHub (02-binario-b-lezioni.md)

Torna a Costruire il cruscotto

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