AI, approvazioni e operations¶

Questa è la parte della piattaforma che rende l’AI utile, ma soprattutto governabile.

Cosa include¶

Checklist
AI Assist
Task Runs
AI Approvals
Action Workbench
Execution Timeline
Approval Audit Chain
Role Twins
Prompt Packs
Chat workspace
Voice session
CEB Queue
CEB Dashboard
Ops Control Plane
Evidence Navigation
Release Gates

Problema che risolve¶

Senza questa area l’AI sarebbe solo un copilota testuale.
Con questa area diventa un motore controllato che:

riceve un task reale;
genera una proposta contestualizzata;
la sottopone a una persona accountable;
esegue solo ciò che è autorizzato;
registra receipts, stato ed evidenze;
rende recuperabile ogni run.

Flusso end-to-end¶

sequenceDiagram
    participant User as Reviewer o operator
    participant Checklist as ChecklistTask
    participant AI as AI Orchestrator
    participant Approval as Approval layer
    participant Exec as Action Executor
    participant Ops as Ops Control Plane
    participant Ledger as Evidence Ledger

    User->>Checklist: apre task o richiede AI Assist
    Checklist->>AI: crea TaskRun
    AI->>Approval: output + action plan proposto
    Approval->>User: workbench approvativo
    alt approved
        User->>Exec: conferma esecuzione
        Exec->>Ledger: receipts + domain effect
        Ledger->>Ops: stato e verifiche di coerenza
    else rejected or change requested
        User->>AI: note correttive
        AI->>Ledger: rigetto o nuova iterazione
    end

Oggetti fondamentali¶

Oggetto	Scopo
`ChecklistTask`	unità di lavoro di business o compliance
`TaskRun`	singola esecuzione AI o di sistema
`AIApproval`	esito umano su un run
`AiActionPlan`	piano di azioni materializzabili
`AiActionExecution`	singola esecuzione effettiva
`AiActionReceipt`	prova dell’effetto ottenuto
`WorkerLease`	ownership esclusiva dei worker critici
`ReconciliationIssue`	deviazione da invarianti o attese

Sottosistemi¶

Checklist¶

È il contenitore operativo:

assegnazione;
priorità;
stato;
evidenze;
note;
transizioni;
AI assist.

Run console¶

Espone la singola esecuzione AI:

prompt e contesto;
output;
stato run;
gate;
retry/cancel;
storico correlato.

Approvals¶

Il reviewer lavora su:

contenuto proposto;
intent dell’azione;
rischio dell’effetto;
note;
approvazione o rigetto.

Action workbench¶

Qui si vede l’effetto operativo vero:

action plan;
esecuzioni;
receipts;
timeline;
audit chain.

Role twins e prompt packs¶

Permettono di configurare il comportamento AI:

ruolo simulato;
tone of voice;
confini operativi;
pack istruzionali specializzati.

Ops Control Plane¶

Serve agli owner del sistema per:

vedere worker attivi;
leggere backlog e retry backlog;
individuare reconciliation issues;
eseguire retry o manual intervention;
valutare release gates.

Chi usa cosa¶

Ruolo	Superfici principali
Team AML	`/checklist`, `/checklist/:id`, `/ai/chat`
RFA / RSOS / DG	`/ai/approvals`, `/ai/approvals/:runId`, `/ai/run/:id`
SUPERADMIN	`/superadmin/dashboard-estesa`, `/superadmin/osservabilita/attivita`
Controllo / Audit	`/admin/ceb/dashboard`, `/admin/ceb/ops`, `/admin/ceb/evidence-nav`

UI chiave¶

/checklist
/checklist/dashboard
/checklist/:id
/ai/chat
/ai/run/:id
/ai/task/:id/runs
/ai/approvals
/ai/approvals/:runId
/ai/approvals/:runId/execution
/ai/approvals/:runId/audit-chain
/ai/role-twins
/ai/prompt-packs
/admin/ceb/queue
/admin/ceb/dashboard
/admin/ceb/ops
/admin/ceb/evidence-nav

API chiave¶

POST /api/checklist/:id/ai-assist
GET /api/ai-runs/:id
POST /api/ai-runs/:id/accept
POST /api/ai-runs/:id/cancel
POST /api/ai-runs/:id/gate/complete
GET /api/checklist/:id/ai-runs
GET /api/ai-approvals
POST /api/ai-approvals/:runId/approve
POST /api/ai-approvals/:runId/reject
GET /api/ceb/queue
GET /api/ceb/ops/overview
GET /api/ceb/release-gates

Evidenze prodotte¶

approval events;
action receipts;
execution timeline;
state transitions;
retry / manual intervention notes;
gate outcomes;
ledger entries.

Criterio di qualità¶

Questa area è corretta solo se il sistema sa dimostrare:

chi ha deciso;
cosa è stato proposto;
quale effetto è stato eseguito;
perché il task è in quello stato;
come recuperare se qualcosa fallisce.