Passa al contenuto principale

Argomenti e varianti normative

🔗 Apri nel BackOffice​

🎯 Cosa fa​

Gestisce la macchina normativa della formazione: i topic formativi (categorie di contenuto imposte da legge, es. "Formazione base lavoratori"), le varianti (versioni di uno stesso topic che cambiano nel tempo per aggiornamenti normativi), gli argomenti (il contenuto concreto erogato in un corso), e le dipendenze fra topic (propedeuticità).

È il cuore che determina cosa deve essere insegnato, per quante ore, per quanto vale l'attestato.

🧩 Concetti chiave​

OggettoCosa rappresenta
Topic formativoContenuto normativo (es. "Formazione lavoratori rischio basso", "Antincendio medio rischio"). Identificato da codice, categoria, rischio.
VarianteVersione specifica di un topic con ore minime, validità, CCNL applicabile. Un topic ha nel tempo più varianti (aggiornamenti normativi).
ArgomentoUnità di contenuto concreto che viene inserita in un appuntamento (es. "Uso dei DPI", "Procedura emergenza"). Associato a un rischio.
Dipendenza topicVincolo di propedeuticità: per il topic X serve aver completato Y entro N mesi prima.
Sovrapposizione variantiFlag che indica che una variante X copre/sostituisce un'altra variante Y (utile quando il lavoratore ha già formazione equivalente).
Check argomentoVoci di verifica associate a un argomento formativo (checklist di copertura).

🕒 Quando usarlo​

  • Aggiungere un nuovo topic formativo normativo.
  • Registrare una nuova variante di un topic (es. dopo pubblicazione di un nuovo decreto).
  • Aggiornare le ore minime o la validità di una variante.
  • Definire dipendenze di propedeuticità tra topic.
  • Mappare varianti equivalenti (sovrapposizioni).
  • Creare argomenti di contenuto concreto riutilizzabili.

👣 Passi principali​

Creare un topic formativo​

  1. Menu Formazione → Topic formativi.
  2. Crea nuovo topic con codice, nome, categoria, rischio associato.
  3. Flag requireUpdates se richiede aggiornamenti periodici.
  4. regulated = sì (default) se è topic normativo.
  5. fullRetrainingYears = periodicità aggiornamento completo.
  6. Descrizione (opzionale): testo libero esteso che descrive il topic. È la descrizione "principale" ereditata dalle varianti che non ne specificano una propria.

Creare una variante​

  1. Menu Formazione → Varianti formative.
  2. Compila: codice, topic di riferimento, livello di rischio, ore minime, durata validità (giorni/anni), eventuale CCNL applicabile, flag isUpdate (aggiornamento vs formazione iniziale).
  3. Descrizione (opzionale): testo libero specifico della variante. Da compilare solo se serve sovrascrivere la descrizione del topic principale (es. la variante ha specificità normative o di contenuto da evidenziare). Se vuota, vale la descrizione del topic.

Definire dipendenze​

  1. Menu Formazione → Dipendenze topic.
  2. Inserisci topic origine, topic prerequisito, mesi entro cui il prerequisito deve essere stato completato.

Sovrapposizioni varianti​

  1. Menu Formazione → Sovrapposizioni varianti.
  2. Registra che una variante "vale anche per" un'altra (utile per non richiedere nuova formazione a chi ha equivalente già fatto).

Creare argomenti e check​

  1. Menu Formazione → Argomenti.
  2. Crea argomento con nome, descrizione, rischio associato.
  3. Menu Formazione → Check argomenti per aggiungere voci di verifica associate.

⚡ Casi particolari​

  • Topic vs variante. Il topic è la "categoria normativa" stabile (es. "Formazione base lavoratori"). La variante cambia nel tempo (2015 → 2026) con nuove regole orarie o di validità.
  • Variante di aggiornamento vs iniziale. Flag isUpdate: le varianti di aggiornamento hanno ore minime ridotte.
  • Sovrapposizione — caso tipico. Un corso "Primo soccorso in azienda gruppo A" copre anche "Primo soccorso in azienda gruppo B": registra la sovrapposizione per non richiedere doppio corso.
  • ATS (Accordo Stato-Regioni). Flag ats sul topic indica se è topic disciplinato da Accordo Stato-Regioni specifico.

⚠️ Domande aperte​

  • Import topic predefiniti. Esiste un seed dataset dei topic normativi italiani (Formazione base, Preposti, Dirigenti, ...) o l'utente deve crearli a mano?
  • Validazione obbligatoria topic normativi. Per topic regulated = true, le ore minime e la validità sono obbligatorie? Oggi nullable.
  • Gestione cambio variante normativa. Quando esce una nuova variante, come si "aggiorna" silenziosamente il catalogo e si preserva la storia di chi ha fatto la vecchia?
  • Check argomenti come checklist compilata. I check sono template o vengono compilati appuntamento per appuntamento? Da verificare.

🔗 Vedi anche​