Piani di Manutenzione

Configura piani di manutenzione preventiva con trigger a calendario o contatore, percorsi multi-asset e generazione automatica di attivita.

A cosa serve

Definire cadenza preventiva per ogni asset critico.
Standardizzare le checklist per ruolo e tipo di intervento.
Generare ordini di lavoro in anticipo senza intervento manuale.

Come funziona

Crei un piano definendo l'asset, la frequenza (calendario, ore, cicli), la checklist dei passi e il ruolo richiesto. Lo scheduler genera gli ordini di lavoro in anticipo con lead time configurabile.

Cosa sono i piani di manutenzione

I piani di manutenzione preventiva permettono di programmare attivita ricorrenti per i tuoi asset industriali. Ogni piano definisce quando eseguire la manutenzione, quale attivita viene generata automaticamente e chi viene notificato.

Un piano puo applicarsi a uno o piu asset, attivarsi per tempo o per utilizzo, e generare attivita con tutte le informazioni necessarie per il tecnico.

Tipi di trigger

Ogni piano ha un tipo di trigger che determina quando viene eseguito:

Trigger	Descrizione
Calendar	Viene eseguito automaticamente in base a una frequenza e intervallo configurati (es: ogni 30 giorni)
Counter	Viene eseguito quando un contatore raggiunge una soglia definita (es: ogni 500 ore di funzionamento)

Trigger a calendario

Il piano calcola automaticamente la data next_due_at in base alla frequenza e all'intervallo.

Frequenza	Esempio
hours	Ogni 8 ore
days	Ogni 30 giorni
weeks	Ogni 2 settimane
months	Ogni 3 mesi

Quando viene eseguito un piano a calendario, il sistema ricalcola automaticamente la prossima data di esecuzione.

Trigger a contatore

Il piano monitora un campo contatore (counter_field) e si attiva quando current_counter raggiunge il counter_threshold.

{
  "trigger": "counter",
  "counter_field": "operating_hours",
  "counter_threshold": 500
}

Dopo l'esecuzione, il contatore si resetta a zero automaticamente.

Percorsi multi-asset

Un piano puo applicarsi a piu asset utilizzando il campo asset_ids. Il sistema verifica che tutti gli asset esistano prima di creare il piano.

{
  "asset_ids": ["asset_id_1", "asset_id_2", "asset_id_3"]
}

Se fornisci un singolo asset_id, il sistema lo normalizza automaticamente in asset_ids con un solo elemento. Entrambe le forme sono compatibili.

Configurazione dell'attivita generata

Quando un piano viene eseguito, genera automaticamente un'attivita con i seguenti campi:

Campo	Descrizione
task_title_template	Template per il titolo dell'attivita. Se non definito, usa `"{nome_piano} — {nome_asset}"`
task_priority	Priorita dell'attivita: low, medium, high, urgent. Default: medium
department_id	Dipartimento a cui viene assegnata l'attivita
assigned_to	Persona responsabile dell'esecuzione della manutenzione

L'attivita generata include un codice unico automatico (es: MAN-001) basato sul dipartimento.

Canali di notifica

Quando configuri un piano, puoi attivare notifiche automatiche inviate quando viene generata un'attivita:

Canale	Campi richiesti
Email	`notify_email: true` + `notification_email_account_id` (account email attivo)
WhatsApp	`notify_whatsapp: true` + `notification_whatsapp_number_id` (numero WhatsApp connesso)
In-app	Le attivita appaiono automaticamente nella bacheca Kanban

Le notifiche richiedono che la persona assegnata abbia dati di contatto (email o telefono). Se mancanti, il sistema genera un avviso ma crea l'attivita normalmente.

Lista di verifica

Ogni piano puo includere una lista di verifica (checklist) che viene copiata nell'attivita generata:

{
  "checklist": [
    "Verificare livello olio",
    "Ispezionare tensione cinghie",
    "Controllare filtri",
    "Registrare letture vibrazioni"
  ]
}

Durata stimata

Il campo estimated_duration_minutes permette di stimare quanto tempo richiede la manutenzione. Questo valore viene usato per calcolare la data di scadenza dell'attivita generata.

Se definito, la data di scadenza = momento di esecuzione + durata stimata.
Se non definito, la data di scadenza = momento di esecuzione + 24 ore.

Abilitare e disabilitare

Ogni piano ha un campo enabled che controlla se viene eseguito automaticamente:

enabled: true — Il piano viene valutato ad ogni ciclo dello scheduler.
enabled: false — Il piano viene ignorato fino alla riattivazione.

Disabilitare un piano non cancella la cronologia di esecuzione ne modifica la data della prossima esecuzione.

Creare un piano

Vai a Manutenzione > Piani.
Clicca su Nuovo Piano.
Completa la configurazione:

Campo	Obbligatorio	Descrizione
Nome	Si	Nome descrittivo del piano (max 200 caratteri)
Descrizione	No	Dettagli aggiuntivi sulla manutenzione
Asset	Si	Uno o piu asset a cui si applica il piano
Trigger	No	calendar (default) o counter
Frequenza	No	hours, days, weeks, months (solo calendar)
Intervallo	No	Numero di unita di frequenza (default: 30)
Soglia contatore	No	Valore che attiva l'esecuzione (solo counter)
Priorita attivita	No	low, medium, high, urgent
Dipartimento	No	Dipartimento responsabile
Assegnato a	No	Persona responsabile
Notifica via Email	No	Attiva notifica via email
Notifica via WhatsApp	No	Attiva notifica via WhatsApp
Durata stimata	No	Minuti stimati per il completamento
Checklist	No	Lista di verifica per il tecnico

Benefici chiave

Generazione automatica di ordini preventivi.
Cadenza per calendario, ore o cicli operativi.
Checklist standardizzate per ruolo.
Lead time configurabile per pianificazione.
Integrazione con compliance per audit regolatori.

Piani di Manutenzione

In questa pagina