First version 2025.07.16

14-comprendere-i-punteggi.md

@@ -0,0 +1,87 @@
+# 14. Comprendere i punteggi di qualità
+
+Ogni versione di orario generata riceve dei **punteggi** che ne misurano la
+qualità. Capirli ti permette di **confrontare** le versioni e di scegliere con
+consapevolezza, invece di affidarti all'impressione. Questo capitolo spiega cosa
+significano, senza formule complicate.
+
+## Le due domande a cui rispondono i punteggi
+
+1. *L'orario è valido?* → lo dicono i **vincoli rigidi**.
+2. *Quanto è buono?* → lo dice il **punteggio composito** e la sua scomposizione
+   per categoria.
+
+## Il punteggio composito (0–100)
+
+Il **punteggio composito** riassume la qualità complessiva in un unico numero da
+**0 a 100**: più è alto, migliore è l'orario. È una **media pesata** dei singoli
+obiettivi di qualità, dove i "pesi" sono quelli che hai scelto nel preset di
+generazione ([cap. 13](13-generazione-orario.md)).
+
+> **La regola più importante.** Se un orario viola **anche un solo vincolo rigido**,
+> il suo punteggio composito è forzato a **0**, indipendentemente da quanto sia
+> buono sul resto. Un composito pari a 0 è quindi un campanello d'allarme: guarda
+> subito la scheda dei **conflitti** ([cap. 15](15-revisione-orario.md#scheda-conflitti-conflicts)).
+
+> **Il composito è assoluto.** Ogni versione è valutata per conto proprio, non "in
+> classifica" rispetto alle altre. Puoi quindi confrontare direttamente i compositi
+> di due versioni: 82 è meglio di 75.
+
+## Le categorie di qualità
+
+Il composito nasce dalla combinazione di più **categorie**, ciascuna delle quali
+misura un aspetto dell'orario con un valore da **0 a 1** (spesso mostrato come
+percentuale): **1 = pienamente soddisfatta**, **0 = del tutto disattesa**.
+
+| Categoria | Cosa misura |
+|-----------|-------------|
+| **Slot preferiti** | Quanti degli orari *preferiti* dai docenti sono stati effettivamente usati. |
+| **Slot da evitare** | Quanto si è riusciti a **non** usare gli orari che i docenti volevano evitare. |
+| **Preferenza mattino** | Quanta parte delle lezioni cade al mattino, per chi lo preferisce. |
+| **Orario compatto** | Quanto le lezioni di ogni docente sono consecutive, senza "buchi". |
+| **Tempo di viaggio** | Quanto sono contenuti gli spostamenti tra plessi. |
+| **Giorno libero** | Se il giorno libero preferito dal docente è stato rispettato. |
+| **Distribuzione delle classi** | Quanto le ore di una stessa classe sono distribuite su più giorni (invece di ammassarsi). |
+| **Tragitto casa-scuola** | Quanto è contenuto il tragitto da casa alle sedi. |
+
+> **Categorie non applicabili.** Se una categoria non riguarda un docente (per
+> esempio non ha indicato un giorno libero), per lui quella categoria vale come
+> pienamente soddisfatta e non penalizza il punteggio.
+
+## Dove leggi i punteggi
+
+- **Nella lista delle versioni** ([Revisione](15-revisione-orario.md)) vedi il
+  **composito** di ciascuna versione, utile per un confronto immediato.
+- **Nella scheda "Scores"** del dettaglio vedi la **scomposizione per categoria**
+  con grafici a barre e radar, e anche il **dettaglio per singolo docente**.
+
+> [Immagine: scheda Scores con grafico a barre delle categorie e grafico radar] —
+> Didascalia: la scomposizione mostra quali obiettivi sono soddisfatti e quali no.
+
+## Come usare i punteggi nella pratica
+
+- **Confronta due versioni** guardando prima il composito, poi le categorie: una
+  versione può avere composito più basso ma essere migliore proprio
+  sull'aspetto che a te sta più a cuore.
+- **Individua il punto debole:** la categoria con il valore più basso ti dice cosa
+  migliorare. Se, ad esempio, "Orario compatto" è basso, aumenta il peso della
+  compattezza nel preset e rigenera.
+- **Non inseguire il 100.** Gli obiettivi sono spesso in conflitto tra loro
+  (ridurre i buchi può aumentare gli spostamenti, e viceversa): un buon orario è un
+  **compromesso equilibrato**, non un punteggio perfetto ovunque.
+
+## Legame con i pesi della generazione
+
+I **pesi** scelti in fase di generazione decidono **quanto** ciascuna categoria
+incide sul composito. Alzare il peso di una categoria spinge il motore a curarla di
+più, tipicamente a scapito di altre. È il meccanismo con cui traduci le priorità
+del tuo istituto in numeri. Rivedi [Generazione — pesi](13-generazione-orario.md#passo-2--scegliere-il-preset-e-i-pesi).
+
+---
+
+Vediamo ora la pagina in cui tutti questi dati si consultano e si confrontano: la
+Revisione.
+
+---
+
+[← Precedente: Generazione dell'orario](13-generazione-orario.md) · [Indice](README.md) · [Successivo: Revisione e confronto →](15-revisione-orario.md)