Manutenzione Programmata e Interventi
Panoramica
Il modulo manutenzione consente ai distributori di pianificare, eseguire e tracciare gli interventi tecnici sui punti vendita del proprio portafoglio. I servizi di manutenzione operano nel database reseller-scoped (r_{resellerCode}), garantendo visibilita cross-tenant per il distributore.
Servizi di Manutenzione
Il backend espone sei servizi dedicati alla gestione della manutenzione, tutti basati su ResellerDbMixin:
| Servizio | Funzione |
|---|---|
| manutenzioni | Registro interventi e storico |
| manutenzioni-scheduled | Pianificazione interventi ricorrenti |
| manutenzioni-checklist | Template checklist per tipo intervento |
| manutenzioni-parts | Gestione ricambi e materiali |
| manutenzioni-reports | Reportistica interventi |
| manutenzioni-calendar | Vista calendario per pianificazione |
Pianificazione Interventi
Interventi Ricorrenti
Lo scheduler automatico permette di configurare interventi periodici:
- Accedere a Manutenzione > Pianificazione > Nuovo Intervento Ricorrente
- Selezionare il tipo di intervento (manutenzione preventiva, aggiornamento, pulizia)
- Definire la frequenza: giornaliera, settimanale, mensile, trimestrale
- Assegnare il tecnico responsabile
- Selezionare i punti vendita interessati
Lo scheduler itera automaticamente sui reseller registrati (non sui singoli tenant) per generare gli interventi programmati.
Interventi su Richiesta
Per interventi non pianificati (guasti, richieste urgenti):
- Accedere a Manutenzione > Nuovo Intervento
- Selezionare il punto vendita dalla lista delle installazioni
- Descrivere il problema o l'attivita richiesta
- Assegnare priorita (bassa, media, alta, critica) e tecnico
- Pianificare data e fascia oraria
Esecuzione dell'Intervento
Checklist Operativa
Ogni tipo di intervento puo avere una checklist predefinita con i passaggi da eseguire:
- Verifica funzionamento stampanti fiscali
- Controllo stato sincronizzazione dispositivi
- Aggiornamento versione applicazione
- Test connettivita di rete
- Verifica backup dati locali
Il tecnico spunta ogni voce durante l'intervento, documentando eventuali anomalie.
Accesso Remoto
Per interventi che richiedono accesso ai dati del punto vendita, il tecnico apre una sessione di supporto:
- Dalla scheda intervento, cliccare Avvia Sessione Supporto
- Il sistema genera un token temporaneo con scope limitato
- La sessione viene tracciata nell'audit log
- Al termine, la sessione si chiude automaticamente
Questo meccanismo garantisce che ogni accesso remoto sia documentato e legato a uno specifico intervento di manutenzione.
Ricambi e Materiali
Per interventi che richiedono sostituzione di componenti:
- Registrare i ricambi utilizzati (modello, seriale, quantita)
- Il sistema aggiorna l'inventario accessori dell'installazione
- La cronologia dei ricambi e consultabile dalla scheda dell'installazione
Reportistica
Report per Intervento
Ogni intervento completato genera un report che include:
- Data e durata dell'intervento
- Tecnico assegnato e ore lavorate
- Checklist completata con annotazioni
- Ricambi utilizzati
- Sessioni di supporto attivate (con link all'audit log)
- Stato finale (risolto, in attesa ricambio, da ripianificare)
Report Aggregati
La sezione reportistica offre viste aggregate:
- Per punto vendita: storico interventi, frequenza guasti, costi manutenzione
- Per tecnico: carico di lavoro, interventi completati, tempi medi
- Per periodo: trend interventi mensili, confronto anno su anno
- Per tipo: distribuzione tra preventiva, correttiva e straordinaria
Scheduler Automatico
Lo scheduler esegue periodicamente le seguenti operazioni:
- Generazione interventi ricorrenti in base alla pianificazione configurata
- Invio notifiche ai tecnici per interventi in scadenza
- Escalation per interventi non completati entro la data prevista
- Aggiornamento stato installazioni con alert di manutenzione scaduta
In ambiente di sviluppo, la variabile DEV_RESELLER_CODE consente di testare lo scheduler con un reseller specifico.
FAQ
D: Come ricevo notifiche per interventi urgenti? R: Gli interventi con priorita "critica" generano notifiche email immediate al tecnico assegnato e al responsabile del distributore. Gli interventi ad alta priorita vengono notificati entro un'ora.
D: Posso assegnare piu tecnici allo stesso intervento? R: Si, ogni intervento supporta un tecnico principale e uno o piu tecnici di supporto. Tutti i tecnici assegnati hanno visibilita sulla scheda intervento.
D: Lo storico interventi e accessibile al cliente finale?
R: No, i dati di manutenzione risiedono nel database reseller (r_{resellerCode}) e sono visibili solo dal distributore. Il cliente vede unicamente le sessioni di supporto nel proprio audit log.
Vedi Anche
- Gestione Installazioni -- Anagrafica punti vendita e dispositivi
- Accesso Supporto -- Sessioni di supporto tecnico
- Guida Distributore -- Panoramica piattaforma per reseller