diff --git a/03-primi-passi.md b/03-primi-passi.md index 0c7c1b7..60f7599 100644 --- a/03-primi-passi.md +++ b/03-primi-passi.md @@ -14,6 +14,8 @@ quello fornito da chi ha installato il sistema per il tuo istituto. 3. Inserisci **nome utente e password** che ti sono stati forniti. 4. Premi **Accedi**. +![Pagina di accesso](img/login.png) + Alcune indicazioni utili: - **Non esiste una registrazione autonoma.** L'utente amministratore viene creato diff --git a/04-anni-scolastici.md b/04-anni-scolastici.md index 23674a8..10aaa3a 100644 --- a/04-anni-scolastici.md +++ b/04-anni-scolastici.md @@ -29,6 +29,8 @@ qui. etichetta. 4. Salva. +![Elenco anni scolastici](img/academic-years.png) + ## Modificare o eliminare - **Modifica:** usa l'icona di modifica accanto all'anno per correggere diff --git a/05-scuole.md b/05-scuole.md index 77f1c4a..4d7ae7d 100644 --- a/05-scuole.md +++ b/05-scuole.md @@ -22,6 +22,9 @@ Questi tempi diventano poi vincoli e obiettivi durante la generazione (vedi 1. Apri **Schools** dal menu. 2. Clicca **+ New School** (Nuova scuola). + +![Elenco scuole](img/schools.png) + 3. Compila i campi: - **Nome** — es. `Liceo Scientifico`, `Sede centrale`, `Succursale Via Verdi`. - **Indirizzo** — es. `Via Roma 1, 00100 Roma`. @@ -29,6 +32,8 @@ Questi tempi diventano poi vincoli e obiettivi durante la generazione (vedi gradi decimali (es. `41.8902`, `12.4964`). 4. Salva. +![Form di creazione scuola](img/schools-add.png) + ## Coordinate: quando servono - **Un solo plesso:** le coordinate non incidono sull'orario; puoi lasciarle diff --git a/06-aule-e-laboratori.md b/06-aule-e-laboratori.md index f7ad457..4ba3b56 100644 --- a/06-aule-e-laboratori.md +++ b/06-aule-e-laboratori.md @@ -33,6 +33,9 @@ in palestra alla stessa ora. 2. In alto puoi **filtrare per scuola** per vedere le facility di un plesso specifico. 3. Clicca **+ New Facility** (Nuova facility). + +![Elenco facility](img/facilities.png) + 4. Compila: - **Scuola** — a quale plesso appartiene la stanza. - **Nome** — es. `Palestra A`, `Laboratorio di Chimica`. @@ -41,6 +44,8 @@ in palestra alla stessa ora. caratteri). 5. Salva. +![Form di creazione facility](img/facilities-add.png) + > **Attenzione.** La **scuola non è modificabile** dopo la creazione. Se sbagli > plesso, elimina la facility e ricreala. diff --git a/07-orari-e-campanella.md b/07-orari-e-campanella.md index 9aea1ca..a25567d 100644 --- a/07-orari-e-campanella.md +++ b/07-orari-e-campanella.md @@ -33,6 +33,8 @@ In alto nella pagina devi selezionare **l'anno scolastico** e la **scuola** di c vuoi definire gli orari. Finché non li scegli, la pagina ti invita a farlo e non mostra alcuna griglia. +![Griglia slot orari](img/time-slots.png) + ## Creare gli slot in blocco (consigliato) Il modo più veloce per impostare una giornata tipo è generare più slot in una volta: @@ -45,6 +47,8 @@ Il modo più veloce per impostare una giornata tipo è generare più slot in una - **Numero del primo periodo** (di solito `1`). 3. Conferma con **Add Slots**. +![Form aggiunta slot multipli](img/time-slot-add.png) + Il sistema crea automaticamente gli slot consecutivi calcolando gli orari. Ripeti l'operazione se alcuni giorni hanno un numero di ore diverso. diff --git a/08-materie.md b/08-materie.md index 1f1d878..2745a0f 100644 --- a/08-materie.md +++ b/08-materie.md @@ -20,12 +20,17 @@ Per questo le materie vanno create **prima** di configurare le classi e i docent 1. Apri **Subjects** dal menu. 2. Clicca **+ New Subject** (Nuova materia). + +![Elenco materie](img/subjects.png) + 3. Compila: - **Nome** — es. `Matematica`. - **Codice** *(facoltativo)* — una sigla breve, es. `MAT`. Se lo usi deve essere **univoco** (max 50 caratteri). 4. Salva. +![Form di creazione materia](img/subjects-add.png) + ## Come nominare le materie - Usa nomi **uniformi** in tutto l'istituto: scegli, per esempio, sempre diff --git a/09-classi.md b/09-classi.md index 0965c33..221a44d 100644 --- a/09-classi.md +++ b/09-classi.md @@ -17,6 +17,9 @@ docenti**: sono le informazioni più importanti per la generazione. 1. Apri **Class Groups** dal menu. In alto seleziona l'**anno scolastico**; puoi filtrare per **scuola**. 2. Clicca **+ New Class Group** (Nuova classe). + +![Elenco classi](img/class-groups.png) + 3. Compila: - **Scuola** — a quale plesso appartiene la classe. - **Nome** — es. `1A`, `3B` (max 20 caratteri). @@ -24,6 +27,8 @@ docenti**: sono le informazioni più importanti per la generazione. `5`. 4. Salva. +![Form di creazione classe](img/class-groups-add.png) + > **Attenzione.** La **scuola non è modificabile** dopo la creazione della classe. ## Il monte ore (Teachings / Requirements) @@ -41,6 +46,8 @@ Qui definisci, materia per materia, quante ore settimanali servono alla classe: Se non hai ancora definito nulla, vedrai il messaggio *"No requirements defined yet"* (nessun monte ore definito). +![Finestra monte ore e assegnazione 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 diff --git a/10-docenti.md b/10-docenti.md index 58f9f56..b47099a 100644 --- a/10-docenti.md +++ b/10-docenti.md @@ -10,6 +10,9 @@ stesso — le loro preferenze e indisponibilità. 1. Apri **Teachers** dal menu. 2. Clicca **+ New Teacher** (Nuovo docente). + +![Elenco docenti](img/teachers.png) + 3. Compila i dati principali: - **Nome** e **Cognome** — es. `Mario` `Rossi`. - **Email** — es. `mario.rossi@scuola.it`. Serve per inviargli l'invito a @@ -22,6 +25,8 @@ stesso — le loro preferenze e indisponibilità. dell'abitazione, usata per stimare i tempi di spostamento casa→scuola. 4. Salva. +![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 @@ -51,6 +56,8 @@ nell'elenco (*"Preferences — Mario Rossi"*). Vi si trovano: 4. **Indisponibilità assolute** — i periodi in cui il docente non può proprio esserci: sono un **vincolo rigido**. +![Scheda preferenze 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 diff --git a/11-spostamenti.md b/11-spostamenti.md index e5e2560..b8f20cd 100644 --- a/11-spostamenti.md +++ b/11-spostamenti.md @@ -41,6 +41,8 @@ Per ogni coppia di scuole imposti il tempo di percorrenza: 3. Indica i **minuti di viaggio (Travel Minutes)**. 4. Salva. +![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 molte. diff --git a/12-raccolta-preferenze.md b/12-raccolta-preferenze.md index 624a2b8..bdb318a 100644 --- a/12-raccolta-preferenze.md +++ b/12-raccolta-preferenze.md @@ -31,6 +31,8 @@ Crea → Invita i docenti → Invia le email → [I docenti rispondono] → Moni 2. Crea una nuova campagna: scegli l'**anno scolastico** di riferimento e assegna un **nome** riconoscibile (es. `Preferenze 2025/2026`). +![Elenco campagne](img/campaign.png) + ## Passo 2 — Invitare i docenti Seleziona, dall'elenco dei docenti inseriti in [Docenti](10-docenti.md), quelli che @@ -67,6 +69,8 @@ l'altro: Sono le stesse informazioni che potresti inserire tu dalla scheda del docente ([Docenti](10-docenti.md)); qui però le fornisce direttamente l'interessato. +![Modulo preferenze del docente](img/preferences-form.png) + ## Passo 5 — Monitorare le risposte Aprendo il **dettaglio della campagna** vedi, per ciascun invitato, se ha già @@ -75,6 +79,8 @@ risposto oppure no. Usa 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à > obiettivi da rispettare, ma l'orario resterà comunque valido. diff --git a/13-generazione-orario.md b/13-generazione-orario.md index 4084842..9b0ec7f 100644 --- a/13-generazione-orario.md +++ b/13-generazione-orario.md @@ -39,6 +39,8 @@ scegliere quanto tempo concedergli. > volta è utile per fare prove veloci o per programmare in modo incrementale > (generi e "congeli" una parte, poi procedi con il resto). +![Pagina di generazione — scelta ambito](img/generate.png) + ## Passo 2 — Scegliere il preset e i pesi Un **preset** è una configurazione salvata che dice al sistema **quanto** dare @@ -68,6 +70,8 @@ Le principali impostazioni tecniche sono: Puoi 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 @@ -81,6 +85,8 @@ Lascia 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. +![Avanzamento in tempo reale](img/generate-running.png) + ## Passo 5 — Leggere l'esito Al termine, il riepilogo mostra: diff --git a/14-comprendere-i-punteggi.md b/14-comprendere-i-punteggi.md index aab7d42..a0f6244 100644 --- a/14-comprendere-i-punteggi.md +++ b/14-comprendere-i-punteggi.md @@ -55,6 +55,8 @@ percentuale): **1 = pienamente soddisfatta**, **0 = del tutto disattesa**. - **Nella scheda "Scores"** del dettaglio vedi 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 diff --git a/15-revisione-orario.md b/15-revisione-orario.md index 4892e72..969934b 100644 --- a/15-revisione-orario.md +++ b/15-revisione-orario.md @@ -18,6 +18,8 @@ ciascuna sono indicati: Espandendo una versione ne vedi una sintesi della valutazione. È qui che confronti "a colpo d'occhio" le alternative prima di aprirne una. +![Elenco versioni generate](img/review.png) + ## Gli stati di una versione | Stato | Significato | @@ -42,6 +44,8 @@ vista per: 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. +![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 diff --git a/img/academic-years.png b/img/academic-years.png new file mode 100644 index 0000000..dc98a6f Binary files /dev/null and b/img/academic-years.png differ diff --git a/img/campaign-details.png b/img/campaign-details.png new file mode 100644 index 0000000..17f2fb2 Binary files /dev/null and b/img/campaign-details.png differ diff --git a/img/campaign.png b/img/campaign.png new file mode 100644 index 0000000..6d5a3f6 Binary files /dev/null and b/img/campaign.png differ diff --git a/img/class-group-teachings.png b/img/class-group-teachings.png new file mode 100644 index 0000000..ddbfa31 Binary files /dev/null and b/img/class-group-teachings.png differ diff --git a/img/class-groups-add.png b/img/class-groups-add.png new file mode 100644 index 0000000..6e9774c Binary files /dev/null and b/img/class-groups-add.png differ diff --git a/img/class-groups.png b/img/class-groups.png new file mode 100644 index 0000000..c71d03c Binary files /dev/null and b/img/class-groups.png differ diff --git a/img/facilities-add.png b/img/facilities-add.png new file mode 100644 index 0000000..268b839 Binary files /dev/null and b/img/facilities-add.png differ diff --git a/img/facilities.png b/img/facilities.png new file mode 100644 index 0000000..456811f Binary files /dev/null and b/img/facilities.png differ diff --git a/img/generate-options.png b/img/generate-options.png new file mode 100644 index 0000000..02664e8 Binary files /dev/null and b/img/generate-options.png differ diff --git a/img/generate-running.png b/img/generate-running.png new file mode 100644 index 0000000..06642c1 Binary files /dev/null and b/img/generate-running.png differ diff --git a/img/generate.png b/img/generate.png new file mode 100644 index 0000000..90bd31f Binary files /dev/null and b/img/generate.png differ diff --git a/img/login.png b/img/login.png new file mode 100644 index 0000000..1550401 Binary files /dev/null and b/img/login.png differ diff --git a/img/preferences-form.png b/img/preferences-form.png new file mode 100644 index 0000000..068bd77 Binary files /dev/null and b/img/preferences-form.png differ diff --git a/img/review-details.png b/img/review-details.png new file mode 100644 index 0000000..8ccd4a8 Binary files /dev/null and b/img/review-details.png differ diff --git a/img/review-report.png b/img/review-report.png new file mode 100644 index 0000000..1eb18a7 Binary files /dev/null and b/img/review-report.png differ diff --git a/img/review.png b/img/review.png new file mode 100644 index 0000000..ad78e08 Binary files /dev/null and b/img/review.png differ diff --git a/img/schools-add.png b/img/schools-add.png new file mode 100644 index 0000000..5487b4e Binary files /dev/null and b/img/schools-add.png differ diff --git a/img/schools.png b/img/schools.png new file mode 100644 index 0000000..4640834 Binary files /dev/null and b/img/schools.png differ diff --git a/img/subjects-add.png b/img/subjects-add.png new file mode 100644 index 0000000..b5819a0 Binary files /dev/null and b/img/subjects-add.png differ diff --git a/img/subjects.png b/img/subjects.png new file mode 100644 index 0000000..962dccc Binary files /dev/null and b/img/subjects.png differ diff --git a/img/teachers-add.png b/img/teachers-add.png new file mode 100644 index 0000000..e9caa29 Binary files /dev/null and b/img/teachers-add.png differ diff --git a/img/teachers-preferences.png b/img/teachers-preferences.png new file mode 100644 index 0000000..fe4458e Binary files /dev/null and b/img/teachers-preferences.png differ diff --git a/img/teachers.png b/img/teachers.png new file mode 100644 index 0000000..1902ab2 Binary files /dev/null and b/img/teachers.png differ diff --git a/img/time-slot-add.png b/img/time-slot-add.png new file mode 100644 index 0000000..0e7fb17 Binary files /dev/null and b/img/time-slot-add.png differ diff --git a/img/time-slots.png b/img/time-slots.png new file mode 100644 index 0000000..f8cb307 Binary files /dev/null and b/img/time-slots.png differ diff --git a/img/travel-matrix.png b/img/travel-matrix.png new file mode 100644 index 0000000..859b8df Binary files /dev/null and b/img/travel-matrix.png differ