Checklist di avanzamento

Aggiornare questa pagina nello stesso commit/PR con cui un'attività viene completata. Una macro-voce si considera chiusa solo quando sono soddisfatti codice, test, migrazione e documentazione.

Decisioni e baseline

Approvare requisiti, glossario e confini MVP/Release 1 con il committente
Fotografare API, schema, dataset e comportamento AS-IS
Creare regression suite del POC
Approvare ADR-001 tenant/source of truth — approvata il 15 agosto 2026
Approvare matrice ruoli e permessi
Approvare ADR-002 confine del dominio — approvata il 15 agosto 2026
Approvare ADR cursori/consegna/correzioni
Approvare ADR forecasting e funzione obiettivo
Approvare ADR adapter import/export

P0 — Organizzazione e sicurezza

HR e risorse

Ferie e disponibilità

La sezione è stata ridimensionata dal committente il 17 agosto 2026: non si costruisce un modulo HR, ma il minimo che serve al forecast. Vedi Fase 2. L'ordine dei punti è quello deciso e va rispettato.

Creare le due tabelle — saldo annuale e piano mensile — tenant-scoped con chiave composita verso employees, una riga per dipendente e anno (migrazione 108: employee_leave_balances, employee_monthly_leave_plan)
Decrementare i giorni goduti dall'import presenze riconoscendo 8FE (si ricalcola, non si decrementa: vedi Stato e decisioni)
Permettere ad Admin/HR di inserire i giorni previsti per dipendente e anno, distinguendo «nessun dato» da «zero giorni» (sotto-scheda Ferie in Storico; la casella vuota azzera il dato, 0 è un valore)
Mostrare ferie prese e residue nella scheda dipendente (un anno per riga; senza previsti il residuo dice «non calcolabile», non zero)
Self-service per i giorni pianificati, per mese (in «I miei dati»; prime scritture concesse a self, con mesi futuri e tetto dei giorni imposti dal servizio)
Usare il piano mensile nel monte ore del forecast (solo le ferie pianificate: ricalcolaTutti toglie 8 ore per giorno pianificato, per persona e per mese. Il residuo non collocato resta fuori, e dipende dal modello di capacità della Fase 6)

Rimandati e non in Fase 2: policy, carry-over e calendari; stati e workflow di approvazione; viste manager; i permessi <n>PR; part-time e cessazioni infra-annuali. E la riserva per ferie non pianificate, che non è un problema di ferie ma dipende dal modello di capacità dipendente/progetti, ancora da sviluppare.

Enti, progetti e costi

Import/export

Definire modelli canonici dipendenti, progetti, ferie e consuntivi (modules/data-exchange/modelliCanonici.js — esistevano già senza nome dentro importPayloads; il quarto, le assenze, mancava davvero)
Definire interfacce e registry adapter (registroAdapter.js: cinque cose e non una di più, confidenza 0–1 invece di un booleano, e un adapter incompleto si rifiuta alla registrazione)
[~] Incapsulare formati attuali come adapter v1 (i tre lettori esistono — progettiSheet, tariffariSheet, personaleSheet, tariffeRealiSheet — ma non passano ancora dal registro: le rotte li chiamano dritti. Il registro è scritto e provato, non collegato)
Implementare nuovi formati come adapter separati (foglio PROGETTI e foglio TARIFFARI del file nuovo, più l'anagrafica del file BU come terza rotta)
Versionare detection, mapping e contratti
[~] Garantire staging, diff, approvazione e rollback (progetti, tariffari ed enti passano dallo staging e compaiono nel diff; l'anagrafica personale no — è un import diretto, e ciò che crea si cancella dalle schede)
Gestire più file di rendicontazione senza sovrascrivere (modalità ADD_ONLY: non cancella, non sovrascrive, ed elenca campo per campo ciò che non ha importato. Le altre tre presuppongono un file solo — Sync e Revisione proporrebbero di cancellare i progetti degli altri file)
Garantire idempotenza tenant-aware (reimportare aggiorna invece di raddoppiare: dipendenti, cataloghi, enti, tariffari, intervalli di costo e legami ente-tariffario hanno tutti un test che lo fissa)
Creare fixture anonimizzate e contract test

Consuntivo e consegna

Implementare actual_through_month per organizzazione (esisteva già come consolidated_until_month, mosso dall'import presenze; dal 18 agosto 2026 l'import rifiuta i mesi fuori sequenza e il forecast riparte dal mese successivo al cursore invece che da oggi)
Implementare delivered_through_month — per progetto, non per organizzazione (migrazione 117: ogni progetto ha il suo cursore di consegna, deciso dal committente il 18 agosto 2026; sostituisce freeze_config, che era un piano e non un fatto)
Implementare comando/permesso di consegna (PUT /projects/:id/consegna con storico in project_delivery_events; il permesso è quello di modifica del progetto, scelta del committente il 18 agosto 2026)
Creare snapshot/hash dei periodi consegnati
Bloccare modifiche a periodi consegnati in DB/API/UI (tre porte chiuse il 18 agosto 2026: il ricalcolo globale di un mese passato conserva i progetti già consegnati invece di rifiutare il mese, l'annullamento di un import consegnato è rifiutato, e le associazioni non si modificano nella parte consegnata — prolungarle nel futuro resta permesso)
Implementare dirty range per correzioni retroattive
[~] Ricalcolare tutti i periodi/progetti impattati (parziale: esiste il ricalcolo manuale per progetto dal cursore di consegna al mese consuntivato, con gli altri progetti riportati identici. Manca il dirty range automatico: nessuna modifica scatena il ricalcolo da sola)
Conservare versioni, motivazione e confronto prima/dopo
Rigenerare report aperti senza alterare snapshot consegnati

Forecasting

MVP avanzato

Completare flusso HR → progetto → forecast
Completare flusso consuntivo → correzione → consegna
Validare report dipendente e progetto
Eseguire UAT end-to-end con il committente
Risolvere finding bloccanti UAT
Ottenere sign-off MVP avanzato

Decisioni e baseline​

P0 — Organizzazione e sicurezza​

HR e risorse​

Ferie e disponibilità​

Enti, progetti e costi​

Import/export​

Consuntivo e consegna​

Forecasting​

MVP avanzato​

Uso LLM​

Release 1​