# Rendicontazione lavori — Gestione Ore Cantieri (Massini & Gori)

**Cliente:** Massini & Gori S.r.l.  
**Progetto:** Modulo Gestione Ore su VTE CRM (sostituzione operativa del sistema Access)  
**Periodo lavori:** 23 – 28 luglio 2026  
**Ore rendicontate:** **46 ore**  
**Ambiente:** istanza di pre-produzione `vtemassiniegori` (non ancora in produzione)

---

## 1. Sintesi per la direzione

In questa fase è stato portato avanti, in modo continuo e verificato, il passaggio dal vecchio sistema Access alla nuova Gestione Ore su VTE.

Il lavoro non si è limitato a “mettere a posto qualche schermata”: è stata costruita (e rifinita insieme al referente) la logica operativa reale dell’azienda — regole su ordinario/straordinario/CIG, chiusura mese, stampe ufficiali, ridistribuzione straordinari, report cartacei allineati ai fogli Excel/Access già in uso, e usabilità quotidiana per Dipendenti e Appaltatori.

Le **46 ore** coprono:

1. **Analisi e allineamento** ai requisiti emersi dalla riunione del 30 giugno 2026  
2. **Implementazione a fasi** (regole → controllo mese → stampe → report)  
3. **Molte iterazioni di rifinitura UI** su indicazioni dirette (foto, feedback a video, correzioni immediate)  
4. **Test funzionali e grafici** ad ogni step (incluso accesso in qualità di amministratore)

---

## 2. Percorso dei lavori (cronologia)

### Giornata 1 — Analisi, piano e avvio regole (23 luglio)

**Mattina / primo pomeriggio**

- Analisi completa della registrazione riunione del 30/06/2026 e produzione di un documento strutturato di requisiti e decisioni.
- Definizione della roadmap a fasi (P0→P3) con priorità chiare: prima le regole di conformità, poi chiusura mese e report, poi elaborazione straordinari.
- Chiarimento decisioni chiave con il referente (es. regole CIG/straordinario sui Dipendenti; seed di prova a giugno; nessuna esportazione paghe in questa fase).

**Pomeriggio — implementazione P0 e P1 (base)**

- Inserimento dati di prova realistici a **giugno 2026** (su anagrafiche già presenti), utili per testare regole e report senza rischiare i dati “veri”.
- Motore regole ore (parametrico):
  - giornata standard **8 ore**;
  - straordinario max **2 ore/giorno** e **8 ore/settimana** (Dipendenti);
  - CIG che deve “completare” la giornata;
  - controlli soft (avvisi) e hard (blocchi) dove richiesto.
- Blocco/alert in fase di salvataggio ore + pannello anomalie.
- Congelamento mese, audit delle modifiche, prime correzioni report (CERT solo ordinarie, malattia/infortunio nei fogli).
- Aggiornamenti piattaforma VTE e verifica di regressione.

**Sera — usabilità e correzioni operative**

Interventi mirati su quanto emerso dall’uso reale a video:

- Distinzione chiara Dipendenti / Appaltatori (colori, navigazione, conteggi ore coerenti).
- Tema arancione Appaltatori allineato alla home.
- Ricerca immediata su anagrafiche (riparata e resa affidabile).
- Campi anagrafici mancanti / non accessibili resi disponibili dove necessario.
- Testi su bande colorate resi leggibili (bianco su blu/arancio).
- Filtri cantiere e persona sempre visibili durante l’inserimento.
- Legenda colori celle (ordinario, straordinario, CIG, guida, ecc.) — Dipendenti e Appaltatori.
- Navigazione hub/home sistemata (link che non “restavano lì”).
- Widget **Periodo / ricorrenza** per malattie, ferie, L104 su più giorni lavorativi (con gestione conflitti: sovrascrivi / salta).
- Pannello anomalie reso più chiaro, con indicazioni su come correggere.

**Stima giornata 1:** circa **14–16 ore** (analisi + implementazione massiva + rifiniture UI serali).

---

### Giornata 2 — Modello ufficiale ore, ridistribuzione ST, report (24 luglio)

**Mattina — modello “ibrido” ufficiale / effettivo**

Dopo confronto sulle esigenze di stampa paghe vs storico cantiere, è stato implementato il modello concordato:

- **Presenze** = storico effettivo di ciò che è stato lavorato (non si “cancella” con la ridistribuzione).
- **Sandbox straordinari** = bozza delle mosse (spostamenti ST).
- **Snapshot ufficiale** alla **chiusura mese** = dati da usare per le stampe “paghe / ufficiali”.
- Nei report: selettore **Ufficiale / Effettivo**, con default sensati per tipo di report (es. fogli/CERT → ufficiale; ripartizione cantiere → effettivo).
- Possibilità di anteprima ufficiale **provvisoria** (Presenze + sandbox) prima della chiusura, con link rapido alla chiusura mese.

**Ridistribuzione straordinari (ST)**

- Pannello ridistribuzione riprogettato (filtri mese, dipendenti, stato lavorato).
- Auto-assegnazione ST in eccesso + **modifica manuale su calendario** (stesso linguaggio visivo dell’immissione ore).
- Ore non collocabili nel mese → **avanzo** disponibile nel mese successivo.
- Evidenza di chi è già stato “lavorato” (colore riga / stato).
- Ridistribuzione di massa dove utile.

**Report**

- Allineamento testi/menu home e hub.
- Riprogettazione **Ripartizione ore** secondo il foglio di riferimento (dipendenti × cantieri, totali, intestazioni verticali).
- Miglioramento UX griglia grande, filtri, export **PDF A3** ed Excel con icone/azioni a tema.
- Flag su cantiere “presente in CERT” + preset di selezione cantieri nel report.

**Stima giornata 2:** circa **12–14 ore**.

---

### Giornata 3 — Report cartacei CERT / CIG / Fogli / Guide + regole ore (28 luglio)

**Report CERT cantiere (layout cartaceo)**

- Nuovo report separato dal CERT “obiettivi”, un foglio per cantiere.
- Testata anagrafica completa (committente, CF/P.IVA, indirizzo, email, tipologia, valori opera, date) allineata al foglio cartaceo inviato via WhatsApp.
- Tabella ore dipendenti del mese + sezione opere subappaltate.
- Export Excel e PDF nello stesso stile.
- Filtro multiplo cantieri e preset (attivi+CERT / con ore / tutti).
- Stesso layout cartaceo esteso anche al **Report CIG**.

**Fogli presenze**

- Indennità mensa / trasporto / guida da **anagrafica** nel riepilogo in alto (non come righe confondenti in griglia giorni).
- Riallineamento grafico anteprima + Excel + PDF allo stile Access dei fogli di Aprile 2026 (testata DIPENDENTE/AZIENDA/MESE/ANNO, blocco indennità, griglia giorni ORD/STR/CIG/FERIE/PERM/MAL/INF).

**Regole inserimento ore**

- Correzione bug: se su un giorno, su più cantieri, le ore **ordinarie** superano 8, l’eccesso diventa **straordinario** (o viene bloccato se oltre i limiti ST).
- Stessa logica applicata anche agli **Appaltatori** (limiti ST giorno/settimana), senza attivare le regole CIG tipiche solo dei Dipendenti.

**Report Guide**

- Nuovo report mensile guide/mezzi (come “Guida Q” di Access): per ogni persona elenco giorno, mezzo, destinazione, cantiere.
- Anteprima + Excel + PDF; disponibile in area Dipendenti e Appaltatori.

**Stima giornata 3:** circa **14–16 ore**.

---

## 3. Cosa è stato consegnato (elenco leggibile)

### A. Conformità e controllo inserimento ore

| Funzione | Beneficio per l’ufficio |
|----------|-------------------------|
| Split automatico Ordinario → Straordinario oltre le 8h (anche su più cantieri) | Evita “tutte ordinarie” oltre soglia; allineato alle regole concordate |
| Limiti straordinario (2h/giorno, 8h/settimana) Dipendenti | Blocca errori prima della stampa |
| Controlli CIG (completa a 8h, conflitti con ST) | Riduce anomalie da correggere a fine mese |
| Pannello anomalie | Vista mensile di cosa non torna, con messaggio chiaro |
| Periodo / ricorrenza (malattia, ferie, L104) | Inserimento multi-giorno senza ripetere cella per cella |

### B. Chiusura mese e stampe corrette

| Funzione | Beneficio |
|----------|-----------|
| Congelamento mese | Evita modifiche accidentali dopo chiusura |
| Snapshot ufficiale | Stampe CERT/fogli/CIG leggono i dati “dopo” ridistribuzione ST |
| Selettore Ufficiale / Effettivo | Paghe vs controllo cantiere senza perdere lo storico |
| Anteprima ufficiale provvisoria | Si può verificare la stampa prima di chiudere |

### C. Ridistribuzione straordinari

| Funzione | Beneficio |
|----------|-----------|
| Sandbox ST | Si prova lo spostamento senza rovinare lo storico |
| Calendario manuale + auto | Operatività come in immissione ore |
| Avanzo mese successivo | Gestione residui non collocabili |
| Stato “già lavorato” | Chiarezza su chi è già stato elaborato |

### D. Report allineati ai fogli aziendali

| Report | Stato |
|--------|--------|
| CERT cantiere (cartaceo) | Nuovo — Excel/PDF |
| CIG (stesso layout cartaceo) | Aggiornato |
| Fogli presenze (layout Access) | Riallineato Excel/PDF/anteprima |
| Ripartizione ore (matrice) | Ridisegnata + PDF A3 |
| Report Guide | Nuovo |
| Menu / home Dip e App | Aggiornati con le nuove voci |

### E. Usabilità quotidiana (Dipendenti e Appaltatori)

- Home e hub con percorsi chiari  
- Colori e legende coerenti  
- Filtri sempre a vista  
- Ricerca anagrafiche funzionante  
- Navigazione settimana vicino alla griglia  
- Legenda in fondo con rimando rapido  
- Banner e tipografia leggibili  

---

## 4. Perché 46 ore sono coerenti

| Macro-area | Ore indicative | Note |
|------------|----------------|------|
| Analisi riunione + roadmap + decisioni | 4 | Documento requisiti, piano fasi, allineamento |
| Motore regole + seed + anomalie + test | 8 | Cuore conformità Dipendenti |
| UX immissione (ricerca, filtri, legende, colori, widget multi-giorno) | 8 | Molte iterazioni da feedback a schermo |
| Modello ufficiale/effettivo + chiusura mese + selettori report | 6 | Impatto su tutte le stampe |
| Ridistribuisci ST (UI + calendario + avanzo + massa) | 7 | Funzionalità complessa lato utente |
| Report CERT/CIG cartaceo + campi cantiere + filtri | 6 | Allineamento a foglio fisico WhatsApp |
| Fogli presenze layout Access + indennità | 4 | Excel/PDF/anteprima |
| Report Guide + regole Ord/ST anche Appaltatori | 3 | Chiusura ultimi gap operativi |
| **Totale** | **≈ 46** | Inclusi test grafici e regressione |

Le ore non sono “solo sviluppo”: una parte rilevante è stata **co-progettazione iterativa** (foto, “non ci siamo”, rifacimenti layout) tipica di un passaggio Access → CRM dove il risultato deve somigliare ai fogli che l’ufficio già conosce.

---

## 5. Cosa resta fuori (consapevolmente)

Come concordato in roadmap, **non** rientrano in queste 46 ore (o restano backlog):

- Export automatico verso paghe / EdilConnect / Cassa Edile  
- Integrazioni magazzino / altri sistemi esterni  
- Messa in produzione definitiva e formazione estesa agli utenti finali  

---

## 6. Stato attuale e prossimi passi consigliati

**Stato:** modulo Gestione Ore operativo in pre-produzione, con regole, chiusura mese, ridistribuzione ST e report principali allineati ai riferimenti cartacei/Access.

**Prossimi passi suggeriti al cliente:**

1. Validazione utenti ufficio su un mese reale (es. Aprile/Giugno) confrontando stampe VTE vs Excel storici.  
2. Check anagrafiche (indennità, flag CERT cantieri, email/CF).  
3. Decisione go-live + eventuale formazione breve.  
4. Solo dopo OK: avvio export paghe / integrazioni esterne.

---

## 7. Conclusione

Le **46 ore** rendicontate corrispondono a un blocco di lavoro completo: dall’analisi della riunione alla messa a punto operativa di inserimento ore, controllo mese, ridistribuzione straordinari e stampe (CERT, CIG, fogli, guide), con continuo allineamento al modo di lavorare di Massini & Gori.

Il risultato è un sistema già utilizzabile in prova, pensato per sostituire l’Access senza perdere le logiche e i formati di stampa a cui l’ufficio è abituato.

---

*Documento preparato da Pantarei — luglio 2026*  
*Riferimenti interni di lavoro: riunione 30/06/2026, roadmap Gestione Ore, feedback UI 23–28/07/2026.*