Lezione 5 · Binario B

Dal fork al sito online

120 minuti

Dal fork al sito online. Questa è l'unica lezione del percorso che va provata prima. Fai il fork e il deploy a casa, fino in fondo, poi cancella tutto e rifallo in classe. Lo studente impara che cos'è un repository, un fork, un deploy, e verifica che un servizio funzioni interrogando direttamente un endpoint. Il cruscotto appena pubblicato è ancora generico: è il ponte per la lezione 6. Account GitHub e Vercel del docente, creati prima. Durata: 120 minuti.

Obiettivi

Al termine della lezione lo studente sa:

• spiegare che cos'è un repository e a che cosa serve la storia delle versioni;
• spiegare che cos'è un fork e perché non è una copia qualsiasi;
• descrivere che cosa succede quando un sito viene "messo online";
• verificare che un servizio funzioni interrogando direttamente un endpoint;
• riconoscere che il cruscotto appena pubblicato è ancora generico, e dire che cosa manca.

Prerequisiti

• Lezioni 1–2 (consigliate). Account GitHub e Vercel del docente, creati prima della lezione.

Svolgimento

Materiali. Proiettore · un dispositivo per gruppo · scheda studente 5 · guida al riuso · registrazione di riserva.

1. Apertura — 10 minuti. Proietta il cruscotto di San Vincenzo e poi la pagina GitHub del template. Domanda: «Questi due sono lo stesso programma. Che cosa cambia fra loro?» La risposta — cambia la configurazione, non il codice — è il concetto centrale delle lezioni 5 e 6.
2. Mini-lezione — 20 minuti. Repository: una cartella con dentro tutta la storia delle sue modifiche. Fork: una copia che ricorda da dove viene. Deploy: mettere il programma su un computer sempre acceso e collegato a internet. Template: il repository di Cruscotto Comune non è il cruscotto di San Vincenzo svuotato. È un progetto pensato per essere riusato.
3. Attività 1 — Il fork — 30 minuti. Dal profilo GitHub del docente, proiettato: fork di github.com/magiaslab/cruscotto-comune. Mentre si fa, chiedi a voce cosa vedono: il numero di fork, la licenza, l'ultimo commit, il file README. Sono tutte informazioni che nella lezione 1 avrebbero chiamato «metadati».
4. Attività 2 — Il deploy — 30 minuti. Import del repository su Vercel, deploy. Nessuna variabile d'ambiente obbligatoria: i KPI comunali arrivano dall'MCP pubblico di AgID. Mentre la build gira, fai compilare la prima parte della scheda studente: che cosa sta succedendo in questo momento?
5. Attività 3 — Lo smoke test — 20 minuti. Apri https://NOME-PROGETTO.vercel.app/api/kpi e guarda la risposta. È testo, non un sito: è il modo in cui il programma parla con altri programmi. Poi apri il sito vero. Domanda: «Di che comune è questo cruscotto?» La risposta è che non è di nessuno: è la configurazione di default.

Frase da portare a casa. Il codice è uguale per tutti i comuni. Quello che cambia è un file di configurazione. Domani lo compiliamo.

Cosa può andare storto

• github.com bloccato dal filtro scolastico. Non c'è workaround pulito. Prevenilo con il referente IT; se succede lo stesso, usa la registrazione di riserva e sposta il fork a casa.
• Build fallita. Leggi il log insieme alla classe invece di nasconderlo. Le cause più comuni sono il nome del progetto già usato e limiti dell'account gratuito.
• Il deploy ci mette più del previsto. Ecco perché la scheda studente ha una parte da compilare durante l'attesa.
• Uno studente chiede se può farlo dal suo account. Rispondi di no, e spiega perché: i termini di servizio (13 anni per GitHub, 16 per Vercel) e la responsabilità di quello che si pubblica.

Compito

Scrivere cinque righe: che cosa vuol dire che un sito è "online"? Dove si trova fisicamente?

Collegamenti disciplinari

• Informatica
• educazione civica (cittadinanza digitale, responsabilità di ciò che si pubblica)

DigComp 2.2

• area 3.1
• area 5

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.