📡 Fleet Control Console - Server (Central Hub) v6.0.0
🌍 Read in English | 🇮🇹 Leggi in Italiano
🇬🇧 English
Fleet Control Console is a professional, real-time command and control (C2) dashboard designed for amateur radio repeater networks (MMDVM). This repository contains the Server (Central Hub) component, which provides a centralized web interface to monitor and manage a fleet of remote digital voice nodes (DMR, NXDN, YSF, P25).
ℹ️ Note: This is the Central Server repository. To monitor remote repeaters, you must install the Fleet Control Agent on each node.
🏗️ Architecture & Technology Stack
The server acts as the brain of the network, built on a highly scalable foundation (v6.0.0):
- Modular Backend: Completely decoupled architecture (
core/,services/,routes/) for high maintainability and robust background task handling. - Core Engine: Flask (Python) with
geventfor high-concurrency WebSocket handling. - Database: SQLite (WAL mode) for robust User Management, Audit Logs, Schedules, and Radio Traffic storage.
- Communication: MQTT for instant data routing + WebSockets (SocketIO) for zero-latency UI updates.
- Frontend: Vanilla JS with a modern Glassmorphism Borderless Executive NOC (Network Operations Center) design. Full i18n (Internationalization) support for English and Italian.
✨ Ultimate Features (v6.0.0)
🗓️ Calendar Profile Scheduler [NEW]
- Plan automated profile switches (e.g., Regional Nets, Contests, Civil Defense drills) across multiple nodes.
- Seamless background execution: the system automatically triggers the
Target Profileat the specified start time and gracefully falls back to theRestore Profileonce the event ends.
🗺️ Tactical APRS Map [NEW]
- Real-time GIS map showing both your fixed repeater locations and roaming APRS stations.
- Automatically extracts and parses APRS payloads from gateway logs.
- Features a smart Garbage Collector that automatically cleans up roaming pins after 2 hours of inactivity.
🛠️ Advanced Remote Control & Visual Diff [NEW]
- Time Machine Config Editor: Edit daemon configuration files (e.g., MMDVMHost.ini) directly from the web interface, with the ability to rollback to previous historical backups.
- Semantic Visual Diff: Compare your local unsaved edits against the running config with a rich Green/Red semantic diff viewer before safely committing changes to the node.
- OTA Server Updates: Apply server-side Git updates directly from the admin dashboard without SSH access.
- Service Management & Hardware: Start/Stop/Restart remote daemons, trigger physical OS reboots, or hard GPIO resets of the MMDVM HAT.
📈 Dynamic Analytics & Monitoring [NEW]
- Timeframe Analytics: Interactive historical charts (Chart.js) for CPU/Temp and RF Transits/BER. Zoom dynamically across 12H, 24H, 48H, or 7D timeframes with smart axis labeling.
- Live WebSocket Console: Zero-latency terminal streams for node daemons. Real-time active operator tracking (see who is logged in and managing the dashboard).
- Proactive Diagnostics (Watchdog): Continuous analysis of remote CPU temperatures, disk space, and RF BER. Triggers automated Web Push Notifications.
🔐 Strict Security & Access Control
- Role-Based Access Control (RBAC): True Zero-Trust architecture. Node management is bound to explicitly assigned nodes (
allowed_nodes) for both Operators and Node Admins. - System Administration: Admins retain exclusive rights to global server settings, schedules, and user management.
- Security Audit Trail: Every critical action (reboots, config edits, schedules) is securely logged with username, timestamp, and target node.
⚠️ Security Requirement: HTTPS
Web Push Notifications and the Service Worker require a secure connection. Modern browsers only enable these features over HTTPS. We recommend using a reverse proxy (like Nginx, Caddy, or Apache) with an SSL certificate.
⚠️ Reverse Proxy & WebSocket Configuration
If using a reverse proxy like Apache on HTTPS, you must enable WebSocket tunneling:
sudo a2enmod proxy_wstunnel rewrite headers
Insert the Rewrite rules before the ProxyPass directives in your <VirtualHost *:443>:
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule /(.*) ws://127.0.0.1:9000/$1 [P,L]
RewriteCond %{HTTP:Upgrade} !=websocket [NC]
RewriteRule /(.*) http://127.0.0.1:9000/$1 [P,L]
ProxyPass /socket.io/ ws://127.0.0.1:9000/socket.io/
ProxyPassReverse /socket.io/ ws://127.0.0.1:9000/socket.io/
ProxyPass / http://127.0.0.1:9000/
ProxyPassReverse / http://127.0.0.1:9000/
🇮🇹 Italiano
Fleet Control Console è una dashboard di comando e controllo (C2) professionale in tempo reale, progettata per le reti di ripetitori radioamatoriali (MMDVM). Questo repository contiene il Server (Central Hub), che fornisce un'interfaccia web centralizzata per monitorare e gestire una flotta di nodi digitali remoti.
ℹ️ Nota: Questo è il repository del Server Centrale. Per monitorare i ripetitori, devi installare il Fleet Control Agent su ciascun nodo remoto.
🏗️ Architettura e Tecnologie (v6.0.0)
- Backend Modulare: Architettura completamente disaccoppiata (
core/,services/,routes/) per un'elevata manutenibilità e gestione asincrona. - Motore Core: Flask (Python) con
geventper la gestione ad alta concorrenza dei WebSocket. - Database: SQLite (in modalità WAL) per gestire Utenti, Log Sicurezza, Schedulazioni e traffico radio.
- Frontend Bilingue: Vanilla JS con layout Borderless Executive in stile NOC. Traduzioni dinamiche (Inglese/Italiano) attivabili in tempo reale.
✨ Funzionalità Principali v6.0.0
🗓️ Calendario Pianificazione Profili [NUOVO]
- Schedula i cambi di profilo automatici (es. Net Regionali, Contest, Esercitazioni) su nodi multipli.
- Esecuzione in background: il sistema innesca il
Profilo Targetall'orario di inizio e ripristina automaticamente ilProfilo di Ritornoalla scadenza della finestra temporale.
🗺️ Mappa Tattica APRS [NUOVO]
- Mappa GIS in tempo reale che mostra sia i ripetitori fissi che i passanti APRS in mobilità.
- Intercetta e formatta istantaneamente i payload APRS dai log dei gateway.
- Include un sistema di pulizia automatica (Garbage Collector) che rimuove i pin mobili dopo 2 ore di inattività.
🛠️ Editor Avanzato & Visual Diff [NUOVO]
- Editor Config .INI "Macchina del Tempo": Modifica i file operativi direttamente dal pannello web, con possibilità di ripristinare i backup storici salvati automaticamente nel database.
- Visual Diff Semantico: Controlla visivamente le differenze (in verde le aggiunte, in rosso le rimozioni) tra le tue modifiche in bozza e la configurazione attualmente in esecuzione prima di salvare.
- Interventi Hardware & Servizi: Avvia/arresta demoni, forza il riavvio del SO o esegui un reset hardware GPIO sulla scheda MMDVM.
📈 Analitiche Dinamiche & Console Live [NUOVO]
- Grafici Temporali: Analizza l'andamento di CPU/Temp e Transiti/BER esplorando finestre temporali dinamiche da 12 Ore fino a 7 Giorni, con rendering fluido via Chart.js.
- Console WebSocket: Terminale a latenza zero per analizzare i log dei demoni.
- Tracciamento Operatori: Visualizza in tempo reale quali amministratori sono connessi e operativi sulla dashboard.
- Watchdog Proattivo: Analisi continua di surriscaldamenti e degrado RF, con avvisi inviati via notifiche Web Push.
🔐 Sicurezza e Controllo Accessi
- Role-Based Access Control (RBAC): Gestione nodi limitata esclusivamente ai ripetitori assegnati (
allowed_nodes) per Operatori enode_admin. - Audit Trail di Sicurezza: Ogni comando operativo e configurazione viene tracciato con timestamp, utente e obiettivo.
⚠️ Sicurezza Richiesta: HTTPS
Le Notifiche Web Push e il Service Worker richiedono obbligatoriamente una connessione HTTPS per funzionare. Si consiglia l'uso di un reverse proxy (come Apache o Nginx) con certificato SSL Let's Encrypt.
