First version 2025.07.16

2026-07-16 00:06:33 +02:00
commit 8551382c77
20 changed files with 1840 additions and 0 deletions
@@ -0,0 +1,63 @@
+# Manuale d'uso — Generatore di orario scolastico
+
+Benvenuto nel manuale del sistema di **pianificazione e ottimizzazione dell'orario
+scolastico**. Questo strumento aiuta chi si occupa dell'orario (la cosiddetta
+"funzione strumentale orario", un collaboratore del Dirigente o chiunque abbia
+questo incarico) a costruire un orario di qualità per un istituto composto da una
+o più scuole, riducendo drasticamente il lavoro manuale.
+
+Il sistema raccoglie i dati della scuola (aule, classi, materie, docenti, monte
+ore) e le preferenze dei docenti, quindi genera automaticamente uno o più orari
+che rispettano tutti i **vincoli obbligatori** e cercano di massimizzare la
+**qualità complessiva** (meno spostamenti, meno "buchi", rispetto delle
+preferenze). Tu resti sempre al comando: puoi confrontare le versioni, correggerle
+a mano ed esportarle.
+
+## Come leggere questo manuale
+
+Il manuale è pensato per essere letto **in ordine** la prima volta: i capitoli
+seguono la sequenza reale di lavoro, dall'inserimento dei dati fino all'orario
+finale esportato. Ogni pagina termina con i collegamenti alla pagina
+**precedente** e **successiva**, oltre che a questo indice.
+
+Se hai già dimestichezza con lo strumento, usa l'indice qui sotto per saltare
+direttamente all'argomento che ti interessa.
+
+> **Nota sulle immagini.** In questo manuale le schermate sono indicate con
+> segnaposto del tipo `[Immagine: ...]`. Sostituiscili con le catture reali
+> dell'interfaccia della tua installazione quando distribuisci il manuale.
+
+## Indice
+
+### Parte 1 — Introduzione e orientamento
+1. [Introduzione: cos'è questo sistema](01-introduzione.md) — cosa fa lo strumento, il contesto della scuola italiana e il vocabolario di base.
+2. [Panoramica: dal dato all'orario finale](02-panoramica-del-processo.md) — la sequenza completa di lavoro, dall'inizio alla fine.
+3. [Primi passi: accesso e interfaccia](03-primi-passi.md) — come accedere, muoversi tra le sezioni e cambiare lingua.
+
+### Parte 2 — Preparare i dati (Configurazione)
+4. [Anni scolastici](04-anni-scolastici.md) — l'anno di riferimento a cui appartengono tutti i dati.
+5. [Scuole](05-scuole.md) — gli edifici dell'istituto.
+6. [Aule e laboratori](06-aule-e-laboratori.md) — le aule speciali richieste da alcune materie.
+7. [Orari e campanella](07-orari-e-campanella.md) — la griglia giorni × ore di ogni scuola.
+8. [Materie](08-materie.md) — le discipline insegnate.
+9. [Classi, monte ore e assegnazione docenti](09-classi.md) — le classi, le ore per materia e chi insegna cosa.
+10. [Docenti e preferenze](10-docenti.md) — l'anagrafica dei docenti e i loro vincoli.
+11. [Distanze e spostamenti](11-spostamenti.md) — i tempi di viaggio tra scuole e da casa.
+
+### Parte 3 — Preferenze dei docenti
+12. [Raccolta preferenze dei docenti](12-raccolta-preferenze.md) — le campagne per invitare i docenti a compilare le loro preferenze.
+
+### Parte 4 — Generare e rivedere l'orario
+13. [Generazione dell'orario](13-generazione-orario.md) — avviare l'ottimizzatore e seguirne l'avanzamento.
+14. [Comprendere i punteggi di qualità](14-comprendere-i-punteggi.md) — come leggere e confrontare la qualità delle versioni.
+15. [Revisione e confronto delle versioni](15-revisione-orario.md) — analizzare l'orario, finalizzarlo o eliminarlo.
+16. [Personalizzazione manuale](16-personalizzazione-orario.md) — correggere a mano una versione.
+17. [Esportazione in foglio di calcolo](17-esportazione.md) — scaricare l'orario in Excel o OpenDocument.
+
+### Parte 5 — Consigli e riferimenti
+18. [Buone pratiche e risoluzione dei problemi](18-buone-pratiche-e-problemi.md) — come ottenere un buon primo orario e cosa fare quando qualcosa non torna.
+19. [Glossario](19-glossario.md) — i termini chiave spiegati in breve.
+
+---
+
+[Inizia dal capitolo 1: Introduzione →](01-introduzione.md)