Italian genders

2026-07-16 11:08:15 +02:00
parent 4ecd8ed07d
commit dc58504e03
20 changed files with 426 additions and 426 deletions
+16 -16
@@ -1,8 +1,8 @@
# 1. Introduzione: cos'è questo sistema # 1. Introduzione: cos'è questo sistema
Questo capitolo spiega **a cosa serve** lo strumento, **perché** è pensato in Questo capitolo spiega **a cosa serve** lo strumento, **perché** è pensato in
questo modo e introduce le **parole chiave** che userai in tutto il manuale. questo modo e introduce le **parole chiave** che userete in tutto il manuale.
Leggilo con calma: capire questi concetti ora ti farà risparmiare molto tempo Leggilo con calma: capire questi concetti ora vi farà risparmiare molto tempo
dopo. dopo.
## Il problema: costruire l'orario di un istituto ## 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; - ogni classe abbia esattamente le ore previste per ciascuna materia;
- nessun docente sia in due classi nello stesso momento; - nessun docente sia in due classi nello stesso momento;
- si rispettino i limiti di ore giornaliere e le indisponibilità; - 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. - e, possibilmente, tutti siano contenti dell'orario che ricevono.
Fatto a mano, questo lavoro richiede giorni e produce spesso soluzioni con troppi Fatto a mano, questo lavoro richiede giorni e produce spesso soluzioni con troppi
"buchi", spostamenti inutili o preferenze ignorate. Questo sistema **automatizza** "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. controllo delle decisioni importanti.
## Il contesto della scuola italiana ## Il contesto della scuola italiana
@@ -29,38 +29,38 @@ dalle università:
- **Gli studenti restano nella loro aula.** Ogni classe (per esempio la "1ª A") - **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 è un gruppo fisso di studenti che rimane nella stessa aula per la maggior parte
delle lezioni. 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. 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) - **Un istituto può avere più scuole.** Il sistema gestisce più edifici (plessi)
e tiene conto dei **tempi di viaggio** tra di essi. e tiene conto dei **tempi di viaggio** tra di essi.
Di conseguenza l'orario non deve ottimizzare solo la sequenza delle lezioni di 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 ## Cosa fa lo strumento, in breve
1. **Raccoglie i dati** della scuola: plessi, aule, orario delle campanelle, 1. **Raccoglie i dati** della scuola: plessi, aule, orario delle campanelle,
materie, classi, monte ore e docenti. 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...). preferite, giorno libero...).
3. **Genera automaticamente** uno o più orari con un motore di ottimizzazione. 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. 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 ## 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: ben distinte fin da subito:
- **Vincoli rigidi (obbligatori).** Regole che **devono** essere sempre - **Vincoli rigidi (obbligatori).** Regole che **devono** essere sempre
rispettate. Se anche una sola viene violata, l'orario non è valido. Esempi: il 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. indisponibilità dichiarate, il tempo minimo per spostarsi tra plessi.
- **Preferenze (obiettivi di qualità).** Desideri che il sistema cerca di - **Preferenze (obiettivi di qualità).** Desideri che il sistema cerca di
soddisfare il più possibile, ma che **può sacrificare** se necessario per soddisfare il più possibile, ma che **può sacrificare** se necessario per
trovare una soluzione valida. Esempi: preferire le ore del mattino, evitare i 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 In pratica: i **vincoli rigidi** definiscono cosa è un orario *ammissibile*; le
**preferenze** definiscono cosa è un orario *buono*. Il motore prima trova una **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 ## 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). [Glossario](19-glossario.md).
| Termine | Significato | | 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. | | **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. | | **Monte ore** | Quante ore settimanali di una materia servono a una classe. |
| **Assegnazione docente** | Il legame "questo docente insegna questa materia a questa classe". | | **Assegnazione docente** | Il legame "questo docente insegna questa materia a questa classe". |
| **Preferenza** | Un desiderio del docente trattato come obiettivo di qualità. | | **Preferenza** | Un desiderio della docente e del docente trattato come obiettivo di qualità. |
| **Indisponibilità** | Un periodo in cui il docente non può proprio esserci (vincolo rigido). | | **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). | | **Versione di orario** | Un orario generato, con il suo punteggio e il suo stato (bozza/finale/archiviato). |
## Cosa NON copre questo manuale ## 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. entrare nel dettaglio delle singole funzioni.
--- ---
+38 -38
@@ -22,16 +22,16 @@ flowchart LR
end end
subgraph F2["<b>Fase 2: RACCOGLI<br/>PREFERENZE</b>"] subgraph F2["<b>Fase 2: RACCOGLI<br/>PREFERENZE</b>"]
direction TB direction TB
B1[Crea campagna] B1[Create campagna]
B2[Invita docenti] B2[Invitate docenti]
B3[Invia email] B3[Inviate email]
B4[Monitora risposte] B4[Monitorate risposte]
end end
subgraph F3["<b>Fase 3: GENERA<br/>E SCEGLI</b>"] subgraph F3["<b>Fase 3: GENERA<br/>E SCEGLI</b>"]
direction TB direction TB
C1[Configura e avvia<br/>l'ottimizzatore] C1[Configura e avvia<br/>l'ottimizzatore]
C2[Confronta versioni<br/>e punteggi] C2[Confronta versioni<br/>e punteggi]
C3[Scegli la migliore] C3[Scegliete la migliore]
end end
subgraph F4["<b>Fase 4: RIFINISCI</b>"] subgraph F4["<b>Fase 4: RIFINISCI</b>"]
direction TB direction TB
@@ -47,9 +47,9 @@ Le quattro fasi corrispondono alle quattro parti operative di questo manuale.
## Fase 1 — Prepara i dati (Configurazione) ## Fase 1 — Prepara i dati (Configurazione)
È la fase più lunga, ma si fa **una volta sola** e negli anni successivi si È la fase più lunga, ma si fa **una volta sola** e negli anni successivi si
aggiorna solo ciò che cambia. Inserisci, in quest'ordine consigliato: aggiorna solo ciò che cambia. Inserite, in quest'ordine consigliato:
1. **[Anno scolastico](04-anni-scolastici.md)** — crea l'anno di riferimento. 1. **[Anno scolastico](04-anni-scolastici.md)** — create l'anno di riferimento.
Tutto il resto sarà legato ad esso. Tutto il resto sarà legato ad esso.
2. **[Scuole](05-scuole.md)** — gli edifici dell'istituto, con indirizzo e 2. **[Scuole](05-scuole.md)** — gli edifici dell'istituto, con indirizzo e
posizione (serve per calcolare gli spostamenti). posizione (serve per calcolare gli spostamenti).
@@ -59,51 +59,51 @@ aggiorna solo ciò che cambia. Inserisci, in quest'ordine consigliato:
di ciascuna scuola. di ciascuna scuola.
5. **[Materie](08-materie.md)** — l'elenco delle discipline. 5. **[Materie](08-materie.md)** — l'elenco delle discipline.
6. **[Classi](09-classi.md)** — le classi con il **monte ore** per materia e 6. **[Classi](09-classi.md)** — le classi con il **monte ore** per materia e
l'**assegnazione dei docenti** (chi insegna cosa a chi). È il cuore della l'**assegnazione delle docenti e dei docenti** (chi insegna cosa a chi). È il cuore della
configurazione. configurazione.
7. **[Docenti](10-docenti.md)** — l'anagrafica, i limiti (ore massime giornaliere, 7. **[Docenti](10-docenti.md)** — l'anagrafica, i limiti (ore massime giornaliere,
giorno libero) ed eventuali indisponibilità. giorno libero) ed eventuali indisponibilità.
8. **[Distanze e spostamenti](11-spostamenti.md)** — i tempi di viaggio tra i 8. **[Distanze e spostamenti](11-spostamenti.md)** — i tempi di viaggio tra i
plessi (necessari solo se l'istituto ha più scuole). plessi (necessari solo se l'istituto ha più scuole).
> **Perché quest'ordine?** Ogni passo si appoggia ai precedenti: non puoi > **Perché quest'ordine?** Ogni passo si appoggia ai precedenti: non potete
> assegnare un docente a una classe se la classe non esiste, né definire il monte > assegnare una docente ed un docente a una classe se la classe non esiste, né definire il monte
> ore se non hai le materie. Seguire l'ordine evita di tornare indietro. > ore se non avete le materie. Seguire l'ordine evita di tornare indietro.
## Fase 2 — Raccogli le preferenze dei docenti ## Fase 2 — Raccogli le preferenze delle docenti e dei docenti
Questa fase è **facoltativa ma fortemente consigliata**: le preferenze migliorano Questa fase è **facoltativa ma fortemente consigliata**: le preferenze migliorano
molto la qualità dell'orario e il gradimento dei docenti. molto la qualità dell'orario e il gradimento delle docenti e dei docenti.
- Crei una **campagna** per l'anno scolastico. - Create una **campagna** per l'anno scolastico.
- Inviti i docenti e invii loro un'email con un link personale. - Invitate le docenti ed i docenti e inviate loro un'email con un link personale.
- Ogni docente compila un modulo con i propri orari graditi, indisponibilità, - Ogni docente compila un modulo con i propri orari graditi, indisponibilità,
sedi preferite, giorno libero, ecc. sedi preferite, giorno libero, ecc.
- Tu **monitori** chi ha risposto. - Voi **monitorate** chi ha risposto.
Vedi [Raccolta preferenze dei docenti](12-raccolta-preferenze.md). In alternativa, Vedete [Raccolta preferenze delle docenti e dei docenti](12-raccolta-preferenze.md). In alternativa,
puoi inserire le preferenze tu stesso dalla scheda del docente potete inserire le preferenze voi stessi dalla scheda della docente e del docente
([Docenti](10-docenti.md)). ([Docenti](10-docenti.md)).
## Fase 3 — Genera e scegli ## Fase 3 — Generate e scegliete
Quando i dati sono pronti: Quando i dati sono pronti:
1. Apri la pagina **[Generazione](13-generazione-orario.md)**, scegli l'ambito 1. Aprite la pagina **[Generazione](13-generazione-orario.md)**, scegliete l'ambito
(tutto l'istituto o un sottoinsieme), le impostazioni e avvii il motore. (tutto l'istituto o un sottoinsieme), le impostazioni e avviate il motore.
2. Il sistema lavora e, al termine, restituisce **una o più versioni** di orario, 2. Il sistema lavora e, al termine, restituisce **una o più versioni** di orario,
ciascuna con un **punteggio di qualità**. ciascuna con un **punteggio di qualità**.
3. Impari a leggere quei punteggi in [Comprendere i punteggi](14-comprendere-i-punteggi.md) 3. Imparate a leggere quei punteggi in [Comprendere i punteggi](14-comprendere-i-punteggi.md)
e confronti le versioni nella pagina di [Revisione](15-revisione-orario.md). e confrontate le versioni nella pagina di [Revisione](15-revisione-orario.md).
## Fase 4 — Rifinisci, finalizza ed esporta ## Fase 4 — Rifinite, finalizzate ed esportate
- Se una versione è quasi perfetta ma ha qualche dettaglio da sistemare, la - Se una versione è quasi perfetta ma ha qualche dettaglio da sistemare, la
**[personalizzi a mano](16-personalizzazione-orario.md)**: la modifica crea una **[personalizzate a mano](16-personalizzazione-orario.md)**: la modifica crea una
nuova bozza, senza toccare l'originale. nuova bozza, senza toccare l'originale.
- Quando sei soddisfatto, **finalizzi** la versione scelta (diventa l'orario - Quando siete soddisfatte e soddisfatti, **finalizzate** la versione scelta (diventa l'orario
ufficiale) dalla pagina di [Revisione](15-revisione-orario.md). ufficiale) dalla pagina di [Revisione](15-revisione-orario.md).
- Infine **[esporti](17-esportazione.md)** l'orario in Excel o OpenDocument per - Infine **[esportate](17-esportazione.md)** l'orario in Excel o OpenDocument per
distribuirlo e stamparlo. distribuirlo e stamparlo.
## Un processo iterativo, non lineare ## Un processo iterativo, non lineare
@@ -114,22 +114,22 @@ Nella realtà raramente si va dritti dall'inizio alla fine. È del tutto normale
- accorgersi che manca un dato, **tornare alla configurazione** e correggere; - accorgersi che manca un dato, **tornare alla configurazione** e correggere;
- **personalizzare** una versione, valutarla e poi decidere. - **personalizzare** una versione, valutarla e poi decidere.
Lo strumento è pensato proprio per questo ciclo: *genera → valuta → correggi Lo strumento è pensato proprio per questo ciclo: *generate → valutate → correggete
rigenera*. Non aver paura di creare più versioni: puoi sempre confrontarle ed rigenerate*. Non abbiate paura di creare più versioni: potete sempre confrontarle ed
eliminare quelle che non servono. eliminare quelle che non servono.
## Il tuo primo orario: percorso minimo ## Il vostro primo orario: percorso minimo
Se vuoi arrivare rapidamente a un primo risultato, questo è il percorso essenziale: Se volete arrivare rapidamente a un primo risultato, questo è il percorso essenziale:
1. Crea l'anno scolastico e almeno una scuola. 1. Create l'anno scolastico e almeno una scuola.
2. Definisci l'orario delle campanelle per quella scuola. 2. Definite l'orario delle campanelle per quella scuola.
3. Inserisci le materie e almeno una classe con il suo monte ore. 3. Inserite le materie e almeno una classe con il suo monte ore.
4. Inserisci i docenti e assegnali alle classi/materie. 4. Inserite le docenti ed i docenti e assegnali alle classi/materie.
5. Vai su **Generazione**, lascia le impostazioni predefinite e avvia. 5. Andate su **Generazione**, lasciate le impostazioni predefinite e avviate.
6. Apri la versione prodotta in **Revisione** e osservala. 6. Aprite la versione prodotta in **Revisione** e osservatela.
Poi potrai raffinare aggiungendo preferenze, più classi e più plessi. Poi potrete raffinare aggiungendo preferenze, più classi e più plessi.
--- ---
+22 -22
@@ -1,43 +1,43 @@
# 3. Primi passi: accesso e interfaccia # 3. Primi passi: accesso e interfaccia
In questo capitolo impari ad **accedere** allo strumento e a **muoverti** In questo capitolo imparate ad **accedere** allo strumento e a **muovervi**
nell'interfaccia. Sono le poche nozioni pratiche che userai in ogni sessione di nell'interfaccia. Sono le poche nozioni pratiche che userete in ogni sessione di
lavoro. lavoro.
## Accedere al sistema ## Accedere al sistema
Lo strumento si usa dal **browser** (Chrome, Firefox, Edge...). L'indirizzo web è Lo strumento si usa dal **browser** (Chrome, Firefox, Edge...). L'indirizzo web è
quello fornito da chi ha installato il sistema per il tuo istituto. quello fornito da chi ha installato il sistema per il vostro istituto.
1. Apri l'indirizzo del sistema nel browser. 1. Aprite l'indirizzo del sistema nel browser.
2. Compare la pagina di **accesso** (Login). 2. Compare la pagina di **accesso** (Login).
3. Inserisci **nome utente e password** che ti sono stati forniti. 3. Inserite **nome utente e password** che vi sono stati forniti.
4. Premi **Accedi**. 4. Premete **Accedi**.
![Pagina di accesso](img/login.png) ![Pagina di accesso](img/login.png)
Alcune indicazioni utili: Alcune indicazioni utili:
- **Non esiste una registrazione autonoma.** L'utente amministratore viene creato - **Non esiste una registrazione autonoma.** L'utente amministratore viene creato
al momento dell'installazione. Se non hai le credenziali, richiedile a chi al momento dell'installazione. Se non avete le credenziali, richiedile a chi
gestisce il sistema. gestisce il sistema.
- **La sessione resta attiva** sul tuo browser finché non premi *Logout*. Su un - **La sessione resta attiva** sul vostro browser finché non premete *Logout*. Su un
computer condiviso, esci sempre al termine del lavoro. computer condiviso, uscite sempre al termine del lavoro.
- Se dopo un po' di inattività ricevi di nuovo la richiesta di accesso, è normale: - Se dopo un po' di inattività ricevete di nuovo la richiesta di accesso, è normale:
reinserisci le credenziali. reinserite le credenziali.
## La struttura dell'interfaccia ## La struttura dell'interfaccia
Dopo l'accesso vedrai tre aree principali: Dopo l'accesso vedrete tre aree principali:
![Struttura dell'interfaccia](img/academic-years.png) ![Struttura dell'interfaccia](img/academic-years.png)
- **Intestazione (in alto):** contiene il selettore della **lingua** e il pulsante - **Intestazione (in alto):** contiene il selettore della **lingua** e il pulsante
**Logout**. **Logout**.
- **Barra laterale (a sinistra):** il menu di navigazione, diviso in due sezioni - **Barra laterale (a sinistra):** il menu di navigazione, diviso in due sezioni
(vedi sotto). Clicca una voce per aprire la pagina corrispondente. (vedete sotto). Cliccate una voce per aprire la pagina corrispondente.
- **Area contenuto (al centro):** mostra la pagina selezionata, dove leggi e - **Area contenuto (al centro):** mostra la pagina selezionata, dove leggete e
modifichi i dati. modificate i dati.
## Le due sezioni del menu ## Le due sezioni del menu
@@ -45,7 +45,7 @@ La barra laterale è organizzata secondo il processo di lavoro descritto nella
[Panoramica](02-panoramica-del-processo.md): [Panoramica](02-panoramica-del-processo.md):
### Configuration (Configurazione) ### Configuration (Configurazione)
Qui prepari tutti i dati della scuola: Qui preparate tutti i dati della scuola:
| Voce di menu | Pagina del manuale | | Voce di menu | Pagina del manuale |
|--------------|--------------------| |--------------|--------------------|
@@ -60,7 +60,7 @@ Qui prepari tutti i dati della scuola:
| Preferences Campaign | [Raccolta preferenze](12-raccolta-preferenze.md) | | Preferences Campaign | [Raccolta preferenze](12-raccolta-preferenze.md) |
### Timetable (Orario) ### Timetable (Orario)
Qui generi e gestisci gli orari: Qui generate e gestite gli orari:
| Voce di menu | Pagina del manuale | | Voce di menu | Pagina del manuale |
|--------------|--------------------| |--------------|--------------------|
@@ -68,13 +68,13 @@ Qui generi e gestisci gli orari:
| Review | [Revisione delle versioni](15-revisione-orario.md) | | Review | [Revisione delle versioni](15-revisione-orario.md) |
> **Nota.** Le voci dell'interfaccia sono qui riportate anche in inglese perché, > **Nota.** Le voci dell'interfaccia sono qui riportate anche in inglese perché,
> a seconda della lingua impostata, potresti vederle in inglese o in italiano. > a seconda della lingua impostata, potreste vederle in inglese o in italiano.
## Cambiare la lingua ## Cambiare la lingua
In alto a destra c'è il **selettore della lingua** (EN / IT). Cliccalo per passare In alto a destra c'è il **selettore della lingua** (EN / IT). Cliccatelo per passare
tra **inglese** e **italiano**. La scelta cambia immediatamente tutte le etichette tra **inglese** e **italiano**. La scelta cambia immediatamente tutte le etichette
dell'interfaccia. Puoi cambiarla in qualsiasi momento senza perdere i dati. dell'interfaccia. Potete cambiarla in qualsiasi momento senza perdere i dati.
## Elementi comuni a tutte le pagine ## Elementi comuni a tutte le pagine
@@ -91,12 +91,12 @@ Imparerai a riconoscere alcuni elementi che si ripetono ovunque:
## Uscire dal sistema ## Uscire dal sistema
Premi **Logout** nell'intestazione per terminare la sessione. Verrai riportato Premete **Logout** nell'intestazione per terminare la sessione. Verrete riportati
alla pagina di accesso. alla pagina di accesso.
--- ---
Ora sei pronto a inserire i dati. Iniziamo dall'**anno scolastico**, il Ora siete pronte e pronti a inserire i dati. Iniziamo dall'**anno scolastico**, il
contenitore a cui appartiene tutto il resto. contenitore a cui appartiene tutto il resto.
--- ---
+12 -12
@@ -8,45 +8,45 @@ preciso. Per questo è il **primo** elemento da creare.
## A cosa serve ## A cosa serve
Definire l'anno (per esempio `2025/2026`) ti permette di: Definire l'anno (per esempio `2025/2026`) vi permette di:
- tenere separati i dati di anni diversi (l'orario del 2024/2025 non si mescola con - tenere separati i dati di anni diversi (l'orario del 2024/2025 non si mescola con
quello del 2025/2026); quello del 2025/2026);
- **conservare lo storico**: gli anni passati restano consultabili; - **conservare lo storico**: gli anni passati restano consultabili;
- lavorare al nuovo orario mentre quello vecchio resta intatto. - lavorare al nuovo orario mentre quello vecchio resta intatto.
In quasi tutte le altre pagine sceglierai l'anno di riferimento da un menu a In quasi tutte le altre pagine sceglierete l'anno di riferimento da un menu a
tendina in alto: se quel menu è vuoto, è perché non hai ancora creato nessun anno tendina in alto: se quel menu è vuoto, è perché non avete ancora creato nessun anno
qui. qui.
## Creare un anno scolastico ## Creare un anno scolastico
1. Apri **Academic Years** dal menu. 1. Aprite **Academic Years** dal menu.
2. Clicca **+ New Academic Year** (Nuovo anno scolastico). 2. Cliccate **+ New Academic Year** (Nuovo anno scolastico).
3. Inserisci l'**etichetta** dell'anno, per esempio `2025/2026`. 3. Inserite l'**etichetta** dell'anno, per esempio `2025/2026`.
- Massimo 20 caratteri. - Massimo 20 caratteri.
- Deve essere **univoca**: non possono esistere due anni con la stessa - Deve essere **univoca**: non possono esistere due anni con la stessa
etichetta. etichetta.
4. Salva. 4. Salvate.
![Elenco anni scolastici](img/academic-years.png) ![Elenco anni scolastici](img/academic-years.png)
## Modificare o eliminare ## Modificare o eliminare
- **Modifica:** usa l'icona di modifica accanto all'anno per correggere - **Modifica:** usate l'icona di modifica accanto all'anno per correggere
l'etichetta. l'etichetta.
- **Elimina:** usa l'icona di eliminazione. Ti verrà chiesta una conferma. - **Elimina:** usate l'icona di eliminazione. Vi verrà chiesta una conferma.
> **Attenzione.** Eliminare un anno scolastico ha effetti a cascata su tutto ciò > **Attenzione.** Eliminare un anno scolastico ha effetti a cascata su tutto ciò
> che vi è collegato (classi, orari, versioni...). Elimina un anno solo se sei > che vi è collegato (classi, orari, versioni...). Eliminate un anno solo se siete
> certo di non averne più bisogno. In generale conviene **conservare** gli anni > certo di non averne più bisogno. In generale conviene **conservare** gli anni
> passati come archivio. > passati come archivio.
## Consiglio pratico ## Consiglio pratico
Crea l'anno **prima** di iniziare qualsiasi altra configurazione. Se stai Create l'anno **prima** di iniziare qualsiasi altra configurazione. Se state
preparando l'orario per il prossimo anno mentre quello corrente è ancora in uso, preparando l'orario per il prossimo anno mentre quello corrente è ancora in uso,
crea semplicemente il nuovo anno: i due resteranno indipendenti. create semplicemente il nuovo anno: i due resteranno indipendenti.
--- ---
+18 -18
@@ -1,58 +1,58 @@
# 5. Scuole # 5. Scuole
Una **scuola** (o plesso) è un edificio dell'istituto. Qui inserisci tutti gli Una **scuola** (o plesso) è un edificio dell'istituto. Qui inserite tutti gli
edifici in cui si svolgono le lezioni. Anche se il tuo istituto ha un solo edifici in cui si svolgono le lezioni. Anche se il vostro istituto ha un solo
edificio, devi comunque crearne almeno uno. edificio, dovete comunque crearne almeno uno.
> Voce di menu: **Configuration → Schools**. > Voce di menu: **Configuration → Schools**.
## Perché le scuole sono importanti ## Perché le scuole sono importanti
Le scuole sono il luogo dove esistono le aule e dove i docenti si spostano. La loro Le scuole sono il luogo dove esistono le aule e dove le docenti ed i docenti si spostano. La loro
**posizione geografica** è usata dal sistema per calcolare i **tempi di viaggio**: **posizione geografica** è usata dal sistema per calcolare i **tempi di viaggio**:
- da un plesso all'altro (per i docenti che insegnano su più sedi); - da un plesso all'altro (per le docenti ed i docenti che insegnano su più sedi);
- da casa del docente a ciascun plesso. - da casa della docente e del docente a ciascun plesso.
Questi tempi diventano poi vincoli e obiettivi durante la generazione (vedi Questi tempi diventano poi vincoli e obiettivi durante la generazione (vedete
[Distanze e spostamenti](11-spostamenti.md) e [Distanze e spostamenti](11-spostamenti.md) e
[Scheduling: gli spostamenti](02-panoramica-del-processo.md)). [Scheduling: gli spostamenti](02-panoramica-del-processo.md)).
## Creare una scuola ## Creare una scuola
1. Apri **Schools** dal menu. 1. Aprite **Schools** dal menu.
2. Clicca **+ New School** (Nuova scuola). 2. Cliccate **+ New School** (Nuova scuola).
![Elenco scuole](img/schools.png) ![Elenco scuole](img/schools.png)
3. Compila i campi: 3. Compilate i campi:
- **Nome** — es. `Liceo Scientifico`, `Sede centrale`, `Succursale Via Verdi`. - **Nome** — es. `Liceo Scientifico`, `Sede centrale`, `Succursale Via Verdi`.
- **Indirizzo** — es. `Via Roma 1, 00100 Roma`. - **Indirizzo** — es. `Via Roma 1, 00100 Roma`.
- **Latitudine / Longitudine** *(facoltative)* — le coordinate geografiche, in - **Latitudine / Longitudine** *(facoltative)* — le coordinate geografiche, in
gradi decimali (es. `41.8902`, `12.4964`). gradi decimali (es. `41.8902`, `12.4964`).
4. Salva. 4. Salvate.
![Form di creazione scuola](img/schools-add.png) ![Form di creazione scuola](img/schools-add.png)
## Coordinate: quando servono ## Coordinate: quando servono
- **Un solo plesso:** le coordinate non incidono sull'orario; puoi lasciarle - **Un solo plesso:** le coordinate non incidono sull'orario; potete lasciarle
vuote. vuote.
- **Più plessi:** le coordinate permettono al sistema di stimare automaticamente i - **Più plessi:** le coordinate permettono al sistema di stimare automaticamente i
tempi di viaggio tra le sedi. In alternativa puoi inserire i tempi a mano nella tempi di viaggio tra le sedi. In alternativa potete inserire i tempi a mano nella
[Travel Matrix](11-spostamenti.md). [Travel Matrix](11-spostamenti.md).
Se non conosci le coordinate esatte, puoi ricavarle da una mappa online cercando Se non conoscete le coordinate esatte, potete ricavarle da una mappa online cercando
l'indirizzo, oppure lasciare che il sistema le stimi dall'indirizzo (funzione di l'indirizzo, oppure lasciare che il sistema le stimi dall'indirizzo (funzione di
geocodifica descritta nel capitolo sugli spostamenti). geocodifica descritta nel capitolo sugli spostamenti).
## Modificare o eliminare ## Modificare o eliminare
- **Cerca** una scuola con la barra di ricerca quando l'elenco è lungo. - **Cercate** una scuola con la barra di ricerca quando l'elenco è lungo.
- **Modifica** con l'icona corrispondente per aggiornare nome, indirizzo o - **Modifica** con l'icona corrispondente per aggiornare nome, indirizzo o
coordinate. coordinate.
- **Elimina** con doppia conferma. Non eliminare una scuola a cui sono già - **Elimina** con doppia conferma. Non eliminate una scuola a cui sono già
collegate classi o aule, a meno che tu non voglia rimuoverle tutte. collegate classi o aule, a meno che non vogliate rimuoverle tutte.
## Consiglio pratico ## Consiglio pratico
@@ -62,7 +62,7 @@ dell'orario e nei file esportati.
--- ---
Definiti gli edifici, puoi (se necessario) censire le **aule e i laboratori** Definiti gli edifici, potete (se necessario) censire le **aule e i laboratori**
speciali. speciali.
--- ---
+14 -14
@@ -7,9 +7,9 @@ classi contemporaneamente.
> Voce di menu: **Configuration → Facilities**. > Voce di menu: **Configuration → Facilities**.
## Quando ti serve questa sezione ## Quando vi serve questa sezione
Ricorda che, di norma, **ogni classe ha la propria aula fissa**: quella non va Ricordate che, di norma, **ogni classe ha la propria aula fissa**: quella non va
inserita qui. Questa sezione serve **solo** per gli spazi condivisi e limitati, inserita qui. Questa sezione serve **solo** per gli spazi condivisi e limitati,
per esempio: per esempio:
@@ -17,7 +17,7 @@ per esempio:
- i **laboratori** (informatica, chimica, fisica...); - i **laboratori** (informatica, chimica, fisica...);
- l'**aula magna**, l'aula di musica, ecc. - l'**aula magna**, l'aula di musica, ecc.
Se nessuna materia della tua scuola richiede spazi speciali, puoi **saltare Se nessuna materia della vostra scuola richiede spazi speciali, potete **saltare
completamente** questo capitolo. completamente** questo capitolo.
## Perché sono importanti per l'orario ## Perché sono importanti per l'orario
@@ -29,37 +29,37 @@ in palestra alla stessa ora.
## Creare un'aula o un laboratorio ## Creare un'aula o un laboratorio
1. Apri **Facilities** dal menu. 1. Aprite **Facilities** dal menu.
2. In alto puoi **filtrare per scuola** per vedere le facility di un plesso 2. In alto potete **filtrare per scuola** per vedere le facility di un plesso
specifico. specifico.
3. Clicca **+ New Facility** (Nuova facility). 3. Cliccate **+ New Facility** (Nuova facility).
![Elenco facility](img/facilities.png) ![Elenco facility](img/facilities.png)
4. Compila: 4. Compilate:
- **Scuola** — a quale plesso appartiene la stanza. - **Scuola** — a quale plesso appartiene la stanza.
- **Nome** — es. `Palestra A`, `Laboratorio di Chimica`. - **Nome** — es. `Palestra A`, `Laboratorio di Chimica`.
- **Tipo** — una parola chiave per la categoria, es. `gym`, `lab`, - **Tipo** — una parola chiave per la categoria, es. `gym`, `lab`,
`music_room`. Puoi scegliere un suggerimento o scriverne uno tuo (max 50 `music_room`. Potete scegliere un suggerimento o scriverne uno vostro (max 50
caratteri). caratteri).
5. Salva. 5. Salvate.
![Form di creazione facility](img/facilities-add.png) ![Form di creazione facility](img/facilities-add.png)
> **Attenzione.** La **scuola non è modificabile** dopo la creazione. Se sbagli > **Attenzione.** La **scuola non è modificabile** dopo la creazione. Se sbagliate
> plesso, elimina la facility e ricreala. > plesso, eliminate la facility e ricreatela.
## Collegare una facility a una materia ## Collegare una facility a una materia
Definire la facility è solo il primo passo: perché il sistema la usi, la materia Definire la facility è solo il primo passo: perché il sistema la usi, la materia
che la richiede deve essere collegata ad essa. Questo collegamento si imposta nella che la richiede deve essere collegata ad essa. Questo collegamento si imposta nella
gestione delle materie e delle classi — vedi [Materie](08-materie.md) e gestione delle materie e delle classi — vedete [Materie](08-materie.md) e
[Classi](09-classi.md). [Classi](09-classi.md).
## Modificare o eliminare ## Modificare o eliminare
- **Modifica** per aggiornare nome o tipo. - **Modificate** per aggiornare nome o tipo.
- **Elimina** con conferma. Verifica prima che nessuna materia dipenda ancora da - **Eliminate** con conferma. Verificate prima che nessuna materia dipenda ancora da
quella facility. quella facility.
--- ---
+13 -13
@@ -29,8 +29,8 @@ Caratteristiche importanti:
## Prima di iniziare ## Prima di iniziare
In alto nella pagina devi selezionare **l'anno scolastico** e la **scuola** di cui In alto nella pagina dovete 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 volete definire gli orari. Finché non li scegliete, la pagina vi invita a farlo e non
mostra alcuna griglia. mostra alcuna griglia.
![Griglia slot orari](img/time-slots.png) ![Griglia slot orari](img/time-slots.png)
@@ -39,27 +39,27 @@ mostra alcuna griglia.
Il modo più veloce per impostare una giornata tipo è generare più slot in una volta: Il modo più veloce per impostare una giornata tipo è generare più slot in una volta:
1. Clicca **+ Add Multiple Slots** (Aggiungi più slot). 1. Cliccate **+ Add Multiple Slots** (Aggiungete più slot).
2. Indica: 2. Indicate:
- **Orario di inizio** della prima ora (es. `08:00`); - **Orario di inizio** della prima ora (es. `08:00`);
- **Durata (minuti)** di ogni ora (es. `55` o `60`); - **Durata (minuti)** di ogni ora (es. `55` o `60`);
- **Numero di periodi** da creare (es. `6`); - **Numero di periodi** da creare (es. `6`);
- **Numero del primo periodo** (di solito `1`). - **Numero del primo periodo** (di solito `1`).
3. Conferma con **Add Slots**. 3. Confermate con **Add Slots**.
![Form aggiunta slot multipli](img/time-slot-add.png) ![Form aggiunta slot multipli](img/time-slot-add.png)
Il sistema crea automaticamente gli slot consecutivi calcolando gli orari. Ripeti Il sistema crea automaticamente gli slot consecutivi calcolando gli orari. Ripetete
l'operazione se alcuni giorni hanno un numero di ore diverso. l'operazione se alcuni giorni hanno un numero di ore diverso.
> **Nota sulle pause.** Se vuoi rappresentare l'intervallo, imposta gli orari in > **Nota sulle pause.** Se volete rappresentare l'intervallo, impostate gli orari in
> modo che tra un'ora e l'altra resti il tempo dell'intervallo, oppure semplicemente > 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 > non creare uno slot in corrispondenza della ricreazione. La griglia deve
> rispecchiare le ore in cui si fa **effettivamente lezione**. > rispecchiare le ore in cui si fa **effettivamente lezione**.
## Creare o modificare un singolo slot ## Creare o modificare un singolo slot
- **+ New Slot** crea un singolo slot: scegli numero di periodo, giorno, orario di - **+ New Slot** crea un singolo slot: scegliete numero di periodo, giorno, orario di
inizio e fine. inizio e fine.
- L'icona di **modifica** su uno slot esistente permette di correggerne gli orari. - L'icona di **modifica** su uno slot esistente permette di correggerne gli orari.
- L'icona di **eliminazione** lo rimuove. - L'icona di **eliminazione** lo rimuove.
@@ -71,19 +71,19 @@ controllare la coerenza della griglia.
La qualità dell'orario dipende molto dalla griglia: La qualità dell'orario dipende molto dalla griglia:
- Se definisci **poche ore**, il sistema potrebbe non riuscire a collocare tutto il - Se definite **poche ore**, il sistema potrebbe non riuscire a collocare tutto il
monte ore delle classi (orario **non ammissibile**). monte ore delle classi (orario **non ammissibile**).
- Se definisci **troppe ore** rispetto al necessario, il sistema avrà più libertà, - Se definite **troppe ore** rispetto al necessario, il sistema avrà più libertà,
ma potrebbero comparire più "buchi" da gestire con le preferenze di compattezza. ma potrebbero comparire più "buchi" da gestire con le preferenze di compattezza.
L'obiettivo è riprodurre fedelmente l'orario reale delle campanelle della scuola. L'obiettivo è riprodurre fedelmente l'orario reale delle campanelle della scuola.
## Consiglio pratico ## Consiglio pratico
Definisci gli slot **coerentemente per tutte le scuole** coinvolte prima di Definite gli slot **coerentemente per tutte le scuole** coinvolte prima di
generare l'orario. Se un docente lavora su due plessi con campanelle sfasate, generare l'orario. Se una docente ed un docente lavora su due plessi con campanelle sfasate,
è proprio grazie a questi orari che il sistema calcola se ha il tempo di spostarsi è proprio grazie a questi orari che il sistema calcola se ha il tempo di spostarsi
(vedi [Distanze e spostamenti](11-spostamenti.md)). (vedete [Distanze e spostamenti](11-spostamenti.md)).
--- ---
+13 -13
@@ -8,32 +8,32 @@ e da tutte le classi.
## A cosa servono ## A cosa servono
Le materie sono i "mattoni" che collegano le classi ai docenti: Le materie sono i "mattoni" che collegano le classi alle docenti ed ai docenti:
- ogni classe dichiara **quante ore** di ciascuna materia le servono (il monte ore, - ogni classe dichiara **quante ore** di ciascuna materia le servono (il monte ore,
vedi [Classi](09-classi.md)); vedete [Classi](09-classi.md));
- ogni docente viene **assegnato** a insegnare una materia a una classe. - ogni docente viene **assegnato** a insegnare una materia a una classe.
Per questo le materie vanno create **prima** di configurare le classi e i docenti. Per questo le materie vanno create **prima** di configurare le classi, le docenti ed i docenti.
## Creare una materia ## Creare una materia
1. Apri **Subjects** dal menu. 1. Aprite **Subjects** dal menu.
2. Clicca **+ New Subject** (Nuova materia). 2. Cliccate **+ New Subject** (Nuova materia).
![Elenco materie](img/subjects.png) ![Elenco materie](img/subjects.png)
3. Compila: 3. Compilate:
- **Nome** — es. `Matematica`. - **Nome** — es. `Matematica`.
- **Codice** *(facoltativo)* — una sigla breve, es. `MAT`. Se lo usi deve - **Codice** *(facoltativo)* — una sigla breve, es. `MAT`. Se lo usate deve
essere **univoco** (max 50 caratteri). essere **univoco** (max 50 caratteri).
4. Salva. 4. Salvate.
![Form di creazione materia](img/subjects-add.png) ![Form di creazione materia](img/subjects-add.png)
## Come nominare le materie ## Come nominare le materie
- Usa nomi **uniformi** in tutto l'istituto: scegli, per esempio, sempre - Usate nomi **uniformi** in tutto l'istituto: scegliete, per esempio, sempre
`Scienze` e non a volte `Scienze naturali`. Nomi diversi verrebbero trattati `Scienze` e non a volte `Scienze naturali`. Nomi diversi verrebbero trattati
come materie diverse. come materie diverse.
- Se distingui articolazioni o indirizzi, considera se conviene creare materie - Se distingui articolazioni o indirizzi, considera se conviene creare materie
@@ -49,15 +49,15 @@ due classi alla stessa risorsa nello stesso momento.
## Modificare o eliminare ## Modificare o eliminare
- **Cerca**, **modifica** ed **elimina** con i controlli accanto a ciascuna - **Cercate**, **modificate** ed **eliminate** con i controlli accanto a ciascuna
materia. materia.
- Non eliminare una materia già usata nel monte ore delle classi o nelle - Non eliminate una materia già usata nel monte ore delle classi o nelle
assegnazioni dei docenti, salvo tu voglia rimuovere anche quei collegamenti. assegnazioni delle docenti e dei docenti, salvo voi vogliate rimuovere anche quei collegamenti.
--- ---
Ora abbiamo tutti gli ingredienti di base. Il prossimo capitolo è il **cuore** Ora abbiamo tutti gli ingredienti di base. Il prossimo capitolo è il **cuore**
della configurazione: le classi, il loro monte ore e l'assegnazione dei docenti. della configurazione: le classi, il loro monte ore e l'assegnazione delle docenti e dei docenti.
--- ---
+30 -30
@@ -1,11 +1,11 @@
# 9. Classi, monte ore e assegnazione docenti # 9. Classi, monte ore e assegnazione delle docenti e dei docenti
Questo è il **cuore** della configurazione. Una **classe** (Class Group) è un 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 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: anno scolastico. Su ogni classe definite due cose fondamentali:
1. il **monte ore**: quante ore settimanali le servono per ciascuna materia; 1. il **monte ore**: quante ore settimanali le servono per ciascuna materia;
2. l'**assegnazione dei docenti**: chi insegna ciascuna materia a quella classe. 2. l'**assegnazione delle docenti e dei docenti**: chi insegna ciascuna materia a quella classe.
> Voce di menu: **Configuration → Class Groups**. > Voce di menu: **Configuration → Class Groups**.
@@ -14,18 +14,18 @@ docenti**: sono le informazioni più importanti per la generazione.
## Creare una classe ## Creare una classe
1. Apri **Class Groups** dal menu. In alto seleziona l'**anno scolastico**; puoi 1. Aprite **Class Groups** dal menu. In alto selezionate l'**anno scolastico**; potete
filtrare per **scuola**. filtrare per **scuola**.
2. Clicca **+ New Class Group** (Nuova classe). 2. Cliccate **+ New Class Group** (Nuova classe).
![Elenco classi](img/class-groups.png) ![Elenco classi](img/class-groups.png)
3. Compila: 3. Compilate:
- **Scuola** — a quale plesso appartiene la classe. - **Scuola** — a quale plesso appartiene la classe.
- **Nome** — es. `1A`, `3B` (max 20 caratteri). - **Nome** — es. `1A`, `3B` (max 20 caratteri).
- **Anno di corso (Year Level)** — il livello numerico, tipicamente da `1` a - **Anno di corso (Year Level)** — il livello numerico, tipicamente da `1` a
`5`. `5`.
4. Salva. 4. Salvate.
![Form di creazione classe](img/class-groups-add.png) ![Form di creazione classe](img/class-groups-add.png)
@@ -33,46 +33,46 @@ docenti**: sono le informazioni più importanti per la generazione.
## Il monte ore (Teachings / Requirements) ## Il monte ore (Teachings / Requirements)
Dopo aver creato la classe, apri la sua sezione **Teachings** (insegnamenti): Dopo aver creato la classe, aprite la sua sezione **Teachings** (insegnamenti):
cliccando la voce corrispondente sulla riga della classe si apre la finestra cliccando la voce corrispondente sulla riga della classe si apre la finestra
*"Teachings — 1A (2025/2026)"*. *"Teachings — 1A (2025/2026)"*.
Qui definisci, materia per materia, quante ore settimanali servono alla classe: Qui definite, materia per materia, quante ore settimanali servono alla classe:
1. Aggiungi una **materia** tra quelle create in [Materie](08-materie.md). 1. Aggiungete una **materia** tra quelle create in [Materie](08-materie.md).
2. Indica le **ore settimanali** (Weekly Lesson Hrs), es. `4` per Italiano. 2. Indicate le **ore settimanali** (Weekly Lesson Hrs), es. `4` per Italiano.
3. Ripeti per tutte le materie della classe. 3. Ripetete per tutte le materie della classe.
Se non hai ancora definito nulla, vedrai il messaggio *"No requirements defined Se non avete ancora definito nulla, vedrete il messaggio *"No requirements defined
yet"* (nessun monte ore definito). yet"* (nessun monte ore definito).
![Finestra monte ore e assegnazione docenti](img/class-group-teachings.png) ![Finestra monte ore e assegnazione delle docenti e dei docenti](img/class-group-teachings.png)
> **Regola fondamentale.** Il monte ore è un **vincolo rigido**: il sistema > **Regola fondamentale.** Il monte ore è un **vincolo rigido**: il sistema
> collocherà **esattamente** quel numero di ore per materia, né una di più né una > 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 > di meno. Controllate bene i totali: la somma delle ore di tutte le materie è il
> numero di lezioni settimanali della classe, e deve poter entrare nella griglia > numero di lezioni settimanali della classe, e deve poter entrare nella griglia
> oraria ([Orari e campanella](07-orari-e-campanella.md)). > oraria ([Orari e campanella](07-orari-e-campanella.md)).
## L'assegnazione dei docenti ## L'assegnazione delle docenti e dei docenti
Sempre nella sezione Teachings colleghi a ciascuna materia il **docente** che la Sempre nella sezione Teachings collegate a ciascuna materia la **docente** ed il **docente** che la/lo
insegna a quella classe. È l'informazione che risponde alla domanda *"chi fa insegna a quella classe. È l'informazione che risponde alla domanda *"chi fa
Matematica in 1A?"*. Matematica in 1A?"*.
- Per ogni materia della classe scegli il docente incaricato tra quelli inseriti in - Per ogni materia della classe scegliete la docente incaricata ed il docente incaricato tra quelli inseriti in
[Docenti](10-docenti.md). [Docenti](10-docenti.md).
- Un docente può essere assegnato a più materie e a più classi. - Una docente ed un docente può essere assegnata/o a più materie e a più classi.
- Se assegnando un docente si superano le sue ore massime settimanali, il sistema - 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 vi avvisa: *"La docente ed il docente avrebbe N h/settimana ma il massimo è M h. Assegnare
comunque?"*. Puoi procedere o rivedere l'assegnazione. comunque?"*. Potete procedere o rivedere l'assegnazione.
Quando tutte le materie hanno un docente, comparirà l'indicazione *"All subjects Quando tutte le materie hanno una docente ed un docente, comparirà l'indicazione *"All subjects
have been assigned"* (tutte le materie sono assegnate). have been assigned"* (tutte le materie sono assegnate).
> **Perché è indispensabile.** Senza l'assegnazione dei docenti il sistema sa che > **Perché è indispensabile.** Senza l'assegnazione delle docenti e dei docenti il sistema sa che
> servono, ad esempio, 4 ore di Italiano, ma non chi le tiene: non può generare > 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. > l'orario. Verificate che **ogni** materia di **ogni** classe abbia la sua docente ed il suo docente.
## Strumenti per andare più veloce ## Strumenti per andare più veloce
@@ -82,7 +82,7 @@ Configurare tante classi simili a mano è noioso. La pagina offre alcune scorcia
classe. Le materie già presenti non vengono duplicate. classe. Le materie già presenti non vengono duplicate.
- **Clone to …** — copia il monte ore della classe corrente verso una o più altre - **Clone to …** — copia il monte ore della classe corrente verso una o più altre
classi selezionate. classi selezionate.
- **Copy teachers from …** — copia le assegnazioni dei docenti da un'altra classe, - **Copy teachers from …** — copia le assegnazioni delle docenti e dei docenti da un'altra classe,
limitatamente alle materie presenti in entrambe. limitatamente alle materie presenti in entrambe.
Flusso tipico: configuri **una** classe "modello" per ogni indirizzo/anno di Flusso tipico: configuri **una** classe "modello" per ogni indirizzo/anno di
@@ -91,20 +91,20 @@ parallele, correggendo solo le differenze.
## Modificare o eliminare una classe ## Modificare o eliminare una classe
- **Modifica** per correggere nome o anno di corso (non la scuola). - **Modificate** per correggere nome o anno di corso (non la scuola).
- **Elimina** con conferma: rimuove anche il monte ore e le assegnazioni collegate. - **Eliminate** con conferma: rimuove anche il monte ore e le assegnazioni collegate.
## Lista di controllo prima di procedere ## Lista di controllo prima di procedere
Prima di passare oltre, verifica che per ogni classe: Prima di passare oltre, verificate che per ogni classe:
- [ ] siano definite **tutte** le materie con il monte ore corretto; - [ ] siano definite **tutte** le materie con il monte ore corretto;
- [ ] la somma delle ore **entri** nella griglia oraria della scuola; - [ ] la somma delle ore **entri** nella griglia oraria della scuola;
- [ ] **ogni** materia abbia un **docente assegnato**. - [ ] **ogni** materia abbia una **docente assegnata ed un docente assegnato**.
--- ---
Il prossimo capitolo riguarda proprio i **docenti**: anagrafica, limiti e Il prossimo capitolo riguarda proprio le **docenti** ed i **docenti**: anagrafica, limiti e
preferenze. preferenze.
--- ---
+35 -35
@@ -1,96 +1,96 @@
# 10. Docenti e preferenze # 10. Docenti e preferenze
I **docenti** sono le persone che insegnano le materie alle classi. In questa Le **docenti** ed 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 pagina gestite la loro anagrafica, i limiti contrattuali e — se volete inserirle voi
stesso — le loro preferenze e indisponibilità. stessi — le loro preferenze e indisponibilità.
> Voce di menu: **Configuration → Teachers**. > Voce di menu: **Configuration → Teachers**.
## Creare un docente ## Creare un docente
1. Apri **Teachers** dal menu. 1. Aprite **Teachers** dal menu.
2. Clicca **+ New Teacher** (Nuovo docente). 2. Cliccate **+ New Teacher** (Nuovo docente).
![Elenco docenti](img/teachers.png) ![Elenco delle docenti e dei docenti](img/teachers.png)
3. Compila i dati principali: 3. Compilate i dati principali:
- **Nome** e **Cognome** — es. `Mario` `Rossi`. - **Nome** e **Cognome** — es. `Mario` `Rossi`.
- **Email** — es. `mario.rossi@scuola.it`. Serve per inviargli l'invito a - **Email** — es. `mario.rossi@scuola.it`. Serve per inviarle/inviargli l'invito a
compilare le preferenze (vedi [Raccolta preferenze](12-raccolta-preferenze.md)). compilare le preferenze (vedete [Raccolta preferenze](12-raccolta-preferenze.md)).
- **Ore settimanali massime (Max Weekly Hours)** — es. `18`. È il tetto di ore - **Ore settimanali massime (Max Weekly Hours)** — es. `18`. È il tetto di ore
che il docente può insegnare a settimana. che la docente ed il docente può insegnare a settimana.
- **Giorno libero (Free Day)** *(facoltativo)* — il giorno della settimana che - **Giorno libero (Free Day)** *(facoltativo)* — il giorno della settimana che
il docente preferirebbe tenere libero. È una **preferenza**, non una garanzia. la docente ed il docente preferirebbe tenere libero. È una **preferenza**, non una garanzia.
- **Latitudine / Longitudine di casa** *(facoltative)* — la posizione - **Latitudine / Longitudine di casa** *(facoltative)* — la posizione
dell'abitazione, usata per stimare i tempi di spostamento casa→scuola. dell'abitazione, usata per stimare i tempi di spostamento casa→scuola.
4. Salva. 4. Salvate.
![Form di creazione docente](img/teachers-add.png) ![Form di creazione docente](img/teachers-add.png)
## Limiti che diventano vincoli rigidi ## Limiti che diventano vincoli rigidi
Alcuni dati del docente sono trattati come **vincoli rigidi** in fase di Alcuni dati della docente e del docente sono trattati come **vincoli rigidi** in fase di
generazione: generazione:
- le **ore settimanali massime** e le **ore giornaliere massime** non vengono mai - le **ore settimanali massime** e le **ore giornaliere massime** non vengono mai
superate; superate;
- le **indisponibilità** dichiarate (vedi sotto) sono assolute. - le **indisponibilità** dichiarate (vedete sotto) sono assolute.
Altri dati sono invece **preferenze** (obiettivi di qualità), come il **giorno 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 libero** o gli orari graditi: il sistema cerca di rispettarli, ma può derogare se
necessario per trovare una soluzione valida. Per la distinzione vedi necessario per trovare una soluzione valida. Per la distinzione vedete
[Introduzione](01-introduzione.md#vincoli-obbligatori-e-preferenze-la-distinzione-più-importante). [Introduzione](01-introduzione.md#vincoli-obbligatori-e-preferenze-la-distinzione-più-importante).
## Le preferenze del docente ## Le preferenze della docente e del docente
Ogni docente ha una sezione **Preferences** (preferenze), che apri dalla sua riga Ogni docente ha una sezione **Preferences** (preferenze), che aprite dalla sua riga
nell'elenco (*"Preferences — Mario Rossi"*). Vi si trovano: nell'elenco (*"Preferences — Mario Rossi"*). Vi si trovano:
1. **Preferenze sugli slot** — per ogni giorno e ora, il docente può indicare: 1. **Preferenze sugli slot** — per ogni giorno e ora, la docente ed il docente può indicare:
*neutrale*, *preferito*, *da evitare* oppure *non disponibile*. Possono anche *neutrale*, *preferito*, *da evitare* oppure *non disponibile*. Possono anche
essere riferite a una classe specifica. essere riferite a una classe specifica.
2. **Preferenze sulle sedi** — un ordine di gradimento tra i plessi (utile negli 2. **Preferenze sulle sedi** — un ordine di gradimento tra i plessi (utile negli
istituti con più scuole). istituti con più scuole).
3. **Caratteristiche dell'orario** — per esempio la preferenza per le ore del 3. **Caratteristiche dell'orario** — per esempio la preferenza per le ore del
**mattino** e la preferenza per un orario **compatto** (senza "buchi"). **mattino** e la preferenza per un orario **compatto** (senza "buchi").
4. **Indisponibilità assolute** — i periodi in cui il docente non può proprio 4. **Indisponibilità assolute** — i periodi in cui la docente ed il docente non può proprio
esserci: sono un **vincolo rigido**. esserci: sono un **vincolo rigido**.
![Scheda preferenze del docente](img/teachers-preferences.png) ![Scheda preferenze della docente e del docente](img/teachers-preferences.png)
> **Neutrale / preferito / da evitare / non disponibile.** Attenzione alla > **Neutrale / preferito / da evitare / non disponibile.** Attenzione alla
> differenza: *"da evitare"* è una preferenza (il sistema cerca di rispettarla ma > differenza: *"da evitare"* è una preferenza (il sistema cerca di rispettarla ma
> può ignorarla), mentre *"non disponibile"* e le indisponibilità assolute sono > può ignorarla), mentre *"non disponibile"* e le indisponibilità assolute sono
> vincoli rigidi (mai violati). Usa "non disponibile" solo per impossibilità reali, > vincoli rigidi (mai violati). Usate "non disponibile" solo per impossibilità reali,
> altrimenti rischi di rendere l'orario impossibile da costruire. > altrimenti rischiate di rendere l'orario impossibile da costruire.
## Due modi per raccogliere le preferenze ## Due modi per raccogliere le preferenze
Hai due possibilità, che puoi anche combinare: Avete due possibilità, che potete anche combinare:
1. **Inserimento diretto** — compili tu le preferenze dalla scheda del docente, 1. **Inserimento diretto** — compilate voi le preferenze dalla scheda della docente e del docente,
come appena descritto. Comodo per pochi docenti o per correzioni puntuali. come appena descritto. Comodo per poche docenti e pochi docenti o per correzioni puntuali.
2. **Campagna di raccolta** — inviti i docenti a compilare da soli un modulo online 2. **Campagna di raccolta** — invitate le docenti ed i docenti a compilare da sole e da soli un modulo online
(vedi [Raccolta preferenze dei docenti](12-raccolta-preferenze.md)). Consigliato (vedete [Raccolta preferenze delle docenti e dei docenti](12-raccolta-preferenze.md)). Consigliato
quando i docenti sono molti. quando le docenti ed i docenti sono molti.
## Modificare o eliminare ## Modificare o eliminare
- **Cerca** un docente con la barra di ricerca. - **Cercate** una docente ed un docente con la barra di ricerca.
- **Modifica** per aggiornare anagrafica, limiti o preferenze. - **Modificate** per aggiornare anagrafica, limiti o preferenze.
- **Elimina** con conferma. Se il docente è assegnato a delle classi, valuta prima - **Eliminate** con conferma. Se la docente è assegnata ed il docente è assegnato a delle classi, valutate prima
di rimuoverlo: quelle materie resterebbero senza insegnante. di rimuoverla/rimuoverlo: quelle materie resterebbero senza insegnante.
## Consiglio pratico ## Consiglio pratico
Inserisci **ore massime realistiche** e usa le indisponibilità con parsimonia. La Inserite **ore massime realistiche** e usate le indisponibilità con parsimonia. La
causa più comune di un orario "impossibile da generare" sono limiti e causa più comune di un orario "impossibile da generare" sono limiti e
indisponibilità troppo stringenti che, sommati, non lasciano spazio a una indisponibilità troppo stringenti che, sommati, non lasciano spazio a una
soluzione valida (vedi [Buone pratiche e problemi](18-buone-pratiche-e-problemi.md)). soluzione valida (vedete [Buone pratiche e problemi](18-buone-pratiche-e-problemi.md)).
--- ---
Se il tuo istituto ha più plessi, il prossimo passo è definire i tempi di Se il vostro istituto ha più plessi, il prossimo passo è definire i tempi di
spostamento tra le sedi. spostamento tra le sedi.
--- ---
+21 -21
@@ -1,8 +1,8 @@
# 11. Distanze e spostamenti (Travel Matrix) # 11. Distanze e spostamenti (Travel Matrix)
Negli istituti con **più plessi**, alcuni docenti insegnano in sedi diverse anche Negli istituti con **più plessi**, alcune docenti ed alcuni docenti insegnano in sedi diverse anche
nella stessa giornata. Il sistema deve sapere **quanto tempo** serve per spostarsi nella stessa giornata. Il sistema deve sapere **quanto tempo** serve per spostarsi
da una scuola all'altra, per non produrre orari impossibili (un docente che finisce da una scuola all'altra, per non produrre orari impossibili (una docente ed un docente che finisce
in un plesso e inizia subito in un altro lontano). in un plesso e inizia subito in un altro lontano).
> Voce di menu: **Configuration → Travel Matrix**. > Voce di menu: **Configuration → Travel Matrix**.
@@ -13,15 +13,15 @@ La **matrice dei tempi di viaggio** raccoglie i tempi di spostamento (in **minut
tra le sedi: tra le sedi:
- **scuola → scuola**: quanto ci vuole per andare da un plesso a un altro; - **scuola → scuola**: quanto ci vuole per andare da un plesso a un altro;
- (in secondo piano) **casa del docente → scuola**: usato per favorire i docenti - (in secondo piano) **casa della docente e del docente → scuola**: usato per favorire le docenti ed i docenti
vicini alle sedi in cui insegnano. vicini alle sedi in cui insegnano.
> **Un solo plesso?** Se l'istituto ha un'unica scuola, questa pagina non ti serve: > **Un solo plesso?** Se l'istituto ha un'unica scuola, questa pagina non vi serve:
> non ci sono spostamenti tra sedi da gestire. Puoi saltare il capitolo. > non ci sono spostamenti tra sedi da gestire. Potete saltare il capitolo.
## Come i tempi influenzano l'orario ## Come i tempi influenzano l'orario
I tempi di viaggio entrano nella generazione in due modi (vedi I tempi di viaggio entrano nella generazione in due modi (vedete
[Panoramica](02-panoramica-del-processo.md)): [Panoramica](02-panoramica-del-processo.md)):
- **Come vincolo rigido:** tra due lezioni consecutive in plessi diversi deve - **Come vincolo rigido:** tra due lezioni consecutive in plessi diversi deve
@@ -29,47 +29,47 @@ I tempi di viaggio entrano nella generazione in due modi (vedi
viaggio con l'intervallo tra le due ore (definito dagli viaggio con l'intervallo tra le due ore (definito dagli
[orari delle campanelle](07-orari-e-campanella.md)). [orari delle campanelle](07-orari-e-campanella.md)).
- **Come obiettivo di qualità:** a parità di altre condizioni, il sistema cerca di - **Come obiettivo di qualità:** a parità di altre condizioni, il sistema cerca di
**ridurre** gli spostamenti totali dei docenti e di preferire le sedi vicine a **ridurre** gli spostamenti totali delle docenti e dei docenti e di preferire le sedi vicine a
casa loro. casa loro.
## Inserire i tempi di viaggio ## Inserire i tempi di viaggio
Per ogni coppia di scuole imposti il tempo di percorrenza: Per ogni coppia di scuole impostate il tempo di percorrenza:
1. Apri **Travel Matrix**. 1. Aprite **Travel Matrix**.
2. Scegli la scuola di partenza (**From**) e quella di arrivo (**To**). 2. Scegliete la scuola di partenza (**From**) e quella di arrivo (**To**).
3. Indica i **minuti di viaggio (Travel Minutes)**. 3. Indicate i **minuti di viaggio (Travel Minutes)**.
4. Salva. 4. Salvate.
![Matrice tempi di viaggio](img/travel-matrix.png) ![Matrice tempi di viaggio](img/travel-matrix.png)
I filtri in alto (From / To, con l'opzione *"Anywhere"* per non filtrare) ti I filtri in alto (From / To, con l'opzione *"Anywhere"* per non filtrare) vi
aiutano a trovare rapidamente la coppia che ti interessa quando le scuole sono aiutano a trovare rapidamente la coppia che vi interessa quando le scuole sono
molte. molte.
## Calcolo automatico (Recalculate) ## Calcolo automatico (Recalculate)
Se hai inserito le **coordinate geografiche** delle scuole Se avete inserito le **coordinate geografiche** delle scuole
([Scuole](05-scuole.md)), puoi usare il pulsante **Recalculate** (Ricalcola) per ([Scuole](05-scuole.md)), potete usare il pulsante **Recalculate** (Ricalcola) per
far **stimare automaticamente** i tempi al sistema, a partire dagli indirizzi e far **stimare automaticamente** i tempi al sistema, a partire dagli indirizzi e
dalle posizioni. dalle posizioni.
> **Attenzione: sono stime.** Il calcolo automatico si basa su una stima della > **Attenzione: sono stime.** Il calcolo automatico si basa su una stima della
> distanza e **non** conosce traffico, parcheggio o mezzi di trasporto. Controlla > distanza e **non** conosce traffico, parcheggio o mezzi di trasporto. Controllate
> sempre i valori proposti e correggi a mano le tratte che conosci: pochi minuti in > sempre i valori proposti e correggete a mano le tratte che conoscete: pochi minuti in
> più o in meno possono fare la differenza tra un orario ammissibile e uno no. > più o in meno possono fare la differenza tra un orario ammissibile e uno no.
## Consiglio pratico ## Consiglio pratico
Inserisci i tempi **in eccesso prudenziale** sulle tratte critiche. È preferibile Inserite i tempi **in eccesso prudenziale** sulle tratte critiche. È preferibile
un margine di sicurezza in più (che al massimo rende l'orario leggermente meno un margine di sicurezza in più (che al massimo rende l'orario leggermente meno
"compatto") piuttosto che un tempo troppo ottimistico che costringe un docente a "compatto") piuttosto che un tempo troppo ottimistico che costringe una docente ed un docente a
una corsa impossibile tra due plessi. una corsa impossibile tra due plessi.
--- ---
Con questo si conclude la parte di **configurazione dei dati**. Il prossimo Con questo si conclude la parte di **configurazione dei dati**. Il prossimo
capitolo apre la fase di **raccolta delle preferenze** dei docenti. capitolo apre la fase di **raccolta delle preferenze** delle docenti e dei docenti.
--- ---
+32 -32
@@ -1,13 +1,13 @@
# 12. Raccolta preferenze dei docenti # 12. Raccolta preferenze delle docenti e dei docenti
Le preferenze dei docenti migliorano sensibilmente la qualità dell'orario e il suo Le preferenze delle docenti e dei docenti migliorano sensibilmente la qualità dell'orario e il suo
gradimento. Invece di raccoglierle su carta o via email e inserirle a mano, puoi gradimento. Invece di raccoglierle su carta o via email e inserirle a mano, potete
lanciare una **campagna**: il sistema invia a ogni docente un link personale per lanciare una **campagna**: il sistema invia a ogni docente un link personale per
compilare da solo le proprie preferenze. compilare da sola o da solo le proprie preferenze.
> Voce di menu: **Configuration → Preferences Campaign**. > Voce di menu: **Configuration → Preferences Campaign**.
Questa fase è **facoltativa**: puoi generare un orario anche senza preferenze. Ma Questa fase è **facoltativa**: potete generare un orario anche senza preferenze. Ma
è **fortemente consigliata**, perché è ciò che trasforma un orario semplicemente è **fortemente consigliata**, perché è ciò che trasforma un orario semplicemente
"valido" in un orario "buono" per le persone. "valido" in un orario "buono" per le persone.
@@ -16,45 +16,45 @@ Questa fase è **facoltativa**: puoi generare un orario anche senza preferenze.
Il ciclo di vita di una campagna è lineare: Il ciclo di vita di una campagna è lineare:
``` ```
Crea → Invita i docenti → Invia le email → [I docenti rispondono] → Monitora le risposte Create → Invitate le docenti ed i docenti → Inviate le email → [Le docenti ed i docenti rispondono] → Monitorate le risposte
``` ```
1. **Crea** una campagna per l'anno scolastico, dandole un nome. 1. **Create** una campagna per l'anno scolastico, dandole un nome.
2. **Invita** i docenti scegliendoli dall'elenco. 2. **Invitate** le docenti ed i docenti scegliendole/l'i dall'elenco.
3. **Invia** le email: ogni docente riceve un link personale. 3. **Inviate** le email: ogni docente riceve un link personale.
4. I docenti **compilano** il modulo online. 4. Le docenti ed i docenti **compilano** il modulo online.
5. Tu **monitori** chi ha risposto e chi no. 5. Voi **monitorate** chi ha risposto e chi no.
## Passo 1 — Creare la campagna ## Passo 1 — Creare la campagna
1. Apri **Preferences Campaign** dal menu. 1. Aprite **Preferences Campaign** dal menu.
2. Crea una nuova campagna: scegli l'**anno scolastico** di riferimento e assegna 2. Create una nuova campagna: scegliete l'**anno scolastico** di riferimento e assegnate
un **nome** riconoscibile (es. `Preferenze 2025/2026`). un **nome** riconoscibile (es. `Preferenze 2025/2026`).
![Elenco campagne](img/campaign.png) ![Elenco campagne](img/campaign.png)
## Passo 2 — Invitare i docenti ## Passo 2 — Invitare le docenti ed i docenti
Seleziona, dall'elenco dei docenti inseriti in [Docenti](10-docenti.md), quelli che Selezionate, dall'elenco delle docenti e dei docenti inseriti in [Docenti](10-docenti.md), quelle e quelli che
vuoi includere nella campagna. Puoi invitarli tutti o solo una parte (per esempio volete includere nella campagna. Potete invitarle/invitarli tutte e tutti o solo una parte (per esempio
solo i nuovi docenti, se gli altri hanno già fornito le preferenze). solo le nuove docenti ed i nuovi docenti, se le altre/gli altri hanno già fornito le preferenze).
> **Requisito.** Ogni docente invitato deve avere un **indirizzo email valido** > **Requisito.** Ogni docente invitata o invitato deve avere un **indirizzo email valido**
> nella sua scheda: è lì che verrà recapitato il link. > nella sua scheda: è lì che verrà recapitato il link.
## Passo 3 — Inviare le email ## Passo 3 — Inviare le email
Con il comando di invio, il sistema spedisce a ciascun docente invitato un'email Con il comando di invio, il sistema spedisce a ciascuna docente invitata ed a ciascun docente invitato un'email
con un **link personale e univoco**. Il link porta a un modulo online dedicato, con un **link personale e univoco**. Il link porta a un modulo online dedicato,
senza bisogno di username o password: il collegamento stesso identifica il docente. senza bisogno di username o password: il collegamento stesso identifica la docente ed il docente.
> **Privacy e sicurezza del link.** Il link è personale e va usato una sola volta. > **Privacy e sicurezza del link.** Il link è personale e va usato una sola volta.
> Invita i docenti a non condividerlo: chi possiede il link può compilare le > Invitate le docenti ed i docenti a non condividerlo: chi possiede il link può compilare le
> preferenze a nome loro. > preferenze a nome loro.
## Passo 4 — Cosa compila il docente ## Passo 4 — Cosa compila la docente ed il docente
Il docente apre il link e trova un modulo semplice in cui può indicare, tra La docente ed il docente apre il link e trova un modulo semplice in cui può indicare, tra
l'altro: l'altro:
- l'**indirizzo di casa** (per il calcolo degli spostamenti); - l'**indirizzo di casa** (per il calcolo degli spostamenti);
@@ -66,34 +66,34 @@ l'altro:
- le **caratteristiche dell'orario** (preferenza per il mattino, orario compatto); - le **caratteristiche dell'orario** (preferenza per il mattino, orario compatto);
- le **indisponibilità assolute**. - le **indisponibilità assolute**.
Sono le stesse informazioni che potresti inserire tu dalla scheda del docente Sono le stesse informazioni che potreste inserire voi dalla scheda della docente e del docente
([Docenti](10-docenti.md)); qui però le fornisce direttamente l'interessato. ([Docenti](10-docenti.md)); qui però le fornisce direttamente l'interessata e l'interessato.
![Modulo preferenze del docente](img/preferences-form.png) ![Modulo preferenze della docente e del docente](img/preferences-form.png)
## Passo 5 — Monitorare le risposte ## Passo 5 — Monitorare le risposte
Aprendo il **dettaglio della campagna** vedi, per ciascun invitato, se ha già Aprendo il **dettaglio della campagna** vedete, per ciascuna invitata e ciascun invitato, se ha già
risposto oppure no. Usa questa vista per: risposto oppure no. Usate questa vista per:
- sollecitare chi è in ritardo; - sollecitare chi è in ritardo;
- decidere quando "chiudere" la raccolta e passare alla generazione. - decidere quando "chiudere" la raccolta e passare alla generazione.
![Dettaglio campagna con stato risposte](img/campaign-details.png) ![Dettaglio campagna con stato risposte](img/campaign-details.png)
> **Non serve aspettare il 100%.** Puoi generare l'orario anche se non tutti hanno > **Non serve aspettare il 100%.** Potete generare l'orario anche se non tutte e tutti hanno
> risposto: per i docenti senza preferenze il sistema semplicemente non avrà > risposto: per le docenti ed i docenti senza preferenze il sistema semplicemente non avrà
> obiettivi da rispettare, ma l'orario resterà comunque valido. > obiettivi da rispettare, ma l'orario resterà comunque valido.
## In ambiente di prova ## In ambiente di prova
Se il sistema è configurato in modalità di prova, le email potrebbero non essere Se il sistema è configurato in modalità di prova, le email potrebbero non essere
spedite davvero ma solo registrate. In tal caso rivolgiti a chi gestisce spedite davvero ma solo registrate. In tal caso rivolgetevi a chi gestisce
l'installazione per ottenere i link o per attivare l'invio reale. l'installazione per ottenere i link o per attivare l'invio reale.
--- ---
Quando i dati sono pronti e (idealmente) le preferenze raccolte, sei pronto per il Quando i dati sono pronti e (idealmente) le preferenze raccolte, siete pronte e pronti per il
momento più atteso: **generare l'orario**. momento più atteso: **generare l'orario**.
--- ---
+21 -21
@@ -1,43 +1,43 @@
# 13. Generazione dell'orario # 13. Generazione dell'orario
È il momento in cui il sistema costruisce l'orario al posto tuo. In questa pagina È il momento in cui il sistema costruisce l'orario al posto vostro. In questa pagina
imposti l'ambito e le impostazioni, avvii il **motore di ottimizzazione** e ne impostate l'ambito e le impostazioni, avviate il **motore di ottimizzazione** e ne
segui l'avanzamento in tempo reale. seguite l'avanzamento in tempo reale.
> Voce di menu: **Timetable → Generate**. > Voce di menu: **Timetable → Generate**.
## Prima di iniziare: la lista di controllo ## Prima di iniziare: la lista di controllo
La generazione riesce solo se i dati sono completi. Verifica di aver definito: La generazione riesce solo se i dati sono completi. Verificate di aver definito:
- [ ] l'**anno scolastico** ([cap. 4](04-anni-scolastici.md)); - [ ] l'**anno scolastico** ([cap. 4](04-anni-scolastici.md));
- [ ] almeno una **scuola** ([cap. 5](05-scuole.md)); - [ ] almeno una **scuola** ([cap. 5](05-scuole.md));
- [ ] gli **orari delle campanelle** per ogni scuola ([cap. 7](07-orari-e-campanella.md)); - [ ] gli **orari delle campanelle** per ogni scuola ([cap. 7](07-orari-e-campanella.md));
- [ ] le **materie** ([cap. 8](08-materie.md)); - [ ] le **materie** ([cap. 8](08-materie.md));
- [ ] le **classi** con **monte ore** e **docenti assegnati** ([cap. 9](09-classi.md)); - [ ] le **classi** con **monte ore** e **docenti assegnate ed assegnati** ([cap. 9](09-classi.md));
- [ ] i **docenti** con i loro limiti ([cap. 10](10-docenti.md)); - [ ] le **docenti** ed i **docenti** con i loro limiti ([cap. 10](10-docenti.md));
- [ ] le **aule/laboratori** se richiesti ([cap. 6](06-aule-e-laboratori.md)); - [ ] le **aule/laboratori** se richiesti ([cap. 6](06-aule-e-laboratori.md));
- [ ] i **tempi di viaggio** se hai più plessi ([cap. 11](11-spostamenti.md)); - [ ] i **tempi di viaggio** se avete più plessi ([cap. 11](11-spostamenti.md));
- [ ] (facoltativo) le **preferenze** dei docenti ([cap. 12](12-raccolta-preferenze.md)). - [ ] (facoltativo) le **preferenze** delle docenti e dei docenti ([cap. 12](12-raccolta-preferenze.md)).
## Come lavora il motore, in due parole ## Come lavora il motore, in due parole
Il motore prima cerca una soluzione che rispetti **tutti i vincoli rigidi** Il motore prima cerca una soluzione che rispetti **tutti i vincoli rigidi**
(orario *ammissibile*), poi la **migliora** massimizzando le preferenze (orario (orario *ammissibile*), poi la **migliora** massimizzando le preferenze (orario
*di qualità*). Può trovare **più soluzioni** e proporti le migliori a confronto. *di qualità*). Può trovare **più soluzioni** e proporti le migliori a confronto.
Non devi capire la matematica sottostante: ti basta configurare bene i dati e Non dovete capire la matematica sottostante: vi basta configurare bene i dati e
scegliere quanto tempo concedergli. scegliere quanto tempo concedergli.
## Passo 1 — Scegliere l'anno e l'ambito ## Passo 1 — Scegliere l'anno e l'ambito
1. Seleziona l'**anno scolastico** di destinazione. 1. Selezionate l'**anno scolastico** di destinazione.
2. Scegli l'**ambito (scope)**: 2. Scegliete l'**ambito (scope)**:
- **tutto l'istituto** (tutte le scuole e tutte le classi), oppure - **tutto l'istituto** (tutte le scuole e tutte le classi), oppure
- un **sottoinsieme** (alcune scuole o alcune classi). - un **sottoinsieme** (alcune scuole o alcune classi).
> **Ambito più stretto = calcolo più rapido.** Generare per una sola scuola alla > **Ambito più stretto = calcolo più rapido.** Generare per una sola scuola alla
> volta è utile per fare prove veloci o per programmare in modo incrementale > volta è utile per fare prove veloci o per programmare in modo incrementale
> (generi e "congeli" una parte, poi procedi con il resto). > (generate e "congelate" una parte, poi procedete con il resto).
![Pagina di generazione — scelta ambito](img/generate.png) ![Pagina di generazione — scelta ambito](img/generate.png)
@@ -46,42 +46,42 @@ scegliere quanto tempo concedergli.
Un **preset** è una configurazione salvata che dice al sistema **quanto** dare Un **preset** è una configurazione salvata che dice al sistema **quanto** dare
importanza a ciascun obiettivo di qualità (i **pesi**). importanza a ciascun obiettivo di qualità (i **pesi**).
- Per il **primo orario** lascia il **preset predefinito**: i pesi standard vanno - Per il **primo orario** lasciate il **preset predefinito**: i pesi standard vanno
bene nella maggior parte dei casi. bene nella maggior parte dei casi.
- In seguito puoi creare preset personalizzati per dare più peso, ad esempio, alla - In seguito potete creare preset personalizzati per dare più peso, ad esempio, alla
**riduzione degli spostamenti** o al **rispetto delle preferenze**. **riduzione degli spostamenti** o al **rispetto delle preferenze**.
Passando il mouse sulle singole opzioni compaiono dei **suggerimenti** che spiegano Passando il mouse sulle singole opzioni compaiono dei **suggerimenti** che spiegano
a cosa serve ciascun peso. Per capire *come* i pesi influenzano il risultato, leggi a cosa serve ciascun peso. Per capire *come* i pesi influenzano il risultato, leggete
[Comprendere i punteggi di qualità](14-comprendere-i-punteggi.md). [Comprendere i punteggi di qualità](14-comprendere-i-punteggi.md).
> **Regola d'oro dei pesi.** I pesi sono **priorità relative**, non percentuali. > **Regola d'oro dei pesi.** I pesi sono **priorità relative**, non percentuali.
> Alzare il peso di un obiettivo lo fa preferire *a scapito* degli altri. Cambia > Alzare il peso di un obiettivo lo fa preferire *a scapito* degli altri. Cambiate
> **un peso alla volta** e rigenera, così capisci l'effetto di ciascuna modifica. > **un peso alla volta** e rigenerate, così capite l'effetto di ciascuna modifica.
## Passo 3 — Impostare le opzioni del solutore ## Passo 3 — Impostare le opzioni del solutore
Le principali impostazioni tecniche sono: Le principali impostazioni tecniche sono:
- **Tempo massimo (timeout):** per quanti secondi il motore può lavorare. Più tempo - **Tempo massimo (timeout):** per quanti secondi il motore può lavorare. Più tempo
gli concedi, migliore può essere la soluzione. Per istituti grandi, aumenta questo gli concedete, migliore può essere la soluzione. Per istituti grandi, aumentate questo
valore. valore.
- **Numero massimo di soluzioni:** quante alternative raccogliere per il confronto. - **Numero massimo di soluzioni:** quante alternative raccogliere per il confronto.
Puoi partire dai valori predefiniti e regolarli in base ai risultati. Potete partire dai valori predefiniti e regolarli in base ai risultati.
![Opzioni e pesi del solutore](img/generate-options.png) ![Opzioni e pesi del solutore](img/generate-options.png)
## Passo 4 — Avviare e seguire l'avanzamento ## Passo 4 — Avviare e seguire l'avanzamento
Premi **Generate** (Genera). Durante il lavoro vedrai un **avanzamento in tempo Premete **Generate** (Genera). Durante il lavoro vedrete un **avanzamento in tempo
reale**: reale**:
- il numero di **soluzioni trovate** finora; - il numero di **soluzioni trovate** finora;
- la **qualità** (valore obiettivo) della migliore soluzione trovata; - la **qualità** (valore obiettivo) della migliore soluzione trovata;
- il **tempo trascorso**. - il **tempo trascorso**.
Lascia la pagina aperta durante il calcolo. Se la connessione in tempo reale Lasciate la pagina aperta durante il calcolo. Se la connessione in tempo reale
dovesse interrompersi, il sistema continua comunque a lavorare e aggiorna lo stato dovesse interrompersi, il sistema continua comunque a lavorare e aggiorna lo stato
periodicamente. periodicamente.
+18 -18
@@ -1,8 +1,8 @@
# 14. Comprendere i punteggi di qualità # 14. Comprendere i punteggi di qualità
Ogni versione di orario generata riceve dei **punteggi** che ne misurano la Ogni versione di orario generata riceve dei **punteggi** che ne misurano la
qualità. Capirli ti permette di **confrontare** le versioni e di scegliere con qualità. Capirli vi permette di **confrontare** le versioni e di scegliere con
consapevolezza, invece di affidarti all'impressione. Questo capitolo spiega cosa consapevolezza, invece di affidarvi all'impressione. Questo capitolo spiega cosa
significano, senza formule complicate. significano, senza formule complicate.
## Le due domande a cui rispondono i punteggi ## Le due domande a cui rispondono i punteggi
@@ -15,16 +15,16 @@ significano, senza formule complicate.
Il **punteggio composito** riassume la qualità complessiva in un unico numero da Il **punteggio composito** riassume la qualità complessiva in un unico numero da
**0 a 100**: più è alto, migliore è l'orario. È una **media pesata** dei singoli **0 a 100**: più è alto, migliore è l'orario. È una **media pesata** dei singoli
obiettivi di qualità, dove i "pesi" sono quelli che hai scelto nel preset di obiettivi di qualità, dove i "pesi" sono quelli che avete scelto nel preset di
generazione ([cap. 13](13-generazione-orario.md)). generazione ([cap. 13](13-generazione-orario.md)).
> **La regola più importante.** Se un orario viola **anche un solo vincolo rigido**, > **La regola più importante.** Se un orario viola **anche un solo vincolo rigido**,
> il suo punteggio composito è forzato a **0**, indipendentemente da quanto sia > il suo punteggio composito è forzato a **0**, indipendentemente da quanto sia
> buono sul resto. Un composito pari a 0 è quindi un campanello d'allarme: guarda > buono sul resto. Un composito pari a 0 è quindi un campanello d'allarme: guardate
> subito la scheda dei **conflitti** ([cap. 15](15-revisione-orario.md#scheda-conflitti-conflicts)). > subito la scheda dei **conflitti** ([cap. 15](15-revisione-orario.md#scheda-conflitti-conflicts)).
> **Il composito è assoluto.** Ogni versione è valutata per conto proprio, non "in > **Il composito è assoluto.** Ogni versione è valutata per conto proprio, non "in
> classifica" rispetto alle altre. Puoi quindi confrontare direttamente i compositi > classifica" rispetto alle altre. Potete quindi confrontare direttamente i compositi
> di due versioni: 82 è meglio di 75. > di due versioni: 82 è meglio di 75.
## Le categorie di qualità ## Le categorie di qualità
@@ -40,31 +40,31 @@ percentuale): **1 = pienamente soddisfatta**, **0 = del tutto disattesa**.
| **Preferenza mattino** | Quanta parte delle lezioni cade al mattino, per chi lo preferisce. | | **Preferenza mattino** | Quanta parte delle lezioni cade al mattino, per chi lo preferisce. |
| **Orario compatto** | Quanto le lezioni di ogni docente sono consecutive, senza "buchi". | | **Orario compatto** | Quanto le lezioni di ogni docente sono consecutive, senza "buchi". |
| **Tempo di viaggio** | Quanto sono contenuti gli spostamenti tra plessi. | | **Tempo di viaggio** | Quanto sono contenuti gli spostamenti tra plessi. |
| **Giorno libero** | Se il giorno libero preferito dal docente è stato rispettato. | | **Giorno libero** | Se il giorno libero preferito dal/dalla docente è stato rispettato. |
| **Distribuzione delle classi** | Quanto le ore di una stessa classe sono distribuite su più giorni (invece di ammassarsi). | | **Distribuzione delle classi** | Quanto le ore di una stessa classe sono distribuite su più giorni (invece di ammassarsi). |
| **Tragitto casa-scuola** | Quanto è contenuto il tragitto da casa alle sedi. | | **Tragitto casa-scuola** | Quanto è contenuto il tragitto da casa alle sedi. |
> **Categorie non applicabili.** Se una categoria non riguarda un docente (per > **Categorie non applicabili.** Se una categoria non riguarda un/una docente (per
> esempio non ha indicato un giorno libero), per lui quella categoria vale come > esempio non ha indicato un giorno libero), per lui/lei quella categoria vale come
> pienamente soddisfatta e non penalizza il punteggio. > pienamente soddisfatta e non penalizza il punteggio.
## Dove leggi i punteggi ## Dove leggete i punteggi
- **Nella lista delle versioni** ([Revisione](15-revisione-orario.md)) vedi il - **Nella lista delle versioni** ([Revisione](15-revisione-orario.md)) vedete il
**composito** di ciascuna versione, utile per un confronto immediato. **composito** di ciascuna versione, utile per un confronto immediato.
- **Nella scheda "Scores"** del dettaglio vedi la **scomposizione per categoria** - **Nella scheda "Scores"** del dettaglio vedete la **scomposizione per categoria**
con grafici a barre e radar, e anche il **dettaglio per singolo docente**. con grafici a barre e radar, e anche il **dettaglio per singolo docente**.
![Scheda Scores con grafici e scomposizione](img/review-report.png) ![Scheda Scores con grafici e scomposizione](img/review-report.png)
## Come usare i punteggi nella pratica ## Come usare i punteggi nella pratica
- **Confronta due versioni** guardando prima il composito, poi le categorie: una - **Confrontate due versioni** guardando prima il composito, poi le categorie: una
versione può avere composito più basso ma essere migliore proprio versione può avere composito più basso ma essere migliore proprio
sull'aspetto che a te sta più a cuore. sull'aspetto che a voi sta più a cuore.
- **Individua il punto debole:** la categoria con il valore più basso ti dice cosa - **Individuate il punto debole:** la categoria con il valore più basso vi dice cosa
migliorare. Se, ad esempio, "Orario compatto" è basso, aumenta il peso della migliorare. Se, ad esempio, "Orario compatto" è basso, aumentate il peso della
compattezza nel preset e rigenera. compattezza nel preset e rigenerate.
- **Non inseguire il 100.** Gli obiettivi sono spesso in conflitto tra loro - **Non inseguire il 100.** Gli obiettivi sono spesso in conflitto tra loro
(ridurre i buchi può aumentare gli spostamenti, e viceversa): un buon orario è un (ridurre i buchi può aumentare gli spostamenti, e viceversa): un buon orario è un
**compromesso equilibrato**, non un punteggio perfetto ovunque. **compromesso equilibrato**, non un punteggio perfetto ovunque.
@@ -73,8 +73,8 @@ percentuale): **1 = pienamente soddisfatta**, **0 = del tutto disattesa**.
I **pesi** scelti in fase di generazione decidono **quanto** ciascuna categoria I **pesi** scelti in fase di generazione decidono **quanto** ciascuna categoria
incide sul composito. Alzare il peso di una categoria spinge il motore a curarla di incide sul composito. Alzare il peso di una categoria spinge il motore a curarla di
più, tipicamente a scapito di altre. È il meccanismo con cui traduci le priorità più, tipicamente a scapito di altre. È il meccanismo con cui traducete le priorità
del tuo istituto in numeri. Rivedi [Generazione — pesi](13-generazione-orario.md#passo-2--scegliere-il-preset-e-i-pesi). del vostro istituto in numeri. Rivedete [Generazione — pesi](13-generazione-orario.md#passo-2--scegliere-il-preset-e-i-pesi).
--- ---
+21 -21
@@ -1,21 +1,21 @@
# 15. Revisione e confronto delle versioni # 15. Revisione e confronto delle versioni
Dopo la generazione, la pagina di **Revisione** è il tuo centro di controllo: qui Dopo la generazione, la pagina di **Revisione** è il vostro centro di controllo: qui
vedi tutte le versioni di orario prodotte per un anno, le apri in dettaglio, le vedete tutte le versioni di orario prodotte per un anno, le aprite in dettaglio, le
confronti, e infine ne finalizzi una come orario ufficiale. confronti, e infine ne finalizzate una come orario ufficiale.
> Voce di menu: **Timetable → Review**. > Voce di menu: **Timetable → Review**.
## L'elenco delle versioni ## L'elenco delle versioni
Selezionato l'anno scolastico, vedi l'elenco delle **versioni** generate. Per Selezionato l'anno scolastico, vedete l'elenco delle **versioni** generate. Per
ciascuna sono indicati: ciascuna sono indicati:
- il **punteggio composito** (0100) — vedi [Comprendere i punteggi](14-comprendere-i-punteggi.md); - il **punteggio composito** (0100) — vedete [Comprendere i punteggi](14-comprendere-i-punteggi.md);
- lo **stato**: *bozza (draft)*, *finale (final)* o *archiviata (archived)*; - lo **stato**: *bozza (draft)*, *finale (final)* o *archiviata (archived)*;
- la **data di creazione**. - la **data di creazione**.
Espandendo una versione ne vedi una sintesi della valutazione. È qui che confronti Espandendo una versione ne vedete una sintesi della valutazione. È qui che confronti
"a colpo d'occhio" le alternative prima di aprirne una. "a colpo d'occhio" le alternative prima di aprirne una.
![Elenco versioni generate](img/review.png) ![Elenco versioni generate](img/review.png)
@@ -30,10 +30,10 @@ Espandendo una versione ne vedi una sintesi della valutazione. È qui che confro
## Il dettaglio di una versione ## Il dettaglio di una versione
Cliccando una versione ne apri il **dettaglio**, organizzato in quattro schede. Cliccando una versione ne aprite il **dettaglio**, organizzato in quattro schede.
### Scheda griglia (Grid) ### Scheda griglia (Grid)
È l'orario vero e proprio, in forma di tabella giorni × ore. Puoi **filtrare** la È l'orario vero e proprio, in forma di tabella giorni × ore. Potete **filtrare** la
vista per: vista per:
- **classe** — l'orario di una singola classe; - **classe** — l'orario di una singola classe;
@@ -42,14 +42,14 @@ vista per:
- **materia** o **giorno**. - **materia** o **giorno**.
Ogni cella mostra l'assegnazione: materia, docente e — se prevista — l'aula/ Ogni cella mostra l'assegnazione: materia, docente e — se prevista — l'aula/
laboratorio. È la vista che userai di più per controllare "a occhio" l'orario. laboratorio. È la vista che userete di più per controllare "a occhio" l'orario.
![Dettaglio versione — griglia orario](img/review-details.png) ![Dettaglio versione — griglia orario](img/review-details.png)
### Scheda punteggi (Scores) ### Scheda punteggi (Scores)
La scomposizione della qualità con grafici (barre e radar) e il **dettaglio per La scomposizione della qualità con grafici (barre e radar) e il **dettaglio per
docente**. Serve a capire i punti di forza e di debolezza della versione. Per docente**. Serve a capire i punti di forza e di debolezza della versione. Per
interpretarla, vedi [Comprendere i punteggi](14-comprendere-i-punteggi.md). interpretarla, vedete [Comprendere i punteggi](14-comprendere-i-punteggi.md).
### Scheda assegnazioni (Assignments) ### Scheda assegnazioni (Assignments)
Il riepilogo del **carico di lavoro** dei docenti: Il riepilogo del **carico di lavoro** dei docenti:
@@ -58,46 +58,46 @@ Il riepilogo del **carico di lavoro** dei docenti:
- distribuzione tra le classi; - distribuzione tra le classi;
- necessità di spostamento per chi insegna su più plessi. - necessità di spostamento per chi insegna su più plessi.
Utile per verificare che nessun docente sia sovraccarico e per controllare gli Utile per verificare che nessun/nessuna docente sia sovraccarico/a e per controllare gli
spostamenti. spostamenti.
### Scheda conflitti (Conflicts) ### Scheda conflitti (Conflicts)
Elenca le eventuali **violazioni di vincoli rigidi**. Per una versione generata dal Elenca le eventuali **violazioni di vincoli rigidi**. Per una versione generata dal
motore **dovrebbe essere vuota**. Se contiene qualcosa (tipicamente dopo una motore **dovrebbe essere vuota**. Se contiene qualcosa (tipicamente dopo una
[personalizzazione manuale](16-personalizzazione-orario.md)), qui trovi [personalizzazione manuale](16-personalizzazione-orario.md)), qui trovi
esattamente cosa non va — per esempio un docente in due classi contemporaneamente o esattamente cosa non va — per esempio un/una docente in due classi contemporaneamente o
un monte ore non rispettato. un monte ore non rispettato.
> **Ricorda:** qualsiasi conflitto rigido porta il punteggio composito a **0**. > **Ricordate:** qualsiasi conflitto rigido porta il punteggio composito a **0**.
> Controlla questa scheda ogni volta che il composito è 0. > Controllate questa scheda ogni volta che il composito è 0.
## Confrontare le versioni ## Confrontare le versioni
Poiché l'elenco mostra tutte le versioni dello stesso anno, puoi confrontarle su: Poiché l'elenco mostra tutte le versioni dello stesso anno, potete confrontarle su:
- il **composito** (qualità complessiva); - il **composito** (qualità complessiva);
- le **categorie** di qualità (aprendo la scheda Scores di ciascuna); - le **categorie** di qualità (aprendo la scheda Scores di ciascuna);
- il **numero di lezioni collocate** e il carico dei docenti. - il **numero di lezioni collocate** e il carico dei docenti.
Un metodo pratico: apri due versioni in due schede del browser e confrontane le Un metodo pratico: aprite due versioni in due schede del browser e confrontane le
schede *Scores* e *Grid* fianco a fianco. schede *Scores* e *Grid* fianco a fianco.
## Finalizzare una versione ## Finalizzare una versione
Quando hai scelto l'orario definitivo, clicca **Finalize** (Finalizza) sulla Quando avete scelto l'orario definitivo, cliccate **Finalize** (Finalizza) sulla
versione: versione:
- lo stato passa a **finale**; - lo stato passa a **finale**;
- la versione viene **bloccata** contro ulteriori modifiche accidentali. - la versione viene **bloccata** contro ulteriori modifiche accidentali.
Finalizza **solo** una versione priva di conflitti e che ti soddisfa: è il segnale Finalizzate **solo** una versione priva di conflitti e che vi soddisfa: è il segnale
che quello è l'orario ufficiale. Se in seguito devi correggerla, usa la che quello è l'orario ufficiale. Se in seguito dovete correggerla, usate la
[personalizzazione](16-personalizzazione-orario.md), che lavora su una copia. [personalizzazione](16-personalizzazione-orario.md), che lavora su una copia.
## Eliminare una versione ## Eliminare una versione
Con **Delete** (Elimina) rimuovi una versione che non ti serve. L'operazione Con **Delete** (Elimina) rimuovete una versione che non vi serve. L'operazione
richiede una **doppia conferma** per evitare cancellazioni accidentali. Elimina richiede una **doppia conferma** per evitare cancellazioni accidentali. Eliminate
liberamente le bozze scartate per tenere l'elenco pulito. liberamente le bozze scartate per tenere l'elenco pulito.
--- ---
+18 -18
@@ -2,7 +2,7 @@
Anche il miglior orario automatico a volte va ritoccato: un cambio dell'ultimo Anche il miglior orario automatico a volte va ritoccato: un cambio dell'ultimo
minuto, un caso particolare che il motore non poteva conoscere, una richiesta minuto, un caso particolare che il motore non poteva conoscere, una richiesta
sopraggiunta. La **personalizzazione** ti permette di modificare a mano una sopraggiunta. La **personalizzazione** vi permette di modificare a mano una
versione mantenendo il pieno controllo. versione mantenendo il pieno controllo.
> Si apre con **Customize** (Personalizza) dalla pagina di > Si apre con **Customize** (Personalizza) dalla pagina di
@@ -10,19 +10,19 @@ versione mantenendo il pieno controllo.
## Il principio: si lavora su una copia ## Il principio: si lavora su una copia
Quando personalizzi una versione, il sistema **non** modifica l'originale: crea una Quando personalizzate una versione, il sistema **non** modifica l'originale: crea una
**nuova bozza** derivata da essa. Questo significa che: **nuova bozza** derivata da essa. Questo significa che:
- l'orario di partenza resta **intatto** e sempre recuperabile; - l'orario di partenza resta **intatto** e sempre recuperabile;
- puoi fare esperimenti senza timore; - potete fare esperimenti senza timore;
- puoi generare più varianti manuali e confrontarle come qualsiasi altra versione. - potete generare più varianti manuali e confrontarle come qualsiasi altra versione.
## Cosa puoi fare ## Cosa potete fare
Nella pagina di personalizzazione vedi **tutte le assegnazioni** (le singole Nella pagina di personalizzazione vedete **tutte le assegnazioni** (le singole
lezioni) in una tabella filtrabile e ordinabile. Su ciascuna puoi: lezioni) in una tabella filtrabile e ordinabile. Su ciascuna potete:
- **Modificare** una lezione: cambiare lo **slot** (giorno/ora), il **docente** - **Modificare** una lezione: cambiare lo **slot** (giorno/ora), il/la **docente**
oppure l'**aula/laboratorio**. oppure l'**aula/laboratorio**.
- **Rimuovere** una lezione: eliminare una specifica assegnazione. - **Rimuovere** una lezione: eliminare una specifica assegnazione.
- **Aggiungere** una lezione: inserire manualmente una nuova assegnazione. - **Aggiungere** una lezione: inserire manualmente una nuova assegnazione.
@@ -33,28 +33,28 @@ lezioni) in una tabella filtrabile e ordinabile. Su ciascuna puoi:
Questo è il punto più importante da ricordare. Questo è il punto più importante da ricordare.
> **Le modifiche manuali NON vengono ri-validate automaticamente.** Spostando una > **Le modifiche manuali NON vengono ri-validate automaticamente.** Spostando una
> lezione potresti, senza accorgertene, creare un conflitto: due lezioni della > lezione potreste, senza accorgervene, creare un conflitto: due lezioni della
> stessa classe alla stessa ora, un docente in due posti insieme, un monte ore non > stessa classe alla stessa ora, un/una docente in due posti insieme, un monte ore non
> più rispettato, un tempo di viaggio insufficiente. > più rispettato, un tempo di viaggio insufficiente.
Per questo, **dopo** ogni sessione di modifiche: Per questo, **dopo** ogni sessione di modifiche:
1. Salva la nuova bozza. 1. Salvate la nuova bozza.
2. Aprila in [Revisione](15-revisione-orario.md) e controlla la **scheda 2. Apritela in [Revisione](15-revisione-orario.md) e controllate la **scheda
Conflitti**. Conflitti**.
3. Usa la funzione di **validazione (Validate)** per verificare che non siano stati 3. Usate la funzione di **validazione (Validate)** per verificare che non siano stati
introdotti conflitti rigidi. introdotti conflitti rigidi.
Se la scheda Conflitti è vuota e il punteggio composito non è 0, la tua versione Se la scheda Conflitti è vuota e il punteggio composito non è 0, la vostra versione
manuale è valida. manuale è valida.
## Quando personalizzare e quando rigenerare ## Quando personalizzare e quando rigenerare
- **Personalizza** per **piccoli ritocchi**: spostare una o due lezioni, sostituire - **Personalizza** per **piccoli ritocchi**: spostare una o due lezioni, sostituire
un docente per una supplenza, cambiare un'aula. Sono interventi mirati che non un/una docente per una supplenza, cambiare un'aula. Sono interventi mirati che non
giustificano una nuova generazione. giustificano una nuova generazione.
- **Rigenera** ([cap. 13](13-generazione-orario.md)) quando i cambiamenti sono - **Rigenera** ([cap. 13](13-generazione-orario.md)) quando i cambiamenti sono
**strutturali**: è cambiato il monte ore, si è aggiunta una classe o un docente, **strutturali**: è cambiato il monte ore, si è aggiunta una classe o un/una docente,
sono cambiate molte preferenze. In questi casi conviene ripartire dal motore. sono cambiate molte preferenze. In questi casi conviene ripartire dal motore.
## Un flusso di lavoro efficace ## Un flusso di lavoro efficace
@@ -62,10 +62,10 @@ manuale è valida.
Il modo migliore di usare lo strumento combina automatico e manuale: Il modo migliore di usare lo strumento combina automatico e manuale:
``` ```
Genera → Scegli la versione migliore → Personalizza i dettagli → Valida → Finalizza Generate → Scegliete la versione migliore → Personalizzate i dettagli → Validate → Finalizzate
``` ```
Così sfrutti la potenza del motore per il grosso del lavoro e il tuo giudizio per Così sfruttate la potenza del motore per il grosso del lavoro e il vostro giudizio per
gli ultimi ritocchi. gli ultimi ritocchi.
--- ---
+10 -10
@@ -1,26 +1,26 @@
# 17. Esportazione in foglio di calcolo # 17. Esportazione in foglio di calcolo
Una volta scelto (ed eventualmente rifinito e finalizzato) l'orario, dovrai Una volta scelto (ed eventualmente rifinito e finalizzato) l'orario, dovrete
distribuirlo a docenti e classi, stamparlo e magari conservarlo negli archivi distribuirlo a docenti e classi, stamparlo e magari conservarlo negli archivi
della scuola. Lo strumento permette di **esportare** l'orario in un foglio di della scuola. Lo strumento permette di **esportare** l'orario in un foglio di
calcolo pronto all'uso. calcolo pronto all'uso.
## Formati disponibili ## Formati disponibili
Puoi esportare in due formati, entrambi apribili con i più comuni programmi da Potete esportare in due formati, entrambi apribili con i più comuni programmi da
ufficio: ufficio:
- **XLSX** — il formato di Microsoft Excel (apribile anche con LibreOffice, - **XLSX** — il formato di Microsoft Excel (apribile anche con LibreOffice,
Google Fogli, ecc.). Google Fogli, ecc.).
- **ODS** — il formato OpenDocument (LibreOffice/OpenOffice Calc). - **ODS** — il formato OpenDocument (LibreOffice/OpenOffice Calc).
Scegli il formato in base al programma che usi abitualmente; il contenuto è Scegliete il formato in base al programma che usate abitualmente; il contenuto è
identico. identico.
## Da dove si esporta ## Da dove si esporta
L'esportazione si avvia dalla pagina di [Revisione](15-revisione-orario.md) o dal L'esportazione si avvia dalla pagina di [Revisione](15-revisione-orario.md) o dal
**dettaglio** della versione. Individua la versione che vuoi esportare e usa il **dettaglio** della versione. Individua la versione che volete esportare e usate il
comando di esportazione, scegliendo il formato. comando di esportazione, scegliendo il formato.
## Cosa contiene il file ## Cosa contiene il file
@@ -38,25 +38,25 @@ sia quelli individuali per i docenti.
## Consigli per la distribuzione ## Consigli per la distribuzione
- **Esporta la versione finalizzata**, non una bozza di lavoro: eviti di far - **Esportate la versione finalizzata**, non una bozza di lavoro: evitate di far
circolare orari provvisori. circolare orari provvisori.
- Prima di stampare, dai un'occhiata all'**anteprima di stampa** del foglio di - Prima di stampare, date un'occhiata all'**anteprima di stampa** del foglio di
calcolo e regola margini e orientamento (l'orizzontale spesso rende meglio per le calcolo e regolate margini e orientamento (l'orizzontale spesso rende meglio per le
griglie settimanali). griglie settimanali).
- Conserva una copia del file di esportazione insieme alla documentazione - Conservate una copia del file di esportazione insieme alla documentazione
dell'anno: sarà un utile riferimento e punto di partenza per l'anno successivo. dell'anno: sarà un utile riferimento e punto di partenza per l'anno successivo.
## E se devo ancora fare modifiche? ## E se devo ancora fare modifiche?
Se dopo l'esportazione emerge la necessità di un cambiamento, **non** modificare il Se dopo l'esportazione emerge la necessità di un cambiamento, **non** modificare il
foglio di calcolo: le modifiche fatte lì non tornano nel sistema e rischi di far foglio di calcolo: le modifiche fatte lì non tornano nel sistema e rischi di far
circolare versioni discordanti. Torna invece nello strumento, usa la circolare versioni discordanti. Tornate invece nello strumento, usate la
[personalizzazione](16-personalizzazione-orario.md), valida e **riesporta**. Il [personalizzazione](16-personalizzazione-orario.md), valida e **riesporta**. Il
file esportato deve sempre rispecchiare l'orario "ufficiale" presente nel sistema. file esportato deve sempre rispecchiare l'orario "ufficiale" presente nel sistema.
--- ---
Hai completato l'intero percorso: dai dati all'orario esportato. L'ultima parte del avete completato l'intero percorso: dai dati all'orario esportato. L'ultima parte del
manuale raccoglie consigli pratici e soluzioni ai problemi più comuni. manuale raccoglie consigli pratici e soluzioni ai problemi più comuni.
--- ---
+36 -36
@@ -8,12 +8,12 @@ soluzioni.
### Cura i dati: è lì che si vince o si perde ### Cura i dati: è lì che si vince o si perde
La qualità dell'orario dipende quasi tutta dalla qualità dei dati in ingresso. La qualità dell'orario dipende quasi tutta dalla qualità dei dati in ingresso.
Prima di generare, verifica che: Prima di generare, verificate che:
- il **monte ore** di ogni classe sia corretto e **entri** nella griglia oraria; - il **monte ore** di ogni classe sia corretto e **entri** nella griglia oraria;
- **ogni** materia di **ogni** classe abbia un **docente assegnato**; - **ogni** materia di **ogni** classe abbia un/una **docente assegnato/a**;
- le **ore massime** dei docenti siano realistiche; - le **ore massime** dei docenti siano realistiche;
- le **indisponibilità** siano davvero indispensabili (vedi sotto). - le **indisponibilità** siano davvero indispensabili (vedete sotto).
### Distingui sempre vincoli rigidi e preferenze ### Distingui sempre vincoli rigidi e preferenze
È l'errore concettuale più frequente. Marca come **"non disponibile"** o come È l'errore concettuale più frequente. Marca come **"non disponibile"** o come
@@ -22,86 +22,86 @@ obbligatorio" va espresso come **preferenza** ("da evitare", "preferito"). Tropp
vincoli rigidi sono la causa numero uno degli orari impossibili da generare. vincoli rigidi sono la causa numero uno degli orari impossibili da generare.
### Parti semplice, poi raffina ### Parti semplice, poi raffina
Per il primo orario, usa il **preset predefinito** e l'ambito completo. Guarda il Per il primo orario, usate il **preset predefinito** e l'ambito completo. Guardate il
risultato, individua il punto debole dai [punteggi](14-comprendere-i-punteggi.md), risultato, individuate il punto debole dai [punteggi](14-comprendere-i-punteggi.md),
poi cambia **un solo peso alla volta** e rigenera. Così capisci l'effetto di ogni poi cambiate **un solo peso alla volta** e rigenerate. Così capite l'effetto di ogni
modifica. modifica.
### Lavora per versioni ### Lavorate per versioni
Non aver paura di generare molte versioni: costano poco e puoi confrontarle. Tieni Non abbiate paura di generare molte versioni: costano poco e potete confrontarle. Tenete
le più promettenti, elimina le altre per non fare confusione, e **finalizza** solo le più promettenti, eliminate le altre per non fare confusione, e **finalizzate** solo
alla fine. alla fine.
### Concedi tempo al motore sugli istituti grandi ### Concedete tempo al motore sugli istituti grandi
Se l'istituto è grande, aumenta il **tempo massimo** di calcolo o restringi 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 l'**ambito** (genera una scuola alla volta). Più tempo e meno complessità aiutano
il motore a trovare soluzioni migliori. il motore a trovare soluzioni migliori.
### Valida sempre dopo le modifiche manuali ### Valida sempre dopo le modifiche manuali
Ogni volta che [personalizzi](16-personalizzazione-orario.md) un orario, controlla Ogni volta che [personalizzate](16-personalizzazione-orario.md) un orario, controllate
la scheda **Conflitti** ed esegui la **validazione**: le modifiche manuali non sono la scheda **Conflitti** ed eseguite la **validazione**: le modifiche manuali non sono
controllate in automatico. controllate in automatico.
## Risoluzione dei problemi ## Risoluzione dei problemi
### Il motore non trova alcuna soluzione ### Il motore non trova alcuna soluzione
Significa che i **vincoli rigidi sono in conflitto**: l'orario richiesto è Significa che i **vincoli rigidi sono in conflitto**: l'orario richiesto è
*impossibile*, non solo difficile. Controlla, in quest'ordine: *impossibile*, non solo difficile. Controllate, in quest'ordine:
| Verifica | Cosa controllare | | Verifica | Cosa controllare |
|----------|------------------| |----------|------------------|
| Griglia oraria | Il totale delle ore di una classe **entra** nel numero di slot disponibili? Servono più ore nella settimana? Vedi [cap. 7](07-orari-e-campanella.md). | | 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. Vedi [cap. 10](10-docenti.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? | | Ore massime | Le ore massime (settimanali/giornaliere) dei docenti sono sufficienti a coprire le loro assegnazioni? |
| Assegnazioni | Un docente è assegnato a troppe classi rispetto al monte ore che può coprire? | | 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? Vedi [cap. 11](11-spostamenti.md). | | Spostamenti | Per i multi-plesso, i tempi di viaggio sono compatibili con l'intervallo tra le ore? Vedete [cap. 11](11-spostamenti.md). |
Correggi il dato più sospetto e rigenera. Procedi per tentativi, cambiando **una Correggete il dato più sospetto e rigenerate. Procedete per tentativi, cambiando **una
cosa alla volta**. cosa alla volta**.
### La qualità è bassa (composito basso, ma > 0) ### La qualità è bassa (composito basso, ma > 0)
L'orario è valido ma migliorabile. Apri la scheda **Scores** L'orario è valido ma migliorabile. Aprite la scheda **Scores**
([cap. 14](14-comprendere-i-punteggi.md)), individua la **categoria più bassa** e ([cap. 14](14-comprendere-i-punteggi.md)), individuate la **categoria più bassa** e
aumenta il **peso** corrispondente nel preset, poi rigenera. Ricorda che gli aumentate il **peso** corrispondente nel preset, poi rigenerate. Ricordate che gli
obiettivi sono in parte in conflitto: migliorarne uno può peggiorarne un altro. obiettivi sono in parte in conflitto: migliorarne uno può peggiorarne un altro.
### Il punteggio composito è 0 ### Il punteggio composito è 0
C'è (almeno) una **violazione di un vincolo rigido**. Apri la scheda **Conflitti** C'è (almeno) una **violazione di un vincolo rigido**. Aprite la scheda **Conflitti**
([cap. 15](15-revisione-orario.md#scheda-conflitti-conflicts)): elenca esattamente ([cap. 15](15-revisione-orario.md#scheda-conflitti-conflicts)): elenca esattamente
le violazioni. Succede tipicamente dopo una modifica manuale; correggi la lezione le violazioni. Succede tipicamente dopo una modifica manuale; correggete la lezione
segnalata e valida di nuovo. segnalata e valida di nuovo.
### Il calcolo va in timeout senza una buona soluzione ### Il calcolo va in timeout senza una buona soluzione
L'istanza è troppo grande per il tempo concesso. Soluzioni: **aumenta il tempo L'istanza è troppo grande per il tempo concesso. Soluzioni: **aumentate il tempo
massimo**, oppure **restringi l'ambito** (genera meno scuole/classi per volta), massimo**, oppure **restringete l'ambito** (genera meno scuole/classi per volta),
oppure semplifica i vincoli. oppure semplifica i vincoli.
### Non vedo classi o materie nella generazione ### Non vedo classi o materie nella generazione
Quasi sempre mancano i **monte ore** o le **assegnazioni docenti**. Torna in Quasi sempre mancano i **monte ore** o le **assegnazioni docenti**. Tornate in
[Classi](09-classi.md) e verifica che ogni classe abbia le materie con le ore e il [Classi](09-classi.md) e verificate che ogni classe abbia le materie con le ore e il/la
docente. docente.
### Un docente risulta sovraccarico ### Un docente risulta sovraccarico
Controlla la scheda **Assignments** ([cap. 15](15-revisione-orario.md)) per vedere Controllate la scheda **Assignments** ([cap. 15](15-revisione-orario.md)) per vedere
il totale ore. Se supera il previsto, rivedi le sue **assegnazioni** in 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). [Classi](09-classi.md) o le sue **ore massime** in [Docenti](10-docenti.md).
### Le email delle preferenze non arrivano ### Le email delle preferenze non arrivano
Il sistema potrebbe essere in modalità di prova (le email vengono registrate ma non Il sistema potrebbe essere in modalità di prova (le email vengono registrate ma non
spedite). Rivolgiti a chi gestisce l'installazione. Nel frattempo puoi inserire le spedite). Rivolgetevi a chi gestisce l'installazione. Nel frattempo potete inserire le
preferenze a mano dalla scheda del docente ([cap. 10](10-docenti.md)). preferenze a mano dalla scheda del/della docente ([cap. 10](10-docenti.md)).
### Ho perso l'accesso / la sessione è scaduta ### Ho perso l'accesso / la sessione è scaduta
Reinserisci le credenziali nella pagina di login ([cap. 3](03-primi-passi.md)). Se Reinserite le credenziali nella pagina di login ([cap. 3](03-primi-passi.md)). Se
le hai smarrite, contatta l'amministratore del sistema: non esiste un recupero le avete smarrite, contatta l'amministratrice e l'amministratore del sistema: non esiste un recupero
autonomo. autonomo.
## Quando chiedere aiuto tecnico ## Quando chiedere aiuto tecnico
Se un problema non rientra tra quelli qui sopra — per esempio errori di sistema, 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 pagine che non si caricano o comportamenti anomali — annota **cosa stavi facendo** e
**quale messaggio** hai visto, e contatta chi gestisce l'installazione del sistema **quale messaggio** avete visto, e contatta chi gestisce l'installazione del sistema
per il tuo istituto. per il vostro istituto.
--- ---
+31 -31
@@ -2,109 +2,109 @@
Definizioni brevi dei termini usati nel manuale e nell'interfaccia. Dove utile, il Definizioni brevi dei termini usati nel manuale e nell'interfaccia. Dove utile, il
rimando porta al capitolo che approfondisce il concetto. Tra parentesi, in rimando porta al capitolo che approfondisce il concetto. Tra parentesi, in
corsivo, l'etichetta inglese che potresti vedere nell'interfaccia. corsivo, l'etichetta inglese che potreste vedere nell'interfaccia.
### Ambito / Scope *(scope)* ### Ambito / Scope *(scope)*
La porzione di orario da generare: tutto l'istituto oppure un sottoinsieme di scuole La porzione di orario da generare: tutto l'istituto oppure un sottoinsieme di scuole
o classi. Un ambito più stretto rende il calcolo più rapido. Vedi o classi. Un ambito più stretto rende il calcolo più rapido. Vedete
[cap. 13](13-generazione-orario.md). [cap. 13](13-generazione-orario.md).
### Anno scolastico *(academic year)* ### Anno scolastico *(academic year)*
Il periodo di riferimento (es. 2025/2026) a cui appartengono tutti i dati. Vedi Il periodo di riferimento (es. 2025/2026) a cui appartengono tutti i dati. Vedete
[cap. 4](04-anni-scolastici.md). [cap. 4](04-anni-scolastici.md).
### Assegnazione (docente) *(teacher assignment)* ### Assegnazione (docente) *(teacher assignment)*
Il legame "questo docente insegna questa materia a questa classe". Senza Il legame "questo docente insegna questa materia a questa classe". Senza
assegnazioni il sistema non sa chi tiene le lezioni. Vedi [cap. 9](09-classi.md). assegnazioni il sistema non sa chi tiene le lezioni. Vedete [cap. 9](09-classi.md).
### Aula/laboratorio *(facility)* ### Aula/laboratorio *(facility)*
Una stanza a uso speciale e condiviso (palestra, laboratorio) richiesta da alcune Una stanza a uso speciale e condiviso (palestra, laboratorio) richiesta da alcune
materie e non usabile da due classi insieme. Vedi [cap. 6](06-aule-e-laboratori.md). materie e non usabile da due classi insieme. Vedete [cap. 6](06-aule-e-laboratori.md).
### Bozza *(draft)* ### Bozza *(draft)*
Stato di una versione di orario ancora modificabile. Vedi [cap. 15](15-revisione-orario.md). Stato di una versione di orario ancora modificabile. Vedete [cap. 15](15-revisione-orario.md).
### Campagna (di raccolta preferenze) *(campaign)* ### Campagna (di raccolta preferenze) *(campaign)*
L'iniziativa con cui inviti i docenti a compilare le loro preferenze tramite un link L'iniziativa con cui invitate le docenti ed i docenti a compilare le loro preferenze tramite un link
personale. Vedi [cap. 12](12-raccolta-preferenze.md). personale. Vedete [cap. 12](12-raccolta-preferenze.md).
### Classe *(class group)* ### Classe *(class group)*
Un gruppo fisso di studenti (es. 1A) che appartiene a una scuola e resta nella Un gruppo fisso di studenti (es. 1A) che appartiene a una scuola e resta nella
propria aula. Vedi [cap. 9](09-classi.md). propria aula. Vedete [cap. 9](09-classi.md).
### Composito (punteggio) *(composite score)* ### Composito (punteggio) *(composite score)*
Il punteggio complessivo di qualità di una versione, da 0 a 100. Una violazione Il punteggio complessivo di qualità di una versione, da 0 a 100. Una violazione
rigida lo azzera. Vedi [cap. 14](14-comprendere-i-punteggi.md). rigida lo azzera. Vedete [cap. 14](14-comprendere-i-punteggi.md).
### Conflitto *(conflict)* ### Conflitto *(conflict)*
Una violazione di un vincolo rigido in una versione di orario. Elencati nell'apposita Una violazione di un vincolo rigido in una versione di orario. Elencati nell'apposita
scheda del dettaglio. Vedi [cap. 15](15-revisione-orario.md#scheda-conflitti-conflicts). scheda del dettaglio. Vedete [cap. 15](15-revisione-orario.md#scheda-conflitti-conflicts).
### Finalizzare *(finalize)* ### Finalizzare *(finalize)*
Approvare una versione come orario ufficiale, bloccandola contro modifiche Approvare una versione come orario ufficiale, bloccandola contro modifiche
accidentali. Vedi [cap. 15](15-revisione-orario.md). accidentali. Vedete [cap. 15](15-revisione-orario.md).
### Generazione / Ottimizzazione *(generate / optimization)* ### Generazione / Ottimizzazione *(generate / optimization)*
Il processo con cui il motore costruisce automaticamente l'orario rispettando i Il processo con cui il motore costruisce automaticamente l'orario rispettando i
vincoli e massimizzando la qualità. Vedi [cap. 13](13-generazione-orario.md). vincoli e massimizzando la qualità. Vedete [cap. 13](13-generazione-orario.md).
### Giorno libero *(free day)* ### Giorno libero *(free day)*
Il giorno che un docente preferirebbe tenere libero da lezioni. È una **preferenza**, Il giorno che un/una docente preferirebbe tenere libero da lezioni. È una **preferenza**,
non una garanzia. Vedi [cap. 10](10-docenti.md). non una garanzia. Vedete [cap. 10](10-docenti.md).
### Indisponibilità *(unavailability)* ### Indisponibilità *(unavailability)*
Un periodo in cui un docente non può proprio esserci: è un **vincolo rigido**, Un periodo in cui un/una docente non può proprio esserci: è un **vincolo rigido**,
sempre rispettato. Da non confondere con la preferenza "da evitare". Vedi sempre rispettato. Da non confondere con la preferenza "da evitare". Vedete
[cap. 10](10-docenti.md). [cap. 10](10-docenti.md).
### Materia *(subject)* ### Materia *(subject)*
Una disciplina insegnata (Matematica, Italiano...). Vedi [cap. 8](08-materie.md). Una disciplina insegnata (Matematica, Italiano...). Vedete [cap. 8](08-materie.md).
### Monte ore / Requisito *(subject requirement)* ### Monte ore / Requisito *(subject requirement)*
Le ore settimanali di una materia richieste da una classe. È un **vincolo rigido**: Le ore settimanali di una materia richieste da una classe. È un **vincolo rigido**:
vengono collocate esattamente. Vedi [cap. 9](09-classi.md). vengono collocate esattamente. Vedete [cap. 9](09-classi.md).
### Orario compatto / Compattezza *(compactness)* ### Orario compatto / Compattezza *(compactness)*
La qualità di un orario senza "buchi" tra le lezioni di un docente nello stesso La qualità di un orario senza "buchi" tra le lezioni di un/una docente nello stesso
giorno. Obiettivo di qualità. Vedi [cap. 14](14-comprendere-i-punteggi.md). giorno. Obiettivo di qualità. Vedete [cap. 14](14-comprendere-i-punteggi.md).
### Peso *(weight)* ### Peso *(weight)*
Il valore che stabilisce quanta importanza dare a un obiettivo di qualità durante la Il valore che stabilisce quanta importanza dare a un obiettivo di qualità durante la
generazione. I pesi sono priorità relative, non percentuali. Vedi generazione. I pesi sono priorità relative, non percentuali. Vedete
[cap. 13](13-generazione-orario.md). [cap. 13](13-generazione-orario.md).
### Plesso / Scuola *(school)* ### Plesso / Scuola *(school)*
Un edificio dell'istituto. Vedi [cap. 5](05-scuole.md). Un edificio dell'istituto. Vedete [cap. 5](05-scuole.md).
### Preferenza *(preference)* ### Preferenza *(preference)*
Un desiderio (del docente o dell'istituto) trattato come **obiettivo di qualità**: Un desiderio (del/della docente o dell'istituto) trattato come **obiettivo di qualità**:
il sistema cerca di soddisfarlo ma può derogare. Contrapposto al vincolo rigido. il sistema cerca di soddisfarlo ma può derogare. Contrapposto al vincolo rigido.
Vedi [cap. 1](01-introduzione.md). Vedete [cap. 1](01-introduzione.md).
### Preset *(preset)* ### Preset *(preset)*
Una configurazione salvata di pesi e impostazioni per la generazione, riutilizzabile. Una configurazione salvata di pesi e impostazioni per la generazione, riutilizzabile.
Vedi [cap. 13](13-generazione-orario.md). Vedete [cap. 13](13-generazione-orario.md).
### Slot orario *(time slot)* ### Slot orario *(time slot)*
Una casella "giorno + ora" della griglia oraria (es. lunedì, 3ª ora). Vedi Una casella "giorno + ora" della griglia oraria (es. lunedì, 3ª ora). Vedete
[cap. 7](07-orari-e-campanella.md). [cap. 7](07-orari-e-campanella.md).
### Tempo massimo *(timeout)* ### Tempo massimo *(timeout)*
Il tempo massimo concesso al motore per cercare una soluzione. Vedi Il tempo massimo concesso al motore per cercare una soluzione. Vedete
[cap. 13](13-generazione-orario.md). [cap. 13](13-generazione-orario.md).
### Vincolo rigido *(hard constraint)* ### Vincolo rigido *(hard constraint)*
Una regola che **deve** sempre essere rispettata; se violata, l'orario non è valido. Una regola che **deve** sempre essere rispettata; se violata, l'orario non è valido.
Contrapposto alla preferenza. Vedi [cap. 1](01-introduzione.md). Contrapposto alla preferenza. Vedete [cap. 1](01-introduzione.md).
### Versione (di orario) *(timetable version)* ### Versione (di orario) *(timetable version)*
Un orario generato, con il suo punteggio e il suo stato (bozza/finale/archiviata). Un orario generato, con il suo punteggio e il suo stato (bozza/finale/archiviata).
Vedi [cap. 15](15-revisione-orario.md). Vedete [cap. 15](15-revisione-orario.md).
--- ---
Questo conclude il manuale. Per ricominciare da capo o consultare un altro Questo conclude il manuale. Per ricominciare da capo o consultare un altro
argomento, torna all'[Indice](README.md). argomento, tornate all'[Indice](README.md).
--- ---
+7 -7
@@ -7,10 +7,10 @@ questo incarico) a costruire un orario di qualità per un istituto composto da u
o più scuole, riducendo drasticamente il lavoro manuale. o più scuole, riducendo drasticamente il lavoro manuale.
Il sistema raccoglie i dati della scuola (aule, classi, materie, docenti, monte Il sistema raccoglie i dati della scuola (aule, classi, materie, docenti, monte
ore) e le preferenze dei docenti, quindi genera automaticamente uno o più orari ore) e le preferenze delle docenti e dei docenti, quindi genera automaticamente uno o più orari
che rispettano tutti i **vincoli obbligatori** e cercano di massimizzare la che rispettano tutti i **vincoli obbligatori** e cercano di massimizzare la
**qualità complessiva** (meno spostamenti, meno "buchi", rispetto delle **qualità complessiva** (meno spostamenti, meno "buchi", rispetto delle
preferenze). Tu resti sempre al comando: puoi confrontare le versioni, correggerle preferenze). Voi restate sempre al comando: potete confrontare le versioni, correggerle
a mano ed esportarle. a mano ed esportarle.
## Come leggere questo manuale ## Come leggere questo manuale
@@ -20,8 +20,8 @@ seguono la sequenza reale di lavoro, dall'inserimento dei dati fino all'orario
finale esportato. Ogni pagina termina con i collegamenti alla pagina finale esportato. Ogni pagina termina con i collegamenti alla pagina
**precedente** e **successiva**, oltre che a questo indice. **precedente** e **successiva**, oltre che a questo indice.
Se hai già dimestichezza con lo strumento, usa l'indice qui sotto per saltare Se avete già dimestichezza con lo strumento, usate l'indice qui sotto per saltare
direttamente all'argomento che ti interessa. direttamente all'argomento che vi interessa.
## Indice ## Indice
@@ -37,11 +37,11 @@ direttamente all'argomento che ti interessa.
7. [Orari e campanella](07-orari-e-campanella.md) — la griglia giorni × ore di ogni scuola. 7. [Orari e campanella](07-orari-e-campanella.md) — la griglia giorni × ore di ogni scuola.
8. [Materie](08-materie.md) — le discipline insegnate. 8. [Materie](08-materie.md) — le discipline insegnate.
9. [Classi, monte ore e assegnazione docenti](09-classi.md) — le classi, le ore per materia e chi insegna cosa. 9. [Classi, monte ore e assegnazione docenti](09-classi.md) — le classi, le ore per materia e chi insegna cosa.
10. [Docenti e preferenze](10-docenti.md) — l'anagrafica dei docenti e i loro vincoli. 10. [Docenti e preferenze](10-docenti.md) — l'anagrafica delle docenti e dei docenti e i loro vincoli.
11. [Distanze e spostamenti](11-spostamenti.md) — i tempi di viaggio tra scuole e da casa. 11. [Distanze e spostamenti](11-spostamenti.md) — i tempi di viaggio tra scuole e da casa.
### Parte 3 — Preferenze dei docenti ### Parte 3 — Preferenze delle docenti e dei docenti
12. [Raccolta preferenze dei docenti](12-raccolta-preferenze.md) — le campagne per invitare i docenti a compilare le loro preferenze. 12. [Raccolta preferenze delle docenti e dei docenti](12-raccolta-preferenze.md) — le campagne per invitare le docenti ed i docenti a compilare le loro preferenze.
### Parte 4 — Generare e rivedere l'orario ### Parte 4 — Generare e rivedere l'orario
13. [Generazione dell'orario](13-generazione-orario.md) — avviare l'ottimizzatore e seguirne l'avanzamento. 13. [Generazione dell'orario](13-generazione-orario.md) — avviare l'ottimizzatore e seguirne l'avanzamento.