wip

node_notifier/README.md

@@ -0,0 +1,226 @@
+# Node Notifier (Application principale)
+
+Point d'entrée principal du système de surveillance avec notifications Discord.
+
+## 📋 Description
+
+Cette crate constitue l'application principale qui orchestre la surveillance des ressources système et l'envoi de notifications Discord. Elle utilise les crates `system_monitor` et `discord_client` pour fournir un système de monitoring complet.
+
+## 🔧 Fonctionnalités
+
+- Orchestration du monitoring système
+- Gestion des configurations via variables d'environnement
+- Coordination entre surveillance et notifications
+- Point d'entrée unique pour l'application
+
+## 📦 Dépendances
+
+```toml
+[dependencies]
+dotenvy = "0.15.7"              # Gestion des fichiers .env
+discord_client = { path = "../discord_client" }    # Notifications Discord
+system_monitor = { path = "../system_monitor" }    # Surveillance système
+```
+
+## ⚙️ Configuration
+
+### Variables d'environnement
+
+Créez un fichier `.env` dans le répertoire racine du projet :
+
+```env
+# Obligatoire : URL du webhook Discord
+DISCORD_WEBHOOK=https://discord.com/api/webhooks/your/webhook/url
+```
+
+### Configuration Discord
+
+1. Accédez à votre serveur Discord
+2. Allez dans les paramètres du canal où vous voulez recevoir les notifications
+3. Créez un webhook et copiez l'URL
+4. Ajoutez l'URL dans votre fichier `.env`
+
+## 🚀 Utilisation
+
+### Exécution simple
+
+```bash
+cargo run
+```
+
+### Compilation et exécution
+
+```bash
+# Mode debug
+cargo build
+./target/debug/node-notifier
+
+# Mode release (optimisé)
+cargo build --release
+./target/release/node-notifier
+```
+
+### Exécution en tâche de fond
+
+```bash
+# Avec nohup
+nohup cargo run > monitoring.log 2>&1 &
+
+# Avec systemd (recommandé pour la production)
+# Voir section "Déploiement" ci-dessous
+```
+
+## 🔄 Flux d'exécution
+
+1. **Initialisation** : Chargement de la configuration depuis `.env`
+2. **Création du notifier Discord** : Configuration du client avec webhook
+3. **Initialisation du monitor système** : Création avec seuils par défaut
+4. **Vérification des seuils** : Contrôle des ressources système
+5. **Envoi d'alertes** : Notifications pour les seuils dépassés
+6. **Rapport final** : Synthèse complète des ressources
+
+## 🎛️ Personnalisation
+
+### Modification des seuils
+
+Pour personnaliser les seuils de surveillance, vous pouvez modifier le code pour utiliser `SystemMonitor::new_with_thresholds()` :
+
+```rust
+use system_monitor::{SystemMonitor, ResourceThreshold, get_cpu_usage};
+
+let custom_thresholds = vec![
+    ResourceThreshold::new(
+        "CPU".to_string(),
+        get_cpu_usage,
+        90.0, // Seuil à 90% au lieu de 80%
+        "CPU critique !".to_string(),
+    ),
+    // ... autres seuils
+];
+
+let mut monitor = SystemMonitor::new_with_thresholds(custom_thresholds);
+```
+
+### Avatar et nom du bot Discord
+
+Modifiez ces valeurs dans `main.rs` :
+
+```rust
+let notifier = DiscordNotifier::new(
+    webhook_url,
+    "Mon Monitor".to_string(),        // Nom personnalisé
+    "https://mon-site.com/avatar.png".to_string(), // Avatar personnalisé
+);
+```
+
+## 🚀 Déploiement
+
+### Service systemd (recommandé)
+
+1. Créez un fichier de service `/etc/systemd/system/node-notifier.service` :
+
+```ini
+[Unit]
+Description=Node Notifier System Monitor
+After=network.target
+
+[Service]
+Type=simple
+User=your-user
+WorkingDirectory=/path/to/node-notifier/node_notifier
+ExecStart=/path/to/node-notifier/target/release/node-notifier
+Restart=always
+RestartSec=10
+Environment=DISCORD_WEBHOOK=your-webhook-url
+
+[Install]
+WantedBy=multi-user.target
+```
+
+2. Activez et démarrez le service :
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable node-notifier
+sudo systemctl start node-notifier
+```
+
+### Cron (alternative)
+
+Pour une exécution périodique plutôt que continue :
+
+```bash
+# Exécution toutes les 5 minutes
+*/5 * * * * cd /path/to/node-notifier/node_notifier && /path/to/cargo run
+```
+
+## 📊 Logs et debugging
+
+### Activation des logs
+
+Ajoutez des logs pour le debugging :
+
+```bash
+RUST_LOG=debug cargo run
+```
+
+### Redirection des logs
+
+```bash
+# Logs dans un fichier
+cargo run > monitoring.log 2>&1
+
+# Logs avec rotation
+cargo run 2>&1 | tee -a monitoring.log
+```
+
+## 🔧 Dépannage
+
+### Erreurs courantes
+
+**"DISCORD_WEBHOOK environment variable not set"**
+```bash
+# Vérifiez votre fichier .env
+cat .env
+# Ou définissez directement
+export DISCORD_WEBHOOK="https://discord.com/api/webhooks/..."
+```
+
+**"Failed to send notification"**
+- Vérifiez la connectivité réseau
+- Validez l'URL du webhook Discord
+- Consultez les logs Discord pour les erreurs
+
+**Permissions système insuffisantes**
+- Certaines métriques peuvent nécessiter des privilèges élevés
+- Exécutez avec `sudo` si nécessaire
+
+## 🧪 Tests
+
+```bash
+# Tests unitaires
+cargo test
+
+# Tests avec logs
+RUST_LOG=debug cargo test
+
+# Tests spécifiques
+cargo test test_name
+```
+
+## 📈 Métriques
+
+L'application surveille par défaut :
+
+- **CPU** : Utilisation globale en pourcentage
+- **Mémoire** : RAM utilisée vs totale
+- **Swap** : Espace swap utilisé vs total  
+- **Disque** : Espace utilisé sur `/` et `/home`
+
+## 🔮 Extensions possibles
+
+- Configuration via fichier TOML/YAML
+- Support de multiples webhooks
+- Planification d'exécutions
+- Interface CLI avec arguments
+- Mode daemon avec rechargement de config