# 18. Buone pratiche e risoluzione dei problemi

Questo capitolo raccoglie i consigli che fanno la differenza tra un orario faticoso
e uno costruito con serenità, e una guida ai problemi più comuni con le relative
soluzioni.

## Buone pratiche per un ottimo orario

### Cura i dati: è lì che si vince o si perde
La qualità dell'orario dipende quasi tutta dalla qualità dei dati in ingresso.
Prima di generare, verificate che:

- il **monte ore** di ogni classe sia corretto e **entri** nella griglia oraria;
- **ogni** materia di **ogni** classe abbia un/una **docente assegnato/a**;
- le **ore massime** dei docenti siano realistiche;
- le **indisponibilità** siano davvero indispensabili (vedete sotto).

### Distingui sempre vincoli rigidi e preferenze
È l'errore concettuale più frequente. Marca come **"non disponibile"** o come
**indisponibilità** solo le impossibilità reali. Tutto ciò che è "gradito ma non
obbligatorio" va espresso come **preferenza** ("da evitare", "preferito"). Troppi
vincoli rigidi sono la causa numero uno degli orari impossibili da generare.

### Parti semplice, poi raffina
Per il primo orario, usate il **preset predefinito** e l'ambito completo. Guardate il
risultato, individuate il punto debole dai [punteggi](14-comprendere-i-punteggi.md),
poi cambiate **un solo peso alla volta** e rigenerate. Così capite l'effetto di ogni
modifica.

### Lavorate per versioni
Non abbiate paura di generare molte versioni: costano poco e potete confrontarle. Tenete
le più promettenti, eliminate le altre per non fare confusione, e **finalizzate** solo
alla fine.

### Concedete tempo al motore sugli istituti grandi
Se l'istituto è grande, aumentate il **tempo massimo** di calcolo o restringete
l'**ambito** (genera una scuola alla volta). Più tempo e meno complessità aiutano
il motore a trovare soluzioni migliori.

### Valida sempre dopo le modifiche manuali
Ogni volta che [personalizzate](16-personalizzazione-orario.md) un orario, controllate
la scheda **Conflitti** ed eseguite la **validazione**: le modifiche manuali non sono
controllate in automatico.

## Risoluzione dei problemi

### Il motore non trova alcuna soluzione
Significa che i **vincoli rigidi sono in conflitto**: l'orario richiesto è
*impossibile*, non solo difficile. Controllate, in quest'ordine:

| Verifica | Cosa controllare |
|----------|------------------|
| Griglia oraria | Il totale delle ore di una classe **entra** nel numero di slot disponibili? Servono più ore nella settimana? Vedete [cap. 7](07-orari-e-campanella.md). |
| Indisponibilità | Ci sono docenti con troppe ore marcate "non disponibile"? Riducile all'essenziale. Vedete [cap. 10](10-docenti.md). |
| Ore massime | Le ore massime (settimanali/giornaliere) dei docenti sono sufficienti a coprire le loro assegnazioni? |
| Assegnazioni | Un/Una docente è assegnato/a a troppe classi rispetto al monte ore che può coprire? |
| Spostamenti | Per i multi-plesso, i tempi di viaggio sono compatibili con l'intervallo tra le ore? Vedete [cap. 11](11-spostamenti.md). |

Correggete il dato più sospetto e rigenerate. Procedete per tentativi, cambiando **una
cosa alla volta**.

### La qualità è bassa (composito basso, ma > 0)
L'orario è valido ma migliorabile. Aprite la scheda **Scores**
([cap. 14](14-comprendere-i-punteggi.md)), individuate la **categoria più bassa** e
aumentate il **peso** corrispondente nel preset, poi rigenerate. Ricordate che gli
obiettivi sono in parte in conflitto: migliorarne uno può peggiorarne un altro.

### Il punteggio composito è 0
C'è (almeno) una **violazione di un vincolo rigido**. Aprite la scheda **Conflitti**
([cap. 15](15-revisione-orario.md#scheda-conflitti-conflicts)): elenca esattamente
le violazioni. Succede tipicamente dopo una modifica manuale; correggete la lezione
segnalata e valida di nuovo.

### Il calcolo va in timeout senza una buona soluzione
L'istanza è troppo grande per il tempo concesso. Soluzioni: **aumentate il tempo
massimo**, oppure **restringete l'ambito** (genera meno scuole/classi per volta),
oppure semplifica i vincoli.

### Non vedo classi o materie nella generazione
Quasi sempre mancano i **monte ore** o le **assegnazioni docenti**. Tornate in
[Classi](09-classi.md) e verificate che ogni classe abbia le materie con le ore e il/la
docente.

### Un docente risulta sovraccarico
Controllate la scheda **Assignments** ([cap. 15](15-revisione-orario.md)) per vedere
il totale ore. Se supera il previsto, rivedete le sue **assegnazioni** in
[Classi](09-classi.md) o le sue **ore massime** in [Docenti](10-docenti.md).

### Le email delle preferenze non arrivano
Il sistema potrebbe essere in modalità di prova (le email vengono registrate ma non
spedite). Rivolgetevi a chi gestisce l'installazione. Nel frattempo potete inserire le
preferenze a mano dalla scheda del/della docente ([cap. 10](10-docenti.md)).

### Ho perso l'accesso / la sessione è scaduta
Reinserite le credenziali nella pagina di login ([cap. 3](03-primi-passi.md)). Se
le avete smarrite, contatta l'amministratrice e l'amministratore del sistema: non esiste un recupero
autonomo.

## Quando chiedere aiuto tecnico

Se un problema non rientra tra quelli qui sopra — per esempio errori di sistema,
pagine che non si caricano o comportamenti anomali — annota **cosa stavi facendo** e
**quale messaggio** avete visto, e contatta chi gestisce l'installazione del sistema
per il vostro istituto.

---

Consulta il glossario per un ripasso rapido dei termini.

---

[← Precedente: Esportazione](17-esportazione.md) · [Indice](README.md) · [Successivo: Glossario →](19-glossario.md)