Runbook: preparare e rivedere un Issue

Quando usarlo

Usare questo runbook per selezionare un Topic accettato, generare un draft, correggerlo e portarlo a una decisione editoriale senza pubblicarlo.

Prerequisiti

• identità umana con i permessi necessari;
• Topic accepted;
• almeno un Knowledge Asset accepted collegato;
• provider AI e Queue disponibili per la generazione;
• nessun job attivo duplicato per lo stesso lavoro;
• comprensione che review e pubblicazione sono separate.

Procedura

1. Aprire il catalogo Topic e rileggere stato e revisione.
2. Verificare la copertura Knowledge Asset.
3. Nel workspace Issue selezionare il Topic e avviare una sola generazione.
4. Registrare il job e monitorare queued o running entro una finestra bounded.
5. Su completed, aprire l'Issue associato.
6. Rivedere JSON canonico, Topic, Knowledge Asset, riferimenti e quality report.
7. Correggere esplicitamente il draft usando expectedRevision.
8. Se il contenuto cambia, rileggere la nuova revisione e il quality report.
9. Nel workspace review assegnare un reviewer umano quando necessario.
10. Eseguire approve o reject; non pubblicare.

Verifiche attese

• job completato e associato allo stesso Topic;
• Issue draft;
• quality gate verdi;
• editorialStatus terminale coerente con la decisione;
• reviewer e timestamp autorevoli;
• nessuna pubblicazione o operazione provider email.

Condizioni di stop

Fermarsi su Topic non accettato, copertura assente, job ambiguo, revisione stantia, quality failure irrisolto, reviewer non autenticato o permesso assente.

Rollback o recupero

Un draft non pubblicato non richiede rollback. Su job fallito usare recupero generazione. Su modifica errata, rileggere la revisione e salvare una nuova correzione; non cancellare l'audit.

Evidenza da conservare

• Topic e job selezionati;
• stato terminale del job;
• Issue e draft revision;
• esito quality;
• decisione review e reviewer;
• conferma che pubblicazione, Campaign Draft, scheduling e delivery non sono avvenuti.