Workflow — Introduzione

Il motore workflow di Clack permette di definire e personalizzare i processi operativi per ogni commessa: quali stati può attraversare un Ordine di Lavoro, un Ticket o una Segnalazione, chi può eseguire le transizioni, e quali azioni vengono intraprese automaticamente.

Cos'è un workflow

Un workflow è un insieme di stati e transizioni che descrivono il ciclo di vita di un elemento:

• Un Ordine di Lavoro (ODL) nasce in stato "In attesa", poi diventa "In esecuzione", poi "Eseguito"
• Una Segnalazione nasce "In attesa", viene presa in carico, lavorata e infine chiusa
• Un Ticket raggruppa più ODL e segue un ciclo parallelo

Ogni commessa in Clack può avere la propria configurazione workflow, personalizzata in base alle esigenze contrattuali e operative del cliente.

Gli elementi del workflow

Stati (Places)

Ogni stato rappresenta una fase del ciclo di vita. Ogni stato appartiene a uno dei tre macro-stati:

Macro-stato	Colore	Significato
In attesa (pending)	Grigio/Arancione	L'elemento è stato creato ma non è ancora iniziato
In corso (ongoing)	Blu/Verde	L'elemento è in lavorazione attiva
Completato (complete)	Verde	L'elemento ha raggiunto uno stato finale

Oltre ai tre macro-stati base, le commesse possono definire stati intermedi personalizzati. Ogni stato ha:

• Un'etichetta leggibile (es. "In attesa", "In esecuzione", "Eseguito")
• Un macro-stato di appartenenza
• Policy specifiche per le azioni eseguibili in quello stato

Transizioni

Le transizioni sono i passaggi da uno stato all'altro. Ogni transizione ha:

• Uno stato di partenza (from)
• Uno stato di arrivo (to)
• I ruoli autorizzati a eseguire la transizione
• Eventuali condizioni che devono essere soddisfatte (es. "l'ODL deve essere assegnato a un ticket")

Azioni workflow disponibili

Per gli Ordini di Lavoro (ODL):

Azione	Descrizione
Do	Segna l'ODL come eseguito
Start	Avvia l'esecuzione dell'ODL
Pause	Sospende temporaneamente l'ODL
Resume	Riprende un ODL sospeso
Validate	Valida il completamento dell'ODL
Cancel	Cancella l'ODL
Reject	Rifiuta l'ODL
Fail	Segna l'ODL come fallito
Noop	Marca l'ODL come non eseguibile
Complain	Segnala un reclamo sull'ODL

Per i Ticket:

Azione	Descrizione
Start	Avvia il ticket (mette in esecuzione gli operatori)
Pause	Sospende il ticket
Restart	Riavvia un ticket sospeso
Close	Chiude il ticket

Per le Segnalazioni (Issue):

Le transizioni delle segnalazioni seguono la stessa logica degli ODL, con stati personalizzabili per commessa.

Perché il workflow è per commessa

Ogni contratto di manutenzione ha esigenze diverse:

• Alcuni clienti richiedono una fase di "verifica" prima della chiusura
• Alcuni contratti prevedono stati specifici per la rendicontazione
• I ruoli autorizzati a certi passaggi variano da cliente a cliente

Per questo motivo, la configurazione workflow è salvata nella commessa e non è condivisa globalmente. Questo permette la massima flessibilità operativa.

Approfondimenti

• Configurazione Workflow — Come impostare stati, transizioni e permessi
• Stati e Transizioni — Tabelle degli stati e chi può fare cosa