OrarioSmart — Generatore orario scolastico

§ 01 Cos'è OrarioSmart

OrarioSmart è il modulo integrato in EduSubSmart per la costruzione dell'orario scolastico. Permette di definire le assegnazioni docente-materia-classe, generare automaticamente l'orario con un algoritmo, modificarlo visivamente e pubblicarlo direttamente nella tabella che EduSubSmart usa per calcolare le supplenze.

§ 02 Come si integra con EduSubSmart

La tabella orario contiene per ogni riga: docente, giorno, ora, classe, tipo (LEZIONE o P). È la stessa tabella letta dal motore di calcolo supplenze. OrarioSmart e l'import CSV scrivono in questa tabella con lo stesso formato — sono alternative equivalenti.

Quando si pubblica, OrarioSmart cancella l'orario esistente per quella scuola e inserisce i nuovi slot. L'algoritmo di sostituzione usa i nuovi dati dalla richiesta successiva.

§ 03 Come accedere

1. Accedi a EduSubSmart come Admin o Supervisor
2. Dalla Dashboard vai su Moduli Avanzati → Apri OrarioSmart
3. Oppure accedi direttamente all'URL /orario_smart.php

§ 04 Tab Insegnamenti

Le quattro sezioni di OrarioSmart si usano in sequenza: insegnamenti → configurazione → genera → visualizza e pubblica. Ogni tab è indipendente.

Definire chi insegna cosa

Qui si definisce chi insegna cosa e a quale classe, con quante ore settimanali. Ogni riga è un'assegnazione docente-materia-classe.

Come aggiungere un insegnamento

1. Clicca + Aggiungi nella tab Insegnamenti
2. Seleziona il Docente dal menu a tendina
3. Seleziona la Classe
4. Digita il nome della Materia (es. "Matematica")
5. Inserisci le Ore settimanali (es. 4 per matematica)
6. Inserisci le Ore doppie — blocchi da 2 ore consecutive (0 se non necessario)
7. Clicca Salva

§ 05 Tab Configurazione

Definisce la struttura temporale dell'orario e i vincoli di generazione usati dall'algoritmo.

Struttura oraria

Vincoli di generazione

§ 06 Tab Genera Orario

Con un click l'algoritmo distribuisce automaticamente tutte le ore degli insegnamenti nei giorni e nelle fasce orarie disponibili, rispettando i vincoli impostati.

1. Assicurati di avere almeno un insegnamento configurato nella Tab 1
2. Controlla i parametri in Tab 2 (giorni, max ore, vincoli)
3. Clicca ⚡ Genera Orario Automatico
4. L'algoritmo elabora e mostra il risultato con un riepilogo ore per classe
5. Se ci sono avvisi (ore non piazzate), leggili e correggi se necessario
6. Passa alla Tab 4 per visualizzare e controllare l'orario generato

§ 07 Tab Vista Orario

Mostra l'orario generato come griglia settimanale, visualizzabile per docente o per classe. Ogni cella è cliccabile per modificare lo slot.

Come leggere la griglia

• Righe: ore della giornata (1ª, 2ª…) con orario reale calcolato in base all'ora di inizio
• Colonne: giorni della settimana
• Celle colorate: slot occupato — mostra classe (vista docente) o docente (vista classe)
• Celle vuote: slot libero disponibile

§ 08 Modifica manuale degli slot

L'algoritmo automatico è un punto di partenza. Puoi modificare qualsiasi slot cliccandoci sopra nella griglia.

1. Vai sulla Tab Vista Orario e seleziona docente o classe
2. Clicca su una cella occupata per modificarla o su una cella vuota per aggiungere uno slot
3. Si apre un pannello con i menu a tendina: Docente e Classe
4. Lascia la classe vuota per impostare l'ora come "Disposizione P"
5. Clicca Salva per applicare
6. Clicca Cancella per svuotare lo slot

§ 09 Pubblicare in EduSubSmart

Quando l'orario è completo e corretto, la pubblicazione lo scrive nel database rendendolo immediatamente disponibile per l'algoritmo delle supplenze.

1. Verifica l'orario nella Tab Vista — controlla slot mancanti o errati
2. Clicca 🚀 Pubblica in EduSubSmart in alto a destra
3. Appare una finestra di conferma con il numero di slot da pubblicare
4. Clicca Conferma
5. Il sistema mostra: "Orario pubblicato: N slot caricati"
6. La pagina si ricarica con il contatore aggiornato

Operazioni nel database

• DELETE FROM orario WHERE scuola_id = ? — elimina l'orario attuale
• INSERT INTO orario — N inserimenti (docente_id, giorno, ora, classe_id, tipo)
• COMMIT — operazione atomica: se qualcosa va storto, tutto viene annullato

§ 10 Vincoli e limitazioni dell'algoritmo

Vincoli rigidi (sempre rispettati)

Limitazioni note

• L'algoritmo è probabilistico: genera risultati diversi a ogni esecuzione. Se il primo risultato non è ottimale, rigenerare può migliorarlo.
• Le ore doppie (blocchi da 2h consecutive) non sono ancora gestite dall'algoritmo — vanno aggiunte manualmente nella Tab Vista dopo la generazione.
• L'algoritmo non considera le aule speciali (palestra, laboratori). La gestione degli spazi è prevista in un futuro modulo SpaziSmart.

§ 11 Domande frequenti

Ho già importato l'orario da Argo. Posso usare OrarioSmart in parallelo?

Sì, ma non in contemporanea. Ogni volta che pubblichi da OrarioSmart o importi un CSV, l'orario precedente viene sovrascritto. Scegli un metodo e usalo in modo coerente per tutto l'anno.

Ho pubblicato ma l'algoritmo non propone candidati. Perché?

Verifica che: (1) i docenti nell'orario siano gli stessi in EduSubSmart, (2) le classi abbiano lo stesso nome, (3) i giorni nell'orario corrispondano al giorno reale (es. "lunedi" non "Lunedì"). Controlla il contatore slot nella dashboard: se è 0, la pubblicazione non è riuscita.

Cosa significa "Ora P" (Disposizione)?

Un docente ha un'ora "P" quando quella fascia è dedicata alle supplenze — è a scuola ma non ha lezione. L'algoritmo EduSubSmart propone questi docenti come candidati prioritari (Score 90). Per impostare un'ora P: clicca la cella, seleziona il Docente, lascia la Classe vuota e salva.

Posso modificare l'orario nel corso dell'anno senza ricaricare tutto?

Sì. Apri OrarioSmart → Tab Vista → clicca la cella → salva → Pubblica. Per modifiche puntuali puoi anche usare Orario → Modifica Slot di EduSubSmart che modifica un singolo slot senza toccare il resto.

Gli insegnamenti salvati restano anche l'anno prossimo?

Sì, gli insegnamenti persistono nel database fino a quando non vengono eliminati manualmente. A inizio anno scolastico, eliminali e inserisci quelli nuovi. L'orario pubblicato viene azzerato con la procedura Cambio Anno di EduSubSmart.