📘 Ajout d’un README complet reconstitué

This commit is contained in:
2025-04-12 04:59:55 +02:00
parent 6360dff44c
commit 4a0953e847
2 changed files with 43 additions and 0 deletions

43
README.md Normal file
View File

@@ -0,0 +1,43 @@
# 🌡️ 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é.
---
## 🧩 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`**
---
## 🗂️ 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) |
---
## 🖥️ Installation locale (pour dev)
```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
pip install -r requirements.txt