# Panoramica del Sistema

## Cos'è MussoHolding

MussoHolding è una piattaforma web integrata progettata per **Musso Holding S.R.L.**, azienda operante nel settore metalmeccanico ed edile con maestranze distribuite sia in sede sia su cantieri dislocati sul territorio.

Il sistema nasce per risolvere un problema concreto: l'attuale gestione delle ore di lavoro, trasferte e straordinari avviene tramite **cartellini manuali (Excel)** e software dedicati per le timbrature, senza un sistema integrato che ne elabori automaticamente le componenti salariali.

## Obiettivi del Progetto

La piattaforma persegue due obiettivi principali:

### 🎯 Obiettivo 1 – Controllo ODL e Generazione Alert

Il sistema supporta l'operatore nella fase di **controllo degli ODL** (Ordini di Lavorazione Interna), incrociando le ore dichiarate nei fogli di lavorazione con le timbrature reali dei dipendenti.

- Importazione automatica degli ODL dal gestionale (tramite **OCR** da PDF)
- Importazione dei dati di timbratura dal software interno e dall'app cantiere
- **Confronto automatico** tra ore ODL e ore timbrate per operaio/giorno
- **Generazione alert** in caso di discrepanze (soglie configurabili)
- Dashboard di controllo con stato ODL per commessa

### 🎯 Obiettivo 2 – Elaborazione Ore e Output Amministrativi

Il sistema elabora automaticamente le timbrature dei metalmeccanici producendo output strutturati:

- **Output A** – Prospetto ore per dipendente/giorno (ordinarie, viaggio, straordinari)
- **Output B** – Prospetto fasce tariffarie (ordinaria, notturna, festiva)
- **Output C** – Prospetto costi per risorsa

## Tipologie di Dipendenti

| Categoria | Luogo timbratura | Trattamento ore viaggio |
|-----------|------------------|------------------------|
| **Metalmeccanici** (produzione e impiegati) | In azienda (software interno) | Ore viaggio trattate separatamente – soggette a calcolo specifico per trasferta e straordinario |
| **Edili** (cantiere) | In cantiere (app mobile) | Ore di viaggio trattate come trasferta contrattuale – escluse dalla Fase 1 |

:::note[Scope Fase 1]
La Fase 1 del progetto copre **esclusivamente i metalmeccanici**. La gestione timbrature edili (cantiere) è prevista in Fase 2.
:::

## Flusso Operativo

| # | Fase | Descrizione |
|---|------|-------------|
| 1 | **Ordine cliente** | Ricezione dell'ordine da parte dell'azienda |
| 2 | **Generazione ODL** | L'operatore genera il foglio di Lavorazione Interna (ODL) nel gestionale, con i materiali utilizzati |
| 3 | **Esecuzione lavori** | I metalmeccanici timbrano in azienda e in cantiere; gli edili timbrano in cantiere |
| 4 | **Rapportini giornalieri** | Compilati dagli operai e verificati dal responsabile. Gli impiegati inseriscono le attività su una maschera dedicata |
| 5 | **Elaborazione amministrativa** | Il sistema elabora automaticamente cartellini, straordinari e trasferte |

## Architettura Tecnica

Il sistema è composto da:

- **Applicazione Web** (Blazor) – interfaccia utente accessibile da browser
- **API Cloud** – servizi backend ospitati su Azure App Service
- **Azure AI (Foundry)** – motore OCR per l'estrazione dei dati dai documenti PDF
- **Database SQL** – archiviazione strutturata di tutti i dati
- **Blob Storage** – archiviazione delle immagini e dei PDF scansionati
- **Application Insights** – monitoraggio e telemetria applicativa
- **Key Vault** – gestione sicura dei segreti e delle credenziali

## Sorgenti Dati Integrate

| Sorgente | Copertura | Note |
|----------|-----------|------|
| **Software timbratura interno** | Metalmeccanici (in sede) | Genera cartellini mensili in formato Excel |
| **App mobile cantiere** | Dipendenti in cantiere | Include selezione cantiere (per calcolo percorrenza) |
| **Gestionale (ODL)** | Tutti i reparti | Contiene gli Ordini di Lavorazione Interna |

## Requisiti di Accesso

- Browser moderno (Chrome, Edge, Firefox, Safari)
- Connessione internet attiva
- Credenziali di accesso Microsoft Entra ID fornite dall'amministratore