Ordini di Lavoro Avanzati
Dipendenze tra attivita, tracciamento del tempo, riepilogo costi, checklist con progresso, commenti e metriche.
Panoramica
Gli ordini di lavoro avanzati estendono le attivita base con funzionalita aggiuntive per gestire progetti di manutenzione complessi. Includono dipendenze tra attivita, tracciamento dettagliato di tempo e costi, e metriche di prestazione.
Dipendenze tra attivita
Le attivita possono avere dipendenze che controllano l'ordine di esecuzione.
Tipi di dipendenza
| Tipo | Descrizione |
|---|---|
blocks | L'attivita corrente blocca l'attivita dipendente |
blocked_by | L'attivita corrente e bloccata da un'altra attivita |
related | Relazione informativa senza blocco |
Creare una dipendenza
{
"task_id": "tsk_001",
"depends_on": "tsk_002",
"type": "blocked_by"
}Rilevamento dipendenze circolari
Il sistema valida automaticamente che non vengano creati cicli di dipendenza:
tsk_001 → blocked_by → tsk_002 → blocked_by → tsk_001 (RIFIUTATO)Se viene rilevata una dipendenza circolare, l'operazione viene rifiutata con un errore
400 Bad Request che include la catena di dipendenze che forma il ciclo.
Stato di blocco
Un'attivita bloccata non puo passare allo stato in_progress finche tutte le sue
dipendenze non sono risolte. La dashboard mostra un indicatore visivo di blocco.
Tracciamento del tempo
Ogni attivita consente di registrare il tempo lavorato dai tecnici.
Registrare il tempo
{
"task_id": "tsk_001",
"user_id": "usr_tech_01",
"started_at": "2026-03-25T08:00:00Z",
"ended_at": "2026-03-25T10:30:00Z",
"notes": "Sostituzione cuscinetti del motore principale"
}Riepilogo del tempo
GET /api/v1/work-orders/{task_id}/time-entries| Metrica | Descrizione |
|---|---|
total_hours | Ore totali registrate |
estimated_hours | Ore stimate alla creazione dell'attivita |
variance | Differenza tra stimato e reale |
entries_count | Numero di registrazioni di tempo |
Il tracciamento del tempo e facoltativo. Se non vengono registrate voci, le metriche temporali si basano sui timestamp di cambio stato dell'attivita.
Riepilogo dei costi
Ogni attivita accumula costi da diverse fonti:
| Categoria | Descrizione |
|---|---|
labor | Costo della manodopera (ore x tariffa) |
parts | Ricambi utilizzati |
external | Servizi esterni appaltati |
other | Altri costi associati |
Registrare un costo
{
"task_id": "tsk_001",
"category": "parts",
"description": "Cuscinetto SKF 6205",
"quantity": 2,
"unit_cost": 35.50,
"currency": "USD"
}GET /api/v1/work-orders/{task_id}/costsChecklist con progresso
La checklist di un'attivita mostra il progresso di completamento in tempo reale.
Struttura
{
"checklist": [
{ "id": "chk_01", "text": "Togliere energia all'apparecchiatura", "completed": true },
{ "id": "chk_02", "text": "Rimuovere componente danneggiato", "completed": true },
{ "id": "chk_03", "text": "Installare componente nuovo", "completed": false },
{ "id": "chk_04", "text": "Verificare allineamento", "completed": false },
{ "id": "chk_05", "text": "Test di funzionamento", "completed": false }
],
"progress": 40
}Il campo progress viene calcolato automaticamente come percentuale degli elementi completati.
Commenti
I commenti consentono la comunicazione del team nel contesto dell'attivita.
{
"task_id": "tsk_001",
"user_id": "usr_tech_01",
"content": "Serve una gru per rimuovere il motore. Richiedo supporto.",
"attachments": ["photo_motor.jpg"]
}Funzionalita
- Testo libero con supporto per allegati (immagini, documenti)
- Notifica automatica ai partecipanti dell'attivita
- Storico cronologico completo
- Menzione utenti con
@utente
Metriche degli ordini di lavoro
GET /api/v1/work-orders/metrics?department_id=dept_01&period=last_30d| Metrica | Descrizione |
|---|---|
mttr | Tempo Medio di Riparazione (Mean Time To Repair) |
backlog_count | Attivita in sospeso nel backlog |
completion_rate | Tasso di completamento nel periodo |
on_time_rate | Percentuale completate entro la scadenza |
avg_cost | Costo medio per ordine di lavoro |
rework_rate | Percentuale di attivita riaperte |
Le metriche vengono aggiornate ogni ora e sono disponibili nella dashboard con grafici di tendenza e confronti tra periodi.