Programmazione e Report

A cosa serve

• Distribuire ordini tra tecnici in base a capacità e ubicazione.
• Rispettare finestre di manutenzione della produzione.
• Minimizzare spostamenti tra stabilimenti o zone.

Come funziona

Lo scheduler risolve un problema di assegnazione considerando skill del tecnico, ubicazione dell'asset, finestre autorizzate e SLA pendenti. Il supervisore può forzare manualmente.

Report programmati

Puoi configurare report automatici che vengono generati e consegnati periodicamente con informazioni sui tuoi piani di manutenzione.

Creare un report programmato

1. Vai a Manutenzione > Report Programmati.
2. Clicca su Nuovo Report.
3. Configura i parametri:

Frequenze disponibili

Preset di branding

I report programmati possono utilizzare un preset di branding salvato per mantenere un'identita visiva coerente:

Per collegare un branding a un report programmato, usa il campo branding_id:

{
  "name": "Report Settimanale di Manutenzione",
  "frequency": "weekly",
  "format": "pdf",
  "branding_id": "branding_abc123",
  "day_of_week": 0,
  "hour": 8
}

Integrazione con Cloud Scheduler

I report programmati vengono eseguiti attraverso un endpoint interno invocato da Google Cloud Scheduler:

POST /internal/run-scheduled-reports

Flusso di esecuzione

1. Cloud Scheduler invoca l'endpoint a intervalli regolari.
2. Il sistema controlla tutti i report abilitati di tutti i tenant.
3. Per ogni report, verifica se e il momento di eseguirlo in base alla sua frequenza e ora configurata.
4. Genera il report nel formato specificato (PDF o Excel).
5. Consegna il report al canale configurato (email o WhatsApp).
6. Aggiorna last_run_at e calcola next_run_at.

Sicurezza dell'endpoint

L'endpoint interno e protetto da:

• HMAC Secret — L'header X-Scheduler-Secret deve corrispondere al segreto configurato.
• Senza JWT — Non richiede autenticazione utente, solo il segreto dello scheduler.

Mettere in pausa e riprendere i piani

Puoi mettere in pausa temporaneamente un piano di manutenzione senza eliminarlo. La pausa disabilita l'esecuzione automatica e registra l'azione nel trail di audit.

Mettere in pausa un piano

1. Seleziona il piano da Manutenzione > Piani.
2. Clicca su Pausa.
3. Opzionalmente, inserisci un motivo (max 500 caratteri).

Quando metti in pausa un piano:

Riprendere un piano

1. Seleziona il piano in pausa.
2. Clicca su Riprendi.

Quando riprendi un piano:

Trail di audit

Tutte le azioni di pausa e ripresa vengono registrate nel trail di audit immutabile:

{
  "action": "pause",
  "resource_type": "maintenance_plan",
  "resource_id": "plan_abc123",
  "actor": "user_xyz",
  "actor_type": "user",
  "details": { "reason": "Apparecchiatura in riparazione maggiore" },
  "timestamp": "2026-03-25T10:30:00Z"
}

Questo permette di tracciare chi ha messo in pausa o ripreso un piano, quando e perche.

Protezione di idempotenza

Il sistema include molteplici meccanismi per garantire che i piani non vengano eseguiti in modo duplicato:

Esecuzione manuale dei report

Oltre all'esecuzione automatica, puoi generare qualsiasi report programmato immediatamente:

1. Vai a Manutenzione > Report Programmati.
2. Seleziona il report.
3. Clicca su Esegui Ora.

L'esecuzione manuale aggiorna last_run_at ma non modifica next_run_at. Il report viene consegnato immediatamente al canale configurato.

Benefici chiave

• Assegnazione ottimizzata per skill e ubicazione.
• Rispetta automaticamente le finestre di produzione.
• Minimizza spostamenti — meno tempo morto.
• Forzatura manuale per casi eccezionali.
• Visibilità preventiva del piano della settimana.