| 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:
- Carica i moduli engine esistenti (
lib/odg/finalizationRules.ts, lib/schedule/compliance/matrix.ts)
- Genera uno snapshot testuale readable del
OdgFinalizationState per il dayNumber richiesto
- Se invocata in programming context, può validare che la UI (
components/odg/ODGReadinessPanel.tsx) sta renderizzando correttamente
- 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)
