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,93 @@
+# 7. Orari e campanella
+
+Gli **slot orari** (Time Slots) definiscono la **griglia** temporale in cui il
+sistema colloca le lezioni: quali giorni si fa lezione e in quali ore. In pratica,
+qui riproduci l'**orario delle campanelle** di ciascuna scuola.
+
+> Voce di menu: **Configuration → Time Slots**.
+
+## Il concetto di slot
+
+Uno **slot** è la combinazione di un **giorno** e di un'**ora (periodo)**. Per
+esempio: *lunedì, 1ª ora, 8:00–8:55*. L'insieme di tutti gli slot forma la griglia
+vuota che l'ottimizzatore riempirà con le lezioni.
+
+```
+        Lun    Mar    Mer    Gio    Ven
+  1ª  [8:00] [8:00] [8:00] [8:00] [8:00]
+  2ª  [8:55] [8:55] [8:55] [8:55] [8:55]
+  3ª   ...    ...    ...    ...    ...
+```
+
+Caratteristiche importanti:
+
+- Gli slot sono definiti **per scuola**: plessi diversi possono avere campanelle
+  diverse.
+- Ogni slot appartiene a un **anno scolastico**.
+- Ogni slot ha un **numero di periodo** (1 = prima ora), un **orario di inizio** e
+  una **durata**.
+
+## Prima di iniziare
+
+In alto nella pagina devi selezionare **l'anno scolastico** e la **scuola** di cui
+vuoi definire gli orari. Finché non li scegli, la pagina ti invita a farlo e non
+mostra alcuna griglia.
+
+> [Immagine: pagina Time Slots con i selettori di anno e scuola in alto] —
+> Didascalia: gli slot mostrati dipendono dall'anno e dalla scuola selezionati.
+
+## Creare gli slot in blocco (consigliato)
+
+Il modo più veloce per impostare una giornata tipo è generare più slot in una volta:
+
+1. Clicca **+ Add Multiple Slots** (Aggiungi più slot).
+2. Indica:
+   - **Orario di inizio** della prima ora (es. `08:00`);
+   - **Durata (minuti)** di ogni ora (es. `55` o `60`);
+   - **Numero di periodi** da creare (es. `6`);
+   - **Numero del primo periodo** (di solito `1`).
+3. Conferma con **Add Slots**.
+
+Il sistema crea automaticamente gli slot consecutivi calcolando gli orari. Ripeti
+l'operazione se alcuni giorni hanno un numero di ore diverso.
+
+> **Nota sulle pause.** Se vuoi rappresentare l'intervallo, imposta gli orari in
+> modo che tra un'ora e l'altra resti il tempo dell'intervallo, oppure semplicemente
+> non creare uno slot in corrispondenza della ricreazione. La griglia deve
+> rispecchiare le ore in cui si fa **effettivamente lezione**.
+
+## Creare o modificare un singolo slot
+
+- **+ New Slot** crea un singolo slot: scegli numero di periodo, giorno, orario di
+  inizio e fine.
+- L'icona di **modifica** su uno slot esistente permette di correggerne gli orari.
+- L'icona di **eliminazione** lo rimuove.
+
+La pagina mostra un riepilogo del tipo *"X slot su Y periodi"* per aiutarti a
+controllare la coerenza della griglia.
+
+## Perché la griglia è così importante
+
+La qualità dell'orario dipende molto dalla griglia:
+
+- Se definisci **poche ore**, il sistema potrebbe non riuscire a collocare tutto il
+  monte ore delle classi (orario **non ammissibile**).
+- Se definisci **troppe ore** rispetto al necessario, il sistema avrà più libertà,
+  ma potrebbero comparire più "buchi" da gestire con le preferenze di compattezza.
+
+L'obiettivo è riprodurre fedelmente l'orario reale delle campanelle della scuola.
+
+## Consiglio pratico
+
+Definisci gli slot **coerentemente per tutte le scuole** coinvolte prima di
+generare l'orario. Se un docente lavora su due plessi con campanelle sfasate,
+è proprio grazie a questi orari che il sistema calcola se ha il tempo di spostarsi
+(vedi [Distanze e spostamenti](11-spostamenti.md)).
+
+---
+
+Definito il *quando*, passiamo al *cosa* si insegna: le materie.
+
+---
+
+[← Precedente: Aule e laboratori](06-aule-e-laboratori.md) · [Indice](README.md) · [Successivo: Materie →](08-materie.md)