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,114 @@
+# 9. Classi, monte ore e assegnazione docenti
+
+Questo è il **cuore** della configurazione. Una **classe** (Class Group) è un
+gruppo fisso di studenti — per esempio la `1A` — che appartiene a una scuola e a un
+anno scolastico. Su ogni classe definisci due cose fondamentali:
+
+1. il **monte ore**: quante ore settimanali le servono per ciascuna materia;
+2. l'**assegnazione dei docenti**: chi insegna ciascuna materia a quella classe.
+
+> Voce di menu: **Configuration → Class Groups**.
+
+Da questi dati il sistema capisce **quante lezioni** deve collocare e **con quali
+docenti**: sono le informazioni più importanti per la generazione.
+
+## Creare una classe
+
+1. Apri **Class Groups** dal menu. In alto seleziona l'**anno scolastico**; puoi
+   filtrare per **scuola**.
+2. Clicca **+ New Class Group** (Nuova classe).
+3. Compila:
+   - **Scuola** — a quale plesso appartiene la classe.
+   - **Nome** — es. `1A`, `3B` (max 20 caratteri).
+   - **Anno di corso (Year Level)** — il livello numerico, tipicamente da `1` a
+     `5`.
+4. Salva.
+
+> [Immagine: finestra di creazione classe con scuola, nome e anno di corso] —
+> Didascalia: la classe appartiene a una scuola e a un anno scolastico.
+
+> **Attenzione.** La **scuola non è modificabile** dopo la creazione della classe.
+
+## Il monte ore (Teachings / Requirements)
+
+Dopo aver creato la classe, apri la sua sezione **Teachings** (insegnamenti):
+cliccando la voce corrispondente sulla riga della classe si apre la finestra
+*"Teachings — 1A (2025/2026)"*.
+
+Qui definisci, materia per materia, quante ore settimanali servono alla classe:
+
+1. Aggiungi una **materia** tra quelle create in [Materie](08-materie.md).
+2. Indica le **ore settimanali** (Weekly Lesson Hrs), es. `4` per Italiano.
+3. Ripeti per tutte le materie della classe.
+
+Se non hai ancora definito nulla, vedrai il messaggio *"No requirements defined
+yet"* (nessun monte ore definito).
+
+> **Regola fondamentale.** Il monte ore è un **vincolo rigido**: il sistema
+> collocherà **esattamente** quel numero di ore per materia, né una di più né una
+> di meno. Controlla bene i totali: la somma delle ore di tutte le materie è il
+> numero di lezioni settimanali della classe, e deve poter entrare nella griglia
+> oraria ([Orari e campanella](07-orari-e-campanella.md)).
+
+> [Immagine: finestra Teachings con l'elenco materie e le ore settimanali] —
+> Didascalia: ogni riga è una materia con il suo monte ore.
+
+## L'assegnazione dei docenti
+
+Sempre nella sezione Teachings colleghi a ciascuna materia il **docente** che la
+insegna a quella classe. È l'informazione che risponde alla domanda *"chi fa
+Matematica in 1A?"*.
+
+- Per ogni materia della classe scegli il docente incaricato tra quelli inseriti in
+  [Docenti](10-docenti.md).
+- Un docente può essere assegnato a più materie e a più classi.
+- Se assegnando un docente si superano le sue ore massime settimanali, il sistema
+  ti avvisa: *"Il docente avrebbe N h/settimana ma il massimo è M h. Assegnare
+  comunque?"*. Puoi procedere o rivedere l'assegnazione.
+
+Quando tutte le materie hanno un docente, comparirà l'indicazione *"All subjects
+have been assigned"* (tutte le materie sono assegnate).
+
+> **Perché è indispensabile.** Senza l'assegnazione dei docenti il sistema sa che
+> servono, ad esempio, 4 ore di Italiano, ma non chi le tiene: non può generare
+> l'orario. Verifica che **ogni** materia di **ogni** classe abbia il suo docente.
+
+## Strumenti per andare più veloce
+
+Configurare tante classi simili a mano è noioso. La pagina offre alcune scorciatoie:
+
+- **Clone from …** — copia nel gruppo corrente tutto il monte ore di un'altra
+  classe. Le materie già presenti non vengono duplicate.
+- **Clone to …** — copia il monte ore della classe corrente verso una o più altre
+  classi selezionate.
+- **Copy teachers from …** — copia le assegnazioni dei docenti da un'altra classe,
+  limitatamente alle materie presenti in entrambe.
+
+Flusso tipico: configuri **una** classe "modello" per ogni indirizzo/anno di
+corso, poi usi *Clone to* e *Copy teachers from* per replicarla sulle sezioni
+parallele, correggendo solo le differenze.
+
+> [Immagine: menu Clone from / Clone to / Copy teachers from] — Didascalia: gli
+> strumenti di clonazione velocizzano la configurazione di classi simili.
+
+## Modificare o eliminare una classe
+
+- **Modifica** per correggere nome o anno di corso (non la scuola).
+- **Elimina** con conferma: rimuove anche il monte ore e le assegnazioni collegate.
+
+## Lista di controllo prima di procedere
+
+Prima di passare oltre, verifica che per ogni classe:
+
+- [ ] siano definite **tutte** le materie con il monte ore corretto;
+- [ ] la somma delle ore **entri** nella griglia oraria della scuola;
+- [ ] **ogni** materia abbia un **docente assegnato**.
+
+---
+
+Il prossimo capitolo riguarda proprio i **docenti**: anagrafica, limiti e
+preferenze.
+
+---
+
+[← Precedente: Materie](08-materie.md) · [Indice](README.md) · [Successivo: Docenti →](10-docenti.md)