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,98 @@
+# 10. Docenti e preferenze
+
+I **docenti** sono le persone che insegnano le materie alle classi. In questa
+pagina gestisci la loro anagrafica, i limiti contrattuali e — se vuoi inserirle tu
+stesso — le loro preferenze e indisponibilità.
+
+> Voce di menu: **Configuration → Teachers**.
+
+## Creare un docente
+
+1. Apri **Teachers** dal menu.
+2. Clicca **+ New Teacher** (Nuovo docente).
+3. Compila i dati principali:
+   - **Nome** e **Cognome** — es. `Mario` `Rossi`.
+   - **Email** — es. `mario.rossi@scuola.it`. Serve per inviargli l'invito a
+     compilare le preferenze (vedi [Raccolta preferenze](12-raccolta-preferenze.md)).
+   - **Ore settimanali massime (Max Weekly Hours)** — es. `18`. È il tetto di ore
+     che il docente può insegnare a settimana.
+   - **Giorno libero (Free Day)** *(facoltativo)* — il giorno della settimana che
+     il docente preferirebbe tenere libero. È una **preferenza**, non una garanzia.
+   - **Latitudine / Longitudine di casa** *(facoltative)* — la posizione
+     dell'abitazione, usata per stimare i tempi di spostamento casa→scuola.
+4. Salva.
+
+> [Immagine: finestra di creazione docente con nome, email, ore massime e giorno
+> libero] — Didascalia: l'email è necessaria per la raccolta delle preferenze.
+
+## Limiti che diventano vincoli rigidi
+
+Alcuni dati del docente sono trattati come **vincoli rigidi** in fase di
+generazione:
+
+- le **ore settimanali massime** e le **ore giornaliere massime** non vengono mai
+  superate;
+- le **indisponibilità** dichiarate (vedi sotto) sono assolute.
+
+Altri dati sono invece **preferenze** (obiettivi di qualità), come il **giorno
+libero** o gli orari graditi: il sistema cerca di rispettarli, ma può derogare se
+necessario per trovare una soluzione valida. Per la distinzione vedi
+[Introduzione](01-introduzione.md#vincoli-obbligatori-e-preferenze-la-distinzione-più-importante).
+
+## Le preferenze del docente
+
+Ogni docente ha una sezione **Preferences** (preferenze), che apri dalla sua riga
+nell'elenco (*"Preferences — Mario Rossi"*). Vi si trovano:
+
+1. **Preferenze sugli slot** — per ogni giorno e ora, il docente può indicare:
+   *neutrale*, *preferito*, *da evitare* oppure *non disponibile*. Possono anche
+   essere riferite a una classe specifica.
+2. **Preferenze sulle sedi** — un ordine di gradimento tra i plessi (utile negli
+   istituti con più scuole).
+3. **Caratteristiche dell'orario** — per esempio la preferenza per le ore del
+   **mattino** e la preferenza per un orario **compatto** (senza "buchi").
+4. **Indisponibilità assolute** — i periodi in cui il docente non può proprio
+   esserci: sono un **vincolo rigido**.
+
+> **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
+> vincoli rigidi (mai violati). Usa "non disponibile" solo per impossibilità reali,
+> altrimenti rischi di rendere l'orario impossibile da costruire.
+
+> [Immagine: editor delle preferenze del docente con la griglia giorni × ore] —
+> Didascalia: la griglia degli slot permette di marcare ogni ora come preferita,
+> da evitare o non disponibile.
+
+## Due modi per raccogliere le preferenze
+
+Hai due possibilità, che puoi anche combinare:
+
+1. **Inserimento diretto** — compili tu le preferenze dalla scheda del docente,
+   come appena descritto. Comodo per pochi docenti o per correzioni puntuali.
+2. **Campagna di raccolta** — inviti i docenti a compilare da soli un modulo online
+   (vedi [Raccolta preferenze dei docenti](12-raccolta-preferenze.md)). Consigliato
+   quando i docenti sono molti.
+
+## Modificare o eliminare
+
+- **Cerca** un docente con la barra di ricerca.
+- **Modifica** per aggiornare anagrafica, limiti o preferenze.
+- **Elimina** con conferma. Se il docente è assegnato a delle classi, valuta prima
+  di rimuoverlo: quelle materie resterebbero senza insegnante.
+
+## Consiglio pratico
+
+Inserisci **ore massime realistiche** e usa le indisponibilità con parsimonia. La
+causa più comune di un orario "impossibile da generare" sono limiti e
+indisponibilità troppo stringenti che, sommati, non lasciano spazio a una
+soluzione valida (vedi [Buone pratiche e problemi](18-buone-pratiche-e-problemi.md)).
+
+---
+
+Se il tuo istituto ha più plessi, il prossimo passo è definire i tempi di
+spostamento tra le sedi.
+
+---
+
+[← Precedente: Classi](09-classi.md) · [Indice](README.md) · [Successivo: Distanze e spostamenti →](11-spostamenti.md)