Actualiser README.md

This commit is contained in:
2025-04-19 06:33:07 +00:00
parent 5a4fed2c16
commit c78dbfa0c7

118
README.md
View File

@@ -1,52 +1,130 @@
# 🌡️ Gestion des sondes domotiques # 🔌 Gestion des sondes domotiques
[![Version Python](https://img.shields.io/badge/Python-3.10-blue)](https://python.org) ![Python](https://img.shields.io/badge/Python-3.10-blue?logo=python)
[![Licence](https://img.shields.io/badge/Licence-Propriétaire-orange)](https://mj91.fr:448/michel/Gestion_sondes) ![Licence](https://img.shields.io/badge/Licence-Propriétaire-red)
[![Gitea](https://img.shields.io/badge/Gitea-auto--hébergé-green)](https://mj91.fr:448) ![Gitea](https://img.shields.io/badge/Gitea-actif-success)
![Hébergement](https://img.shields.io/badge/Hébergement-auto--géré-informational)
Application de **surveillance des températures** avec alertes, visualisation Streamlit, et déploiement automatisé via Gitea + Supervisor. Application de **surveillance des températures** avec alertes, visualisation Streamlit, et déploiement automatisé via Gitea + Supervisor.
--- ---
## 🧩 Fonctionnalités principales ## 🌟 Fonctionnalités principales
- 🔍 Lecture de capteurs **DS18B20** et **DHT22** - 🔢 Lecture de capteurs **DS18B20** et **DHT22**
- 📨 Transmission via **MQTT** - 📡 Transmission via **MQTT**
- 📊 Interface **Streamlit** (app.domo91.fr) - 🌐 Interface Streamlit ([app.domo91.fr](https://app.domo91.fr))
- 🔔 Alertes **email / Telegram** si dépassement > 30 minutes - ⚠️ Alertes email / Telegram si dépassement > 30 minutes
- 🧠 Déploiement auto avec **`deploy.sh`** - 🚀 Déploiement auto avec `deploy.sh`
- 🧾 Stockage SQL sur **MySQL (VPS)** - 📁 Stockage **SQL** sur MySQL (VPS)
--- ---
## 📊 Exemple de visualisation ## 📈 Exemple de visualisation
Voici un aperçu dun graphique dans linterface Streamlit : 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) ![Exemple de graphique Streamlit](https://via.placeholder.com/600x200.png?text=Graphique+Streamlit)
--- ---
## 🗂️ Structure du projet ## 📂 Structure du projet
| Fichier | Description | | Fichier | Description |
|-----------------------------|---------------------------------------------------------------------| |----------------------|----------------------------------------------|
| `Monitor.py` | Analyse de température et alertes | | `Monitor.py` | Analyse de température et alertes |
| `Streamlit.py` | Interface graphique web | | `domo91.py` | Interface graphique web |
| `Cuisine_saclay.py` | Script capteur pour le site de Saclay | | `Cuisine_saclay.py` | Script capteur pour le site de Saclay |
| `Cuisine_meudon.py` | Script capteur pour Meudon | | `Cuisine_meudon.py` | Script capteur pour Meudon |
| `check_supervisor.py` | Vérifie létat des scripts supervisés | | `check_supervisor.py`| Vérifie létat des scripts supervisés |
| `deploy.sh` | Déploiement auto depuis Gitea (branche `product`) | | `deploy.sh` | Déploiement auto depuis Gitea (branche `product`) |
| `requirements.txt` | Dépendances Python | | `requirements.txt` | Dépendances Python |
--- ---
## 🧪 Installation locale ## 🛠️ Installation locale
```bash ```bash
git clone https://mj91.fr:448/michel/Gestion_sondes.git # Clone depuis Gitea
cd Gestion_sondes git clone https://mj91.fr:448/michel/gestion_sondes.git
cd gestion_sondes
# Environnement virtuel
python -m venv .venv python -m venv .venv
source .venv/bin/activate # Linux/macOS source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows .venv\Scripts\activate # Windows
pip install -r requirements.txt pip install -r requirements.txt
```
---
## 🏛️ Architecture globale
- Données temps réel envoyées par ESP8266 (MQTT)
- Base MySQL avec tables par site (`Saclay`, `Meudon`, `Roissy`...)
- Script `Monitor.py` tournant en boucle 5 minutes (avec `supervisord`)
- Application Streamlit avec login / rôle (accès personnalisé)
- Alertes par Email / Telegram, PDF générables depuis lapp
---
## 🧰 Bases de données principales
### 📉 Températures
- Tables : `Saclay`, `Meudon`, etc. (même structure)
- Champs : `Id`, `Sonde`, `Temperature`, `Date`
### ⚠️ Alertes
- Tables : `Alertes_Saclay`, `Alertes_Meudon`, etc.
- Champs : `Id`, `Sonde`, `Debut_defaut`, `Etat` (En cours, Acquitté, Test...)
### 🏢 Chambres froides (seuils)
- Table : `Chambres_froides`
- Champs : `Id`, `Lieu`, `Sonde`, `Temp_Max`, `Etat` (ON/OFF)
### 🔐 Authentification
- Table : `MotsDePasse`
- Champs : `Utilisateur`, `MotDePasse`, `Lieu`, `Role`
### 📅 Inventaires
- Champs : `Id_inventaire`, `Id_Article`, `Quantité`, `Prix`, `Date`
- Remplissage via Excel nettoyé par macro VBA ou formulaire
---
## 💪 Monitor.py
- 🔄 Boucle toutes les 5 minutes
- ⚠️ Déclenche une alerte si seuil dépassé pendant 30 minutes
- ✅ Acquittement automatique quand retour à la normale
- 📧 Notifications par Email + Telegram
---
## 💼 Bonnes pratiques Git
- Branche `develop` : développement
- Branche `product` : version stable (protégée)
- Pas de push direct sur `product`
- Utiliser `pull --rebase` pour éviter les conflits
- `deploy.sh` pour déploiement manuel si besoin
---
## 🌟 Idées damélioration
- 📱 Alertes SMS via API (Twilio ou OVH)
- 📊 Historique détaillé + export CSV
- 📋 Récap PDF automatique chaque matin
- 📆 Maintenance planifiée avec calendrier
- 🌐 Tableau de bord multi-sites consolidé
---
## 📖 Auteur & contact
Projet développé par [Michel]
Site principal : [https://app.domo91.fr](https://app.domo91.fr)
Gitea auto-hébergé sur : [https://mj91.fr](https://mj91.fr)