============================================================
       INSTALLATION GUIDE - FLEET CONTROL CONSOLE
============================================================

This guide describes the steps to install the Central 
Dashboard and the Remote Agents on MMDVM nodes.

------------------------------------------------------------
1. PRE-REQUISITES
------------------------------------------------------------
Ensure Python 3 is installed on all systems.
The necessary dependencies are listed in the 
'requirements.txt' file.

Install dependencies:
   pip install -r requirements.txt

------------------------------------------------------------
2. SERVER SETUP (CENTRAL HUB)
------------------------------------------------------------
The server handles the web interface and user permissions.

Steps:
1. Configure 'config.json' using 'config.example.json' as a template.
2. Enter MQTT credentials and VAPID keys.
3. Define repeaters in the 'clients.json' file.
4. Start the server: 
   python3 app.py

------------------------------------------------------------
3. GENERATING VAPID KEYS (PUSH NOTIFICATIONS)
------------------------------------------------------------
Required to enable browser and mobile notifications.

1. Go to https://vapidkeys.com/ and generate the keys.
2. Copy 'Public Key' and 'Private Key' into 'config.json'.
3. Set 'vapid_claim_email' (e.g., "mailto:your@email.com").

------------------------------------------------------------
4. AGENT SETUP (REMOTE NODES)
------------------------------------------------------------
To be installed on each Raspberry Pi / MMDVM Node.

1. Copy 'system_monitor.py' and 'node_config.json' to 
   '/opt/node_agent/'.
2. Edit 'node_config.json' with a unique 'client_id'.
3. (Optional) Install 'RPi.GPIO' for hardware reset.

------------------------------------------------------------
5. RUNNING AS A SERVICE (SYSTEMD)
------------------------------------------------------------
For auto-start and process monitoring.

Configuration:
1. Copy .service files to '/etc/systemd/system/':
   - Server: sudo cp fleet-console.service /etc/systemd/system/
   - Nodes: sudo cp fleet-agent.service /etc/systemd/system/
2. Reload systemd: 
   sudo systemctl daemon-reload
3. Enable start on boot: 
   sudo systemctl enable fleet-console (or fleet-agent)
4. Start the service: 
   sudo systemctl start fleet-console


============================================================
       GUIDA ALL'INSTALLAZIONE - FLEET CONTROL CONSOLE
============================================================

Questa guida descrive i passaggi per installare la Dashboard
Centrale e gli Agenti Remoti sui nodi MMDVM.

------------------------------------------------------------
1. REQUISITI PRELIMINARI
------------------------------------------------------------
Assicurarsi di avere Python 3 installato su tutti i sistemi.
Le dipendenze necessarie sono elencate nel file 
'requirements.txt'.

Installazione dipendenze:
   pip install -r requirements.txt

------------------------------------------------------------
2. SETUP DEL SERVER (HUB CENTRALE)
------------------------------------------------------------
Il server gestisce l'interfaccia web e i permessi.

Passaggi:
1. Configura 'config.json' partendo da 'config.example.json'.
2. Inserisci le credenziali MQTT e le chiavi VAPID.
3. Definisci i ripetitori nel file 'clients.json'.
4. Avvia il server: 
   python3 app.py

------------------------------------------------------------
3. GENERAZIONE CHIAVI VAPID (NOTIFICHE PUSH)
------------------------------------------------------------
Necessarie per abilitare le notifiche su browser e mobile.

1. Vai su https://vapidkeys.com/ e genera le chiavi.
2. Copia 'Public Key' e 'Private Key' nel 'config.json'.
3. Imposta 'vapid_claim_email' (es. "mailto:tua@email.com").

------------------------------------------------------------
4. SETUP DELL'AGENTE (NODI REMOTI)
------------------------------------------------------------
Da installare su ogni Raspberry Pi / Nodo MMDVM.

1. Copia 'system_monitor.py' e 'node_config.json' in 
   '/opt/node_agent/'.
2. Modifica 'node_config.json' con il 'client_id' univoco.
3. (Opzionale) Installa 'RPi.GPIO' per il reset hardware.

------------------------------------------------------------
5. ESECUZIONE COME SERVIZIO (SYSTEMD)
------------------------------------------------------------
Per l'avvio automatico e il monitoraggio del processo.

Configurazione:
1. Copia i file .service in '/etc/systemd/system/':
   - Server: sudo cp fleet-console.service /etc/systemd/system/
   - Nodi: sudo cp fleet-agent.service /etc/systemd/system/
2. Ricarica systemd: 
   sudo systemctl daemon-reload
3. Abilita l'avvio al boot: 
   sudo systemctl enable fleet-console (oppure fleet-agent)
4. Avvia il servizio: 
   sudo systemctl start fleet-console

------------------------------------------------------------
Created by IV3JDV @ ARIFVG - 2026
============================================================