odg-readiness-check

name	odg-readiness-check
description	Visualizza e valida lo stato finalization ODG per una giornata specifica — 6 semafori compliance (cast/location/permessi/elementi/mezzi/pasti) + readiness interno + stato firma DP. Riusa engine esistenti T601 Compliance Matrix + T602 finalizationRules. Uso tipico: prima di firmare ODG, Direttore di Produzione invoca la skill per vedere a colpo d'occhio se la giornata è finalizzabile.

Skill: odg-readiness-check

Scopo

Il flusso firma ODG (T602) richiede che il Direttore di Produzione sappia in 5 secondi se una giornata può essere firmata. Questa skill:

1. Carica i moduli engine esistenti (lib/odg/finalizationRules.ts, lib/schedule/compliance/matrix.ts)
2. Genera uno snapshot testuale readable del OdgFinalizationState per il dayNumber richiesto
3. Se invocata in programming context, può validare che la UI (components/odg/ODGReadinessPanel.tsx) sta renderizzando correttamente
4. Se invocata in planning context (pre-firma), informa il DP sullo stato 6 semafori + blocker + warnings

Quando invocarmi

• L'utente dice "odg readiness", "check ODG day N", "semafori firma ODG", "/odg-readiness-check"
• Prima di invocare la UI firma DP su una giornata specifica
• Post-cambiamento upstream (drag strip, revoca permesso) per verificare staleness firma
• In development: come test vitale del compliance matrix engine

Prerequisiti

• Project esistente con schedule.strips popolato (scene + dayBreak)
• ComplianceContext completo (permits, castRoster, locationRoster, breakdown, troupe, rentals)
• Opzionale: signature esistente su DayOdg se già firmato (per test staleness)

Flusso

Step 1 — Parse input

Input atteso dall'utente:

• dayNumber (numerico, richiesto)
• projectId o context corrente (opzionale, default al progetto attivo)

Step 2 — Invoca engine

Carico via require/import:

import { computeFinalizationState, getOdgExportReadiness } from "@/lib/odg/finalizationRules";
import { buildComplianceMatrix, summarizeMatrix } from "@/lib/schedule/compliance/matrix";

Esecuzione (pseudocode):

1. const project = caricoProgetto(projectId)
2. const state = computeFinalizationState(project, dayNumber)
3. const exportReadiness = getOdgExportReadiness(state)

Step 3 — Rendering testuale output

Output strutturato:

## ODG Readiness — Giornata N del DD-MM-YYYY

**Stage**: <missing-odg | incomplete | blocked | ready-to-sign | finalized | stale>
**Can finalize**: <true | false>
**Export readiness**: <ready | draft | stale | blocked>

### 6 Semafori Compliance

- 🟢/🟡/🔴 Cast: <status> — <requirements met count> / <unmet count>
- 🟢/🟡/🔴 Location: <status>
- 🟢/🟡/🔴 Permessi: <status>
- 🟢/🟡/🔴 Elementi Chiave: <status>
- 🟢/🟡/🔴 Mezzi: <status>
- 🟢/🟡/🔴 Pasti: <status>

### Blocker (hard, bloccano firma)
- <lista>

### Warning (accettabili alla firma con DecisionMemo)
 


 Presente: 
 Firmato da: 
 Data firma: 
 Stato: 
 Se stale: motivo upstream change = 

Step 4 — Raccomandazione operativa

Basata su stage + blocker:

• ready-to-sign → "Puoi firmare. Invoca modal DirectorOfProductionSignature."
• blocked → "Risolvi N blocker prima di firmare: <top 3>. Chiama reparti responsabili."
• incomplete → "Completa ODG readiness interno prima: "
• missing-odg → "Genera ODG via generateOdgForDay(N) dal projectStore."
• finalized → "Già firmato da X. Nessuna azione richiesta."
• stale → "Stato cambiato dopo firma di X. Ri-firma richiesta (riapri modal pre-fill)."

Output

Report markdown con 6 semafori + blocker + warnings + raccomandazione.

Non modifica nulla nel progetto (read-only).

Esempi d'uso

Esempio 1 — DP matteo, giornata 5

Utente: "check ODG day 5"

Output:

## ODG Readiness — Giornata 5 del 15-05-2026

Stage: **blocked**
Can finalize: false
Export readiness: blocked

### 6 Semafori
- 🔴 Cast: missing (1 unmet) — Marco deal memo scaduto 14-05
- 🟢 Location: ok
- 🟢 Permessi: ok
- 🟡 Elementi chiave: not-configured (SpecialistDealMemo MVP)
- 🔴 Mezzi: missing — veicolo scena senza rental
- 🟡 Pasti: not-configured (MealPlan MVP)

### Blocker
1. [cast] Marco: deal memo scaduto il 2026-05-14 (ripresa 2026-05-15)
2. [mezzi] Picture car "Fiat Panda" in scena ma nessun rental veicoli attivo

### Warning
(nessuno)

### Firma DP
Presente: no

### Raccomandazione
Risolvi 2 blocker prima di firmare:
1. Casting director: rinnova deal memo Marco → oggi
2. Organizzatore generale: conferma rental veicolo → T-24h
Poi ri-esegui check.

Esempio 2 — giornata finalized, upstream change

Utente: "check ODG day 3 dopo drag strip"

Output identifica stage: stale + suggerisce ri-firma.

Integration con UI

La skill è complementare a components/odg/ODGReadinessPanel.tsx:

• UI = display interattivo per uso normale
• Skill = verifica rapida via chat/CLI, test engine, debugging

Troubleshooting

• Project not loaded: skill emette warning + suggerisce caricare progetto
• Day doesn't exist: skill ritorna "missing-odg" + suggerisce generateOdgForDay
• ComplianceContext incompleto: skill segnala campi mancanti nel context

Related skills

• /load-production-context (consigliato prima per contesto MMS/CCNL)
• /update-todo (per tracciare decisione post-firma)

Version + maintenance

• Version: 1.0 (created 2026-04-23 T1703)
• Maintained by: direttore-produzione-agent + workflow-state-machine-agent

References

• lib/odg/finalizationRules.ts (T602 logic)
• lib/schedule/compliance/matrix.ts (T601 compliance)
• content/knowledge-base/set-operations-realtime.md §2 (ODG sequencing)
• content/knowledge-base/produzione-italiana-compliance.md (CCNL + L.977/67 che alimentano compliance matrix)