La Scuola Amica — Wiki tecnica

Documentazione tecnica del progetto lascuolaamica.it.

---

Pagine della wiki

Pagina	Contenuto
Architettura	Struttura frontend, quiz engine unificato, gestione dati
Installazione e deploy	Avvio locale, build e pubblicazione
Contenuti e domande	Pipeline editoriale, regole qualità, formato JSON
Sicurezza, privacy e minori	Privacy-by-design, tutela minori e controlli di sicurezza
Runbook release	Checklist pre-merge, deploy, rollback

---

Il progetto in sintesi

La Scuola Amica è una piattaforma educativa gratuita per la scuola primaria italiana. Quiz a risposta multipla su 8 materie (matematica, italiano, inglese, problemi, civica, geografia, storia, scienze), per le classi dalla 2ª alla 5ª. Include anche due giochi: "Cervellino Spacca-Muri" (/breakout), un arcade che riusa lo stesso pool di domande per i suoi bonus, e "Il Bosco delle Lettere" (/bosco), un gioco di ortografia per la 2ª e la 3ª con un banco di parole tutto suo.

9.926 domande validate, costruite sulle Indicazioni Nazionali del 2012; revisione sulle nuove Indicazioni (DM 221/2025, dall’a.s. 2026/27) in corso.

Principi tecnici fondamentali:

• Statico — nessun server applicativo, nessun database. Solo HTML, CSS, JavaScript e JSON.
• PWA offline-first — funziona dopo il primo caricamento, su qualsiasi dispositivo.
• Privacy-by-design — nessuna registrazione, nessun cookie di terze parti, dati di gioco salvati solo nella memoria locale del browser.
• Bacheca premi locale — badge, coccarde, coppe e trofei sbloccati sul dispositivo, esportabili come immagine.
• WCAG 2.1 AA — validata manualmente con tastiera, screen reader e riduzione movimento.
• Zero dipendenze runtime — JavaScript vanilla, font self-hosted.

---

Repository e pubblicazione

• Repo: GitHub (branch main)
• Hosting: piattaforma statica con pubblicazione automatica da main
• Build: bash scripts/export_for_cloudflare.sh → directory export/
• Sicurezza: gestita a livello infrastrutturale con regole e controlli dedicati