Dominio `job` — Panoramica sviluppatore

🎯 Cosa fa

Il dominio job (workers & risks) gestisce anagrafica lavoratori, mansioni, ruoli aziendali, reparti e rischi. È il ponte logico tra reg (aziende) ed edu (formazione): da reg eredita il contesto azienda/sedi, verso edu determina quali corsi sono obbligatori tramite il cascade rischi.

Dominio di dimensione media: 17 tabelle, tutte in scope.

🗺️ Mappa moduli

Database — `TrainingHub.Database/job/`

Area	Tabella	Ruolo
Lavoratori	`job.workers`	Anagrafica dipendenti
Lavoratori	`job.workerJobHistory`	Storico mansioni/ruoli/reparti
Mansioni	`job.jobs`	Mansioni (con riskLevel e inheritsCompanyRisks)
Mansioni	`job.jobGroups`	Raggruppamenti visuali di mansioni
Mansioni	`job.jobSubcategories`	N:N mansione ↔ sottocategoria azienda
Mansioni	`job.workersJobs`	N:N lavoratore ↔ mansione
Ruoli	`job.roles`	Ruoli aziendali (lavoratore, preposto, dirigente)
Struttura	`job.departments`	Reparti gerarchici (parentId)
Rischi	`job.risks`	Anagrafica rischi
Rischi	`job.riskLevel`	Livelli (1=basso, 2=medio, 3=alto)
Rischi	`job.atecoCodes`	Codici ATECO gerarchici (parentCode) con riskLevelId suggerito
Rischi	`job.companiesRisks`	Rischi aziendali
Rischi	`job.jobsRisks`	Rischi per mansione
Rischi	`job.workersRisks`	Override/esclusione rischio per lavoratore
Rischi	`job.workerEffectiveRisksCache`	Cache di `vw_workerEffectiveRisks`, popolata da `sp_refreshEffectiveRisksForScope`
Rischi	`job.atecoCodesLegacy`	Mapping codici ATECO legacy → 2025
Documenti	`job.workerDocuments`	Bridge lavoratore ↔ `oss.documents`
Compliance	`job.vw_workerComplianceSummary`	Vista — rollup per-lavoratore: `worstStatus` (`expired` > `missing` > `expiring` > `insufficient` > `ok`) + conteggi per stato, incluso `insufficientCount`, + `minDaysRemaining`. Attenzione: `okCount` conta solo `status = 'ok' AND hoursShortfall = 0`. Filtrabile per `companyId`. Aggrega `edu.vw_workerTrainingStatus`

Service layer — `TrainingHub.Shared/Services/`

File	Ruolo
`IRiskInheritanceService.cs` / `RiskInheritanceService.cs`	Sola lettura dei rischi effettivi (`job.vw_workerEffectiveRisks`), per lavoratore o per azienda
`DataLayer/job/workers.cs`	`UpdateRiskLevel` — materializza `workers.riskLevelId`; `SyncSiblingsByFiscalCode` — allinea l'anagrafica fra worker con lo stesso CF
`ITrainingExpirationService.cs` / `TrainingExpirationService.cs`	Usa i rischi del lavoratore per calcolare compliance (condiviso con edu)

QueryModifiers — `TrainingHub.BackOffice/Services/QueryModifiers/job/`

Sono sette:

File	Scope
`CompaniesRisksQueryModifier.cs`	Hook su `companiesRisks` — `UpdateRiskLevel(companyId)` + refresh cache variante e rischi
`WorkersQueryModifier.cs`	Hook su `workers` — `UpdateRiskLevel`, sync anagrafico per CF, tre stored procedure di refresh; e in `PreExecutionQuery` la guardia di cancellazione
`WorkersJobsQueryModifier.cs`	Hook su `workersJobs` — `UpdateRiskLevel` + apertura/chiusura del periodo in `workerJobHistory`
`JobsQueryModifier.cs`	Hook su `jobs`
`JobsRisksQueryModifier.cs`	Hook su `jobsRisks`
`WorkersRisksQueryModifier.cs`	Hook su `workersRisks` — solo refresh cache, non tocca `riskLevelId`
`AtecoCodesQueryModifier.cs`	Hook su `atecoCodes` — propaga il livello suggerito alle aziende (`reg.company.UpdateRiskLevel`)

UI CRUD — `TrainingHub.BackOffice/Components/CRUD/job/`

Entità CRUD standard:

Worker, WorkerJobHistory, WorkersData (vista aggregata)
Job, JobGroup, JobSubcategory, JobsData
WorkersJob (associazione)
Role, Department
Risk, RiskLevel, AtecoCode
CompaniesRisk, JobsRisk, WorkersRisk
WorkerEffectiveRisk — vista calcolata dei rischi effettivi del lavoratore (cascade applicato)
WorkerComplianceSummary — CRUD auto-generato sulla view vw_workerComplianceSummary (read-only). FK manuali su worker/company/role/department, badge stato in colonna worstStatus. Embed nel wizard CompanyFormPopup come step "Conformità formativa". Pattern descritto in Architettura — view → CRUD

🔧 API pubblica

`IRiskInheritanceService`

Legge i rischi effettivi, non li propaga. Due sole query su job.vw_workerEffectiveRisks (IRiskInheritanceService.cs:5-9): GetEffectiveRisksAsync(workerId) e GetEffectiveRisksByCompanyAsync(companyId). Consumato da Worker.razor.cs, Company.razor.cs e Program.cs.

`worker.UpdateRiskLevel` — la propagazione vera

TrainingHub.Shared/DataLayer/job/workers.cs:7:

public static async Task<int> UpdateRiskLevel(
    ISimpleCRUDService simpleCRUD,
    Guid? jobId = null, Guid? companyId = null, Guid? workerId = null);

Un UPDATE che scrive workers.riskLevelId come massimo fra le mansioni, con fallback sul livello azienda. Invocato da reg/CompaniesQueryModifier.cs:78,82, job/CompaniesRisksQueryModifier.cs:28, job/WorkersQueryModifier.cs:72,74, job/WorkersJobsQueryModifier.cs:62, job/JobsQueryModifier.cs:34,40, job/JobsRisksQueryModifier.cs:28 e Shared/Services/TrainingImportService.Processing.cs:884.

La propagazione ATECO → azienda è un passo a monte e distinto: job/AtecoCodesQueryModifier.cs:29, che chiama reg.company.UpdateRiskLevel.

Dettaglio in logica applicativa.

`ITrainingExpirationService`

Calcola compliance formativa combinando rischi del lavoratore (dominio job) con formazione ricevuta (dominio edu). Dettaglio in Logica applicativa edu.

🧩 Pattern chiave

Cascade rischi

Codice ATECO
    └── riskLevelId suggerito
        └── azienda.riskLevelId (default)
            ├── jobs.riskLevelId (opzionale — override per mansione)
            │   ├── jobs.inheritsCompanyRisks
            │   │   └── aggiunge i rischi companiesRisks ai rischi jobsRisks
            │   │       └── tranne quelli con companiesRisks.onlyForExposedJobs = 1 (rischio d'attività: vale solo per le mansioni che lo dichiarano)
            │   └── jobsRisks.onlyIfCompanyHasRisk (indipendente da inheritsCompanyRisks — il rischio mansione entra solo se l'azienda ha lo stesso rischio)
            └── workers.riskLevelId (staticizzato per lavoratore)
                └── workersRisks (override singolo rischio + esclusioni)

Propagazione automatica:

Cambio ATECO azienda → CompaniesQueryModifier → UpdateRiskLevel
Cambio riskLevel azienda → idem
Cambio companiesRisks → CompaniesRisksQueryModifier → ricalcolo
Cambio mansione lavoratore → staticizzazione workers.riskLevelId

Storico mansioni

workerJobHistory è uno snapshot storico della sola mansione. WorkersJobsQueryModifier apre il periodo sull'Insert di workersJobs (righe 67-77) e lo chiude sul DeleteSingle (29-51), registrando i valori correnti di riskLevelId, roleId, departmentId.

⚠️ I cambi di ruolo e reparto passano da job.workers e WorkersQueryModifier (:64-93) non tocca workerJobHistory: non lasciano traccia nello storico. Entrambe le operazioni sono best-effort — un errore nell'audit non blocca l'operazione CRUD.

Vista `WorkerEffectiveRisk`

Componente UI non-CRUD che mostra i rischi finali del lavoratore applicando il cascade (rischi azienda + mansione + override lavoratore, meno esclusioni). Utile per DVR e per determinare formazione richiesta.

Gerarchia `departments`

Tabella auto-referenziante: departments.parentId crea un albero reparti (es. "Produzione" → "Linea A" → "Turno notte"). UI deve supportare visualizzazione ad albero.

Codici ATECO gerarchici

atecoCodes.parentCode simile ai reparti: ATECO hanno gerarchia (es. "F - Costruzioni" → "F.41 - Costruzione di edifici" → "F.41.1 - Sviluppo di progetti immobiliari"). Flag selectable indica quali codici possono essere assegnati direttamente alle aziende (foglie o nodi selezionabili).

📦 Dipendenze

Brighela.SimpleCRUD — CRUD base + QueryModifier
Stack UI comune (DevExpress, Tabiot, Oss)

Cross-dominio in entrata (FK da altri domini a job):

reg.companies.riskLevelId → job.riskLevel(id)
reg.companies.atecoCode → job.atecoCodes(code)
edu.courses.trainingVariantId non tocca job, ma varianti formative (fuori scope edu) mappano verso rischi

Cross-dominio in uscita (FK da job):

job.workers.companyId → reg.companies(id)
job.workers.companyLocationId → reg.companyLocations(id)
job.workers.academicQualificationId → reg.academicQualifications(id)
job.departments.companyId → reg.companies(id)
job.jobSubcategories.companySubcategoryId → reg.companySubcategories(id)

📁 File chiave

Database/job/Tables/*.sql (17)
Database/job/Views/vw_workerEffectiveRisks.sql — l'autorità sul cascade
Database/job/Functions/fn_getWorkerRisks.sql
BackOffice/Services/QueryModifiers/job/*.cs (7)
BackOffice/Components/CRUD/job/Worker.razor{,.cs,.tt.cs} + Forms/WorkerForm.razor
BackOffice/Components/CRUD/job/WorkerEffectiveRisk.razor — vista rischi effettivi calcolati
Shared/Services/IRiskInheritanceService.cs + impl

⚠️ Domande aperte / debito tecnico

~~Regola calcolo rischio finale del lavoratore.~~ È il massimo fra le mansioni, con fallback sul livello dell'azienda: ISNULL(MAX(J.riskLevelId), C.riskLevelId) (Shared/DataLayer/job/workers.cs:19-27). Gli override personali (workersRisks) valgono per i rischi effettivi, non per questa colonna.
~~Storico mansioni — trigger automatico.~~ Automatico: OpenPeriodAsync sull'Insert di workersJobs, ClosePeriodAsync sul DeleteSingle (WorkersJobsQueryModifier.cs:44,71), entrambe idempotenti e best-effort. Copre solo la mansione, non ruolo e reparto.
~~workers.riskLevelId staticizzato — quando viene refreshato?~~ Da otto punti: WorkersQueryModifier.cs:72,74, WorkersJobsQueryModifier.cs:62, JobsQueryModifier.cs:34,40, JobsRisksQueryModifier.cs:28, CompaniesRisksQueryModifier.cs:28, reg/CompaniesQueryModifier.cs:78,82, TrainingImportService.Processing.cs:884. Dettaglio in logica applicativa.
~~Refresh massivo senza companyId.~~ Non è un problema: l'UPDATE filtra su WHERE ISNULL(W.riskLevelId,-1) <> ISNULL(...) (workers.cs:28), quindi tocca solo le righe fuori sync. È anzi il meccanismo di rebuild.
Nessuna validazione del checksum del codice fiscale. WorkerForm.razor.cs:10 controlla solo Length >= 16. Vedi il debito in logica applicativa.
Mansioni globali vs per-azienda. Oggi jobs è tabella globale: non ha companyId. Un'azienda "Acme" e "Beta" che hanno un "Saldatore" condividono lo stesso record. Se una vuole personalizzare rischi solo per la propria "Saldatore" deve creare una mansione custom. Pattern da documentare.
atecoCodes.selectable — semantica. Chi può deselezionare? Sono ATECO pre-popolati dal sistema o l'utente può aggiungerne?

🔗 Vedi anche

Schema DB
Componenti UI
Logica applicativa
Aggiungere un campo
Guida utente: Panoramica lavoratori (docs-site-user)
Dominio reg: logica applicativa — cascade CompaniesQueryModifier invoca job
Dominio edu: logica applicativa — usa rischi job per calcolare compliance

🎯 Cosa fa​

🗺️ Mappa moduli​

Database — TrainingHub.Database/job/​

Service layer — TrainingHub.Shared/Services/​

QueryModifiers — TrainingHub.BackOffice/Services/QueryModifiers/job/​

UI CRUD — TrainingHub.BackOffice/Components/CRUD/job/​

🔧 API pubblica​

IRiskInheritanceService​

worker.UpdateRiskLevel — la propagazione vera​

ITrainingExpirationService​

🧩 Pattern chiave​

Cascade rischi​

Storico mansioni​

Vista WorkerEffectiveRisk​

Gerarchia departments​

Codici ATECO gerarchici​

📦 Dipendenze​

📁 File chiave​

⚠️ Domande aperte / debito tecnico​

🔗 Vedi anche​