# Procédure d'Installation (Bare-Metal) - PiAware Monitor

Ce guide détaille l'installation pas-à-pas sur une machine Linux (typiquement un Raspberry Pi sous Raspberry Pi OS, Debian ou Ubuntu).

## 1. Préparation du Système

Il est fortement recommandé de mettre à jour le système et de s'assurer que les outils Python de base sont installés.

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install python3 python3-venv python3-pip -y
```

## 2. Déploiement des Fichiers

Copiez le dossier contenant le code source sur votre machine cible.
Par défaut, nous supposerons que vous le placez dans `/home/pi/piaware`.

```bash
cd /home/pi
# Si vous utilisez le script de portabilité, décompressez l'archive ici :
# unzip piaware_export.zip -d piaware
cd piaware
```

## 3. Création de l'Environnement Virtuel Python

Pour ne pas polluer l'installation Python du système (requis sous Debian 12 / Bookworm) :

```bash
python3 -m venv venv
```

Activez l'environnement virtuel :

```bash
source venv/bin/activate
```

Installez les dépendances requises :

```bash
pip install --upgrade pip
pip install -r requirements.txt
```

## 4. Configuration

Copiez le fichier de configuration par défaut s'il n'existe pas, ou éditez `config.json` directement :

```bash
nano config.json
```

Exemple de contenu attendu :
```json
{
    "PIAWARE_IP": "127.0.0.1",
    "RECEIVER_LAT": 48.8566,
    "RECEIVER_LON": 2.3522,
    "HISTORY_RETENTION_DAYS": 30,
    "REFRESH_RATE": 5
}
```
* **PIAWARE_IP** : L'adresse IP de votre Raspberry Pi gérant dump1090. Laissez `127.0.0.1` si ce script tourne sur la même machine.
* **RECEIVER_LAT / LON** : Les coordonnées GPS exactes de votre antenne. Crucial pour calculer les distances !

Sauvegardez avec `Ctrl+O`, `Entrée`, puis quittez avec `Ctrl+X`.

## 5. Rendre les Scripts Exécutables

Assurez-vous que les scripts de contrôle ont les permissions d'exécution :

```bash
chmod +x start.sh stop.sh
```

## 6. Démarrage de l'Application

Vous pouvez maintenant lancer l'application en arrière-plan :

```bash
./start.sh
```

Vérifiez que tout fonctionne en consultant les logs :

```bash
tail -f app.log
```

## 7. Accès au Tableau de Bord

Ouvrez un navigateur web sur un ordinateur de votre réseau local :
**http://[IP_DE_VOTRE_RASPBERRY]:8000**

Pour arrêter proprement l'application :
```bash
./stop.sh
```
