📐 Didattica della Matematica Offline con KaTeX e WebApp Containerizzate

Obiettivo del Progetto

Creare un ambiente di apprendimento della matematica moderno, accessibile localmente o via rete domestica senza dipendere da connessioni internet esterne, con rendering tipografico perfetto delle formule matematiche ed esercizi interattivi per la scuola secondaria di primo grado.

---

🎯 Il Contesto Didattico: Dalla Teoria alla Pratica

La matematica nella scuola secondaria di primo grado (scuole medie) rappresenta il passaggio critico dall’aritmetica concreta all’astrazione algebrica e geometrica:

• Frazioni e numeri relativi.
• Teorema di Pitagora ed euclide nelle figure piane e solide.
• Equazioni di primo grado e modellizzazione di problemi reali.
• Calcolo delle probabilità e statistica descrittiva.

Spesso le piattaforme didattiche commerciali online soffrono di lentezze di caricamento, pubblicità, tracciamento o interruzioni in assenza di connessione stabile.

---

🏗️ Architettura del Sistema: Resilienza & Semplicità

Il sistema è basato su tre componenti integrati:

1. Motore KaTeX Offline:
   Il rendering delle formule matematiche avviene interamente client-side tramite font e librerie JavaScript KaTeX caricate localmente.
   Ad esempio, le formule di algebra e geometria:
   $x=\frac{-b\pm \sqrt{b^2-4ac}}{2a}$
   $V=\frac{1}{3}\pi r^{2}h$
   vengono visualizzate istantaneamente senza invocare server esterni (come MathJax via CDN o Google Fonts).

2. Database Domande & Distrattori Didattici:
   I quesiti sono tratti ed elaborati da archivi storici ufficiali (INVALSI, UbiMath, Kangourou della Matematica).
   Ogni domanda include:

   • Testo chiaro e formule KaTeX formattate.
   • 4 risposte a scelta multipla, con distrattori intelligenti (errori tipici di calcolo o comprensione).
   • Spiegazione step-by-step della risoluzione corretta.

3. WebApp Docker Always-On:
   L’applicativo gira in un container leggero su NAS domestico (porta 8082), accessibile da qualsiasi tablet, smartphone o computer della rete locale con persistenza su database SQLite.

---

💡 Valore Educativo: Feedback Immediato e Basso Attrito

L’obiettivo è trasformare lo studio della matematica in un’esperienza autonoma e incoraggiante: poter verificare subito il risultato di un problema e comprendere immediatamente l’errore senza frustrazione.