PTT-Live/electron

PTT Live Desktop

Application desktop Electron pour gérer le serveur PTT Live.

🚀 Démarrage

# Depuis la racine du projet
./start-desktop.sh

# OU depuis electron/
cd electron
npm start

📦 Build pour distribution

cd electron

# macOS
npm run build:mac

# Linux
npm run build:linux

# Les deux
npm run build

Les builds seront dans electron/dist/.

🎨 Fonctionnalités

Dashboard

• ✅ Stats temps réel (uptime, utilisateurs, connexions)
• ✅ Liste utilisateurs connectés
• ✅ QR Code pour connexion rapide clients
• ✅ Contrôles démarrage/arrêt serveur

Configuration

• ✅ Sélection périphériques audio (input/output)
• ✅ Paramètres audio (sample rate, bitrate, jitter buffer)
• ✅ Sauvegarde automatique dans config.yaml

Groupes

• ✅ Liste groupes configurés
• ✅ Ajout/modification/suppression groupes
• ✅ Configuration bitrate par groupe

Monitoring

• 🚧 VU-mètres temps réel (WebSocket)
• 🚧 Graphiques latence
• 🚧 Stats réseau par client

Logs

• ✅ Logs serveur en temps réel
• ✅ Filtrage par niveau (error/warn/info/debug)
• ✅ Export logs

🏗️ Architecture

electron/
├── main.js          # Main Process (Node.js)
│                    # - Spawn serveur PTT Live
│                    # - IPC avec renderer
│                    # - Gestion tray icon
│
├── preload.js       # Bridge sécurisé IPC
│
└── ui/              # Renderer Process (Frontend)
    ├── index.html   # Interface dashboard
    ├── styles.css   # Styles
    └── app.js       # Logic frontend
                     # - Consomme API admin (/admin/*)
                     # - Met à jour UI

🔌 Communication

┌─────────────────────────────────────────┐
│         MAIN PROCESS (Node.js)          │
│  ┌──────────────────────────────────┐   │
│  │  Serveur PTT Live (spawn)        │   │
│  │  - LiveKit Server                │   │
│  │  - Audio Bridge                  │   │
│  │  - API REST :3000                │   │
│  └──────────────────────────────────┘   │
│              ↕ IPC                      │
│  ┌──────────────────────────────────┐   │
│  │  Electron Window                 │   │
│  └──────────────────────────────────┘   │
└─────────────────────────────────────────┘
              ↕ HTTP
┌─────────────────────────────────────────┐
│      RENDERER PROCESS (Frontend)        │
│  - Fetch API admin                      │
│  - WebSocket audio levels               │
│  - Interface dashboard                  │
└─────────────────────────────────────────┘

🛠️ API Utilisées

Toutes les routes de l'API admin serveur :

GET  /admin/stats              → Dashboard metrics
GET  /admin/users              → Utilisateurs connectés
GET  /admin/groups             → Liste groupes
POST /admin/groups             → Créer groupe
PUT  /admin/groups/:id         → Modifier groupe
DELETE /admin/groups/:id       → Supprimer groupe
GET  /admin/config             → Config complète
PUT  /admin/config/audio       → Mettre à jour config audio
GET  /admin/audio/devices      → Énumérer devices
POST /admin/audio/device       → Sélectionner device
GET  /admin/audio/routing      → Config routing
POST /admin/audio/routing      → Mettre à jour routing
GET  /admin/devices/list       → Auto-détection devices
GET  /admin/logs               → Logs serveur
WS   /audio-levels             → WebSocket VU-mètres

🔧 TODO

• Implémenter QR Code canvas (bibliothèque qrcode.js)
• WebSocket audio levels pour VU-mètres
• Notifications desktop (toast)
• Tray icon avec vraie icône
• Graphiques monitoring (Chart.js)
• Export logs (CSV/JSON)
• Auth admin (optionnel)
• Thème dark/light toggle
• Auto-update (electron-updater)

📝 Notes de développement

• Main Process : Gère le cycle de vie de l'app et spawn le serveur
• Renderer Process : Interface web, appelle l'API REST du serveur
• IPC : Communication sécurisée via contextBridge
• Serveur : Tourne dans un process child_process, logs transmis au renderer
• Port : 3000 par défaut (configurable via PORT env)

🐛 Debug

Ouvrir DevTools : automatique en mode --dev

npm run dev

Logs dans la console :

• [Serveur] : logs du serveur PTT Live
• [Serveur Error] : erreurs serveur
• ✅/❌ : statut démarrage/arrêt

📦 Packaging

electron-builder crée :

• macOS : .dmg + .app dans dist/mac/
• Linux : .deb + .AppImage dans dist/

Tester le build :

npm run build:mac
open dist/mac/PTT\ Live\ Server.app