Files
mqtt_explorer/README.md
Gilles Soulier 383ad292d3 first
2025-12-24 14:47:39 +01:00

48 lines
1.5 KiB
Markdown
Executable File

# MQTT Web Explorer - Monokai Pro
Interface web moderne pour l'exploration de brokers MQTT avec backend persistant en Go.
## Caractéristiques
- **Backend Go**: Connexion continue même quand l'onglet est fermé.
- **SQLite**: Historique complet des messages stocké localement.
- **UI Monokai**: Thème sombre haute fidélité pour les développeurs.
- **Explorateur CLI**: Arbre hiérarchique intelligent avec filtres regex.
- **Payload Intelligent**: Détection automatique de JSON et Images Base64.
- **Responsive**: Compatible Desktop, Tablette et Mobile.
## Lancement rapide
### Via Docker (Recommandé)
```bash
docker compose up -d --build
```
L'application sera disponible sur `http://localhost:8088`.
### Développement local (Backend)
```bash
cd backend
go run ./cmd/server
```
### Développement local (Frontend)
```bash
cd frontend
npm install
npm run dev
```
## Structure du projet
- `backend/`: Serveur Go (Gin + Paho MQTT + SQLite).
- `frontend/`: Client React (Tailwind + Lucide + Vite).
- `doc/`: Analyses détaillées et documentation technique.
- `docker-compose.yml`: Orchestration des services (Mosquitto + App).
## Configuration
Les variables d'environnement suivantes peuvent être configurées :
- `MQTT_BROKER`: URL du broker (default: tcp://broker.hivemq.com:1883)
- `SQLITE_DB`: Chemin de la DB (default: ./data/mqtt.db)
- `TTL_DAYS`: Durée de conservation des messages (default: 7)
- `MQTT_SUBSCRIBE`: Topic de souscription par défaut (default: #)
- `MQTT_QOS`: QoS par défaut (default: 0)