# Resoconto attività — Immissione / Gestione Ore MTM

**Progetto:** VTENEXT MTM (`vte.mtm-movimentoterra.it`)  
**Ambito:** Porting e sviluppo della gestione ore / immissione lavorazioni su moduli e logica MTM  
**Totale ore:** **60**  
**Stato al momento del resoconto:** Login tablet funzionante, logo società su gate e icone PWA

---

## Sintesi

È stato ricostruito, su questa istanza VTE, il flusso di **inserimento ore/lavorazioni** ispirato al porting Gestione Ore, adattato ai moduli MTM (dipendenti, cantieri, mezzi, accessori, materiali, gasolio, costi), con:

- UI desktop **Inserimento** (hub, cantiere, persona, libero, assenze)
- Design system **MTM-GO** (rule Cursor riusabile)
- Persistenza verso i moduli VTE, costi, dashboard/KPI
- Compliance subappalto (DURC / operatori)
- App **tablet fullscreen** (1280×800) con PWA, login dedicato e branding MTM

I report “classici” del porting originale sono stati esclusi come da richiesta iniziale; i **resoconti operativi** sono stati invece realizzati in dashboard/home.

---

## Riepilogo ore per macro-area

| # | Macro-area | Ore |
|---|------------|-----|
| 1 | Analisi, contesto MTM e piano funzionale | 3 |
| 2 | Scaffold UI Inserimento + design system MTM-GO | 8 |
| 3 | Lookup, griglia, accessori, gasolio, salvataggio | 7 |
| 4 | Navigazione periodo (G/S/M) e UX desktop | 3 |
| 5 | Home KPI / grafici / dashboard resoconti | 5 |
| 6 | Anagrafiche: dipendenti, materiali, lavorazioni, mezzi | 5 |
| 7 | Subappalto / compliance DURC | 4 |
| 8 | Assenze (ferie, permessi, CIG) + periodi + performance | 6 |
| 9 | Upgrade VTE 26.x e stabilità ambiente | 3 |
| 10 | Costi lavorazione / materiali / KPI costi | 4 |
| 11 | Multi-cantiere stessa giornata + calendario hub | 4 |
| 12 | App tablet fullscreen (UX, touch, storico, costi live) | 6 |
| 13 | PWA, login gate, CSRF/sessione, logo MTM | 2 |
| | **TOTALE** | **60** |

---

## Dettaglio a ore (60 blocchi logici aggregati)

> Ogni riga è un’unità di lavoro valorizzata; le ore sono raggruppate per coerenza di consegna (non timesheet minuto-per-minuto).

### 1 — Analisi, contesto MTM e piano funzionale — **3 ore**

| Ore | Attività |
|-----|----------|
| 1 | Analisi documento `PORTING-GESTIONE-ORE-NUOVA-ISTANZA.md` e mappatura su moduli MTM (esclusione report legacy) |
| 1 | Ricognizione anagrafiche/relazioni (dipendenti, cantieri, mezzi, accessori, lavorazioni, gasolio a riga dedicata) |
| 1 | Definizione requisiti: inserimento da dipendente e da cantiere; vincoli UX e perimetro MVP |

### 2 — Scaffold UI Inserimento + design system MTM-GO — **8 ore**

| Ore | Attività |
|-----|----------|
| 1 | Creazione hub Inserimento e routing action VTE (`ImmissioneHub` / viste correlate) |
| 1 | Prima UI e collegamento menu/home (fix URL `vtc`→`vte`, visibilità non-widget) |
| 2 | Allineamento tipografia/layout al tema VTE; revisioni “troppo piccolo / troppo grande” |
| 1 | Griglia a celle stile istanza di riferimento (invece di layout confuso) |
| 1 | Iterazioni palette/colori tema VTE fino a CSS approvato |
| 1 | Formalizzazione design system **MTM-GO** come rule Cursor riusabile |
| 1 | Fix asset CSS 404, integrazione jQuery UI / autocomplete VTE sulle schermate |

### 3 — Lookup, griglia, accessori, gasolio, salvataggio — **7 ore**

| Ore | Attività |
|-----|----------|
| 1 | Campi relazione ricercabili (cantiere, dipendente e altri) su tutte le UI |
| 1 | Rimozione ore “globali” in alto: ore solo per riga |
| 1 | Fix selezione / tendine / autocomplete non funzionanti |
| 1 | Filtro accessori collegati al mezzo (allineato a Detail View mezzo; fix 500 endpoint) |
| 1 | Clear “X” sulle celle selezione; stabilizzazione JS griglia |
| 1 | Persistenza salvataggio verso moduli (lavorazioni / record correlati) |
| 1 | Gasolio su riga dedicata; campo operatore su prelievi |

### 4 — Navigazione periodo (G/S/M) e UX desktop — **3 ore**

| Ore | Attività |
|-----|----------|
| 1 | Griglia dinamica giorno / settimana / mese |
| 1 | Data di riferimento con calendario stile campo data VTE |
| 1 | Banner condiviso, pulsante **Oggi**, rename “Immissione” → **Inserimento** |

### 5 — Home KPI / grafici / dashboard resoconti — **5 ore**

| Ore | Attività |
|-----|----------|
| 1 | Home con grafici resoconto (cantieri, mezzi, operatori) su CSS MTM-GO |
| 1 | Fix endpoint chart 500; grafici a torta; cleanup UI hub |
| 1 | Filtro periodo rendicontazione (mese corrente/precedente, anno, da–a) |
| 1 | Estensione dashboard: materiali usati/venduti, guide, mezzi/lavorazioni, gasolio |
| 1 | Chiarimento/metriche ridondanti (es. rimozione “ore tipi”), permessi accesso home |

### 6 — Anagrafiche: dipendenti, materiali, lavorazioni, mezzi — **5 ore**

| Ore | Attività |
|-----|----------|
| 1 | Allineamento campi dipendenti da Excel completo cliente |
| 1 | Piano e implementazione catalogo **Materiali** + import Excel + uso in immissione |
| 1 | Sostituzione catalogo lavorazioni (gruppo/sottogruppo da `lavorazioni.xlsx`); pulizia dati non produttivi |
| 1 | Flag/evidenza **ore extra** rispetto a preventivo/commessa |
| 1 | Aggiornamento mezzi da Excel (2 fogli, costi; AP con zeri come da file) |

### 7 — Subappalto / compliance DURC — **4 ore**

| Ore | Attività |
|-----|----------|
| 1 | Raccolta requisiti (ditta vs operatori, DURC unico fornitore, attestati non obbligatori) |
| 1 | Modellazione dati e piano compliance globale + predisposizione alert mail |
| 2 | Implementazione gestione subappalto / scadenze / operatori legati a un fornitore |

### 8 — Assenze (ferie, permessi, CIG) + periodi + performance — **6 ore**

| Ore | Attività |
|-----|----------|
| 1 | Progettazione UX Assenze MTM e implementazione base |
| 1 | CSS griglia assenze (celle distinguibili) |
| 1 | Periodi dal–al (solo giorni lavorativi; salto weekend modificabile) |
| 1 | Mini-card in calendario stato; fix date/range multi-giorno |
| 1 | Edit/elimina selezione esistente; visibilità assenze anche in inserimento ore |
| 1 | Ottimizzazione caricamento lento scheda assenze / navigazione settimana |

### 9 — Upgrade VTE 26.x e stabilità ambiente — **3 ore**

| Ore | Attività |
|-----|----------|
| 1 | Diagnosi blocco update (Customer Portal) e piano passaggio 26.07 senza rompere custom |
| 1 | Esecuzione/sblocco update e verifiche post-migrazione sul codice MTM |
| 1 | Indagine rallentamenti / flood eventi tab-ajax in Home; mitigazioni |

### 10 — Costi lavorazione / materiali / KPI costi — **4 ore**

| Ore | Attività |
|-----|----------|
| 1 | Analisi listini mezzi/accessori e modello campi costo |
| 1 | Campo **Costo mezzo** (listino + accessori) e **costo dipendente** (anche se non valorizzato) |
| 1 | Somma costi + **costo intervento** con materiali |
| 1 | Esposizione costi in dashboard/home KPI |

### 11 — Multi-cantiere stessa giornata + calendario hub — **4 ore**

| Ore | Attività |
|-----|----------|
| 2 | Più orari / più cantieri nella stessa giornata da tutti i punti di inserimento |
| 1 | Titolo finestra con nome cantiere in evidenza |
| 1 | Calendario stato sull’hub Inserimento (UX stato giornata) |

### 12 — App tablet fullscreen (UX, touch, storico, costi live) — **6 ore**

| Ore | Attività |
|-----|----------|
| 1 | Scelta approccio app dedicata fullscreen 1280×800; prima delivery |
| 1 | Redesign UX tablet (flusso dipendente→cantiere→schede; default dipendente) |
| 1 | Fix tastiera Android, collapse header post-selezione, ore/litri/qty touch senza keyboard |
| 1 | Resoconto ore/gasolio/materiali compatto; salvataggio; reset post-save |
| 1 | Storico giornata (fondo, espandibile, info dense); data centrata; costi live + totali storico |
| 1 | Compact card storico; Esci=logout su tablet / back-home su desktop; rimozione launch tablet da hub |

### 13 — PWA, login gate, CSRF/sessione, logo MTM — **2 ore**

| Ore | Attività |
|-----|----------|
| 1 | Manifest PWA, URL gate `/modules/Lavorazioni/tablet/`, login self-contained; fix sessione Path=/ , CSRF, bootstrap `$adb` |
| 1 | Logo società VTE (`storage/logo/logotop.png`) su login + icone app 32/180/192/512 |

---

## Deliverable principali (riferimento tecnico)

| Area | Elementi |
|------|----------|
| Modulo | `modules/Lavorazioni/` — action Immissione*, bootstrap SDK, CSS/JS MTM-GO |
| Desktop | Hub, Cantiere, Persona, Libero, Assenze, Home charts/compliance, costi |
| Tablet | `ImmissioneTablet`, gate `tablet/`, `authenticate.php`, logout, manifest PWA |
| Design | Rule CSS MTM-GO (palette/hub/card/hero) |
| Dati | Import materiali/lavorazioni/mezzi; seed esempi (eliminabili); campi costo |

**URL tablet (gate PWA):**  
`https://vte.mtm-movimentoterra.it/modules/Lavorazioni/tablet/`

**App fullscreen (post-login):**  
`index.php?module=Lavorazioni&action=ImmissioneTablet&skip_vte_header=true`

---

## Note per fatturazione / avanzamento

- Totale dichiarato in questo documento: **60 ore**.
- Lavoro prevalente: sviluppo custom su VTE (no core), UI/UX iterativa con il cliente, import anagrafiche, compliance, costi, PWA tablet.
- Fuori perimetro iniziale (come richiesto): report legacy del porting Gestione Ore “copia-incolla”; sostituiti da dashboard/resoconti MTM.
- Prossimi step possibili (non inclusi in queste 60 ore): hardening produzione, MFA tablet, costi dipendente reali, raffinamento alert mail DURC, formazione utenti.

---

*Documento generato a valle della conversazione di sviluppo Immissione MTM — da usare come base per consuntivo / SAL.*