Italian genders

This commit is contained in:
2026-07-16 11:08:15 +02:00
parent 4ecd8ed07d
commit dc58504e03
20 changed files with 426 additions and 426 deletions
+16 -16
View File
@@ -1,8 +1,8 @@
# 1. Introduzione: cos'è questo sistema
Questo capitolo spiega **a cosa serve** lo strumento, **perché** è pensato in
questo modo e introduce le **parole chiave** che userai in tutto il manuale.
Leggilo con calma: capire questi concetti ora ti farà risparmiare molto tempo
questo modo e introduce le **parole chiave** che userete in tutto il manuale.
Leggilo con calma: capire questi concetti ora vi farà risparmiare molto tempo
dopo.
## Il problema: costruire l'orario di un istituto
@@ -13,12 +13,12 @@ Bisogna incastrare centinaia di lezioni in modo che:
- ogni classe abbia esattamente le ore previste per ciascuna materia;
- nessun docente sia in due classi nello stesso momento;
- si rispettino i limiti di ore giornaliere e le indisponibilità;
- i docenti che lavorano su più plessi abbiano il tempo di spostarsi;
- le docenti ed i docenti che lavorano su più plessi abbiano il tempo di spostarsi;
- e, possibilmente, tutti siano contenti dell'orario che ricevono.
Fatto a mano, questo lavoro richiede giorni e produce spesso soluzioni con troppi
"buchi", spostamenti inutili o preferenze ignorate. Questo sistema **automatizza**
la parte più faticosa — trovare una combinazione valida — lasciando a te il
la parte più faticosa — trovare una combinazione valida — lasciando a voi il
controllo delle decisioni importanti.
## Il contesto della scuola italiana
@@ -29,38 +29,38 @@ dalle università:
- **Gli studenti restano nella loro aula.** Ogni classe (per esempio la "1ª A")
è un gruppo fisso di studenti che rimane nella stessa aula per la maggior parte
delle lezioni.
- **Sono i docenti a spostarsi.** I professori cambiano aula tra un'ora e l'altra
- **Sono le docenti ed i docenti a spostarsi.** Le professoresse ed i professori cambiano aula tra un'ora e l'altra
e, quando l'istituto ha più plessi, si spostano anche tra edifici diversi.
- **Un istituto può avere più scuole.** Il sistema gestisce più edifici (plessi)
e tiene conto dei **tempi di viaggio** tra di essi.
Di conseguenza l'orario non deve ottimizzare solo la sequenza delle lezioni di
ogni classe, ma anche **i movimenti e la disponibilità dei docenti**.
ogni classe, ma anche **i movimenti e la disponibilità delle docenti e dei docenti**.
## Cosa fa lo strumento, in breve
1. **Raccoglie i dati** della scuola: plessi, aule, orario delle campanelle,
materie, classi, monte ore e docenti.
2. **Raccoglie le preferenze** dei docenti (orari graditi, indisponibilità, sedi
2. **Raccoglie le preferenze** delle docenti e dei docenti (orari graditi, indisponibilità, sedi
preferite, giorno libero...).
3. **Genera automaticamente** uno o più orari con un motore di ottimizzazione.
4. **Valuta la qualità** di ogni orario con un punteggio, così puoi confrontare le
4. **Valuta la qualità** di ogni orario con un punteggio, così potete confrontare le
alternative.
5. Ti permette di **rivedere, correggere a mano ed esportare** l'orario scelto.
5. Vi permette di **rivedere, correggere a mano ed esportare** l'orario scelto.
## Vincoli obbligatori e preferenze: la distinzione più importante
Tutto il funzionamento del sistema ruota intorno a due tipi di regole. Tienile
Tutto il funzionamento del sistema ruota intorno a due tipi di regole. Tenetele
ben distinte fin da subito:
- **Vincoli rigidi (obbligatori).** Regole che **devono** essere sempre
rispettate. Se anche una sola viene violata, l'orario non è valido. Esempi: il
monte ore di ogni materia, il divieto di doppia presenza di un docente, le
monte ore di ogni materia, il divieto di doppia presenza di una docente ed un docente, le
indisponibilità dichiarate, il tempo minimo per spostarsi tra plessi.
- **Preferenze (obiettivi di qualità).** Desideri che il sistema cerca di
soddisfare il più possibile, ma che **può sacrificare** se necessario per
trovare una soluzione valida. Esempi: preferire le ore del mattino, evitare i
"buchi", ridurre gli spostamenti, rispettare gli orari graditi da un docente.
"buchi", ridurre gli spostamenti, rispettare gli orari graditi da una docente ed un docente.
In pratica: i **vincoli rigidi** definiscono cosa è un orario *ammissibile*; le
**preferenze** definiscono cosa è un orario *buono*. Il motore prima trova una
@@ -68,7 +68,7 @@ soluzione ammissibile, poi la migliora sul fronte della qualità.
## Vocabolario di base
Questi termini ricorrono in tutto il manuale. Per la lista completa vedi il
Questi termini ricorrono in tutto il manuale. Per la lista completa vedete il
[Glossario](19-glossario.md).
| Termine | Significato |
@@ -81,8 +81,8 @@ Questi termini ricorrono in tutto il manuale. Per la lista completa vedi il
| **Classe** | Un gruppo fisso di studenti (es. 2ª B) che appartiene a una scuola. |
| **Monte ore** | Quante ore settimanali di una materia servono a una classe. |
| **Assegnazione docente** | Il legame "questo docente insegna questa materia a questa classe". |
| **Preferenza** | Un desiderio del docente trattato come obiettivo di qualità. |
| **Indisponibilità** | Un periodo in cui il docente non può proprio esserci (vincolo rigido). |
| **Preferenza** | Un desiderio della docente e del docente trattato come obiettivo di qualità. |
| **Indisponibilità** | Un periodo in cui la docente ed il docente non può proprio esserci (vincolo rigido). |
| **Versione di orario** | Un orario generato, con il suo punteggio e il suo stato (bozza/finale/archiviato). |
## Cosa NON copre questo manuale
@@ -93,7 +93,7 @@ esiste la documentazione tecnica nella cartella `docs/`.
---
Ora che sai cosa fa lo strumento, vediamo l'intero processo dall'alto prima di
Ora che sapete cosa fa lo strumento, vediamo l'intero processo dall'alto prima di
entrare nel dettaglio delle singole funzioni.
---