Schema DB edu

🎯 Cosa fa

Definisce il persistence layer della formazione: ~38 tabelle nel dominio edu. Questa pagina documenta in dettaglio le core del catalogo + erogazione + docenti, allineate al redesign edu-sessions-redesign del 2026-05-08 (co-erogazione multi-corso, drop lessons/lessonsCourses, rename courseSessions → trainingSessions).

🗺️ Tabelle core

Catalogo

Tabella	Ruolo
edu.categories	Tassonomia piatta dei corsi
edu.courses	Definizione corso (FK trainingVariants, organizers)

Le tabelle edu.lessons e edu.lessonsCourses sono state droppate dal redesign 2026-05-08. La struttura didattica vive ora su trainingVariants / trainingArguments (fuori scope di questa pagina) + trainingSessionsCoursesArguments per gli argomenti effettivamente trattati nella sessione.

Erogazione

Tabella	Ruolo
edu.trainingSessions	Sessione formativa: blocco fisico (giornata/giornate). FK opzionali locations (aula default), trainingTopics (vincola i corsi), core.recipientGroups (notifiche). Stati: planned/open/inProgress/completed/cancelled
edu.trainingSessionsCourses	M:N session ↔ corso (co-erogazione). Ogni riga è una "vista contrattuale" del corso erogato nella session, con finestra oraria opzionale per-corso (NULL = eredita dalla session)
edu.trainingSessionsCoursesArguments	Argomenti didattici trattati per ogni corso erogato (FK a trainingSessionsCourses). Rinomina di appointmentArguments. Etichetta libera + FK opzionale a trainingArguments di catalogo
edu.trainingSessionsTeachers	Docenti agganciati alla session (default ereditato dagli appointment se questi non hanno override)
edu.appointments	Occorrenza fisica (finestra oraria) all'interno di una session. FK trainingSessions NOT NULL, locations override opzionale
edu.locations	Aule (indirizzo inline; FK opzionale reg.companies come gestore)
edu.locationsTrainingVariants	M:N aula ↔ variant per filtrare aule abilitate alle prove pratiche (variant con requiresEquippedRoom = 1)

Docenti

Tabella	Ruolo
edu.teachers	Anagrafica docenti (label = computed firstName + ' ' + lastName)
edu.appointmentsTeachers	M:N appuntamento ↔ docente (override su default trainingSessionsTeachers, con hourlyAmount opzionale)
edu.teacherCosts	Costo orario per docente per organizzatore
edu.teacherSkills	Skill matrix docente ↔ variante normativa (trainingVariantId, score). Granularità a variant (non più a lesson, ridenominata dal redesign 2026-05-08)

🪟 Viste

Vista	Ruolo
edu.vw_appointmentsCalendar	Backing della vista calendario /appointments-calendar: appuntamenti arricchiti con info session, sede, docenti aggregati, primo trainingTopic (per il colore)
edu.vw_appointmentsData	Dati appuntamenti aggregati (totale ore, partecipanti, ecc.)
edu.vw_appointmentAttendees	Partecipanti per appuntamento
edu.vw_workerTrainingStatus	Stato formativo per coppia (lavoratore × formazione richiesta): status (ok/expiring/expired/missing), daysRemaining, ultima formazione erogata, fonte del requisito (ruolo/mansione/qualifica/attrezzatura/rischio/esenzione). Esposta come CRUD read-only WorkerTrainingStatus. Aggregata da job.vw_workerComplianceSummary
edu.vw_trainingSessionAppointmentsTeachers	Vista filtrata di appointmentsTeachers per trainingSessionId (usata negli step del session planner)
edu.vw_workerEffectiveRisks	Rischi effettivi del lavoratore (JOIN diretto su workersRisks)
edu.vw_workersData	Lavoratori arricchiti con dati di compliance
edu.vw_companyComplianceStatus	Stato compliance per azienda
edu.vw_trainingExpirations	Formazioni in scadenza
edu.vw_availableTrainingSessions	Sessioni disponibili (per iscrizione)

🔗 Relazioni

Referenze esterne:

• edu.courses.organizerSlug → reg.organizers(slug)
• edu.courses.trainingVariantId → edu.trainingVariants(id) (subsystem normative)
• edu.trainingSessions.responsibleGroupId → core.recipientGroups(id) (notifiche operatore)
• edu.trainingSessions.trainingTopicId → edu.trainingTopics(id)
• edu.locations.companyId → reg.companies(id) (opzionale, gestore aula)
• edu.teacherCosts.organizerSlug → reg.organizers(slug)

🗂️ Dettaglio tabelle

edu.courses

• PK: id
• FK: trainingVariantId → edu.trainingVariants(id), organizerSlug → reg.organizers(slug)
• Campi: code, label, description, active (default 1), elearning (default 0), inCatalog (default 1), maxPeople, extraInstructorThreshold
• Check: maxPeople > 0, extraInstructorThreshold > 0

edu.trainingSessions

Giornata (o giornate consecutive) di erogazione formativa, può ospitare uno o più corsi in co-erogazione.

• PK: id
• FK:
  • locationId → edu.locations(id) (opzionale, aula default)
  • responsibleGroupId → core.recipientGroups(id) (opzionale, gruppo destinatari notifiche operatore)
  • trainingTopicId → edu.trainingTopics(id) (opzionale; se valorizzato, vincola i corsi della sessione a quel topic)
• Campi: startDateTime (required, DATETIME), endDateTime (nullable: NULL = single-block), maxPeople (capienza pratica della giornata), status, notes (1024 char)
• Check:
  • endDateTime IS NULL OR endDateTime >= startDateTime
  • maxPeople > 0
  • status IN ('planned','open','inProgress','completed','cancelled')
• Indici: IX_trainingSessions_startDateTime, IX_trainingSessions_locationId (filtered), IX_trainingSessions_trainingTopicId (filtered), IX_trainingSessions_responsibleGroupId (filtered)

edu.trainingSessionsCourses

M:N session ↔ corso: ogni riga rappresenta un corso erogato dentro la session, con finestra oraria opzionale per-corso (per co-erogazione di livelli diversi nello stesso giorno).

• PK: id
• FK: trainingSessionId → edu.trainingSessions(id), courseId → edu.courses(id)
• Unique: (trainingSessionId, courseId) (un corso compare al più una volta per session)
• Campi: startDateTime, endDateTime (entrambi nullable: NULL = eredita dalla session). Vincolo CK_trainingSessionsCourses_window forza la coppia consistente.
• Indice: IX_trainingSessionsCourses_courseId

edu.trainingSessionsCoursesArguments

Argomenti didattici trattati per ciascun corso erogato (rinomina di appointmentArguments dal redesign 2026-05-08).

• PK: id
• FK: trainingSessionsCoursesId → edu.trainingSessionsCourses(id), trainingArgumentId → edu.trainingArguments(id) (opzionale, riferimento a catalogo)
• Campi: label (string libero), description

edu.trainingSessionsTeachers

Default docenti agganciati alla session: ereditato dagli appointment che non hanno override su appointmentsTeachers.

• PK composita: (trainingSessionId, teacherId)
• FK: a trainingSessions e teachers
• Indice: IX_trainingSessionsTeachers_teacherId

edu.appointments

Occorrenza fisica (finestra oraria) all'interno di una session.

• PK: id
• FK:
  • trainingSessionId → edu.trainingSessions(id) (NOT NULL dal redesign 2026-05-08)
  • locationId → edu.locations(id) (nullable, override dell'aula default della session)
• Campi: startDateTime, endDateTime (entrambi required), link (NVARCHAR MAX), notes (NVARCHAR MAX)
• Check: endDateTime > startDateTime
• Indici: IX_appointments_trainingSessionId, IX_appointments_locationId (filtered), IX_appointments_startDateTime

lessonId è stato droppato. L'appuntamento non riferisce più una lezione specifica: il "contenuto" è derivato dai trainingSessionsCourses della session e dai relativi trainingSessionsCoursesArguments.

edu.locations

Aule / spazi di erogazione. Entità autosufficiente: l'indirizzo è inline sull'aula stessa, non rimandato a una sede.

• PK: id
• FK: companyId → reg.companies(id) (opzionale: gestore aula esterno; NULL = aula 3SD)
• Campi anagrafici: shortName, label (required), description, instructions, active, digital, capacity
• Tariffa: unitCost, costMode ('hourly' | 'daily'), coppia consistente (entrambi NULL = aula gratuita) garantita da CK_locations_costPair
• Contatti / fatturazione: email, vatCode (P.IVA gestore), invoicingLabel
• Indirizzo geocoded: formattedAddress, country, province, city, zipCode, address, streetNumber, latitude, longitude

edu.locationsTrainingVariants

M:N aula ↔ variante normativa: utilizzata per filtrare le aule abilitate alle prove pratiche di una variante (requiresEquippedRoom = 1).

edu.teachers

• PK: id
• Campi: firstName, lastName, label (computed column: firstName || ' ' || lastName), active, notes

edu.appointmentsTeachers

• PK composita: (appointmentId, teacherId)
• FK: a appointments e teachers
• Campi: hourlyAmount (nullable: override sul costo standard da teacherCosts)
• Indice: IX_appointmentsTeachers_teacherId

edu.teacherCosts

• PK composita: (teacherId, organizerSlug)
• FK: teacherId → edu.teachers(id), organizerSlug → reg.organizers(slug)
• Campi: hourlyAmount (required)

edu.teacherSkills

Skill matrix docente ↔ variante normativa: abilitazione del formatore per quella variante (granularità a variant dal redesign 2026-05-08, non più a lesson).

• PK composita: (teacherId, trainingVariantId)
• FK: teacherId → edu.teachers(id), trainingVariantId → edu.trainingVariants(id)
• Campi: score (nullable), active (default 1)
• Indice: IX_teacherSkills_trainingVariantId (filtered su active = 1)

edu.trainingTopics

Argomento didattico di alto livello (es. "Antincendio", "Primo soccorso"). Usato come vincolo opzionale su trainingSessions e come fonte del colore mostrato nel calendario.

• PK: id
• FK: categoryId → edu.categories(id), riskId → job.risks(id) (opzionale)
• Campi: code, label, description, requireUpdates, regulated (default 1), fullRetrainingYears, ats (default 0), color (NVARCHAR(16), nullable; hex es. #e53935, usato dal calendario per il colore degli appuntamenti)
• Check: fullRetrainingYears > 0
• Indice: IX_trainingTopics_riskId (filtered)

edu.categories

• PK: id
• Campi: label

📚 Tabelle fuori scope

Worker training journey (5)

workersTrainings, workerTrainingDetails, trainingDetailAttempts, attendances, workerCompletionsCache — registrazione iscrizioni, presenze, esiti, materializzazione compliance.

Argomenti formativi (8)

trainingArguments, trainingTopics, trainingVariants, variantTopicMap, trainingTopicDependencies, trainingArgumentChecks, trainingVariantsOverlaps, appointmentChecks — macchina normativa degli argomenti formativi, varianti, sovrapposizioni.

Nomine (3)

nominations, workersNominations, nominationsTrainingTopics — incarichi di ruolo (es. RSPP, ASPP, preposto) con vincoli formativi.

Certificati & qualifiche (5)

certificates, enrollmentCosts, priorTrainings, qualificationsExemptions, qualificationsRequiredTrainings — attestati, costi iscrizione, formazione pregressa, esenzioni e requisiti.

Ruoli vs corsi (2)

rolesRequiredTrainings, rolesForbiddenTrainings — matrice ruoli e corsi richiesti/vietati.

Attrezzature (3)

equipments, workerEquipments, workerCredentials — attrezzature e credenziali necessarie.

📁 File chiave

• TrainingHub.Database/edu/Tables/*.sql — ~38 tabelle
• Indici espliciti: vedi sezione "Dettaglio tabelle"

⚠️ Debito tecnico

• appointments.courseSessionId nullable. Risolto in edu-sessions-redesign 2026-05-08: ora è trainingSessionId NOT NULL.
• Drop appointments.lessonId. Risolto dallo stesso redesign: il contenuto deriva da trainingSessionsCourses + trainingSessionsCoursesArguments.
• teacherSkills.lessonId. Sostituito da trainingVariantId per allinearsi alla granularità varianti.
• Nessun check su sovrapposizione appuntamenti. A livello DB i constraint restano informativi, ma a livello applicativo ISessionPlannerService.DetectConflictsAsync rileva: docente sovrapposto, sede occupata, iscritti oltre capienza, soglia docente, lavoratore in più sessioni, lezione mancante. Esposto come toast warning dal calendario e dal wizard.
• edu.categories senza FK visibili da courses. La correlazione categoria ↔ corso passa per trainingVariants: da documentare chiaramente nel subsystem varianti.
• courses.maxPeople vs trainingSessions.maxPeople. Due limiti distinti — validazione di coerenza non applicata a DB, solo in service SessionPlanner (conflict enrollment_overflow).
• teachers.label computed. Colonna calcolata da firstName + lastName: efficiente ma non indicizzabile. Se serve ricerca, aggiungere indice full-text o persisted computed column.
• Cache workerCompletionsCache non atomica. Aggiornata da trigger/hook vari: coerenza in caso di failure non chiara.

🔗 Vedi anche

• Panoramica dominio
• Componenti UI
• Logica applicativa
• Dominio reg: schema DB — headquarters, organizers, companies referenziate da edu
• Spec di riferimento: docs/superpowers/specs/_archive/2026-05-08-edu-sessions-redesign-design.md