Sessioni e appuntamenti

🔗 Apri nel BackOffice

• Sessioni formative
• Appuntamenti
• Calendario appuntamenti
• Argomenti per corso erogato
• Vista dati appuntamenti
• Partecipanti appuntamento

🎯 Cosa fa

Organizza l'erogazione concreta della formazione nel tempo:

• Sessione formativa — la giornata fisica (o più giornate consecutive) durante cui si svolge l'attività. Una sessione può erogare uno o più corsi in co-erogazione (es. antincendio R.B./R.M./R.A. nello stesso giorno, con orari diversi).
• Appuntamento — la finestra oraria fisica all'interno della sessione, con sede ed eventuale link remoto.
• Luogo / Aula — lo spazio dove si tiene l'appuntamento.

🕒 Quando usarlo

• Pianificare una giornata formativa per un gruppo di partecipanti.
• Calendarizzare gli appuntamenti che compongono la sessione.
• Assegnare l'aula a ogni appuntamento (può differire dall'aula default della sessione).
• Cambiare stato di una sessione (pianificata → aperta → in corso → completata).
• Cancellare o rinviare una sessione.

🧩 Relazione Sessione ↔ Corsi ↔ Appuntamenti

Una sessione è la giornata fisica. Al suo interno possono essere erogati più corsi (M:N) e si svolgono uno o più appuntamenti (finestre orarie con aula). Esempio di giornata multi-corso in co-erogazione:

Sessione "15/03/2026 — Antincendio" (sede principale)
├── Corsi erogati
│   ├── Antincendio R.B. — orario 09:00-11:00
│   ├── Antincendio R.M. — orario 09:00-14:00
│   └── Antincendio R.A. — orario 09:00-17:00
└── Appuntamenti fisici (finestre orarie)
    ├── 15/03/2026 09:00-11:00 — Aula A (R.B. esce)
    ├── 15/03/2026 11:00-14:00 — Aula A (R.M. esce)
    └── 15/03/2026 14:00-17:00 — Aula A (R.A. completa)

Per la pianificazione end-to-end (sessione + corsi + iscritti

• docenti + costi) usa il wizard di pianificazione, che è il flusso consigliato. Le pagine standalone descritte qui sotto servono per edit puntuali o letture rapide.

👣 Passi

Creare una sessione (flusso consigliato: wizard)

1. Apri il wizard di pianificazione da uno dei punti d'ingresso (lista corsi, lista sessioni, coda richieste, scadenziario, calendario).
2. Il wizard crea sessione + corsi erogati + appuntamenti + iscrizioni + assegnazione docenti in un'unica sequenza.

Creare una sessione "minimale" (senza wizard)

1. Apri Formazione → Sessioni formative.
2. Crea nuova sessione.
3. Compila:
   • Data/ora inizio (obbligatoria).
   • Data/ora fine (opzionale).
   • Aula default (opzionale, ereditata dagli appuntamenti se non hanno override).
   • Capienza pratica (limite della giornata; il limite normativo per corso vive su courses.maxPeople).
   • Argomento (opzionale; se valorizzato, i corsi della sessione devono appartenere a quell'argomento).
   • Stato (default: pianificata).
   • Gruppo destinatari notifiche (opzionale).
   • Note (libere).
4. Salva. La sessione resta in stato bozza/pianificata finché non aggiungi corsi e appuntamenti.

Creare appuntamenti

Due punti d'ingresso tipici:

• Dal calendario — apri il Calendario appuntamenti e clicca su uno slot libero: si apre il popup di nuovo appuntamento con data/ora pre-compilate dallo slot.
• Dal dettaglio sessione — apri la sessione e usa la tab "Appuntamenti" per aggiungere/modificare.

Campi del popup:

• Sessione di appartenenza (obbligatoria).
• Data/ora inizio e fine (obbligatorie).
• Aula (opzionale; override dell'aula default della sessione).
• Link (per partecipazione remota).
• Note (libere).

Salvando l'appuntamento, il sistema controlla automaticamente eventuali conflitti (docente sovrapposto, sede occupata, iscritti oltre capienza, ecc.) e mostra un avviso a video. I conflitti sono informativi, non bloccano.

Creare un luogo (aula)

1. Apri Formazione → Aule.
2. Crea nuova aula.
3. Compila:
   • Codice (identificativo breve).
   • Nome esteso.
   • Sede TrainingHub di appartenenza.
   • Capienza (numero massimo di persone).
   • Digitale — flag per aule virtuali.
   • Istruzioni (libere, es. "Ingresso lato parcheggio, 2° piano").
4. Salva.

Costo aula (opzionale)

Le aule esterne con costo di affitto si configurano valorizzando due campi:

• Tariffa unitaria — importo in euro.
• Modalità tariffa — Giornaliera (l'importo si applica per ogni giornata distinta in cui c'è un appuntamento) o Oraria (l'importo si moltiplica per le ore complessive degli appuntamenti).

Per aule interne o aule virtuali, lascia entrambi i campi vuoti: il sistema le considererà gratuite.

I due campi vanno coerenti: o entrambi vuoti, o entrambi valorizzati.

Cambiare stato sessione

Apri la sessione in modifica e seleziona il nuovo stato:

• Pianificata — sessione creata ma non ancora aperta a iscrizioni.
• Aperta — iscrizioni accettate.
• In corso — sessione ha iniziato gli appuntamenti.
• Completata — tutti gli appuntamenti erogati.
• Cancellata — sessione annullata.

📅 Calendario appuntamenti

Il Calendario appuntamenti è la vista temporale principale degli appuntamenti formativi.

Viste e navigazione:

• Tre modalità: Mese / Settimana / Giorno.
• Pulsanti precedente / Oggi / successivo per scorrere il periodo.
• Click su una cella giorno (in vista Mese) per scendere alla vista giornaliera.

Filtri (in alto):

• Corso — restringe agli appuntamenti delle sessioni che erogano quel corso.
• Sede — limita a una specifica aula.
• Docente — mostra solo gli appuntamenti del docente selezionato.
• Sessione — focalizza su una singola sessione.

Colori e legenda:

• Ogni appuntamento è colorato in base al primo argomento della sessione (per ordine alfabetico). Il colore è quello configurato in Argomenti formativi → Colore.
• Gli argomenti senza colore ricadono su una tinta neutra grigia.
• La legenda in alto mostra i colori usati + i puntini di stato (Pianificato / Aperto / In Corso / Completato).

Azioni dirette:

• Click su slot libero → apre il popup nuovo appuntamento con data/ora pre-compilate.
• Click su un appuntamento → si apre il pannello dettaglio a lato con: dati appuntamento, contesto sessione, azioni Modifica appuntamento / Duplica appuntamento / Modifica sessione.
• "Nuova sessione" (in alto a destra) → apre il wizard di pianificazione. Se è attivo il filtro corso, il wizard parte con quel corso pre-selezionato.

Conflitti: dopo aver salvato un appuntamento il sistema controlla la sessione e mostra a toast eventuali conflitti rilevati (docente sovrapposto, sede occupata, iscritti oltre capienza). Gli avvisi non bloccano: tocca a te valutarli.

🗂️ Campi chiave

Sessione formativa

Campo	Obbligatorio	Note
Data/ora inizio	Sì
Data/ora fine	No	Vuota = single-block.
Aula default	No	Ereditata dagli appuntamenti senza override.
Capienza pratica	No	Limite della giornata; limite normativo per corso vive su courses.maxPeople.
Argomento	No	Se valorizzato, vincola i corsi della sessione.
Stato	Sì	Default: pianificata.
Gruppo destinatari notifiche	No	Per notifiche operatore.
Note	No	Testo libero.

I corsi erogati dalla sessione vivono nella M:N trainingSessionsCourses (visibile come tab nel dettaglio sessione o gestita dal wizard).

Appuntamento

Campo	Obbligatorio	Note
Sessione	Sì	FK obbligatoria.
Data/ora inizio	Sì
Data/ora fine	Sì
Aula	No	Override dell'aula default della sessione.
Link	No	Per partecipazione remota.
Note	No	Testo libero.

I docenti dell'appuntamento sono gestiti su appointmentsTeachers (tab nel dettaglio appuntamento o assegnazione dal wizard).

Aula / Luogo

Campo	Obbligatorio	Note
Codice	Sì	Identificativo breve.
Nome	Sì	Testo libero.
Sede TrainingHub	Sì	Appartenenza.
Capienza	No	Numero persone.
Digitale	No	Flag: aula virtuale.
Istruzioni	No	Accesso, parcheggio, ecc.
Attiva	No	Default: sì.

⚡ Casi particolari

• Sessione vs appuntamento — chi viene prima? La sessione viene prima: l'appuntamento ha la sessione come FK obbligatoria.
• Co-erogazione multi-corso. Una sessione può ospitare più corsi con orari diversi (es. R.B. 9-11, R.M. 9-14). Gli appuntamenti sono comuni; il dettaglio orario per-corso vive su trainingSessionsCourses.
• Appuntamento remoto. Aula non obbligatoria se c'è un link. Per appuntamenti misti (alcuni in presenza, alcuni remoti), ogni appuntamento è autonomo.
• Cancellare una sessione. Imposta lo stato a Cancellata. Gli appuntamenti e le iscrizioni collegate restano in archivio.
• Riprogrammare un appuntamento. Modifica data/ora dell'appuntamento esistente, non crearne uno nuovo (si perderebbero i collegamenti).
• Capienza aula vs capienza sessione. Se l'aula ha 20 posti ma la sessione prevede 25 partecipanti, il sistema non impedisce la creazione ma è un segnale di errore di configurazione.
• Conflitti rilevati ma non bloccanti. Docente sovrapposto, sede occupata, iscritti oltre capienza, soglia docente, lavoratore in più sessioni: vengono mostrati come toast warning ma non bloccano il salvataggio.

🔗 Vedi anche

• Panoramica formazione
• Pianificazione sessione — wizard end-to-end (sessione + corsi + iscritti + docenti + costi).
• Catalogo corsi
• Insegnanti — assegnazione docenti agli appuntamenti.
• Argomenti formativi — colore usato dal calendario.
• Glossario
• Emissione fattura — gli appuntamenti completati diventano righe di fattura.