🔬 Cross-Reference: Parametri Eurario & Vincoli XML FET¶

Il motore solutore di Eurario è alimentato dal binario ufficiale ad alte prestazioni FET (Free Timetabling Software).

Questa pagina documenta la corrispondenza biunivoca e analitica tra ogni singolo parametro configurabile nell'interfaccia didattica di Eurario e la relativa struttura XML compilata per il motore FET (Manuale Ufficiale FET).

1. Mappatura Entità Fondamentali¶

2. Vincoli Temporali Docenti (Time_Constraints_List)¶

A. Giorno Libero Contrattuale & Indisponibilità Orarie¶

• Interfaccia Eurario: Scheda Disponibilità Docente → Matrice settimanale cliccabile (giorni x ore).
• Tag XML FET: <ConstraintTeacherNotAvailableTimes>
• Codice XML Generato:

  <ConstraintTeacherNotAvailableTimes>
    <Weight_Percentage>100</Weight_Percentage>
    <Teacher_Name>Rossi Mario</Teacher_Name>
    <Number_of_Not_Available_Times>6</Number_of_Not_Available_Times>
    <Not_Available_Time>
      <Day>Sab</Day>
      <Hour>1</Hour>
    </Not_Available_Time>
    <!-- ... ore da 1 a 6 per il sabato libero -->
  </ConstraintTeacherNotAvailableTimes>
  

• Impatto Risolutivo: Vincolo rigido (Hard Constraint 100%). FET esclude tassativamente la collocazione di attività didattiche in quegli slot.

B. Giorni Massimi e Minimi di Servizio a Settimana¶

• Interfaccia Eurario: Modale Docente → Giorni di presenza settimanali (min_days e max_days).
• Tag XML FET:
• <ConstraintTeacherMaxDaysPerWeek>
• <ConstraintTeacherMinDaysPerWeek>
• Codice XML Generato:

  <ConstraintTeacherMaxDaysPerWeek>
    <Weight_Percentage>100</Weight_Percentage>
    <Teacher_Name>Bianchi Laura</Teacher_Name>
    <Max_Days_Per_Week>4</Max_Days_Per_Week>
  </ConstraintTeacherMaxDaysPerWeek>
  <ConstraintTeacherMinDaysPerWeek>
    <Weight_Percentage>100</Weight_Percentage>
    <Teacher_Name>Bianchi Laura</Teacher_Name>
    <Min_Days_Per_Week>3</Min_Days_Per_Week>
  </ConstraintTeacherMinDaysPerWeek>
  

• Utilizzo Pratico: Indispensabile per part-time verticali (es. docente presente solo su 3 o 4 giorni specifici) ed eliminazione di giorni frammentati.

C. Finestre Libere (Ore Buche Giornaliere e Settimanali)¶

• Interfaccia Eurario: Impostazioni Istituto → Max buchi al giorno (default 1) e Max buchi alla settimana (default 2-3).
• Tag XML FET:
• <ConstraintTeacherMaxGapsPerDay> (Peso 95-100%)
• <ConstraintTeacherMaxGapsPerWeek> (Peso 95-100%)
• Codice XML Generato:

  <ConstraintTeacherMaxGapsPerDay>
    <Weight_Percentage>98</Weight_Percentage>
    <Teacher_Name>Verdi Giuseppe</Teacher_Name>
    <Max_Gaps>1</Max_Gaps>
  </ConstraintTeacherMaxGapsPerDay>
  <ConstraintTeacherMaxGapsPerWeek>
    <Weight_Percentage>95</Weight_Percentage>
    <Teacher_Name>Verdi Giuseppe</Teacher_Name>
    <Max_Gaps>2</Max_Gaps>
  </ConstraintTeacherMaxGapsPerWeek>
  

D. Massimo e Minimo Ore Giornaliere di Lezione¶

• Interfaccia Eurario: Impostazioni Orario → Ore massime di lezione al giorno e Minimo ore nei giorni di presenza.
• Tag XML FET:
• <ConstraintTeacherMaxHoursDaily>: Limita il carico didattico a 4 o 5 ore al giorno.
• <ConstraintTeacherMinHoursDaily>: Impone un minimo di 2 ore nei giorni lavorativi per evitare uscite antieconomiche per 1 sola ora di lezione.
• <ConstraintTeacherMaxSpanPerDay>: Limita la permanenza complessiva del docente a scuola (dalla prima all'ultima ora).

3. Vincoli Temporali Studenti & Classi¶

A. Compattezza Orario Studenti (Zero Ore Buche)¶

• Interfaccia Eurario: Attivo di default per tutte le classi.
• Tag XML FET:
• <ConstraintStudentsMaxGapsPerDay>: <Max_Gaps>0</Max_Gaps> (Peso 100%)
• <ConstraintStudentsMaxGapsPerWeek>: <Max_Gaps>0</Max_Gaps> (Peso 100%)
• Effetto Risolutivo: Garantisce che nessuna classe abbia ore buche non presidiate tra una lezione e l'altra.

B. Ingressi Posticipati alla Seconda Ora¶

• Interfaccia Eurario: Impostazioni Istituto → Massimo ingressi alla seconda ora a settimana.
• Tag XML FET: <ConstraintStudentsEarlyMaxBeginningsAtSecondHour>
• Codice XML Generato:

  <ConstraintStudentsEarlyMaxBeginningsAtSecondHour>
    <Weight_Percentage>100</Weight_Percentage>
    <Max_Beginnings_At_Second_Hour>0</Max_Beginnings_At_Second_Hour>
  </ConstraintStudentsEarlyMaxBeginningsAtSecondHour>
  

• Effetto Risolutivo: Se impostato a 0, impone che per tutte le classi le lezioni inizino sempre rigorosamente alla prima ora della mattina.

C. Pause Didattiche e Intervallo di Istituto¶

• Interfaccia Eurario: Impostazioni Orario → Intervallo Ricreazione.
• Tag XML FET: <ConstraintBreakTimes>
• Effetto Risolutivo: Blocca la collocazione di lezioni durante le pause deliberate dal collegio docenti.

4. Vincoli sulle Discipline & Suddivisione Cattedre¶

A. Distanziamento tra le Lezioni della Stessa Materia¶

• Interfaccia Eurario: Calcolato automaticamente per ciascuna cattedra suddivisa in blocchi (es. 2+1+1).
• Tag XML FET: <ConstraintMinDaysBetweenActivities>
• Codice XML Generato:

  <ConstraintMinDaysBetweenActivities>
    <Weight_Percentage>98</Weight_Percentage>
    <Consecutive_If_Same_Day>true</Consecutive_If_Same_Day>
    <Number_of_Activities>3</Number_of_Activities>
    <Activity_Id>101</Activity_Id>
    <Activity_Id>102</Activity_Id>
    <Activity_Id>103</Activity_Id>
    <MinDays>1</MinDays>
  </ConstraintMinDaysBetweenActivities>
  

• Effetto Risolutivo: Impone che le singole lezioni si tengano in giorni diversi della settimana e che, qualora eccezionalmente assegnate nello stesso giorno, debbano essere obbligatoriamente consecutive (Consecutive_If_Same_Day=true).

B. Fascia Oraria Preferita (Prime Ore / Ultime Ore)¶

• Interfaccia Eurario: Modale Materia → Fascia Oraria Preferita (PRIME, ULTIME, INDIFFERENTE).
• Tag XML FET: <ConstraintActivitiesPreferredTimeSlots>
• Configurazione:
• PRIME: Assegna un peso di preferenza per le ore 1, 2 e 3 (ottimale per Matematica, Latino o compiti scritti).
• ULTIME: Assegna un peso di preferenza per le ore 4, 5 e pomeridiane (ottimale per Scienze Motorie o Laboratori Artistici).

C. Esclusione Rientri Pomeridiani (no_rientri)¶

• Interfaccia Eurario: Modale Materia → Escludi dai Rientri Pomeridiani.
• Tag XML FET: <ConstraintActivitiesPreferredTimeSlots> impostato con divieto assoluto sugli slot pomeridiani (7ª e 8ª ora).

D. Attività Bloccate Manualmente dalla Commissione¶

• Interfaccia Eurario: Icona Lucchetto sulla griglia orario.
• Tag XML FET: <ConstraintActivityPreferredStartingTime> (Hard 100%). Fissa in modo inamovibile giorno e ora di inizio dell'attività.

E. Attività a Termine Giornata (Cattedre Quindicinali / Asimmetriche)¶

• Interfaccia Eurario: Impostazioni Cattedra → Colloca a Fine Giornata.
• Tag XML FET: <ConstraintActivityEndsStudentsDay>
• Codice XML Generato:

  <ConstraintActivityEndsStudentsDay>
    <Weight_Percentage>100</Weight_Percentage>
    <Activity_Id>412</Activity_Id>
    <Active>true</Active>
  </ConstraintActivityEndsStudentsDay>
  

• Utilizzo pratico FET: Raccomandato dal manuale FET per le lezioni che si svolgono una volta ogni due settimane (es. laboratori a settimane alterne), garantendo che l'assenza a settimane alterne si traduca in un'uscita anticipata senza generare ore buche per gli studenti.

F. Consecutività Didattica (Teoria + Laboratorio ITP)¶

• Interfaccia Eurario: Modale Cattedra → Lega in Consecutività Diretta.
• Tag XML FET: <ConstraintTwoActivitiesConsecutive>
• Codice XML Generato:

  <ConstraintTwoActivitiesConsecutive>
    <Weight_Percentage>100</Weight_Percentage>
    <First_Activity_Id>101</First_Activity_Id>
    <Second_Activity_Id>102</Second_Activity_Id>
    <Active>true</Active>
  </ConstraintTwoActivitiesConsecutive>
  

• Utilizzo pratico FET: Impone che la seconda attività (es. laboratorio) sia collocata nello stesso giorno tassativamente nell'ora immediatamente successiva alla prima (teoria), senza buchi intermedi (salvo intervallo).

G. Raggruppamento nello Stesso Giorno (Ordine Flessibile)¶

• Interfaccia Eurario: Modale Cattedra → Raggruppa nello Stesso Giorno.
• Tag XML FET: <ConstraintTwoActivitiesGrouped>
• Utilizzo pratico FET: Le attività sono collocate nello stesso giorno senza buchi intermedi, ma senza vincolare quale debba essere svolta per prima, riducendo drasticamente i tempi di calcolo per il solutore.

H. Propedeuticità Temporale nella Settimana¶

• Interfaccia Eurario: Modale Cattedra → Propedeuticità Settimanale (A prima di B).
• Tag XML FET: <ConstraintTwoActivitiesOrdered>
• Utilizzo pratico FET: Garantisce che l'attività teorica sia programmata nei primi giorni della settimana (es. Lun/Mar) prima dell'attività di verifica o esercitazione (es. Gio/Ven).

I. Sincronizzazione Oraria per Opzioni, Articolazioni & Pseudo-Attività¶

• Interfaccia Eurario: Modale Articolazione → Sincronizza Orario di Inizio.
• Tag XML FET: <ConstraintActivitySameStartingTime>
• Codice XML Generato:

  <ConstraintActivitySameStartingTime>
    <Weight_Percentage>100</Weight_Percentage>
    <First_Activity_Id>201</First_Activity_Id>
    <Second_Activity_Id>202</Second_Activity_Id>
    <Active>true</Active>
  </ConstraintActivitySameStartingTime>
  

• Utilizzo pratico FET: Utilizzato sia per sdoppiamenti paralleli (es. Francese e Spagnolo nella stessa classe) sia per sincronizzare le riunioni collegiali di dipartimento tra docenti senza studenti (pseudo-attività).

J. Riposo Notturno Minimo (Diurno & Serale)¶

• Interfaccia Eurario: Scheda Docente → Intervallo Minimo di Riposo Notturno.
• Tag XML FET: <ConstraintTeacherMinRestingHours>
• Codice XML Generato:

  <ConstraintTeacherMinRestingHours>
    <Weight_Percentage>100</Weight_Percentage>
    <Teacher_Name>Romani Elena</Teacher_Name>
    <Min_Resting_Hours>11</Min_Resting_Hours>
  </ConstraintTeacherMinRestingHours>
  

• Utilizzo pratico FET: Impedisce che un docente con incarico serale (termine alle 22:00) possa essere assegnato alla prima o seconda ora del mattino seguente (\(08:00 - 10:00\)).

K. Tetto di Contemporaneità su Risorse Condivise¶

• Interfaccia Eurario: Vincoli Risorse → Massimo Attività Simultanee per Tag.
• Tag XML FET: <ConstraintActivitiesMaxSimultaneousInSelectedTimeSlots>
• Utilizzo pratico FET: Impedisce a un set di attività etichettate con lo stesso tag (es. PALESTRA_A o USCITA_ESTERNA) di superare una soglia massima istantanea (es. max 2 o 3 classi contemporaneamente).

5. Vincoli Spaziali & Gestione Multi-Plesso (Space_Constraints_List)¶

A. Aula Base della Classe (Home Room)¶

• Interfaccia Eurario: Modale Classe → Aula Base.
• Tag XML FET: <ConstraintStudentsSetHomeRoom>
• Codice XML Generato:

  <ConstraintStudentsSetHomeRoom>
    <Weight_Percentage>100</Weight_Percentage>
    <Students>3A</Students>
    <Room>Aula 204</Room>
  </ConstraintStudentsSetHomeRoom>
  

B. Laboratori & Palestre Condivise¶

• Interfaccia Eurario: Assegnazione Cattedra → Laboratorio / Palestra.
• Tag XML FET: <ConstraintActivityPreferredRooms>
• Codice XML Generato:

  <ConstraintActivityPreferredRooms>
    <Weight_Percentage>100</Weight_Percentage>
    <Activity_Id>205</Activity_Id>
    <Number_of_Preferred_Rooms>1</Number_of_Preferred_Rooms>
    <Preferred_Room>Lab_Informatica_1</Preferred_Room>
  </ConstraintActivityPreferredRooms>
  

C. Spostamento Docenti tra Sedi (Centrale & Succursale)¶

• Interfaccia Eurario: Impostazioni Plessi & Sedi d'Istituto.
• Tag XML FET:
• <ConstraintTeachersMaxBuildingChangesPerDay>: Limita i cambi plesso nello stesso giorno a un massimo prefissato (tipicamente max 1).
• <ConstraintTeachersMaxBuildingChangesPerWeek>: Limita i cambi plesso nell'arco dell'intera settimana (tipicamente max 2 o 3).
• <ConstraintTeachersMinGapsBetweenBuildingChanges>: Impone un intervallo orario vuoto minimo (es. 1 ora di buco obbligatoria per il tempo di percorrenza stradale) prima che il docente possa iniziare la lezione nel nuovo plesso.

D. Stabilità d'Aula per Ore Consecutive¶

• Interfaccia Eurario: Impostazioni Aule → Stessa Aula se Ore Consecutive.
• Tag XML FET: <ConstraintActivitiesSameRoomIfConsecutive>
• Codice XML Generato:

  <ConstraintActivitiesSameRoomIfConsecutive>
    <Weight_Percentage>100</Weight_Percentage>
    <Active>true</Active>
  </ConstraintActivitiesSameRoomIfConsecutive>
  

• Utilizzo pratico FET: Garantisce che se due attività successive hanno gli stessi studenti o lo stesso docente, restino fisicamente nella medesima aula senza costringere a spostamenti intermedi.

E. Riduzione del Nomadismo delle Classi (Tetto Massimo Aule al Giorno)¶

• Interfaccia Eurario: Impostazioni Classi → Massimo Aule Diverse al Giorno.
• Tag XML FET: <ConstraintStudentsSetMaxDifferentRoomsPerDay>
• Codice XML Generato:

  <ConstraintStudentsSetMaxDifferentRoomsPerDay>
    <Weight_Percentage>95</Weight_Percentage>
    <Students>1A</Students>
    <Max_Different_Rooms>2</Max_Different_Rooms>
  </ConstraintStudentsSetMaxDifferentRoomsPerDay>
  

• Utilizzo pratico FET: Impedisce che una classe cambi più di 2 aule nell'arco della mattinata (l'aula base e al più una rotazione verso palestra o laboratorio).

6. Visualizzazione Risultati: FET Nativo vs Eurario¶

Figura 4.1: Interfaccia desktop ufficiale di FET, con i menu per la gestione di vincoli temporali, vincoli spaziali e risoluzione orario.