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: 13 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
Compliance	job.vw_workerComplianceSummary	Vista — rollup per-lavoratore: worstStatus + conteggi expired/missing/expiring/ok + minDaysRemaining. Filtrabile per companyId. Aggrega edu.vw_workerTrainingStatus

Service layer — TrainingHub.Shared/Services/

File	Ruolo
IRiskInheritanceService.cs / RiskInheritanceService.cs	Cascade rischi ATECO → azienda → mansione → lavoratore
ITrainingExpirationService.cs / TrainingExpirationService.cs	Usa i rischi del lavoratore per calcolare compliance (condiviso con edu)

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

File	Scope
CompaniesRisksQueryModifier.cs	Hook su companiesRisks — refresh rischi lavoratori dopo cambi rischio azienda

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

Propaga il livello di rischio ATECO → azienda → mansione → lavoratore. Invocato da:

• reg.CompaniesQueryModifier.PostExecutionQuery dopo update aziende → cascade a workers.
• job.CompaniesRisksQueryModifier dopo cambio rischi aziendali.
• Extension method worker.UpdateRiskLevel(simpleCRUD, companyId?) per invocazione diretta.

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
            └── 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 è un snapshot storico: al cambio di mansione / ruolo / reparto di un lavoratore, un record viene inserito con startDate/endDate e i valori correnti di riskLevelId, roleId, departmentId. Permette audit temporale.

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 (13)
• BackOffice/Services/QueryModifiers/job/CompaniesRisksQueryModifier.cs
• 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. Con più mansioni con livelli diversi e override personali, non è documentata la formula esatta (max? ultimo? merge?).
• Storico mansioni — trigger automatico. Al cambio mansione, il sistema crea automaticamente il record in workerJobHistory o lo fa solo dopo azione esplicita?
• workers.riskLevelId staticizzato. Commento DB: "calcolato e staticizzato in base alla mansione". Staticizzato = materializzato. Quando viene refreshato? Coerenza con i rischi attuali?
• Refresh massivo workers.UpdateRiskLevel senza companyId. Path UpdateWhere senza entity ricalcola TUTTI i workers. Costoso su DB grande. Già segnalato nel dominio reg.
• Validazione codice fiscale. Checksum non validato lato DB. Regex/Luhn lato UI? Verificare.
• 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