iv3jdv 35f1598393 feat(ui): feedback visivo TX sui mini-badge della home
Implementato il riconoscimento dello stato di trasmissione nei mini-badge della schermata principale. I badge ora si illuminano mostrando '🎙️ TX' con bordo e ombreggiatura dinamica abbinata al colore del modo digitale attivo (DMR, YSF, NXDN, ecc.), prioritizzando la visibilità del transito.
2026-10-25 15:52:10 +01:00
2026-10-24 19:26:58 +02:00
2026-04-26 18:28:02 +02:00
2026-09-13 08:18:41 +02:00
2026-04-26 13:10:13 +02:00
2026-04-26 01:36:09 +02:00
2026-04-27 16:53:39 +02:00
2026-04-26 01:36:09 +02:00
2026-04-26 12:25:02 +02:00
2026-04-26 01:36:09 +02:00

📡 Fleet Control Console - Server (Central Hub)

🌍 Read in English | 🇮🇹 Leggi in Italiano


Dashboard Screenshot

🇬🇧 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 (v5.0+):

  • Modular Backend: Completely decoupled architecture (core/, services/, routes/) for high maintainability and robust background task handling.
  • Core Engine: Flask (Python) with gevent for high-concurrency WebSocket handling.
  • Database: SQLite (WAL mode) for robust User Management, Audit Logs, and Radio Traffic storage.
  • Communication: MQTT for instant data routing + WebSockets (SocketIO) for zero-latency UI updates.
  • Frontend: Vanilla JS with a modern Glassmorphism NOC (Network Operations Center) design and separated logic (app.js, modals.js).

✨ Ultimate Features

🛡️ Proactive Diagnostics (Watchdog)

  • Hardware Monitoring: Continuous analysis of remote CPU temperatures and disk space saturation. Automatically triggers Push Notifications before critical failures (e.g., CPU throttling or log overflow) occur.
  • RF Anomaly Detection: Real-time monitoring of local RF BER (Bit Error Rate). Detects hardware RF degradation on local transits and alerts admins instantly.

⚡ Zero-Latency Real-Time Dashboard

  • WebSocket Powered: The dashboard updates instantly upon radio traffic or telemetry changes. No heavy HTTP polling, no page reloads.
  • Live MQTT Status: A real-time badge continuously monitors the connection to the MQTT broker, instantly alerting you if the backend loses connectivity.
  • PWA Ready v6: Install the dashboard as a Progressive Web App on iOS/Android for a native, full-screen mobile experience with offline asset caching.

🔔 Web Push Notifications

  • Get instant, native alerts directly on your desktop or mobile device when:
    • A node goes offline or comes back online.
    • A critical system daemon crashes (Auto-healing failed).
    • The Watchdog detects thermal warnings, disk full alerts, or high RF BER.
  • Works securely even when the web app is closed or in the background.

🛠️ Advanced Remote Control & Maintenance

  • OTA Server Updates: Apply server-side Git updates with a single click directly from the admin dashboard (Over-The-Air) without SSH access.
  • Remote .INI Editor: Edit daemon configuration files (e.g., MMDVMHost.ini) directly from the web interface.
  • Service Management: Start, Stop, or Restart remote system daemons.
  • Global Overrides: Switch profiles (e.g., Profile A/B) or force updates simultaneously on all nodes in the fleet.
  • Hardware Interventions: Trigger a physical OS reboot or a hard GPIO reset of the MMDVM HAT directly from the web panel.

📊 Unified Monitoring & Statistics

  • Interactive Fleet Map: Real-time GIS map showing repeater locations, online/offline status, active TX states (pulsing pins), and active watchdog warnings.
  • Live Heard Log: A centralized view of radio traffic across the entire network, auto-resolving DMR and NXDN IDs into callsigns.
  • Software & Firmware Tracking: Instantly view MMDVM firmware versions and Pi-Star/Gateway component versions for each node.
  • Daily Analytics: Automatically tracks Top Talkgroups, Top Callsigns, Average duration, and daily transit counts.

🔐 Security & Access Control

  • Role-Based Access Control (RBAC): Create admin and operator accounts.
  • Granular Permissions: Restrict operators to view/control only specific repeaters.
  • Audit Trail: Every critical action (reboots, config edits, daemon restarts) is logged with the username, timestamp, and target node.

⚠️ Security Requirement: HTTPS

Please note that Web Push Notifications and the Service Worker require a secure connection to function. For security reasons, modern browsers only enable these features over HTTPS. If you are accessing the console via HTTP (outside of localhost), the "Push" button and notification registration will not work. We recommend using a reverse proxy (like Nginx, Caddy, or Traefik) with an SSL certificate.

⚠️ Reverse Proxy & WebSocket Configuration

If you expose the Fleet Console through a reverse proxy like Apache on a public IP (HTTPS), standard HTTP proxying will drop Socket.IO real-time connections. You must enable the WebSocket tunnel in Apache:

sudo a2enmod proxy_wstunnel rewrite headers

And insert the Rewrite rules before the ProxyPass directives inside your <VirtualHost *:443> block:

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/

🚀 Installation Guide

0. Root Privileges

All installation steps must be executed as the root user.

apt update
apt install build-essential python3-dev libssl-dev libffi-dev python3-pip python3-venv

1. Clone Repository

Clone the repository into the /opt directory to ensure all systemd paths work correctly:

git clone https://git.arifvg.it/iv3jdv/fleet-control-server.git /opt/fleet-control-server
cd /opt/fleet-control-server

To prevent conflicts with OS packages (PEP 668), create an isolated environment:

cd /opt/fleet-control-server
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip setuptools wheel
pip install -r requirements.txt

3. Configuration

  1. Copy config.example.json to config.json.
  2. Configure your MQTT broker credentials.
  3. Define your repeaters in clients.json.
  4. Generate VAPID keys at vapidkeys.com and add them to config.json to enable Web Push notifications. (Note: Push notifications require HTTPS).
  5. Configure dynamic log rotation sizes (log_max_mb and log_backup_count) directly in config.json to manage disk space.

4. Running as a Service

To run the server continuously in production using Gunicorn:

cp fleet-console.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable fleet-console
systemctl start fleet-console

(Ensure the .service file points to the gunicorn executable inside your venv).


🇮🇹 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 (DMR, NXDN, YSF, P25).

ℹ️ Nota: Questo è il repository del Server Centrale. Per monitorare i ripetitori, devi installare il Fleet Control Agent su ciascun nodo remoto.

🏗️ Architettura e Tecnologie

Il server agisce da cervello della rete, basato su fondamenta altamente scalabili (v5.0+):

  • Backend Modulare: Architettura completamente disaccoppiata (core/, services/, routes/) per un'elevata manutenibilità e gestione robusta dei task in background.
  • Motore Core: Flask (Python) con gevent per la gestione ad alta concorrenza dei WebSocket.
  • Database: SQLite (in modalità WAL) per gestire in sicurezza Utenti, Log operativi e traffico radio.
  • Comunicazione: MQTT per il routing istantaneo dei dati + WebSockets (SocketIO) per aggiornare la UI a latenza zero.
  • Frontend: Vanilla JS con un moderno design Glassmorphism in stile NOC (Network Operations Center) e logica completamente separata (app.js, modals.js).

✨ Funzionalità Principali

🛡️ Diagnostica Proattiva (Watchdog)

  • Monitoraggio Hardware: Analisi continua delle temperature CPU e della saturazione disco da remoto. Innesca automaticamente notifiche Push prima che si verifichino guasti critici (es. thermal throttling o blocco log MMDVM).
  • Rilevamento Anomalie RF: Monitoraggio in tempo reale del BER (Bit Error Rate) sul traffico RF locale. Rileva il degrado hardware in radiofrequenza avvisando istantaneamente gli amministratori.

⚡ Dashboard Real-Time a Latenza Zero

  • Motore WebSocket: La dashboard scatta all'istante al passaggio di traffico radio o ai cambi di telemetria. Nessun polling HTTP pesante, nessun refresh della pagina.
  • Stato MQTT Live: Un badge in tempo reale monitora continuamente la connessione al broker MQTT, avvisandoti istantaneamente in caso di problemi di rete.
  • PWA Ready v6: Installabile su smartphone Android e iOS come Progressive Web App per un'esperienza nativa a schermo intero con cache offline intelligente.

🔔 Notifiche Web Push

  • Ricevi avvisi nativi e immediati su PC o smartphone quando:
    • Un nodo va offline o torna operativo.
    • Un demone di sistema remoto si blocca (fallimento auto-healing).
    • Il Watchdog rileva allarmi termici, disco pieno o anomalie BER.
  • Funzionano in modo sicuro anche quando la web app è chiusa o in background.

🛠️ Controllo Remoto & Manutenzione Avanzata

  • Aggiornamenti Server OTA: Applica gli aggiornamenti del server tramite Git direttamente dalla dashboard di amministrazione (Over-The-Air) con un clic, senza usare SSH.
  • Editor .INI Remoto: Modifica i file di configurazione (es. MMDVMHost.ini) direttamente dal pannello web.
  • Gestione Demoni: Avvia, arresta o riavvia i servizi di sistema remoti.
  • Override Globali: Cambia i profili operativi (es. Profilo A/B) simultaneamente su tutta la rete.
  • Interventi Hardware: Innesca un riavvio del sistema operativo o un reset fisico (tramite pin GPIO) della scheda MMDVM.

📊 Monitoraggio & Statistiche

  • Mappa Interattiva di Flotta: Mappa GIS in tempo reale che mostra la posizione dei ripetitori, stato online/offline, trasmissione attiva (pin lampeggianti) e allarmi diagnostici in corso.
  • Log Ascolti Live: Vista unificata in tempo reale del traffico radio di tutta la rete, con traduzione automatica degli ID DMR e NXDN in nominativi.
  • Tracciamento Versioni: Controlla all'istante le versioni firmware MMDVM e software (Pi-Star/Gateway) a bordo di ciascun nodo.
  • Analisi Giornaliera: Statistiche automatiche su Top Talkgroups, Top Callsign, durata media e numero totale di transiti.

🔐 Sicurezza e Controllo Accessi

  • Gestione Ruoli (RBAC): Creazione di account admin e operator.
  • Permessi Granulari: Limita un operatore al controllo e alla visualizzazione di specifici ripetitori.
  • Audit Trail: Ogni azione critica (riavvii, modifiche file, gestione demoni) viene registrata con data, ora, utente e nodo di destinazione.

⚠️ Sicurezza Richiesta: HTTPS

Si prega di notare che le Notifiche Web Push e il Service Worker richiedono una connessione sicura per funzionare. Per motivi di sicurezza, i browser moderni abilitano queste funzionalità solo su HTTPS. Se accedi alla console via HTTP (al di fuori di localhost), il tasto "Push" e la registrazione delle notifiche non saranno attivi. Si consiglia l'uso di un reverse proxy (come Nginx, Caddy o Traefik) con certificato SSL.

⚠️ Configurazione Reverse Proxy & WebSocket

Se esponi la Fleet Console tramite un reverse proxy come Apache su IP pubblico (HTTPS), il proxy HTTP standard farà cadere continuamente la connessione in tempo reale di Socket.IO. Devi abilitare il tunnel WebSocket in Apache:

sudo a2enmod proxy_wstunnel rewrite headers

E inserire le regole di Rewrite prima del ProxyPass all'interno del tuo blocco <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/

🚀 Guida all'Installazione

0. Privilegi di Root

Tutti i passaggi di installazione devono essere eseguiti come utente root.

apt update
apt install build-essential python3-dev libssl-dev libffi-dev python3-pip python3-venv

1. Clonazione dei Repository

Clona il repository nella cartella /opt per assicurarti che tutti i percorsi dei servizi systemd siano corretti:

git clone https://git.arifvg.it/iv3jdv/fleet-control-server.git /opt/fleet-control-server
cd /opt/fleet-control-server

2. Setup Ambiente Virtuale (Consigliato)

Per evitare conflitti con i pacchetti di sistema (regola PEP 668), crea una "bolla" isolata:

cd /opt/fleet-control-server
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip setuptools wheel
pip install -r requirements.txt

3. Configurazione Base

  1. Copia config.example.json in config.json.
  2. Inserisci le credenziali del broker MQTT.
  3. Definisci i ripetitori nel file clients.json.
  4. Genera le chiavi VAPID su vapidkeys.com e inseriscile in config.json per attivare le notifiche Push. (Attenzione: le notifiche Push richiedono obbligatoriamente un certificato HTTPS).
  5. Configura le dimensioni della rotazione dei log (log_max_mb e log_backup_count) direttamente nel config.json per gestire lo spazio su disco.

4. Esecuzione come Servizio (systemd)

Per eseguire il server in produzione in modo continuo e stabile con Gunicorn:

cp fleet-console.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable fleet-console
systemctl start fleet-console

(Assicurati che il file .service punti all'eseguibile gunicorn situato all'interno della cartella venv).


Created by IV3JDV @ ARIFVG - 2026

S
Description
📡 Central Hub & Real-Time Dashboard for MMDVM networks. Features a WebSocket-driven UI, RBAC user management, Web Push notifications, and centralized telemetry. Acts as the brain of the ecosystem. Requires fleet-control-agent on remote nodes.
Readme
23 MiB
Languages
JavaScript 45.3%
Python 31.5%
HTML 14.5%
CSS 7.6%
Shell 1.1%