Web-Writer Didattico

Manuale Operativo e Pedagogico Ufficiale
Ideazione e Architettura Didattica: Marco Guastavigna • Versione 1.0 (Edizione 2026)
Ambiente: HTML5 DOM Nativo, edge-tts Neurale HD, Multi-LLM (Google Gemini, Ollama, OpenAI, Groq)

1. Visione Pedagogica e Architettura a Zero Attrito

I software di videoscrittura tradizionali (come LibreOffice, Microsoft Word o OnlyOffice) sono nati per soddisfare le esigenze dei flussi di lavoro aziendali e burocratici. Se utilizzati nella pratica scolastica con allievi della scuola primaria, secondaria o con studenti con DSA (Disturbi Specifici dell'Apprendimento) e BES, questi applicativi presentano attriti cognitivi che ostacolano il processo di apprendimento:

Rendering rigido a canvas/pagine: la selezione del testo tende a desincronizzarsi o a perdersi non appena l'alunno interagisce con pannelli laterali o barre degli strumenti, provocando frustrazione e cancellazioni accidentali.
Sintesi vocali meccaniche (SAPI5): le voci sintetiche storiche di Windows risultano metalliche e prive di prosodia emotiva, costringendo la memoria di lavoro dell'alunno a decifrare l'audio anziché concentrarsi sul significato.
Separazione tra vista e udito: la lettura senza evidenziazione sincronizzata impedisce all'allievo di ancorare il suono alla parola scritta.

Il principio cardine del Web-Writer: il testo risiede direttamente nell'albero HTML (DOM nativo). Ogni operazione di estrazione, riformulazione, sostituzione e lettura avviene a tempo zero (0 ms) senza intermediari pesanti, garantendo la totale stabilità del focus di scrittura.

2. L'Ambiente di Videoscrittura e Metriche Gulpease

L'area di scrittura centrale simula un foglio bianco ergonomico privo di distrazioni.

🔤 Font ad Alta Leggibilità

Supporto immediato per Lexend (studiato per ridurre l'affollamento visivo e incrementare la velocità di decodifica) e OpenDyslexic (con base marcata per prevenire le rotazioni percettive delle lettere), oltre ai font classici (Arial, Segoe UI, Georgia).

📏 Righello di Lettura Guidata

Attivabile dal pulsante 📏 Righello: genera una barra orizzontale semitrasparente che segue fedelmente il puntatore del mouse, aiutando l'alunno a mantenere la riga ed evitando salti involontari.

Calcolo Scientifico dell'Indice Gulpease in Tempo Reale

Nella testata dell'applicazione è costantemente visibile l'indice di leggibilità Gulpease, calibrato scientificamente per la lingua italiana secondo la formula:

Gulpease = 89 - (10 * lettere / parole) + (300 * frasi / parole)

La barra orizzontale dinamica classifica visivamente il testo:

Punteggio	Grado di Comprensibilità	Livello Scolastico di Riferimento
Punti > 60	Facile	Accessibile con licenza elementare (Scuola Primaria).
Punti 40 - 60	Medio	Comprensibile per studenti con licenza media.
Punti < 40	Difficile	Accessibile solo con diploma superiore o livello universitario.

3. Motore Vocale Neurale HD ed Effetto Karaoke Bimodale

Il Web-Writer integra una sintesi vocale di nuova generazione basata su voci neurali Microsoft ad altissima fedeltà espressiva (tramite micro-server locale edge-tts):

👩 Isabella (Naturale Calda): timbro morbido, amichevole e rassicurante, ideale per la scuola primaria, per brani narrativi e studenti con dislessia.
👨 Diego (Naturale Espressivo): voce maschile ricca di intonazione, eccellente per la spiegazione di concetti storici e scientifici.
👩 Elsa (Naturale Articolata): voce fluente e autorevole per saggi e testi formali.
👨 Giuseppe (Naturale Giovane): timbro fresco e colloquiale.
🌐 Web Speech Fallback: qualora il server neurale non sia in esecuzione, l'app passa all'istante alle voci del browser di sistema senza interrompere il lavoro dell'alunno.

🎤 Lettura Karaoke Parola-per-Parola

Durante la riproduzione, ogni singola parola pronunciata si evidenzia in tempo reale in giallo tenue nel foglio. L'alunno collega immediatamente il suono udito al segno grafico, rafforzando l'ortografia e la decodifica.

📥 Esportazione Audio MP3

Un clic sul pulsante 📥 Scarica MP3 confeziona l'intera lettura del testo in un file audio compresso ad alta fedeltà, riascoltabile in mobilità su smartphone o tablet.

4. I Moduli dell'Assistente alla Mediazione Didattica

Sul lato destro della finestra è ancorata la barra dell'assistente, articolata in schede specializzate:

Scheda 1: ✍️ Riscrivi (Protocolli Scientifici di Mediazione)

Implementa i protocolli di riscrittura linguistica elaborati nella didattica dell'italiano (Mario Ambel 1991, Tullio De Mauro):

📖 Linguaggio Chiaro (Plain Language): riduce le frasi a un massimo di 20 parole, converte i verbi passivi in forma attiva ed elimina burocratismi oscuri.
🎯 De Mauro - Livello 1 (Lessico Base): vincola rigidamente il vocabolario alle parole del Vocabolario di Base della lingua italiana di Tullio De Mauro (massimo 15 parole per frase, sintassi SVO).
⚖️ Protocollo 2 - Sintassi Lineare: mantiene il lessico originale ma rende trasparenti e lineari i nessi coordinati (*e, ma, quindi, perché*).
🔬 Protocollo 3 - Sintassi Articolata: scandisce la coerenza argomentativa formale e la punteggiatura marcata per saggi o tesine.
🧬 Sintesi a Due Fonti (Testo A + B): memorizza un primo brano (pulsante 📥 Memorizza A), legge un secondo brano dal foglio e li fonde in un testo coerente ed essenziale.
📑 Riassunto Strutturato in Markdown: estrae i nuclei concettuali in punti elenco con parole chiave in grassetto.

Scheda 2: 💬 Chatta (Tutor RAG Maieutico)

Un tutor didattico interattivo ancorato al documento aperto:

Risponde a domande sul brano guidando l'alunno alla riflessione autonoma (metodo socratico).
Pulsante 📑 Indicizza Documento: aggiorna all'istante la memoria del modello sul testo corrente.

Scheda 3: 📊 Leggi (Metriche & Dettatura Vocale)

Oltre al dettaglio Gulpease, include la Dettatura Vocale Continua (Speech-to-Text): parlando al microfono, le parole vengono trascritte direttamente sul foglio alla posizione del cursore.

Scheda 4: 📽️ Slide per lo Studio

Estrae dal brano una sequenza di slide didattiche schematizzate (Titolo, Concetto Chiave, Elenco di Sintesi) visualizzabili con un comodo navigatore a carosello.

Scheda 5: 🎨 Prompt Immagini & UDL

Genera prompt visivi dettagliati da fornire a generatori di immagini IA (DALL-E, Midjourney, Stable Diffusion) secondo 3 stili didattici: Didattica Concettuale, Infografica Realistica e Metafora Visiva.

5. Guida alla Configurazione Multi-LLM (Scheda ⚙️ LLM)

Il Web-Writer offre la massima flessibilità di connessione ai motori di intelligenza artificiale:

✨ Google Gemini (Cloud Consigliato)

Velocissimo (1.5 - 2 secondi) e a costo zero per uso personale/didattico.

URL predefinito: https://generativelanguage.googleapis.com/v1beta
Incolla la tua chiave API Google AI Studio nel campo Chiave API.
Rilevamento Live dei Modelli: appena inserisci la chiave, il sistema scarica in tempo reale l'elenco dei modelli attivi per il tuo account e seleziona in automatico gemini-2.5-flash o gemini-2.0-flash.
Carico RAM = 0 MB: lavora interamente sul cloud Google; non appesantisce la memoria del computer.

🦙 Ollama (Locale Offline)

100% offline, privato e gratuito. Ideale per aule scolastiche senza connessione.

URL predefinito: http://127.0.0.1:11434
Nessuna chiave API richiesta.
Facendo clic sul pulsante 🔄, vengono rilevati i modelli installati sul tuo PC (es. llama3:latest, gemma2:2b, PLUS_Redattore_Plain_Language).
Carico Locale: richiede 2–4 GB di memoria RAM/VRAM per l'inferenza del modello.

Trasparenza e Monitoraggio in Tempo Reale

Durante qualsiasi richiesta di riscrittura o chat:

Il banner di stato in cima all'assistente si attiva mostrando il timer dei secondi e la destinazione precisa (☁️ Cloud Gemini oppure 💻 Locale Ollama).
Il riquadro di output scorre automaticamente in primo piano e informa l'utente sull'avanzamento.
Il pulsante `⏹ Ferma` consente di interrompere la richiesta in qualsiasi istante.

6. Modalità di Avvio e Installazione a 1-Click

Avvio Rapido Desktop su Windows

Per lanciare il Web-Writer Didattico come un programma standalone indipendente:

Estrai l'archivio ZIP WebWriterDidattico_Distribuzione_Completa_v1.0.zip in una cartella a tua scelta (es. Desktop o cartella Documenti).
Fai doppio clic sul file Avvia_WebWriterDidattico.bat.
Il comando avvia in background il server vocale neurale server_tts.py e apre Microsoft Edge in modalità Desktop App (finestra pulita, priva di schede del browser e barre dell'URL).

Avvio da Browser Convenzionale

Puoi anche fare doppio clic direttamente sul file index.html con un qualsiasi browser web (Google Chrome, Microsoft Edge, Mozilla Firefox, Safari). L'applicazione funzionerà regolarmente con la sintesi vocale interna del browser.

7. Privacy e Tutela dei Dati (GDPR)

Conservazione Locale delle Chiavi: le chiavi API (Google Gemini, OpenAI, Groq) vengono archiviate unicamente nel localStorage del browser del computer in uso. Non vengono mai condivise con server esterni, telemetrie o sviluppatori terzi.
Nessun Tracciamento: l'applicativo non utilizza tracker, cookie di terze parti o librerie esterne invasive.
Elaborazione Locale Privata: utilizzando Ollama, i compiti e i testi scritti dagli studenti rimangono al 100% all'interno del computer scolastico, garantendo la piena tutela dei dati dei minori.

Web-Writer Didattico • Progetto educativo ideato da Marco Guastavigna • Rilascio v1.0 Completo