# Generazione Report

## Report e Output Amministrativi

La pagina **Report** (`/report`) permette di generare i tre output previsti dal sistema, tutti integrati in un **unico file Excel (.xlsx)** compatibile con il gestionale attuale.

### Output A – Prospetto Ore per Dipendente/Giorno

File Excel con la seguente struttura per ogni dipendente e ogni giorno lavorativo:

| Colonna | Descrizione | Regola di calcolo |
|---------|-------------|-------------------|
| **Ore ordinarie** | Ore lavorate entro le 8h contratto | MIN(ore timbrate, 8h) − ore viaggio entro 8h |
| **Ore di viaggio** | Tempo percorrenza andata + ritorno verso cantiere | Ricavato dal tempo di percorrenza del cantiere selezionato |
| **Ore straordinarie** | Ore lavorate oltre le 8h (non di viaggio) | (Totale ore − 8h) − ore viaggio in eccedenza |

### Output B – Prospetto Fasce Tariffarie

Integrato nell'Output A come fogli aggiuntivi dello stesso file Excel:

| Colonna | Descrizione | Fonte dati |
|---------|-------------|------------|
| **Fascia oraria** | Identificativo fascia tariffaria (ordinaria, notturna, festiva…) | Tabella fasce configurata nel sistema |
| **Ore viaggio in fascia** | Quante ore di viaggio ricadono nella fascia | Incrocio orario timbratura × tabella fasce |
| **Ore lavoro in fascia** | Quante ore di lavoro effettivo ricadono nella fascia | Incrocio orario timbratura × tabella fasce |
| **Costo stimato** | Ore × tariffa oraria per fascia | Parametrizzabile dall'amministrazione |

### Output C – Prospetto Costi per Risorsa

Prospetto con costi per risorsa, calcolato a partire dalla tabella `cod_dipendente → costo`:

| Colonna | Descrizione |
|---------|-------------|
| **Codice dipendente** | Identificativo del dipendente |
| **Ore totali** | Somma ore ordinarie + viaggio + straordinari |
| **Costo calcolato** | Ore × costo orario del dipendente |

### Come Generare un Report

1. Accedi alla sezione **Report** dal menu laterale
2. Seleziona il **periodo** di riferimento (mese/anno)
3. Seleziona i **dipendenti** o la **commessa** da includere
4. Premi **"Genera Report"**
5. Il sistema produce il file Excel con i tre output come fogli separati
6. **Scarica** il file generato

### Formato di Esportazione

I report sono generati in formato **Excel (.xlsx)** per compatibilità diretta con il gestionale attuale e i processi amministrativi esistenti.

:::caution
I report si basano esclusivamente sui dati di **documenti confermati**. Verifica che non ci siano documenti "Da revisionare" pendenti prima di generare un report definitivo.
:::

### Tracciabilità

Ogni elaborazione report è **tracciata** con:
- Data e ora di generazione
- Utente che ha effettuato la generazione
- Parametri utilizzati (periodo, filtri)