Glossario¶
In ordine alfabetico. Tra parentesi i sinonimi usati nelle call o nel codice.
| Termine | Significato |
|---|---|
| Ajax | Marca di sistemi antintrusione. Alcuni clienti hanno centrali Ajax, gestite da un servizio AWS separato (qalarm-ajax). Alcuni sistemi Ajax hanno un altoparlante che funziona come una tromba. |
| Allarme / evento | Segnalazione generata dal detector quando vede qualcosa in una zona protetta. Contiene foto e, con Frigate, aggiornamenti successivi della stessa "review". |
| API | Interfaccia con cui un programma chiede qualcosa a un altro programma via rete. |
| AWS | Amazon Web Services, il cloud usato per archiviare codice (CodeCommit), immagini Docker (ECR), file (S3), segreti e alcune funzioni. Regione Irlanda (eu-west-1). |
3.8, 3.9, linea stage |
La prossima versione del software dei box (branch stage di mdm_installation). Nelle analisi e nelle decisioni fino al 28/10 è chiamata "3.8"; dal 03/08 la versione è la 3.9.0-stage. Nei documenti operativi si usa "linea stage" o "nuova versione". Arriva ai clienti solo unita in main (D22). |
| Box / installazione / impianto (lato software) | Il computer Linux installato dal cliente con il software mdm_installation. Identificato dal suo MAC. |
| Centrale operativa (centrale) | Gli operatori in azienda che gestiscono gli allarmi 24 ore su 24. |
| Cluster (master/slave) | Configurazione con più box nello stesso impianto: uno "master" distribuisce i comandi agli altri. Ultimo lavoro di Franco, poco documentato. |
| CodeBuild / CodeCommit | Servizi AWS: CodeCommit ospita i repository git, CodeBuild costruisce le immagini Docker. |
| Coolify | Piattaforma che semplifica il deploy delle applicazioni su un server. Oggi c'è solo un Coolify dev. |
| Detector | Il componente che analizza i video. GANZ: apparato fisico/software commerciale, con licenza. Frigate: software open source con intelligenza artificiale. |
| Disinserimento / inserimento (arm / disarm) | Spegnere o accendere la protezione dell'impianto. |
| Docker / container | Modo di impacchettare un programma con tutto quello che gli serve. Sui server e sui box ogni servizio gira in un container. |
| ECR | Registro AWS delle immagini Docker. |
| eWeLink / Sonoff | Relè comandabili via cloud, usati per riavviare a distanza l'impianto quando è bloccato o per aprire porte e cancelli. |
| FreePBX / Asterisk | Il centralino telefonico che gestisce le trombe via SIP. |
| Frigate wrapper | Programma che fa da ponte tra il box e Frigate. |
| GANZ | Vedi Detector. Gli impianti più vecchi hanno un PC Windows con il server GANZ. |
| KFT | Software di gestione allarmi per camion (telemetria), usato dalla centrale. Non fa parte di MDM. |
| MAC (indirizzo MAC) | Identificativo unico della scheda di rete del box. Il midserver identifica ogni box con il suo MAC. |
| MDM | Nome interno del nuovo sistema di televigilanza (box + midserver + pannello). Si è detto di volerlo rinominare. |
| Midserver (mid server) | Il server centrale del sistema nuovo: riceve stato ed eventi dai box, inoltra i comandi, alimenta qAlarm. |
| MQTT / Mosquitto | Protocollo di messaggistica leggero con cui midserver e box si scambiano comandi ed eventi. Mosquitto è il server MQTT. |
| NAT / port forward | Regole del firewall che traducono un indirizzo in un altro. Esempio: chi chiama 172.16.16.253 dalla VPN arriva al midserver 170.10.0.108. |
| Netsons | Il fornitore del server fisico (datacenter a Milano). |
| NPM (Nginx Proxy Manager) | Programma che oggi, sul server di prod, smista il traffico web verso pannello e API e gestisce i certificati. |
| OME (OvenMediaEngine) | Server di streaming video: riceve il video dai box e lo rende visibile nel pannello, in qAlarm e nell'app. |
| Pannello MDM (panel, web panel) | Interfaccia web interna per configurare e controllare i box. |
| pfSense | Il firewall virtuale che gestisce internet, VPN e accessi per tutte le macchine sul server Netsons. |
| PIN / IO config | Gestione di una scheda di ingressi/uscite collegata al box (chiave di inserimento, relè sirena). PIN è la versione vecchia, IO config la nuova. Nessuno dei 38 box attuali ha la scheda PIN. |
| Privacy mode | Funzione che "oscura" telecamere a impianto disinserito, deviando il traffico di rete (ARP spoofing). |
| Protexia | App mobile per i clienti e marchio del servizio. |
| Proxmox | Il software che divide il server fisico in più macchine virtuali (VM). |
| qAlarm (vecchio) | Web app esistente per gli allarmi di telemetria (veicoli). |
| qAlarm 2 (nuovo) | La nuova console per gli operatori, nata per la videosorveglianza. Deve sostituire Telegram e unificare gli strumenti. |
| Redis | Database in memoria, velocissimo. Nel midserver contiene lo stato dei box e la coda degli eventi verso qAlarm. |
| Rolling update / zero-downtime | Aggiornare un servizio senza interromperlo: la nuova versione parte prima che la vecchia venga spenta. |
| Telegram | App di messaggistica usata oggi per ricevere gli allarmi in centrale. Ha limiti (blocca l'invio se arrivano troppe foto) e non è sotto il nostro controllo. |
| Tromba | Altoparlante IP installato dal cliente. Riproduce messaggi registrati (via API) o permette di parlare (via SIP). |
| v2 / v3 (midserver) | v2 = midserver Flask, in produzione. v3 = riscrittura FastAPI (refactor/v1), in dev. |
| VM | Macchina virtuale dentro Proxmox. |
| VPN (WireGuard) | Rete privata cifrata. Ogni impianto ha un suo "peer" con un indirizzo 172.16.16.x. |