📝 Mise à jour du README avec badges et aperçu Streamlit

This commit is contained in:
2025-04-12 05:06:13 +02:00
parent 4a0953e847
commit f6a51209da

View File

@@ -1,43 +1,52 @@
# 🌡️ Gestion des sondes domotiques
Ce projet permet la **surveillance en temps réel des températures** pour plusieurs chambres froides réparties sur différents sites, avec alertes, interface graphique, et déploiement automatisé.
[![Version Python](https://img.shields.io/badge/Python-3.10-blue)](https://python.org)
[![Licence](https://img.shields.io/badge/Licence-Propriétaire-orange)](https://mj91.fr:448/michel/Gestion_sondes)
[![Gitea](https://img.shields.io/badge/Gitea-auto--hébergé-green)](https://mj91.fr:448)
Application de **surveillance des températures** avec alertes, visualisation Streamlit, et déploiement automatisé via Gitea + Supervisor.
---
## 🧩 Fonctionnalités principales
- ✅ Relevé de température avec capteurs **DS18B20** et **DHT22**
- ✅ Envoi des valeurs toutes les 5 min sur **serveur MQTT**
- ✅ Analyse des données sur un **VPS avec MySQL**
- ✅ Détection des dépassements de seuils > 30 minutes
- ✅ Génération d'alertes **Email / Telegram**
- ✅ Interface de visualisation **Streamlit** (app.domo91.fr)
- ✅ Supervision via **Supervisor** pour les scripts critiques
- ✅ Déploiement simplifié avec **Gitea + script `deploy.sh`**
- 🔍 Lecture de capteurs **DS18B20** et **DHT22**
- 📨 Transmission via **MQTT**
- 📊 Interface **Streamlit** (app.domo91.fr)
- 🔔 Alertes **email / Telegram** si dépassement > 30 minutes
- 🧠 Déploiement auto avec **`deploy.sh`**
- 🧾 Stockage SQL sur **MySQL (VPS)**
---
## 📊 Exemple de visualisation
Voici un aperçu dun graphique dans linterface Streamlit :
![Exemple de graphique Streamlit](https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Matplotlib_figure.svg/800px-Matplotlib_figure.svg.png)
---
## 🗂️ Structure du projet
| Fichier | Rôle |
|-----------------------------|----------------------------------------------------------------------|
| `Monitor.py` | Analyse les températures et génère les alertes |
| `Streamlit.py` | Interface web de visualisation (hébergée sur app.domo91.fr) |
| `Cuisine_saclay.py` | Script spécifique au site de Saclay |
| `Cuisine_meudon.py` | Script spécifique à Meudon |
| `Purge_Alertes_saclay.py` | Nettoyage périodique des anciennes alertes |
| `check_supervisor.py` | Vérifie létat des services supervisés |
| `requirements.txt` | Liste des dépendances Python |
| `deploy.sh` | Script de déploiement auto (pull + restart services Supervisor) |
| Fichier | Description |
|-----------------------------|---------------------------------------------------------------------|
| `Monitor.py` | Analyse de température et alertes |
| `Streamlit.py` | Interface graphique web |
| `Cuisine_saclay.py` | Script capteur pour le site de Saclay |
| `Cuisine_meudon.py` | Script capteur pour Meudon |
| `check_supervisor.py` | Vérifie létat des scripts supervisés |
| `deploy.sh` | Déploiement auto depuis Gitea (branche `product`) |
| `requirements.txt` | Dépendances Python |
---
## 🖥️ Installation locale (pour dev)
## 🧪 Installation locale
```bash
git clone https://mj91.fr:448/michel/Gestion_sondes.git
cd Gestion_sondes
python -m venv .venv
source .venv/bin/activate # sous Linux/macOS
.venv\Scripts\activate # sous Windows
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows
pip install -r requirements.txt