Added screenshots

03-primi-passi.md

@@ -14,6 +14,8 @@ quello fornito da chi ha installato il sistema per il tuo istituto.
 3. Inserisci **nome utente e password** che ti sono stati forniti.
 4. Premi **Accedi**.
 
+![Pagina di accesso](img/login.png)
+
 Alcune indicazioni utili:
 
 - **Non esiste una registrazione autonoma.** L'utente amministratore viene creato

04-anni-scolastici.md

@@ -29,6 +29,8 @@ qui.
      etichetta.
 4. Salva.
 
+![Elenco anni scolastici](img/academic-years.png)
+
 ## Modificare o eliminare
 
 - **Modifica:** usa l'icona di modifica accanto all'anno per correggere

05-scuole.md

@@ -22,6 +22,9 @@ Questi tempi diventano poi vincoli e obiettivi durante la generazione (vedi
 
 1. Apri **Schools** dal menu.
 2. Clicca **+ New School** (Nuova scuola).
+
+![Elenco scuole](img/schools.png)
+
 3. Compila i campi:
    - **Nome** — es. `Liceo Scientifico`, `Sede centrale`, `Succursale Via Verdi`.
    - **Indirizzo** — es. `Via Roma 1, 00100 Roma`.
@@ -29,6 +32,8 @@ Questi tempi diventano poi vincoli e obiettivi durante la generazione (vedi
      gradi decimali (es. `41.8902`, `12.4964`).
 4. Salva.
 
+![Form di creazione scuola](img/schools-add.png)
+
 ## Coordinate: quando servono
 
 - **Un solo plesso:** le coordinate non incidono sull'orario; puoi lasciarle

06-aule-e-laboratori.md

@@ -33,6 +33,9 @@ in palestra alla stessa ora.
 2. In alto puoi **filtrare per scuola** per vedere le facility di un plesso
    specifico.
 3. Clicca **+ New Facility** (Nuova facility).
+
+![Elenco facility](img/facilities.png)
+
 4. Compila:
    - **Scuola** — a quale plesso appartiene la stanza.
    - **Nome** — es. `Palestra A`, `Laboratorio di Chimica`.
@@ -41,6 +44,8 @@ in palestra alla stessa ora.
      caratteri).
 5. Salva.
 
+![Form di creazione facility](img/facilities-add.png)
+
 > **Attenzione.** La **scuola non è modificabile** dopo la creazione. Se sbagli
 > plesso, elimina la facility e ricreala.
 

07-orari-e-campanella.md

@@ -33,6 +33,8 @@ In alto nella pagina devi selezionare **l'anno scolastico** e la **scuola** di c
 vuoi definire gli orari. Finché non li scegli, la pagina ti invita a farlo e non
 mostra alcuna griglia.
 
+![Griglia slot orari](img/time-slots.png)
+
 ## Creare gli slot in blocco (consigliato)
 
 Il modo più veloce per impostare una giornata tipo è generare più slot in una volta:
@@ -45,6 +47,8 @@ Il modo più veloce per impostare una giornata tipo è generare più slot in una
    - **Numero del primo periodo** (di solito `1`).
 3. Conferma con **Add Slots**.
 
+![Form aggiunta slot multipli](img/time-slot-add.png)
+
 Il sistema crea automaticamente gli slot consecutivi calcolando gli orari. Ripeti
 l'operazione se alcuni giorni hanno un numero di ore diverso.
 

08-materie.md

@@ -20,12 +20,17 @@ Per questo le materie vanno create **prima** di configurare le classi e i docent
 
 1. Apri **Subjects** dal menu.
 2. Clicca **+ New Subject** (Nuova materia).
+
+![Elenco materie](img/subjects.png)
+
 3. Compila:
    - **Nome** — es. `Matematica`.
    - **Codice** *(facoltativo)* — una sigla breve, es. `MAT`. Se lo usi deve
      essere **univoco** (max 50 caratteri).
 4. Salva.
 
+![Form di creazione materia](img/subjects-add.png)
+
 ## Come nominare le materie
 
 - Usa nomi **uniformi** in tutto l'istituto: scegli, per esempio, sempre

09-classi.md

@@ -17,6 +17,9 @@ docenti**: sono le informazioni più importanti per la generazione.
 1. Apri **Class Groups** dal menu. In alto seleziona l'**anno scolastico**; puoi
    filtrare per **scuola**.
 2. Clicca **+ New Class Group** (Nuova classe).
+
+![Elenco classi](img/class-groups.png)
+
 3. Compila:
    - **Scuola** — a quale plesso appartiene la classe.
    - **Nome** — es. `1A`, `3B` (max 20 caratteri).
@@ -24,6 +27,8 @@ docenti**: sono le informazioni più importanti per la generazione.
      `5`.
 4. Salva.
 
+![Form di creazione classe](img/class-groups-add.png)
+
 > **Attenzione.** La **scuola non è modificabile** dopo la creazione della classe.
 
 ## Il monte ore (Teachings / Requirements)
@@ -41,6 +46,8 @@ Qui definisci, materia per materia, quante ore settimanali servono alla classe:
 Se non hai ancora definito nulla, vedrai il messaggio *"No requirements defined
 yet"* (nessun monte ore definito).
 
+![Finestra monte ore e assegnazione docenti](img/class-group-teachings.png)
+
 > **Regola fondamentale.** Il monte ore è un **vincolo rigido**: il sistema
 > collocherà **esattamente** quel numero di ore per materia, né una di più né una
 > di meno. Controlla bene i totali: la somma delle ore di tutte le materie è il

10-docenti.md

@@ -10,6 +10,9 @@ stesso — le loro preferenze e indisponibilità.
 
 1. Apri **Teachers** dal menu.
 2. Clicca **+ New Teacher** (Nuovo docente).
+
+![Elenco docenti](img/teachers.png)
+
 3. Compila i dati principali:
    - **Nome** e **Cognome** — es. `Mario` `Rossi`.
    - **Email** — es. `mario.rossi@scuola.it`. Serve per inviargli l'invito a
@@ -22,6 +25,8 @@ stesso — le loro preferenze e indisponibilità.
      dell'abitazione, usata per stimare i tempi di spostamento casa→scuola.
 4. Salva.
 
+![Form di creazione docente](img/teachers-add.png)
+
 ## Limiti che diventano vincoli rigidi
 
 Alcuni dati del docente sono trattati come **vincoli rigidi** in fase di
@@ -51,6 +56,8 @@ nell'elenco (*"Preferences — Mario Rossi"*). Vi si trovano:
 4. **Indisponibilità assolute** — i periodi in cui il docente non può proprio
    esserci: sono un **vincolo rigido**.
 
+![Scheda preferenze del docente](img/teachers-preferences.png)
+
 > **Neutrale / preferito / da evitare / non disponibile.** Attenzione alla
 > differenza: *"da evitare"* è una preferenza (il sistema cerca di rispettarla ma
 > può ignorarla), mentre *"non disponibile"* e le indisponibilità assolute sono

11-spostamenti.md

@@ -41,6 +41,8 @@ Per ogni coppia di scuole imposti il tempo di percorrenza:
 3. Indica i **minuti di viaggio (Travel Minutes)**.
 4. Salva.
 
+![Matrice tempi di viaggio](img/travel-matrix.png)
+
 I filtri in alto (From / To, con l'opzione *"Anywhere"* per non filtrare) ti
 aiutano a trovare rapidamente la coppia che ti interessa quando le scuole sono
 molte.

12-raccolta-preferenze.md

@@ -31,6 +31,8 @@ Crea → Invita i docenti → Invia le email → [I docenti rispondono] → Moni
 2. Crea una nuova campagna: scegli l'**anno scolastico** di riferimento e assegna
    un **nome** riconoscibile (es. `Preferenze 2025/2026`).
 
+![Elenco campagne](img/campaign.png)
+
 ## Passo 2 — Invitare i docenti
 
 Seleziona, dall'elenco dei docenti inseriti in [Docenti](10-docenti.md), quelli che
@@ -67,6 +69,8 @@ l'altro:
 Sono le stesse informazioni che potresti inserire tu dalla scheda del docente
 ([Docenti](10-docenti.md)); qui però le fornisce direttamente l'interessato.
 
+![Modulo preferenze del docente](img/preferences-form.png)
+
 ## Passo 5 — Monitorare le risposte
 
 Aprendo il **dettaglio della campagna** vedi, per ciascun invitato, se ha già
@@ -75,6 +79,8 @@ risposto oppure no. Usa questa vista per:
 - sollecitare chi è in ritardo;
 - decidere quando "chiudere" la raccolta e passare alla generazione.
 
+![Dettaglio campagna con stato risposte](img/campaign-details.png)
+
 > **Non serve aspettare il 100%.** Puoi generare l'orario anche se non tutti hanno
 > risposto: per i docenti senza preferenze il sistema semplicemente non avrà
 > obiettivi da rispettare, ma l'orario resterà comunque valido.

13-generazione-orario.md

@@ -39,6 +39,8 @@ scegliere quanto tempo concedergli.
 > volta è utile per fare prove veloci o per programmare in modo incrementale
 > (generi e "congeli" una parte, poi procedi con il resto).
 
+![Pagina di generazione — scelta ambito](img/generate.png)
+
 ## Passo 2 — Scegliere il preset e i pesi
 
 Un **preset** è una configurazione salvata che dice al sistema **quanto** dare
@@ -68,6 +70,8 @@ Le principali impostazioni tecniche sono:
 
 Puoi partire dai valori predefiniti e regolarli in base ai risultati.
 
+![Opzioni e pesi del solutore](img/generate-options.png)
+
 ## Passo 4 — Avviare e seguire l'avanzamento
 
 Premi **Generate** (Genera). Durante il lavoro vedrai un **avanzamento in tempo
@@ -81,6 +85,8 @@ Lascia la pagina aperta durante il calcolo. Se la connessione in tempo reale
 dovesse interrompersi, il sistema continua comunque a lavorare e aggiorna lo stato
 periodicamente.
 
+![Avanzamento in tempo reale](img/generate-running.png)
+
 ## Passo 5 — Leggere l'esito
 
 Al termine, il riepilogo mostra:

14-comprendere-i-punteggi.md

@@ -55,6 +55,8 @@ percentuale): **1 = pienamente soddisfatta**, **0 = del tutto disattesa**.
 - **Nella scheda "Scores"** del dettaglio vedi la **scomposizione per categoria**
   con grafici a barre e radar, e anche il **dettaglio per singolo docente**.
 
+![Scheda Scores con grafici e scomposizione](img/review-report.png)
+
 ## Come usare i punteggi nella pratica
 
 - **Confronta due versioni** guardando prima il composito, poi le categorie: una

15-revisione-orario.md

@@ -18,6 +18,8 @@ ciascuna sono indicati:
 Espandendo una versione ne vedi una sintesi della valutazione. È qui che confronti
 "a colpo d'occhio" le alternative prima di aprirne una.
 
+![Elenco versioni generate](img/review.png)
+
 ## Gli stati di una versione
 
 | Stato | Significato |
@@ -42,6 +44,8 @@ vista per:
 Ogni cella mostra l'assegnazione: materia, docente e — se prevista — l'aula/
 laboratorio. È la vista che userai di più per controllare "a occhio" l'orario.
 
+![Dettaglio versione — griglia orario](img/review-details.png)
+
 ### Scheda punteggi (Scores)
 La scomposizione della qualità con grafici (barre e radar) e il **dettaglio per
 docente**. Serve a capire i punti di forza e di debolezza della versione. Per