Orario Facile
Guida per chi costruisce l'orario, lo pubblica e gestisce le sostituzioni dei docenti assenti. Serve il ruolo di modificatore: l'account Google della scuola non basta da solo.
In breve
Per chi è già abilitato e vuole solo i passaggi essenziali.
- 1Apri Orario Facile e accedi con l'account della scuola. Se vedi "Solo consultazione", copia il tuo codice e mandalo a chi gestisce le abilitazioni.
- 2Una volta abilitato, lavora sulle schede: Impostazioni → Discipline → Aule → Quadro orario → Docenti e cattedre → Criteri → Orario (genera e correggi a mano) → Salvataggio.
- 3Per pubblicare per tutti: scheda Salvataggio → Scarica orario.json → carica il file nella cartella
dati/del repository su GitHub → Commit changes. - 4Per le sostituzioni: scheda Sostituzioni → carica il foglio del conteggio ore (o collegalo da Drive) → segna il docente assente → assegna i sostituti proposti.
- 5Per registrare le sostituzioni sul Foglio Google condiviso serve essere nell'elenco Abilitazioni di quel foglio (email, non codice).
Ruoli: fruitori e modificatori
Tutti quelli della scuola possono consultare l'orario nell'app Luis@i (i "fruitori"). Solo i modificatori possono aprire Orario Facile per costruire l'orario e fare le sostituzioni.
- Chi apre Orario Facile per la prima volta accede con l'account Google della scuola (se è già entrato nell'app, non glielo richiede di nuovo).
- Se non è ancora un modificatore vede la schermata "Solo consultazione", con il link all'orario e un codice di 16 caratteri da copiare.
- Manda quel codice a chi gestisce le abilitazioni (uno del gruppo con accesso al repository).
- Chi gestisce aggiunge il codice all'elenco
editoriinapp/js/config.jse pubblica la modifica su GitHub. - Da quel momento, con lo stesso account, la persona entra direttamente in Orario Facile.
Il repository è pubblico, quindi non si possono scrivere le email dei colleghi nei file. Il codice si ricava dall'email con un calcolo a senso unico: non permette di risalire all'indirizzo, ma identifica sempre la stessa persona.
Finché editori è vuoto, chiunque della scuola può usare Orario Facile. La lista serve a restringere l'accesso solo quando il gruppo decide di farlo.
I due livelli di permesso da tenere distinti
Essere "modificatore" nell'app e poter pubblicare le modifiche per tutti sono due cose diverse:
| Permesso | Cosa permette | Chi lo concede |
|---|---|---|
| Modificatore (ruolo nell'app) | aprire Orario Facile, modificare l'orario nel proprio browser, fare sostituzioni | chi modifica editori in config.js |
| Collaboratore del repository GitHub | caricare (commit) i file su GitHub, cioè pubblicare per tutti l'orario aggiornato | chi amministra il repository su GitHub (Impostazioni → Collaborators) |
Un modificatore che non è anche collaboratore del repository può preparare l'orario e le sostituzioni, ma per farle vedere a tutti deve passare il file a chi ha accesso a GitHub (o farsi aggiungere come collaboratore).
Le schede di Orario Facile
Orario Facile è organizzato in 9 schede, da compilare in ordine la prima volta:
| Scheda | A cosa serve | |
|---|---|---|
| 1 | Impostazioni e classi | giorni di lezione, ore al mattino/pomeriggio, elenco classi |
| 2 | Discipline | sigla e colore di ogni materia, per le caselle dell'orario |
| 3 | Aule | elenco aule, quali sono condivisibili da più classi insieme (palestra, laboratorio) |
| 4 | Quadro orario settimanale | quante ore di ogni materia per ogni classe |
| 5 | Docenti e cattedre | materie, classi, ore e aule di ogni docente, eventuali indisponibilità; le ore di ogni docente comprendono anche quelle di compresenza (potenziamento, sostegno, Alternativa) del Foglio Compresenze |
| 6 | Criteri e vincoli | vincoli rigidi (mai violati) e preferenze (pesate) per la generazione automatica |
| 7 | Orario | genera una proposta, poi si corregge a mano: si trascina una lezione, si blocca con il lucchetto, si vede per classe/docente/aula |
| 8 | Salvataggio ed esportazione | pubblicare nell'app, backup completo, tabelle CSV, importazione da Excel |
| 9 | Sostituzioni docenti | gestire l'assenza di un docente e le proposte di sostituzione |
Costruire e correggere l'orario (scheda 7)
- Genera orario crea una proposta automatica; ✨ Ottimizza la migliora ulteriormente; si può scegliere la qualità (Veloce, Normale, Accurata).
- Per correggere a mano: trascina una lezione in un'altra casella per spostarla o scambiarla, oppure clicca una casella e poi la destinazione.
- Il lucchetto 🔒 protegge una casella dalle rigenerazioni: diventa un'assegnazione fissa, elencata più sotto e modificabile da lì.
- In alto si vedono i numeri: ore collocate, caselle vuote, ore non collocate, conflitti; sotto, l'elenco dettagliato di ogni problema (es. "blocchi obbligatori non rispettati").
- Controlla fattibilità verifica se l'orario è risolvibile prima di generare.
- Si può cambiare vista: Per classe, Per docente, Per aula, Quadro generale; da lì anche Stampa / PDF.
Pubblicare l'orario per tutti
Il lavoro si salva da solo nel browser mentre lo si fa. Per farlo vedere a tutti (telefoni dei docenti, monitor di classe, schermo all'ingresso):
- Scheda Salvataggio ed esportazione → pulsante Scarica orario.json.
- Apri la cartella
datidel repository su GitHub. - Trascina il file scaricato (sostituisce quello vecchio) e premi Commit changes.
- Dopo un paio di minuti tutti i dispositivi vedono il nuovo orario (l'app si aggiorna da sola ogni 5 minuti).
Sullo stesso computer, mentre lavori in Orario Facile, l'app Luis@i (aperta in un'altra scheda del browser) mostra già la tua bozza e si aggiorna da sola: pulsante 📱 Vedi nell'app in Orario Facile.
Nella stessa scheda ci sono anche: backup completo (.json, per spostare il lavoro su un altro computer), le tabelle CSV (orario classi, orario docenti, elenco cattedre) e l'importazione da modelli Excel (.csv/.xlsx) o da un orario .xlsm già esistente.
Vedere i nomi veri dei docenti
Nell'orario i docenti compaiono come codici (DOC01, DOC02…) perché il repository è pubblico. Il pulsante 👁 Nomi in alto collega ogni codice al nome vero, leggendolo da un Foglio Google riservato (serve il permesso su quel file, con l'account della scuola).
I nomi restano solo in memoria nel browser: non vanno mai salvati in file scaricati, backup, CSV o altri documenti che potrebbero finire nel repository pubblico su GitHub.
Sostituzioni docenti
È la scheda 10 di Orario Facile, per organizzare la sostituzione dei docenti assenti usando il foglio del conteggio ore (chi è a debito e chi è a credito).
Privacy: il foglio non va mai su GitHub
Il foglio del conteggio ore ha i nomi completi dei docenti. Due modi per usarlo, entrambi senza pubblicarlo:
- Foglio su Google Drive (consigliato): si legge da solo con 👁 Nomi o con ☁️ Carica dal Drive. Ogni sostituzione assegnata scrive +1 nella cella del sostituto, nella colonna della settimana giusta; annullandola toglie 1.
- Carica il foglio (.ods, .xlsx, .csv): viene letto solo nel browser di quel computer, non è inviato a nessuno.
Assenze, sostituzioni e foglio restano salvati solo sul dispositivo usato (si possono cancellare con l'apposito pulsante).
Chi può registrare le sostituzioni
C'è un Foglio Google dedicato alle sostituzioni, con due schede:
- Abilitazioni: nomi ed email di chi può registrare sostituzioni. In cima alla scheda, 🔐 Verifica la mia abilitazione controlla l'email di chi è entrato. Chi non è nell'elenco può solo consultare, non registrare assenze o assegnare sostituzioni. Per abilitare qualcuno si aggiunge una riga nel foglio.
- Sostituzioni: ogni sostituzione assegnata diventa una riga (data, ora, classe, docente assente, sostituto, chi l'ha inserita…), con i nomi veri, presi dal file riservato e mai scritti su GitHub o nel dispositivo.
Come si usa
- Carica il foglio del conteggio ore (.ods, .xlsx o .csv).
- Controlla gli abbinamenti: premi 👁 Nomi (serve il permesso sul file riservato); se un abbinamento manca o è dubbio, scegli dall'elenco a mano.
- Scegli il giorno e spunta le ore in cui il docente è assente.
- In "Ore da coprire", per ogni ora scoperta premi Assegna sul docente proposto. Per annullare una sostituzione: Annulla la sostituzione nella scheda, oppure ✕ Annulla sulla sostituzione nella tabella dell'app Luis@i (funziona anche se l'ha registrata un collega). Al sostituto si toglie 1 ora nel foglio del conteggio. Nel riquadro Assenze e sostituzioni di tutti premi 👥 Mostra le assenze e le sostituzioni di tutti: vedi anche quelle dei colleghi; con Annulla per tutti togli solo quella sostituzione, per tutti (il tasto rosso in fondo cancella solo i dati di questo computer). Per togliere un'assenza: Togli nell'elenco degli assenti, Togli per tutti nel riquadro, oppure ✕ Togli assenza nella tabella dell'app. Si annullano anche le sue sostituzioni (−1 a chi sostituiva), le ore di recupero tornano al docente nel foglio del conteggio e l'assenza sparisce per tutti.
- A fine settimana copia nel foglio le ore di "Da aggiungere nel foglio", poi premi "Segna come già riportate" e ricarica il foglio.
Si possono anche stampare le sostituzioni del giorno e scaricare il registro in CSV.
Come vengono proposti i docenti
Le sostituzioni si fanno sempre sull'orario ufficiale pubblicato, mai sulla bozza. Per ogni ora scoperta la scheda cerca i docenti non assenti e non già impegnati altrove: quelli liberi e quelli spostabili, già in classe con un altro docente (con il sostegno si sposta il docente di cattedra e il sostegno resta con la classe; con il potenziamento si sposta il compresente; l'Alternativa è l'ultima possibilità). Chi è spostato non prende +1 nel conteggio. L'ordine è:
- docenti della classe con un'ora buca;
- docenti della classe spostabili;
- altri docenti della classe liberi;
- altri docenti con un'ora buca;
- altri docenti spostabili;
- altri docenti liberi;
- docenti di Alternativa.
Nello stesso gruppo prima chi è a scuola quel giorno e ha più ore a debito. Sotto ogni nome c'è il motivo della proposta (per esempio «Priorità 2: stessa classe – coperto da sostegno…»). Il saldo usato è: totale del foglio + sostituzioni già fatte ma non ancora riportate. Se in classe c'è già un altro docente (compresenza), la scheda lo segnala. Tra le ore di assenza ci sono anche le ore di compresenza; negli altri giorni della settimana si spuntano le singole ore.
Lavorare in gruppo sul codice
Il gruppo lavora tutti insieme direttamente su main, quindi qualche accortezza evita i conflitti (vale per chi tocca anche il codice del sito, non solo l'orario):
- Prima di iniziare a modificare:
git pull --rebase. - Commit piccoli e frequenti, un argomento per commit.
- Per consegnare:
./sync.sh "cosa ho fatto"(fa commit, pull --rebase e push in un colpo solo). - Configurazione consigliata una volta sola:
git config pull.rebase trueegit config rebase.autoStash true.
Limiti e attenzioni
Orario Facile è fatto di file pubblici: il controllo "modificatore / solo consultazione" avviene nel browser di chi guarda, e separa bene i ruoli nell'uso normale — ma una persona molto esperta potrebbe aggirarlo sul proprio computer. Anche in quel caso, però, non potrebbe cambiare l'orario di tutti: le modifiche restano nel suo browser finché non vengono caricate su GitHub, e per farlo serve essere collaboratori del repository.
L'accesso Google impedisce di usare l'app a chi non è della scuola, ma dati/orario.json resta scaricabile da chi conosce l'indirizzo esatto: GitHub Pages pubblica tutto. Va bene per un orario scolastico (senza nomi reali); se in futuro servisse più riservatezza, i dati andrebbero serviti da un servizio con controllo d'accesso.
Domande frequenti
Ho aperto Orario Facile ma vedo "Solo consultazione"
Copia il codice mostrato in quella schermata e mandalo a chi gestisce le abilitazioni: verrà aggiunto all'elenco editori.
Ho pubblicato l'orario.json ma l'app non lo mostra
Aspetta qualche minuto: l'app lo ricontrolla ogni 5 minuti. Controlla anche di aver caricato il file nella cartella dati/ giusta e di aver premuto "Commit changes" su GitHub.
Non vedo i nomi veri dei docenti
Serve il permesso di lettura sul Foglio Google riservato dei nomi, con l'account della scuola: se il pulsante "👁 Nomi" non funziona, chiedi l'accesso a chi gestisce quel foglio.
Non riesco a registrare una sostituzione
Serve essere nell'elenco Abilitazioni del Foglio Google delle sostituzioni (per email, non per codice): controlla con "🔐 Verifica la mia abilitazione".