Documentazione MDM / qAlarm: stato del progetto e piano di lavoro¶
Ultimo aggiornamento: 29/10/2026 (revisione di coerenza).
Questa cartella descrive com'è fatto oggi il sistema di televigilanza (MDM, qAlarm, infrastruttura) e cosa bisogna fare per portarlo in produzione in modo affidabile. Serve a due tipi di lettori:
- persone non tecniche (direzione, centrale operativa, nuovi colleghi): partire da 01-panoramica;
- sviluppatori e coding agent: leggere prima AGENTS.md, poi la sezione che serve.
Come è organizzata¶
| Cartella | Cosa contiene | Per chi |
|---|---|---|
| guida-sistemista | Guida infrastruttura, rete, apparati, provisioning e fragilità | sistemisti, DevOps |
| 01-panoramica | Cos'è il servizio, a cosa serve, glossario, persone e ruoli, storia | tutti |
| 02-architettura | Componenti software, come parlano tra loro, flussi principali | tecnici |
| 03-infrastruttura | Server, rete, VPN, firewall, AWS, domini, backup | tecnici, sistemisti |
| 04-stato | Situazione attuale: versioni, dati, rischi, decisioni prese, domande aperte | tutti (la sintesi), tecnici (i dettagli) |
| 05-piano-operativo | Piano di lavoro dettagliato, in fasi, con attività, criteri di completamento e rollback | tutti (la sintesi), chi esegue (le attività) |
| 07-ticket | Ticket per dividere il lavoro tra Lorenzo e Mattia, con priorità, stima e criteri di accettazione | chi esegue, coordinamento |
| 06-runbook | Procedure operative: comandi di verifica, cosa non fare in prod, deploy, aggiornamenti | chi opera sui sistemi |
| fonti | Da dove vengono le informazioni e quanto sono affidabili | chi deve verificare |
../tools |
Script di supporto in sola lettura (es. censimento degli impianti) | chi opera sui sistemi |
Le sei cose da sapere subito¶
- Il servizio è critico. Protegge negozi, aziende e abitazioni (circa 70 impianti). Un errore su server, rete o VPN può lasciare scoperti tutti gli impianti insieme. Ogni modifica in produzione va preparata, provata in dev e reversibile.
- Convivono due sistemi. Il sistema vecchio (Telegram, progetto di Michele, software GANZ) gestisce ancora gli allarmi. Il sistema nuovo (MDM + qAlarm) è installato su 38 impianti, ma per ora serve a configurazione, comandi e video, non alla gestione degli allarmi. Vedi 01-panoramica/storia-e-contesto.md.
- Tutto passa da un solo server fisico e da un solo firewall. Il server è da Netsons (Milano), con Proxmox e un firewall pfSense virtuale che gestisce VPN e accessi. Se si ferma pfSense, si ferma tutto. Vedi 03-infrastruttura.
- Il nuovo midserver (v3) non è ancora pronto per la produzione. Mancano alcune funzioni, va provato insieme alla nuova versione dei box (linea
stage) e va reso aggiornabile senza fermo. Vedi 04-stato/parita-midserver-v3.md. - Michele, che conosce rete, VPN e sistema vecchio, lascia l'azienda (presente fino al 30/10/2026). Il passaggio di consegne è l'attività più urgente: T0.9 e le domande in 04-stato/domande-aperte.md.
- Il piano è in fasi, e la prima non tocca il codice: mettere in sicurezza e osservare l'esistente. Vedi 05-piano-operativo.
Regole per chi aggiorna questa documentazione¶
- Descrivere il comportamento attuale e citare la fonte: file del codice, comando eseguito, call, data.
- Separare chiaramente "com'è oggi" da "come vogliamo che sia".
- Mai scrivere password, token, chiavi, contenuti di
.env, nomi o dati dei clienti. Indirizzi IP e nomi dei server sono ammessi, perché servono a operare. - Ogni decisione nuova va in 04-stato/decisioni.md, con data e motivazione.
- Quando un'attività del piano è completata, aggiornare il suo stato in 05-piano-operativo/attivita.md.