# 🏠 Loustiques Home > Projet domotique conçu par le groupe **Les Loustiques** de l'EPHEC. --- ## Contexte Les Loustiques est un groupe d'étudiants de l'EPHEC qui conçoit une maison domotique pilotée par un **Raspberry Pi 2**. L'objectif est de contrôler des équipements physiques (LED, capteurs, etc.) via une interface web sécurisée, accessible depuis le réseau local. L'application repose sur un serveur **Flask** (Python) qui expose une API et sert les pages HTML. L'authentification est gérée via une base de données **MySQL**, et les actions physiques sont déclenchées via la bibliothèque **gpiozero** qui communique avec les GPIOs du Raspberry Pi. --- ## Architecture du projet ``` loustiques-home/ ├── flask/ │ ├── main.py # Point d'entrée Flask — routes et API │ ├── auth.py # Authentification et gestion des utilisateurs │ ├── add_user.py # Ajout d'utilisateur (appelé par l'admin) │ ├── led.py # Contrôle de la LED via GPIO │ ├── log.py # Configuration du système de logs │ └── templates/ │ ├── index.html # Page de connexion │ ├── dashboard.html # Tableau de bord principal │ ├── admin.html # Panneau d'administration │ └── log.html # Visualisation des logs en temps réel ├── run_flask.sh # Script de démarrage du serveur ├── requirement.txt # Dépendances Python └── .env # Variables d'environnement (non versionné) ``` --- ## Description des fichiers ### `run_flask.sh` Script bash de démarrage. Il vérifie la présence de Python 3 et de Flask, crée le fichier de log `/var/log/loustique.log` avec les bonnes permissions, puis lance le serveur Flask. À exécuter avec `sudo` pour pouvoir créer le fichier de log : ```bash sudo bash run_flask.sh ``` --- ### `log.py` Configure le système de logging de l'application. Les logs sont écrits dans `/var/log/loustique.log` au format : ``` 2026-03-24 22:07:44,532 - loustique - INFO - Connexion réussie pour maxime ``` Le logger `werkzeug` (serveur Flask interne) est également redirigé vers ce fichier pour centraliser tous les événements. La propagation vers la console est désactivée pour éviter les doublons et les codes couleur ANSI. --- ### `auth.py` Gère l'authentification des utilisateurs et la récupération des comptes. - `init()` — ouvre une connexion MySQL à partir des variables d'environnement `.env` - `login(username, password)` — vérifie les identifiants en comparant le mot de passe avec le hash bcrypt stocké en base - `get_users()` — retourne la liste de tous les utilisateurs (username, rôle, date de création) --- ### `add_user.py` Permet d'ajouter un nouvel utilisateur en base de données. Cette fonction est appelée par la route `/admin/add_user` de Flask. Le mot de passe est hashé avec **bcrypt** avant d'être stocké. Le rôle (`admin` ou `user`) est passé directement en paramètre. --- ### `led.py` Contient la fonction `led(utilisateur)` qui simule (ou déclenche réellement sur le Pi) l'allumage d'une LED. Le code GPIO est commenté pour permettre les tests hors Raspberry Pi. Chaque déclenchement est logué avec le nom de l'utilisateur qui en est à l'origine. --- ### `main.py` Point d'entrée de l'application Flask. Définit toutes les routes : | Route | Méthode | Description | |---|---|---| | `/` | GET | Page de connexion | | `/login` | POST | Authentifie l'utilisateur | | `/dashboard` | GET | Tableau de bord | | `/led` | POST | Déclenche la LED | | `/admin` | GET | Panneau d'administration | | `/admin/add_user` | POST | Crée un nouvel utilisateur | | `/admin/get_users` | GET | Liste tous les utilisateurs | | `/admin/logs` | GET | Page de visualisation des logs | | `/admin/logs/data` | GET | Retourne les logs en JSON | L'utilisateur connecté est stocké dans la variable globale `current_user` pour être transmis aux fonctions comme `led()`. --- ### `index.html` Page de connexion. Envoie les identifiants en JSON vers `/login` et redirige vers `/dashboard` en cas de succès. --- ### `dashboard.html` Tableau de bord principal. Affiche l'heure locale, le statut du système, et propose des actions rapides : allumer la LED, accéder à l'administration, etc. --- ### `admin.html` Panneau d'administration. Permet de créer de nouveaux utilisateurs (avec choix du rôle et indicateur de force du mot de passe) et de lister les comptes existants avec la possibilité de les supprimer. --- ### `log.html` Interface de visualisation des logs en temps réel. Se rafraîchit automatiquement toutes les 5 secondes via un fetch vers `/admin/logs/data`. Propose un filtrage par niveau (INFO, WARNING, ERROR, DEBUG) et une barre de recherche. --- ## Installation ### Prérequis - Raspberry Pi 2 sous Linux (Raspbian recommandé) - Python 3.11+ - MySQL / MariaDB - Un environnement virtuel Python (`venv`) > **Note :** Le script `run_flask.sh` s'occupe automatiquement de vérifier et installer les dépendances nécessaires. Cette liste est fournie par souci de transparence et pour les installations manuelles. ### Étapes ```bash # Cloner le dépôt git clone git@github.com:maxdrk/loustique-home.git cd loustique-home # Créer et activer le venv python3 -m venv venv source venv/bin/activate # Installer les dépendances pip install -r requirement.txt # Configurer les variables d'environnement cp .env.example .env # Éditer .env avec vos infos MySQL # Lancer le serveur sudo bash run_flask.sh ``` --- ## Variables d'environnement (`.env`) ```env DB_HOST=127.0.0.1 DB_PORT=3306 DB_USER=votre_utilisateur DB_PASSWORD=votre_mot_de_passe DB_NAME=loustique DB_CHARSET=utf8mb4 ``` --- ## Structure de la base de données ```sql CREATE TABLE Auth ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) UNIQUE NOT NULL, password VARCHAR(255) NOT NULL, Fonctions VARCHAR(20) NOT NULL, -- 'admin' ou 'user' created_at DATETIME NOT NULL ); ``` --- ## Dépendances (`requirement.txt`) | Package | Rôle | |---|---| | `flask` | Serveur web | | `pymysql` | Connexion MySQL | | `bcrypt` | Hashage des mots de passe | | `python-dotenv` | Chargement du fichier `.env` | | `gpiozero` | Contrôle des GPIOs du Raspberry Pi | --- ## Groupe Projet réalisé par **Les Loustiques** — étudiants à l'**EPHEC** (Louvain-La-Neuve).