Files
Gestion_sondes/README.md
2025-04-19 11:42:01 +02:00

98 lines
5.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 📡 Gestion des sondes domotiques
Application de **surveillance des températures** avec alertes, visualisation, export PDF, gestion utilisateurs, et déploiement automatisé via Gitea + Supervisor.
---
## 🔧 Fonctionnalités principales
- 📥 Lecture de capteurs DS18B20 et DHT22
- 📤 Transmission des relevés via MQTT
- 🌐 Interface Streamlit sécurisée (https://app.domo91.fr)
- 🧠 Détection de dépassement de seuil (30 min)
- 🚨 Alertes automatiques (Test / En cours / Acquitté)
- 📲 Notifications : email, Telegram (à venir : SMS)
- 📄 Génération de rapports PDF journaliers
- 👥 Gestion utilisateurs + droits daccès par site
- 🔁 Déploiement automatisé via `deploy.sh`
- 💾 Stockage sur base MySQL distante (VPS)
---
## 🖼️ Exemple de visualisation
*Affichage des relevés + seuil sur graphique interactif :*
![Exemple Streamlit](PDF/exemple_graphique.png)
---
## 📁 Structure du projet
| Fichier | Description |
|------------------------|-------------|
| `Monitor.py` | Analyse des températures, génération d'alertes |
| `domo91.py` | Interface utilisateur Streamlit |
| `Cuisine_saclay.py` | Script capteur pour le site de Saclay |
| `Cuisine_meudon.py` | Script capteur Meudon |
| `check_supervisor.py` | Vérifie le statut des scripts supervisés |
| `deploy.sh` | Déploiement auto vers VPS |
| `requirements.txt` | Dépendances Python |
---
## 🧪 Génération dalertes de test
Depuis linterface (une fois connecté) :
👉 Menu latéral > **Test alerte manuelle**
Permet d'injecter une alerte "Test" pour vérifier le bon fonctionnement du système.
---
## 🛠️ Installation locale (développement)
```bash
git clone https://mj91.fr:448/Michel/Gestion_sondes.git
cd Gestion_sondes
python -m venv .venv
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate.bat # Windows
pip install -r requirements.txt
```
---
## ☁️ Environnement serveur
- Debian 12 sur VPS OVH
- MySQL 8
- Supervisor (script `Monitor.py`)
- Nginx en reverse proxy (`app.domo91.fr`)
- Certificat HTTPS via Let's Encrypt
---
## 🔐 Accès utilisateur
- Authentification intégrée (table `MotsDePasse`)
- Superviseurs : multi-sites + gestion des sondes
- Utilisateurs simples : accès restreint à leur site
---
## 📦 Déploiement
```bash
./deploy.sh
```
- Push vers VPS distant
- Rechargement automatique de Streamlit
- Utilisé via Gitea + scripts `post-receive` personnalisés
---
## 📜 Licence
Projet **privé** propriété de lauteur. Toute diffusion interdite sans autorisation préalable.