From dc58504e03197ab95b698154ea0f762af52f1eac Mon Sep 17 00:00:00 2001 From: Francesco Manfredi Date: Thu, 16 Jul 2026 11:08:15 +0200 Subject: [PATCH] Italian genders --- 01-introduzione.md | 32 +++++++------- 02-panoramica-del-processo.md | 76 ++++++++++++++++----------------- 03-primi-passi.md | 44 +++++++++---------- 04-anni-scolastici.md | 24 +++++------ 05-scuole.md | 36 ++++++++-------- 06-aule-e-laboratori.md | 28 ++++++------ 07-orari-e-campanella.md | 26 +++++------ 08-materie.md | 26 +++++------ 09-classi.md | 60 +++++++++++++------------- 10-docenti.md | 70 +++++++++++++++--------------- 11-spostamenti.md | 42 +++++++++--------- 12-raccolta-preferenze.md | 64 +++++++++++++-------------- 13-generazione-orario.md | 42 +++++++++--------- 14-comprendere-i-punteggi.md | 36 ++++++++-------- 15-revisione-orario.md | 42 +++++++++--------- 16-personalizzazione-orario.md | 36 ++++++++-------- 17-esportazione.md | 20 ++++----- 18-buone-pratiche-e-problemi.md | 72 +++++++++++++++---------------- 19-glossario.md | 62 +++++++++++++-------------- README.md | 14 +++--- 20 files changed, 426 insertions(+), 426 deletions(-) diff --git a/01-introduzione.md b/01-introduzione.md index daaf385..aca4ce8 100644 --- a/01-introduzione.md +++ b/01-introduzione.md @@ -1,8 +1,8 @@ # 1. Introduzione: cos'è questo sistema Questo capitolo spiega **a cosa serve** lo strumento, **perché** è pensato in -questo modo e introduce le **parole chiave** che userai in tutto il manuale. -Leggilo con calma: capire questi concetti ora ti farà risparmiare molto tempo +questo modo e introduce le **parole chiave** che userete in tutto il manuale. +Leggilo con calma: capire questi concetti ora vi farà risparmiare molto tempo dopo. ## Il problema: costruire l'orario di un istituto @@ -13,12 +13,12 @@ Bisogna incastrare centinaia di lezioni in modo che: - ogni classe abbia esattamente le ore previste per ciascuna materia; - nessun docente sia in due classi nello stesso momento; - si rispettino i limiti di ore giornaliere e le indisponibilità; -- i docenti che lavorano su più plessi abbiano il tempo di spostarsi; +- le docenti ed i docenti che lavorano su più plessi abbiano il tempo di spostarsi; - e, possibilmente, tutti siano contenti dell'orario che ricevono. Fatto a mano, questo lavoro richiede giorni e produce spesso soluzioni con troppi "buchi", spostamenti inutili o preferenze ignorate. Questo sistema **automatizza** -la parte più faticosa — trovare una combinazione valida — lasciando a te il +la parte più faticosa — trovare una combinazione valida — lasciando a voi il controllo delle decisioni importanti. ## Il contesto della scuola italiana @@ -29,38 +29,38 @@ dalle università: - **Gli studenti restano nella loro aula.** Ogni classe (per esempio la "1ª A") è un gruppo fisso di studenti che rimane nella stessa aula per la maggior parte delle lezioni. -- **Sono i docenti a spostarsi.** I professori cambiano aula tra un'ora e l'altra +- **Sono le docenti ed i docenti a spostarsi.** Le professoresse ed i professori cambiano aula tra un'ora e l'altra e, quando l'istituto ha più plessi, si spostano anche tra edifici diversi. - **Un istituto può avere più scuole.** Il sistema gestisce più edifici (plessi) e tiene conto dei **tempi di viaggio** tra di essi. Di conseguenza l'orario non deve ottimizzare solo la sequenza delle lezioni di -ogni classe, ma anche **i movimenti e la disponibilità dei docenti**. +ogni classe, ma anche **i movimenti e la disponibilità delle docenti e dei docenti**. ## Cosa fa lo strumento, in breve 1. **Raccoglie i dati** della scuola: plessi, aule, orario delle campanelle, materie, classi, monte ore e docenti. -2. **Raccoglie le preferenze** dei docenti (orari graditi, indisponibilità, sedi +2. **Raccoglie le preferenze** delle docenti e dei docenti (orari graditi, indisponibilità, sedi preferite, giorno libero...). 3. **Genera automaticamente** uno o più orari con un motore di ottimizzazione. -4. **Valuta la qualità** di ogni orario con un punteggio, così puoi confrontare le +4. **Valuta la qualità** di ogni orario con un punteggio, così potete confrontare le alternative. -5. Ti permette di **rivedere, correggere a mano ed esportare** l'orario scelto. +5. Vi permette di **rivedere, correggere a mano ed esportare** l'orario scelto. ## Vincoli obbligatori e preferenze: la distinzione più importante -Tutto il funzionamento del sistema ruota intorno a due tipi di regole. Tienile +Tutto il funzionamento del sistema ruota intorno a due tipi di regole. Tenetele ben distinte fin da subito: - **Vincoli rigidi (obbligatori).** Regole che **devono** essere sempre rispettate. Se anche una sola viene violata, l'orario non è valido. Esempi: il - monte ore di ogni materia, il divieto di doppia presenza di un docente, le + monte ore di ogni materia, il divieto di doppia presenza di una docente ed un docente, le indisponibilità dichiarate, il tempo minimo per spostarsi tra plessi. - **Preferenze (obiettivi di qualità).** Desideri che il sistema cerca di soddisfare il più possibile, ma che **può sacrificare** se necessario per trovare una soluzione valida. Esempi: preferire le ore del mattino, evitare i - "buchi", ridurre gli spostamenti, rispettare gli orari graditi da un docente. + "buchi", ridurre gli spostamenti, rispettare gli orari graditi da una docente ed un docente. In pratica: i **vincoli rigidi** definiscono cosa è un orario *ammissibile*; le **preferenze** definiscono cosa è un orario *buono*. Il motore prima trova una @@ -68,7 +68,7 @@ soluzione ammissibile, poi la migliora sul fronte della qualità. ## Vocabolario di base -Questi termini ricorrono in tutto il manuale. Per la lista completa vedi il +Questi termini ricorrono in tutto il manuale. Per la lista completa vedete il [Glossario](19-glossario.md). | Termine | Significato | @@ -81,8 +81,8 @@ Questi termini ricorrono in tutto il manuale. Per la lista completa vedi il | **Classe** | Un gruppo fisso di studenti (es. 2ª B) che appartiene a una scuola. | | **Monte ore** | Quante ore settimanali di una materia servono a una classe. | | **Assegnazione docente** | Il legame "questo docente insegna questa materia a questa classe". | -| **Preferenza** | Un desiderio del docente trattato come obiettivo di qualità. | -| **Indisponibilità** | Un periodo in cui il docente non può proprio esserci (vincolo rigido). | +| **Preferenza** | Un desiderio della docente e del docente trattato come obiettivo di qualità. | +| **Indisponibilità** | Un periodo in cui la docente ed il docente non può proprio esserci (vincolo rigido). | | **Versione di orario** | Un orario generato, con il suo punteggio e il suo stato (bozza/finale/archiviato). | ## Cosa NON copre questo manuale @@ -93,7 +93,7 @@ esiste la documentazione tecnica nella cartella `docs/`. --- -Ora che sai cosa fa lo strumento, vediamo l'intero processo dall'alto prima di +Ora che sapete cosa fa lo strumento, vediamo l'intero processo dall'alto prima di entrare nel dettaglio delle singole funzioni. --- diff --git a/02-panoramica-del-processo.md b/02-panoramica-del-processo.md index cfa2532..9a0a6ea 100644 --- a/02-panoramica-del-processo.md +++ b/02-panoramica-del-processo.md @@ -22,16 +22,16 @@ flowchart LR end subgraph F2["Fase 2: RACCOGLI
PREFERENZE"] direction TB - B1[Crea campagna] - B2[Invita docenti] - B3[Invia email] - B4[Monitora risposte] + B1[Create campagna] + B2[Invitate docenti] + B3[Inviate email] + B4[Monitorate risposte] end subgraph F3["Fase 3: GENERA
E SCEGLI"] direction TB C1[Configura e avvia
l'ottimizzatore] C2[Confronta versioni
e punteggi] - C3[Scegli la migliore] + C3[Scegliete la migliore] end subgraph F4["Fase 4: RIFINISCI"] direction TB @@ -47,9 +47,9 @@ Le quattro fasi corrispondono alle quattro parti operative di questo manuale. ## Fase 1 — Prepara i dati (Configurazione) È 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. 2. **[Scuole](05-scuole.md)** — gli edifici dell'istituto, con indirizzo e posizione (serve per calcolare gli spostamenti). @@ -59,51 +59,51 @@ aggiorna solo ciò che cambia. Inserisci, in quest'ordine consigliato: di ciascuna scuola. 5. **[Materie](08-materie.md)** — l'elenco delle discipline. 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. 7. **[Docenti](10-docenti.md)** — l'anagrafica, i limiti (ore massime giornaliere, giorno libero) ed eventuali indisponibilità. 8. **[Distanze e spostamenti](11-spostamenti.md)** — i tempi di viaggio tra i plessi (necessari solo se l'istituto ha più scuole). -> **Perché quest'ordine?** Ogni passo si appoggia ai precedenti: non puoi -> assegnare 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. +> **Perché quest'ordine?** Ogni passo si appoggia ai precedenti: non potete +> assegnare una docente ed un docente a una classe se la classe non esiste, né definire il monte +> 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 -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. -- Inviti i docenti e invii loro un'email con un link personale. +- Create una **campagna** per l'anno scolastico. +- 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à, 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, -puoi inserire le preferenze tu stesso dalla scheda del docente +Vedete [Raccolta preferenze delle docenti e dei docenti](12-raccolta-preferenze.md). In alternativa, +potete inserire le preferenze voi stessi dalla scheda della docente e del docente ([Docenti](10-docenti.md)). -## Fase 3 — Genera e scegli +## Fase 3 — Generate e scegliete Quando i dati sono pronti: -1. Apri la pagina **[Generazione](13-generazione-orario.md)**, scegli l'ambito - (tutto l'istituto o un sottoinsieme), le impostazioni e avvii il motore. +1. Aprite la pagina **[Generazione](13-generazione-orario.md)**, scegliete l'ambito + (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, ciascuna con un **punteggio di qualità**. -3. Impari 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). +3. Imparate a leggere quei punteggi in [Comprendere i punteggi](14-comprendere-i-punteggi.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 - **[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. -- 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). -- 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. ## 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; - **personalizzare** una versione, valutarla e poi decidere. -Lo strumento è pensato proprio per questo ciclo: *genera → valuta → correggi → -rigenera*. Non aver paura di creare più versioni: puoi sempre confrontarle ed +Lo strumento è pensato proprio per questo ciclo: *generate → valutate → correggete → +rigenerate*. Non abbiate paura di creare più versioni: potete sempre confrontarle ed 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. -2. Definisci l'orario delle campanelle per quella scuola. -3. Inserisci le materie e almeno una classe con il suo monte ore. -4. Inserisci i docenti e assegnali alle classi/materie. -5. Vai su **Generazione**, lascia le impostazioni predefinite e avvia. -6. Apri la versione prodotta in **Revisione** e osservala. +1. Create l'anno scolastico e almeno una scuola. +2. Definite l'orario delle campanelle per quella scuola. +3. Inserite le materie e almeno una classe con il suo monte ore. +4. Inserite le docenti ed i docenti e assegnali alle classi/materie. +5. Andate su **Generazione**, lasciate le impostazioni predefinite e avviate. +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. --- diff --git a/03-primi-passi.md b/03-primi-passi.md index e858c74..6887f56 100644 --- a/03-primi-passi.md +++ b/03-primi-passi.md @@ -1,43 +1,43 @@ # 3. Primi passi: accesso e interfaccia -In questo capitolo impari ad **accedere** allo strumento e a **muoverti** -nell'interfaccia. Sono le poche nozioni pratiche che userai in ogni sessione di +In questo capitolo imparate ad **accedere** allo strumento e a **muovervi** +nell'interfaccia. Sono le poche nozioni pratiche che userete in ogni sessione di lavoro. ## Accedere al sistema 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). -3. Inserisci **nome utente e password** che ti sono stati forniti. -4. Premi **Accedi**. +3. Inserite **nome utente e password** che vi sono stati forniti. +4. Premete **Accedi**. ![Pagina di accesso](img/login.png) Alcune indicazioni utili: - **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. -- **La sessione resta attiva** sul tuo browser finché non premi *Logout*. Su un - computer condiviso, esci sempre al termine del lavoro. -- Se dopo un po' di inattività ricevi di nuovo la richiesta di accesso, è normale: - reinserisci le credenziali. +- **La sessione resta attiva** sul vostro browser finché non premete *Logout*. Su un + computer condiviso, uscite sempre al termine del lavoro. +- Se dopo un po' di inattività ricevete di nuovo la richiesta di accesso, è normale: + reinserite le credenziali. ## 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) - **Intestazione (in alto):** contiene il selettore della **lingua** e il pulsante **Logout**. - **Barra laterale (a sinistra):** il menu di navigazione, diviso in due sezioni - (vedi sotto). Clicca una voce per aprire la pagina corrispondente. -- **Area contenuto (al centro):** mostra la pagina selezionata, dove leggi e - modifichi i dati. + (vedete sotto). Cliccate una voce per aprire la pagina corrispondente. +- **Area contenuto (al centro):** mostra la pagina selezionata, dove leggete e + modificate i dati. ## 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): ### Configuration (Configurazione) -Qui prepari tutti i dati della scuola: +Qui preparate tutti i dati della scuola: | 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) | ### Timetable (Orario) -Qui generi e gestisci gli orari: +Qui generate e gestite gli orari: | Voce di menu | Pagina del manuale | |--------------|--------------------| @@ -68,13 +68,13 @@ Qui generi e gestisci gli orari: | Review | [Revisione delle versioni](15-revisione-orario.md) | > **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 -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 -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 @@ -91,12 +91,12 @@ Imparerai a riconoscere alcuni elementi che si ripetono ovunque: ## 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. --- -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. --- diff --git a/04-anni-scolastici.md b/04-anni-scolastici.md index 10aaa3a..b46753b 100644 --- a/04-anni-scolastici.md +++ b/04-anni-scolastici.md @@ -8,45 +8,45 @@ preciso. Per questo è il **primo** elemento da creare. ## 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 quello del 2025/2026); - **conservare lo storico**: gli anni passati restano consultabili; - lavorare al nuovo orario mentre quello vecchio resta intatto. -In quasi tutte le altre pagine sceglierai l'anno di riferimento da un menu a -tendina in alto: se quel menu è vuoto, è perché non hai ancora creato nessun anno +In quasi tutte le altre pagine sceglierete l'anno di riferimento da un menu a +tendina in alto: se quel menu è vuoto, è perché non avete ancora creato nessun anno qui. ## Creare un anno scolastico -1. Apri **Academic Years** dal menu. -2. Clicca **+ New Academic Year** (Nuovo anno scolastico). -3. Inserisci l'**etichetta** dell'anno, per esempio `2025/2026`. +1. Aprite **Academic Years** dal menu. +2. Cliccate **+ New Academic Year** (Nuovo anno scolastico). +3. Inserite l'**etichetta** dell'anno, per esempio `2025/2026`. - Massimo 20 caratteri. - Deve essere **univoca**: non possono esistere due anni con la stessa etichetta. -4. Salva. +4. Salvate. ![Elenco anni scolastici](img/academic-years.png) ## 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. -- **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ò -> 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 > passati come archivio. ## 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, -crea semplicemente il nuovo anno: i due resteranno indipendenti. +create semplicemente il nuovo anno: i due resteranno indipendenti. --- diff --git a/05-scuole.md b/05-scuole.md index 4d7ae7d..b490520 100644 --- a/05-scuole.md +++ b/05-scuole.md @@ -1,58 +1,58 @@ # 5. Scuole -Una **scuola** (o plesso) è un edificio dell'istituto. Qui inserisci tutti gli -edifici in cui si svolgono le lezioni. Anche se il tuo istituto ha un solo -edificio, devi comunque crearne almeno uno. +Una **scuola** (o plesso) è un edificio dell'istituto. Qui inserite tutti gli +edifici in cui si svolgono le lezioni. Anche se il vostro istituto ha un solo +edificio, dovete comunque crearne almeno uno. > Voce di menu: **Configuration → Schools**. ## 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**: -- da un plesso all'altro (per i docenti che insegnano su più sedi); -- da casa del docente a ciascun plesso. +- da un plesso all'altro (per le docenti ed i docenti che insegnano su più sedi); +- 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 [Scheduling: gli spostamenti](02-panoramica-del-processo.md)). ## Creare una scuola -1. Apri **Schools** dal menu. -2. Clicca **+ New School** (Nuova scuola). +1. Aprite **Schools** dal menu. +2. Cliccate **+ New School** (Nuova scuola). ![Elenco scuole](img/schools.png) -3. Compila i campi: +3. Compilate i campi: - **Nome** — es. `Liceo Scientifico`, `Sede centrale`, `Succursale Via Verdi`. - **Indirizzo** — es. `Via Roma 1, 00100 Roma`. - **Latitudine / Longitudine** *(facoltative)* — le coordinate geografiche, in gradi decimali (es. `41.8902`, `12.4964`). -4. Salva. +4. Salvate. ![Form di creazione scuola](img/schools-add.png) ## 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. - **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). -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 geocodifica descritta nel capitolo sugli spostamenti). ## 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 coordinate. -- **Elimina** con doppia conferma. Non eliminare una scuola a cui sono già - collegate classi o aule, a meno che tu non voglia rimuoverle tutte. +- **Elimina** con doppia conferma. Non eliminate una scuola a cui sono già + collegate classi o aule, a meno che non vogliate rimuoverle tutte. ## 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. --- diff --git a/06-aule-e-laboratori.md b/06-aule-e-laboratori.md index 4ba3b56..4e29f50 100644 --- a/06-aule-e-laboratori.md +++ b/06-aule-e-laboratori.md @@ -7,9 +7,9 @@ classi contemporaneamente. > 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, per esempio: @@ -17,7 +17,7 @@ per esempio: - i **laboratori** (informatica, chimica, fisica...); - 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. ## Perché sono importanti per l'orario @@ -29,37 +29,37 @@ in palestra alla stessa ora. ## Creare un'aula o un laboratorio -1. Apri **Facilities** dal menu. -2. In alto puoi **filtrare per scuola** per vedere le facility di un plesso +1. Aprite **Facilities** dal menu. +2. In alto potete **filtrare per scuola** per vedere le facility di un plesso specifico. -3. Clicca **+ New Facility** (Nuova facility). +3. Cliccate **+ New Facility** (Nuova facility). ![Elenco facility](img/facilities.png) -4. Compila: +4. Compilate: - **Scuola** — a quale plesso appartiene la stanza. - **Nome** — es. `Palestra A`, `Laboratorio di Chimica`. - **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). -5. Salva. +5. Salvate. ![Form di creazione facility](img/facilities-add.png) -> **Attenzione.** La **scuola non è modificabile** dopo la creazione. Se sbagli -> plesso, elimina la facility e ricreala. +> **Attenzione.** La **scuola non è modificabile** dopo la creazione. Se sbagliate +> plesso, eliminate la facility e ricreatela. ## Collegare una facility a una 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 -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). ## Modificare o eliminare -- **Modifica** per aggiornare nome o tipo. -- **Elimina** con conferma. Verifica prima che nessuna materia dipenda ancora da +- **Modificate** per aggiornare nome o tipo. +- **Eliminate** con conferma. Verificate prima che nessuna materia dipenda ancora da quella facility. --- diff --git a/07-orari-e-campanella.md b/07-orari-e-campanella.md index a25567d..c332fb2 100644 --- a/07-orari-e-campanella.md +++ b/07-orari-e-campanella.md @@ -29,8 +29,8 @@ Caratteristiche importanti: ## Prima di iniziare -In alto nella pagina devi selezionare **l'anno scolastico** e la **scuola** di cui -vuoi definire gli orari. Finché non li scegli, la pagina ti invita a farlo e non +In alto nella pagina dovete selezionare **l'anno scolastico** e la **scuola** di cui +volete definire gli orari. Finché non li scegliete, la pagina vi invita a farlo e non mostra alcuna griglia. ![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: -1. Clicca **+ Add Multiple Slots** (Aggiungi più slot). -2. Indica: +1. Cliccate **+ Add Multiple Slots** (Aggiungete più slot). +2. Indicate: - **Orario di inizio** della prima ora (es. `08:00`); - **Durata (minuti)** di ogni ora (es. `55` o `60`); - **Numero di periodi** da creare (es. `6`); - **Numero del primo periodo** (di solito `1`). -3. Conferma con **Add Slots**. +3. Confermate con **Add Slots**. ![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. -> **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 > non creare uno slot in corrispondenza della ricreazione. La griglia deve > rispecchiare le ore in cui si fa **effettivamente lezione**. ## Creare o modificare un singolo slot -- **+ New Slot** crea un singolo slot: scegli numero di periodo, giorno, orario di +- **+ New Slot** crea un singolo slot: scegliete numero di periodo, giorno, orario di inizio e fine. - L'icona di **modifica** su uno slot esistente permette di correggerne gli orari. - L'icona di **eliminazione** lo rimuove. @@ -71,19 +71,19 @@ controllare la coerenza della 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**). -- 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. L'obiettivo è riprodurre fedelmente l'orario reale delle campanelle della scuola. ## Consiglio pratico -Definisci gli slot **coerentemente per tutte le scuole** coinvolte prima di -generare l'orario. Se un docente lavora su due plessi con campanelle sfasate, +Definite gli slot **coerentemente per tutte le scuole** coinvolte prima di +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 -(vedi [Distanze e spostamenti](11-spostamenti.md)). +(vedete [Distanze e spostamenti](11-spostamenti.md)). --- diff --git a/08-materie.md b/08-materie.md index 2745a0f..209ccff 100644 --- a/08-materie.md +++ b/08-materie.md @@ -8,32 +8,32 @@ e da tutte le classi. ## 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, - vedi [Classi](09-classi.md)); + vedete [Classi](09-classi.md)); - 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 -1. Apri **Subjects** dal menu. -2. Clicca **+ New Subject** (Nuova materia). +1. Aprite **Subjects** dal menu. +2. Cliccate **+ New Subject** (Nuova materia). ![Elenco materie](img/subjects.png) -3. Compila: +3. Compilate: - **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). -4. Salva. +4. Salvate. ![Form di creazione materia](img/subjects-add.png) ## 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 come materie diverse. - 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 -- **Cerca**, **modifica** ed **elimina** con i controlli accanto a ciascuna +- **Cercate**, **modificate** ed **eliminate** con i controlli accanto a ciascuna materia. -- Non eliminare una materia già usata nel monte ore delle classi o nelle - assegnazioni dei docenti, salvo tu voglia rimuovere anche quei collegamenti. +- Non eliminate una materia già usata nel monte ore delle classi o nelle + 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** -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. --- diff --git a/09-classi.md b/09-classi.md index 221a44d..20af290 100644 --- a/09-classi.md +++ b/09-classi.md @@ -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 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; -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**. @@ -14,18 +14,18 @@ docenti**: sono le informazioni più importanti per la generazione. ## Creare una classe -1. Apri **Class Groups** dal menu. In alto seleziona l'**anno scolastico**; puoi +1. Aprite **Class Groups** dal menu. In alto selezionate l'**anno scolastico**; potete filtrare per **scuola**. -2. Clicca **+ New Class Group** (Nuova classe). +2. Cliccate **+ New Class Group** (Nuova classe). ![Elenco classi](img/class-groups.png) -3. Compila: +3. Compilate: - **Scuola** — a quale plesso appartiene la classe. - **Nome** — es. `1A`, `3B` (max 20 caratteri). - **Anno di corso (Year Level)** — il livello numerico, tipicamente da `1` a `5`. -4. Salva. +4. Salvate. ![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) -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 *"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). -2. Indica le **ore settimanali** (Weekly Lesson Hrs), es. `4` per Italiano. -3. Ripeti per tutte le materie della classe. +1. Aggiungete una **materia** tra quelle create in [Materie](08-materie.md). +2. Indicate le **ore settimanali** (Weekly Lesson Hrs), es. `4` per Italiano. +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). -![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 > 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 > 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 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). -- 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 - ti avvisa: *"Il docente avrebbe N h/settimana ma il massimo è M h. Assegnare - comunque?"*. Puoi procedere o rivedere l'assegnazione. +vi avvisa: *"La docente ed il docente avrebbe N h/settimana ma il massimo è M h. Assegnare +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). -> **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 -> 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 @@ -82,7 +82,7 @@ Configurare tante classi simili a mano è noioso. La pagina offre alcune scorcia classe. Le materie già presenti non vengono duplicate. - **Clone to …** — copia il monte ore della classe corrente verso una o più altre classi selezionate. -- **Copy teachers from …** — copia le assegnazioni dei docenti da un'altra classe, +- **Copy teachers from …** — copia le assegnazioni delle docenti e dei docenti da un'altra classe, limitatamente alle materie presenti in entrambe. 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 -- **Modifica** per correggere nome o anno di corso (non la scuola). -- **Elimina** con conferma: rimuove anche il monte ore e le assegnazioni collegate. +- **Modificate** per correggere nome o anno di corso (non la scuola). +- **Eliminate** con conferma: rimuove anche il monte ore e le assegnazioni collegate. ## Lista di controllo prima di procedere -Prima di passare oltre, verifica che per ogni classe: +Prima di passare oltre, verificate che per ogni classe: - [ ] siano definite **tutte** le materie con il monte ore corretto; - [ ] la somma delle ore **entri** nella griglia oraria della scuola; -- [ ] **ogni** materia abbia un **docente assegnato**. +- [ ] **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. --- diff --git a/10-docenti.md b/10-docenti.md index b47099a..d8ab6c6 100644 --- a/10-docenti.md +++ b/10-docenti.md @@ -1,96 +1,96 @@ # 10. Docenti e preferenze -I **docenti** sono le persone che insegnano le materie alle classi. In questa -pagina gestisci la loro anagrafica, i limiti contrattuali e — se vuoi inserirle tu -stesso — le loro preferenze e indisponibilità. +Le **docenti** ed i **docenti** sono le persone che insegnano le materie alle classi. In questa +pagina gestite la loro anagrafica, i limiti contrattuali e — se volete inserirle voi +stessi — le loro preferenze e indisponibilità. > Voce di menu: **Configuration → Teachers**. ## Creare un docente -1. Apri **Teachers** dal menu. -2. Clicca **+ New Teacher** (Nuovo docente). +1. Aprite **Teachers** dal menu. +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`. - - **Email** — es. `mario.rossi@scuola.it`. Serve per inviargli l'invito a - compilare le preferenze (vedi [Raccolta preferenze](12-raccolta-preferenze.md)). + - **Email** — es. `mario.rossi@scuola.it`. Serve per inviarle/inviargli l'invito a + compilare le preferenze (vedete [Raccolta preferenze](12-raccolta-preferenze.md)). - **Ore settimanali massime (Max Weekly Hours)** — es. `18`. È il tetto di ore - che il docente può insegnare a settimana. + che la docente ed il docente può insegnare a settimana. - **Giorno libero (Free Day)** *(facoltativo)* — il giorno della settimana che - il docente preferirebbe tenere libero. È una **preferenza**, non una garanzia. + la docente ed il docente preferirebbe tenere libero. È una **preferenza**, non una garanzia. - **Latitudine / Longitudine di casa** *(facoltative)* — la posizione dell'abitazione, usata per stimare i tempi di spostamento casa→scuola. -4. Salva. +4. Salvate. ![Form di creazione docente](img/teachers-add.png) ## 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: - le **ore settimanali massime** e le **ore giornaliere massime** non vengono mai 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 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). -## 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: -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 essere riferite a una classe specifica. 2. **Preferenze sulle sedi** — un ordine di gradimento tra i plessi (utile negli istituti con più scuole). 3. **Caratteristiche dell'orario** — per esempio la preferenza per le ore del **mattino** e la preferenza per un orario **compatto** (senza "buchi"). -4. **Indisponibilità assolute** — i periodi in cui il docente non può proprio +4. **Indisponibilità assolute** — i periodi in cui la docente ed il docente non può proprio 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 > differenza: *"da evitare"* è una preferenza (il sistema cerca di rispettarla ma > può ignorarla), mentre *"non disponibile"* e le indisponibilità assolute sono -> vincoli rigidi (mai violati). Usa "non disponibile" solo per impossibilità reali, -> altrimenti rischi di rendere l'orario impossibile da costruire. +> vincoli rigidi (mai violati). Usate "non disponibile" solo per impossibilità reali, +> altrimenti rischiate di rendere l'orario impossibile da costruire. ## 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, - come appena descritto. Comodo per pochi docenti o per correzioni puntuali. -2. **Campagna di raccolta** — inviti i docenti a compilare da soli un modulo online - (vedi [Raccolta preferenze dei docenti](12-raccolta-preferenze.md)). Consigliato - quando i docenti sono molti. +1. **Inserimento diretto** — compilate voi le preferenze dalla scheda della docente e del docente, + come appena descritto. Comodo per poche docenti e pochi docenti o per correzioni puntuali. +2. **Campagna di raccolta** — invitate le docenti ed i docenti a compilare da sole e da soli un modulo online + (vedete [Raccolta preferenze delle docenti e dei docenti](12-raccolta-preferenze.md)). Consigliato + quando le docenti ed i docenti sono molti. ## Modificare o eliminare -- **Cerca** un docente con la barra di ricerca. -- **Modifica** per aggiornare anagrafica, limiti o preferenze. -- **Elimina** con conferma. Se il docente è assegnato a delle classi, valuta prima - di rimuoverlo: quelle materie resterebbero senza insegnante. +- **Cercate** una docente ed un docente con la barra di ricerca. +- **Modificate** per aggiornare anagrafica, limiti o preferenze. +- **Eliminate** con conferma. Se la docente è assegnata ed il docente è assegnato a delle classi, valutate prima + di rimuoverla/rimuoverlo: quelle materie resterebbero senza insegnante. ## 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 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. --- diff --git a/11-spostamenti.md b/11-spostamenti.md index b8f20cd..e05668b 100644 --- a/11-spostamenti.md +++ b/11-spostamenti.md @@ -1,8 +1,8 @@ # 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 -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). > 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: - **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. -> **Un solo plesso?** Se l'istituto ha un'unica scuola, questa pagina non ti serve: -> non ci sono spostamenti tra sedi da gestire. Puoi saltare il capitolo. +> **Un solo plesso?** Se l'istituto ha un'unica scuola, questa pagina non vi serve: +> non ci sono spostamenti tra sedi da gestire. Potete saltare il capitolo. ## 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)): - **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 [orari delle campanelle](07-orari-e-campanella.md)). - **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. ## 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**. -2. Scegli la scuola di partenza (**From**) e quella di arrivo (**To**). -3. Indica i **minuti di viaggio (Travel Minutes)**. -4. Salva. +1. Aprite **Travel Matrix**. +2. Scegliete la scuola di partenza (**From**) e quella di arrivo (**To**). +3. Indicate i **minuti di viaggio (Travel Minutes)**. +4. Salvate. ![Matrice tempi di viaggio](img/travel-matrix.png) -I filtri in alto (From / To, con l'opzione *"Anywhere"* per non filtrare) ti -aiutano a trovare rapidamente la coppia che ti interessa quando le scuole sono +I filtri in alto (From / To, con l'opzione *"Anywhere"* per non filtrare) vi +aiutano a trovare rapidamente la coppia che vi interessa quando le scuole sono molte. ## Calcolo automatico (Recalculate) -Se hai inserito le **coordinate geografiche** delle scuole -([Scuole](05-scuole.md)), puoi usare il pulsante **Recalculate** (Ricalcola) per +Se avete inserito le **coordinate geografiche** delle scuole +([Scuole](05-scuole.md)), potete usare il pulsante **Recalculate** (Ricalcola) per far **stimare automaticamente** i tempi al sistema, a partire dagli indirizzi e dalle posizioni. > **Attenzione: sono stime.** Il calcolo automatico si basa su una stima della -> distanza e **non** conosce traffico, parcheggio o mezzi di trasporto. Controlla -> sempre i valori proposti e correggi a mano le tratte che conosci: pochi minuti in +> distanza e **non** conosce traffico, parcheggio o mezzi di trasporto. Controllate +> 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. ## 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 -"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. --- 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. --- diff --git a/12-raccolta-preferenze.md b/12-raccolta-preferenze.md index bdb318a..4485c07 100644 --- a/12-raccolta-preferenze.md +++ b/12-raccolta-preferenze.md @@ -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 -gradimento. Invece di raccoglierle su carta o via email e inserirle a mano, puoi +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, potete 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**. -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 "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: ``` -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. -2. **Invita** i docenti scegliendoli dall'elenco. -3. **Invia** le email: ogni docente riceve un link personale. -4. I docenti **compilano** il modulo online. -5. Tu **monitori** chi ha risposto e chi no. +1. **Create** una campagna per l'anno scolastico, dandole un nome. +2. **Invitate** le docenti ed i docenti scegliendole/l'i dall'elenco. +3. **Inviate** le email: ogni docente riceve un link personale. +4. Le docenti ed i docenti **compilano** il modulo online. +5. Voi **monitorate** chi ha risposto e chi no. ## Passo 1 — Creare la campagna -1. Apri **Preferences Campaign** dal menu. -2. Crea una nuova campagna: scegli l'**anno scolastico** di riferimento e assegna +1. Aprite **Preferences Campaign** dal menu. +2. Create una nuova campagna: scegliete l'**anno scolastico** di riferimento e assegnate un **nome** riconoscibile (es. `Preferenze 2025/2026`). ![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 -vuoi includere nella campagna. Puoi invitarli tutti o solo una parte (per esempio -solo i nuovi docenti, se gli altri hanno già fornito le preferenze). +Selezionate, dall'elenco delle docenti e dei docenti inseriti in [Docenti](10-docenti.md), quelle e quelli che +volete includere nella campagna. Potete invitarle/invitarli tutte e tutti o solo una parte (per esempio +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. ## 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, -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. -> 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. -## 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'**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 **indisponibilità assolute**. -Sono le stesse informazioni che potresti inserire tu dalla scheda del docente -([Docenti](10-docenti.md)); qui però le fornisce direttamente l'interessato. +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'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 -Aprendo il **dettaglio della campagna** vedi, per ciascun invitato, se ha già -risposto oppure no. Usa questa vista per: +Aprendo il **dettaglio della campagna** vedete, per ciascuna invitata e ciascun invitato, se ha già +risposto oppure no. Usate questa vista per: - sollecitare chi è in ritardo; - decidere quando "chiudere" la raccolta e passare alla generazione. ![Dettaglio campagna con stato risposte](img/campaign-details.png) -> **Non serve aspettare il 100%.** Puoi generare l'orario anche se non tutti hanno -> risposto: per i docenti senza preferenze il sistema semplicemente non avrà +> **Non serve aspettare il 100%.** Potete generare l'orario anche se non tutte e tutti hanno +> risposto: per le docenti ed i docenti senza preferenze il sistema semplicemente non avrà > obiettivi da rispettare, ma l'orario resterà comunque valido. ## In ambiente di prova 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. --- -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**. --- diff --git a/13-generazione-orario.md b/13-generazione-orario.md index 9b0ec7f..2de9e2c 100644 --- a/13-generazione-orario.md +++ b/13-generazione-orario.md @@ -1,43 +1,43 @@ # 13. Generazione dell'orario -È il momento in cui il sistema costruisce l'orario al posto tuo. In questa pagina -imposti l'ambito e le impostazioni, avvii il **motore di ottimizzazione** e ne -segui l'avanzamento in tempo reale. +È il momento in cui il sistema costruisce l'orario al posto vostro. In questa pagina +impostate l'ambito e le impostazioni, avviate il **motore di ottimizzazione** e ne +seguite l'avanzamento in tempo reale. > Voce di menu: **Timetable → Generate**. ## 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)); - [ ] almeno una **scuola** ([cap. 5](05-scuole.md)); - [ ] gli **orari delle campanelle** per ogni scuola ([cap. 7](07-orari-e-campanella.md)); - [ ] le **materie** ([cap. 8](08-materie.md)); -- [ ] le **classi** con **monte ore** e **docenti assegnati** ([cap. 9](09-classi.md)); -- [ ] i **docenti** con i loro limiti ([cap. 10](10-docenti.md)); +- [ ] le **classi** con **monte ore** e **docenti assegnate ed assegnati** ([cap. 9](09-classi.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)); -- [ ] i **tempi di viaggio** se hai più plessi ([cap. 11](11-spostamenti.md)); -- [ ] (facoltativo) le **preferenze** dei docenti ([cap. 12](12-raccolta-preferenze.md)). +- [ ] i **tempi di viaggio** se avete più plessi ([cap. 11](11-spostamenti.md)); +- [ ] (facoltativo) le **preferenze** delle docenti e dei docenti ([cap. 12](12-raccolta-preferenze.md)). ## Come lavora il motore, in due parole Il motore prima cerca una soluzione che rispetti **tutti i vincoli rigidi** (orario *ammissibile*), poi la **migliora** massimizzando le preferenze (orario *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. ## Passo 1 — Scegliere l'anno e l'ambito -1. Seleziona l'**anno scolastico** di destinazione. -2. Scegli l'**ambito (scope)**: +1. Selezionate l'**anno scolastico** di destinazione. +2. Scegliete l'**ambito (scope)**: - **tutto l'istituto** (tutte le scuole e tutte le classi), oppure - un **sottoinsieme** (alcune scuole o alcune classi). > **Ambito più stretto = calcolo più rapido.** Generare per una sola scuola alla > 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) @@ -46,42 +46,42 @@ scegliere quanto tempo concedergli. Un **preset** è una configurazione salvata che dice al sistema **quanto** dare 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. -- 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**. 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). > **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 -> **un peso alla volta** e rigenera, così capisci l'effetto di ciascuna modifica. +> Alzare il peso di un obiettivo lo fa preferire *a scapito* degli altri. Cambiate +> **un peso alla volta** e rigenerate, così capite l'effetto di ciascuna modifica. ## Passo 3 — Impostare le opzioni del solutore Le principali impostazioni tecniche sono: - **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. - **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) ## 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**: - il numero di **soluzioni trovate** finora; - la **qualità** (valore obiettivo) della migliore soluzione trovata; - 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 periodicamente. diff --git a/14-comprendere-i-punteggi.md b/14-comprendere-i-punteggi.md index a0f6244..6784ea9 100644 --- a/14-comprendere-i-punteggi.md +++ b/14-comprendere-i-punteggi.md @@ -1,8 +1,8 @@ # 14. Comprendere i punteggi di qualità Ogni versione di orario generata riceve dei **punteggi** che ne misurano la -qualità. Capirli ti permette di **confrontare** le versioni e di scegliere con -consapevolezza, invece di affidarti all'impressione. Questo capitolo spiega cosa +qualità. Capirli vi permette di **confrontare** le versioni e di scegliere con +consapevolezza, invece di affidarvi all'impressione. Questo capitolo spiega cosa significano, senza formule complicate. ## 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 **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)). > **La regola più importante.** Se un orario viola **anche un solo vincolo rigido**, > 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)). > **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. ## 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. | | **Orario compatto** | Quanto le lezioni di ogni docente sono consecutive, senza "buchi". | | **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). | | **Tragitto casa-scuola** | Quanto è contenuto il tragitto da casa alle sedi. | -> **Categorie non applicabili.** Se una categoria non riguarda un docente (per -> esempio non ha indicato un giorno libero), per lui quella categoria vale come +> **Categorie non applicabili.** Se una categoria non riguarda un/una docente (per +> esempio non ha indicato un giorno libero), per lui/lei quella categoria vale come > 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. -- **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**. ![Scheda Scores con grafici e scomposizione](img/review-report.png) ## 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 - sull'aspetto che a te sta più a cuore. -- **Individua il punto debole:** la categoria con il valore più basso ti dice cosa - migliorare. Se, ad esempio, "Orario compatto" è basso, aumenta il peso della - compattezza nel preset e rigenera. + sull'aspetto che a voi sta più a cuore. +- **Individuate il punto debole:** la categoria con il valore più basso vi dice cosa + migliorare. Se, ad esempio, "Orario compatto" è basso, aumentate il peso della + compattezza nel preset e rigenerate. - **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 **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 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à -del tuo istituto in numeri. Rivedi [Generazione — pesi](13-generazione-orario.md#passo-2--scegliere-il-preset-e-i-pesi). +più, tipicamente a scapito di altre. È il meccanismo con cui traducete le priorità +del vostro istituto in numeri. Rivedete [Generazione — pesi](13-generazione-orario.md#passo-2--scegliere-il-preset-e-i-pesi). --- diff --git a/15-revisione-orario.md b/15-revisione-orario.md index 969934b..d8f510e 100644 --- a/15-revisione-orario.md +++ b/15-revisione-orario.md @@ -1,21 +1,21 @@ # 15. Revisione e confronto delle versioni -Dopo la generazione, la pagina di **Revisione** è il tuo centro di controllo: qui -vedi tutte le versioni di orario prodotte per un anno, le apri in dettaglio, le -confronti, e infine ne finalizzi una come orario ufficiale. +Dopo la generazione, la pagina di **Revisione** è il vostro centro di controllo: qui +vedete tutte le versioni di orario prodotte per un anno, le aprite in dettaglio, le +confronti, e infine ne finalizzate una come orario ufficiale. > Voce di menu: **Timetable → Review**. ## 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: -- il **punteggio composito** (0–100) — vedi [Comprendere i punteggi](14-comprendere-i-punteggi.md); +- il **punteggio composito** (0–100) — vedete [Comprendere i punteggi](14-comprendere-i-punteggi.md); - lo **stato**: *bozza (draft)*, *finale (final)* o *archiviata (archived)*; - 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. ![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 -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) -È 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: - **classe** — l'orario di una singola classe; @@ -42,14 +42,14 @@ vista per: - **materia** o **giorno**. 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) ### Scheda punteggi (Scores) 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 -interpretarla, vedi [Comprendere i punteggi](14-comprendere-i-punteggi.md). +interpretarla, vedete [Comprendere i punteggi](14-comprendere-i-punteggi.md). ### Scheda assegnazioni (Assignments) Il riepilogo del **carico di lavoro** dei docenti: @@ -58,46 +58,46 @@ Il riepilogo del **carico di lavoro** dei docenti: - distribuzione tra le classi; - 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. ### Scheda conflitti (Conflicts) Elenca le eventuali **violazioni di vincoli rigidi**. Per una versione generata dal motore **dovrebbe essere vuota**. Se contiene qualcosa (tipicamente dopo una [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. -> **Ricorda:** qualsiasi conflitto rigido porta il punteggio composito a **0**. -> Controlla questa scheda ogni volta che il composito è 0. +> **Ricordate:** qualsiasi conflitto rigido porta il punteggio composito a **0**. +> Controllate questa scheda ogni volta che il composito è 0. ## 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); - le **categorie** di qualità (aprendo la scheda Scores di ciascuna); - 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. ## Finalizzare una versione -Quando hai scelto l'orario definitivo, clicca **Finalize** (Finalizza) sulla +Quando avete scelto l'orario definitivo, cliccate **Finalize** (Finalizza) sulla versione: - lo stato passa a **finale**; - la versione viene **bloccata** contro ulteriori modifiche accidentali. -Finalizza **solo** una versione priva di conflitti e che ti soddisfa: è il segnale -che quello è l'orario ufficiale. Se in seguito devi correggerla, usa la +Finalizzate **solo** una versione priva di conflitti e che vi soddisfa: è il segnale +che quello è l'orario ufficiale. Se in seguito dovete correggerla, usate la [personalizzazione](16-personalizzazione-orario.md), che lavora su una copia. ## Eliminare una versione -Con **Delete** (Elimina) rimuovi una versione che non ti serve. L'operazione -richiede una **doppia conferma** per evitare cancellazioni accidentali. Elimina +Con **Delete** (Elimina) rimuovete una versione che non vi serve. L'operazione +richiede una **doppia conferma** per evitare cancellazioni accidentali. Eliminate liberamente le bozze scartate per tenere l'elenco pulito. --- diff --git a/16-personalizzazione-orario.md b/16-personalizzazione-orario.md index c81138e..95b0d92 100644 --- a/16-personalizzazione-orario.md +++ b/16-personalizzazione-orario.md @@ -2,7 +2,7 @@ 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 -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. > Si apre con **Customize** (Personalizza) dalla pagina di @@ -10,19 +10,19 @@ versione mantenendo il pieno controllo. ## 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: - l'orario di partenza resta **intatto** e sempre recuperabile; -- puoi fare esperimenti senza timore; -- puoi generare più varianti manuali e confrontarle come qualsiasi altra versione. +- potete fare esperimenti senza timore; +- 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 -lezioni) in una tabella filtrabile e ordinabile. Su ciascuna puoi: +Nella pagina di personalizzazione vedete **tutte le assegnazioni** (le singole +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**. - **Rimuovere** una lezione: eliminare una specifica 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. > **Le modifiche manuali NON vengono ri-validate automaticamente.** Spostando una -> lezione potresti, senza accorgertene, creare un conflitto: due lezioni della -> stessa classe alla stessa ora, un docente in due posti insieme, un monte ore non +> lezione potreste, senza accorgervene, creare un conflitto: due lezioni della +> stessa classe alla stessa ora, un/una docente in due posti insieme, un monte ore non > più rispettato, un tempo di viaggio insufficiente. Per questo, **dopo** ogni sessione di modifiche: -1. Salva la nuova bozza. -2. Aprila in [Revisione](15-revisione-orario.md) e controlla la **scheda +1. Salvate la nuova bozza. +2. Apritela in [Revisione](15-revisione-orario.md) e controllate la **scheda 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. -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. ## Quando personalizzare e quando rigenerare - **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. - **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. ## Un flusso di lavoro efficace @@ -62,10 +62,10 @@ manuale è valida. 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. --- diff --git a/17-esportazione.md b/17-esportazione.md index ceaf1a3..9f2796a 100644 --- a/17-esportazione.md +++ b/17-esportazione.md @@ -1,26 +1,26 @@ # 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 della scuola. Lo strumento permette di **esportare** l'orario in un foglio di calcolo pronto all'uso. ## 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: - **XLSX** — il formato di Microsoft Excel (apribile anche con LibreOffice, Google Fogli, ecc.). - **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. ## Da dove si esporta 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. ## Cosa contiene il file @@ -38,25 +38,25 @@ sia quelli individuali per i docenti. ## 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. -- Prima di stampare, dai un'occhiata all'**anteprima di stampa** del foglio di - calcolo e regola margini e orientamento (l'orizzontale spesso rende meglio per le +- Prima di stampare, date un'occhiata all'**anteprima di stampa** del foglio di + calcolo e regolate margini e orientamento (l'orizzontale spesso rende meglio per le 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. ## E se devo ancora fare modifiche? 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 -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 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. --- diff --git a/18-buone-pratiche-e-problemi.md b/18-buone-pratiche-e-problemi.md index f297b7a..f5d115a 100644 --- a/18-buone-pratiche-e-problemi.md +++ b/18-buone-pratiche-e-problemi.md @@ -8,12 +8,12 @@ soluzioni. ### Cura i dati: è lì che si vince o si perde 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; -- **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 **indisponibilità** siano davvero indispensabili (vedi sotto). +- le **indisponibilità** siano davvero indispensabili (vedete sotto). ### Distingui sempre vincoli rigidi e preferenze È 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. ### Parti semplice, poi raffina -Per il primo orario, usa il **preset predefinito** e l'ambito completo. Guarda il -risultato, individua 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 +Per il primo orario, usate il **preset predefinito** e l'ambito completo. Guardate il +risultato, individuate il punto debole dai [punteggi](14-comprendere-i-punteggi.md), +poi cambiate **un solo peso alla volta** e rigenerate. Così capite l'effetto di ogni modifica. -### Lavora per versioni -Non aver paura di generare molte versioni: costano poco e puoi confrontarle. Tieni -le più promettenti, elimina le altre per non fare confusione, e **finalizza** solo +### Lavorate per versioni +Non abbiate paura di generare molte versioni: costano poco e potete confrontarle. Tenete +le più promettenti, eliminate le altre per non fare confusione, e **finalizzate** solo alla fine. -### Concedi tempo al motore sugli istituti grandi -Se l'istituto è grande, aumenta il **tempo massimo** di calcolo o restringi +### Concedete tempo al motore sugli istituti grandi +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 il motore a trovare soluzioni migliori. ### Valida sempre dopo le modifiche manuali -Ogni volta che [personalizzi](16-personalizzazione-orario.md) un orario, controlla -la scheda **Conflitti** ed esegui la **validazione**: le modifiche manuali non sono +Ogni volta che [personalizzate](16-personalizzazione-orario.md) un orario, controllate +la scheda **Conflitti** ed eseguite la **validazione**: le modifiche manuali non sono controllate in automatico. ## Risoluzione dei problemi ### Il motore non trova alcuna soluzione 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 | |----------|------------------| -| 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). | -| Indisponibilità | Ci sono docenti con troppe ore marcate "non disponibile"? Riducile all'essenziale. Vedi [cap. 10](10-docenti.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. Vedete [cap. 10](10-docenti.md). | | 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? | -| Spostamenti | Per i multi-plesso, i tempi di viaggio sono compatibili con l'intervallo tra le ore? Vedi [cap. 11](11-spostamenti.md). | +| 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? 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**. ### La qualità è bassa (composito basso, ma > 0) -L'orario è valido ma migliorabile. Apri la scheda **Scores** -([cap. 14](14-comprendere-i-punteggi.md)), individua la **categoria più bassa** e -aumenta il **peso** corrispondente nel preset, poi rigenera. Ricorda che gli +L'orario è valido ma migliorabile. Aprite la scheda **Scores** +([cap. 14](14-comprendere-i-punteggi.md)), individuate la **categoria più bassa** e +aumentate il **peso** corrispondente nel preset, poi rigenerate. Ricordate che gli obiettivi sono in parte in conflitto: migliorarne uno può peggiorarne un altro. ### 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 -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. ### Il calcolo va in timeout senza una buona soluzione -L'istanza è troppo grande per il tempo concesso. Soluzioni: **aumenta il tempo -massimo**, oppure **restringi l'ambito** (genera meno scuole/classi per volta), +L'istanza è troppo grande per il tempo concesso. Soluzioni: **aumentate il tempo +massimo**, oppure **restringete l'ambito** (genera meno scuole/classi per volta), oppure semplifica i vincoli. ### Non vedo classi o materie nella generazione -Quasi sempre mancano i **monte ore** o le **assegnazioni docenti**. Torna in -[Classi](09-classi.md) e verifica che ogni classe abbia le materie con le ore e il +Quasi sempre mancano i **monte ore** o le **assegnazioni docenti**. Tornate in +[Classi](09-classi.md) e verificate che ogni classe abbia le materie con le ore e il/la docente. ### Un docente risulta sovraccarico -Controlla la scheda **Assignments** ([cap. 15](15-revisione-orario.md)) per vedere -il totale ore. Se supera il previsto, rivedi le sue **assegnazioni** in +Controllate la scheda **Assignments** ([cap. 15](15-revisione-orario.md)) per vedere +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). ### Le email delle preferenze non arrivano 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 -preferenze a mano dalla scheda del docente ([cap. 10](10-docenti.md)). +spedite). Rivolgetevi a chi gestisce l'installazione. Nel frattempo potete inserire le +preferenze a mano dalla scheda del/della docente ([cap. 10](10-docenti.md)). ### Ho perso l'accesso / la sessione è scaduta -Reinserisci 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 +Reinserite le credenziali nella pagina di login ([cap. 3](03-primi-passi.md)). Se +le avete smarrite, contatta l'amministratrice e l'amministratore del sistema: non esiste un recupero autonomo. ## Quando chiedere aiuto tecnico 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 -**quale messaggio** hai visto, e contatta chi gestisce l'installazione del sistema -per il tuo istituto. +**quale messaggio** avete visto, e contatta chi gestisce l'installazione del sistema +per il vostro istituto. --- diff --git a/19-glossario.md b/19-glossario.md index e9d3640..07d242d 100644 --- a/19-glossario.md +++ b/19-glossario.md @@ -2,109 +2,109 @@ Definizioni brevi dei termini usati nel manuale e nell'interfaccia. Dove utile, il 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)* 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). ### 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). ### Assegnazione (docente) *(teacher assignment)* 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)* 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)* -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)* -L'iniziativa con cui inviti i docenti a compilare le loro preferenze tramite un link -personale. Vedi [cap. 12](12-raccolta-preferenze.md). +L'iniziativa con cui invitate le docenti ed i docenti a compilare le loro preferenze tramite un link +personale. Vedete [cap. 12](12-raccolta-preferenze.md). ### Classe *(class group)* 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)* 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)* 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)* 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)* 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)* -Il giorno che un docente preferirebbe tenere libero da lezioni. È una **preferenza**, -non una garanzia. Vedi [cap. 10](10-docenti.md). +Il giorno che un/una docente preferirebbe tenere libero da lezioni. È una **preferenza**, +non una garanzia. Vedete [cap. 10](10-docenti.md). ### Indisponibilità *(unavailability)* -Un periodo in cui un docente non può proprio esserci: è un **vincolo rigido**, -sempre rispettato. Da non confondere con la preferenza "da evitare". Vedi +Un periodo in cui un/una docente non può proprio esserci: è un **vincolo rigido**, +sempre rispettato. Da non confondere con la preferenza "da evitare". Vedete [cap. 10](10-docenti.md). ### 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)* 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)* -La qualità di un orario senza "buchi" tra le lezioni di un docente nello stesso -giorno. Obiettivo di qualità. Vedi [cap. 14](14-comprendere-i-punteggi.md). +La qualità di un orario senza "buchi" tra le lezioni di un/una docente nello stesso +giorno. Obiettivo di qualità. Vedete [cap. 14](14-comprendere-i-punteggi.md). ### Peso *(weight)* 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). ### 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)* -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. -Vedi [cap. 1](01-introduzione.md). +Vedete [cap. 1](01-introduzione.md). ### Preset *(preset)* 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)* -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). ### 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). ### Vincolo rigido *(hard constraint)* 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)* 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 -argomento, torna all'[Indice](README.md). +argomento, tornate all'[Indice](README.md). --- diff --git a/README.md b/README.md index 607fad4..9b86c5b 100644 --- a/README.md +++ b/README.md @@ -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. 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 **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. ## 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 **precedente** e **successiva**, oltre che a questo indice. -Se hai già dimestichezza con lo strumento, usa l'indice qui sotto per saltare -direttamente all'argomento che ti interessa. +Se avete già dimestichezza con lo strumento, usate l'indice qui sotto per saltare +direttamente all'argomento che vi interessa. ## 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. 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. -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. -### Parte 3 — Preferenze dei docenti -12. [Raccolta preferenze dei docenti](12-raccolta-preferenze.md) — le campagne per invitare i docenti a compilare le loro preferenze. +### Parte 3 — Preferenze delle docenti e dei docenti +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 13. [Generazione dell'orario](13-generazione-orario.md) — avviare l'ottimizzatore e seguirne l'avanzamento.