# 🏡 Ménage Maison — v3 Application web collaborative de gestion du ménage en famille. ## Architecture ``` accounts → la personne (login, prénom, couleur, avatar, email, rôle) profiles → un périmètre de travail (pièces + tâches visibles) plusieurs comptes peuvent partager le même profil ``` **Règle de visibilité :** - `role=admin` → voit tout, bypass les filtres - `role=user` sans profil → voit **rien** - `role=user` avec profil sans pièces ou sans tâches → voit **rien** - `role=user` avec pièces ET tâches assignées → voit **uniquement celles-là** ## Prérequis - Apache 2.4+ avec `mod_rewrite` - PHP 8.0+ (`pdo_mysql`, `mbstring`, `session`) - MySQL 8.0+ ou MariaDB 10.5+ - Sendmail / Postfix (optionnel, pour les notifications) ## Installation — nouvelle installation ### 1. Déposer les fichiers ```bash unzip menage.zip -d /var/www/menage chown -R www-data:www-data /var/www/menage chmod -R 755 /var/www/menage ``` ### 2. Créer la base MySQL ```bash mysql -u root -p ``` ```sql CREATE USER 'menage_user'@'localhost' IDENTIFIED BY 'MOT_DE_PASSE_FORT'; GRANT ALL PRIVILEGES ON menage.* TO 'menage_user'@'localhost'; FLUSH PRIVILEGES; EXIT; ``` ```bash mysql -u root -p < /var/www/menage/sql/schema.sql ``` ### 3. Configurer `api/config.php` ```php define('DB_USER', 'menage_user'); define('DB_PASS', 'MOT_DE_PASSE_FORT'); ``` Et dans `notify.php` : ```php define('APP_URL', 'http://192.168.1.XXX/menage/'); ``` ### 4. Vhost Apache ```apache Alias /menage /var/www/menage AllowOverride All Require all granted DirectoryIndex login.html ``` ```bash a2ensite menage && a2enmod rewrite && systemctl reload apache2 ``` ### 5. Wizard de setup Ouvrir `http://TON_IP/menage/setup.html` et créer le premier compte admin. **Supprimer ensuite :** ```bash rm /var/www/menage/setup.html /var/www/menage/api/setup.php ``` --- ## Migration depuis v2 ```bash # Sauvegarde d'abord ! mysqldump -u root -p menage > menage_v2_backup.sql # Migration mysql -u root -p menage < /var/www/menage/sql/migration_v2_to_v3.sql ``` --- ## Premier usage (après setup) 1. Se connecter sur `login.html` 2. Admin → **Pièces** : adapter (ajouter Chambre 1, Chambre 2, SDB du bas…) 3. Admin → **Tâches** : créer/ajuster les tâches par pièce 4. Admin → **Profils** : créer un profil (ex: "Enfants", "Cuisine") - Cliquer 🎯 pour assigner pièces + tâches 5. Admin → **Comptes** : créer un compte par personne, lier au profil **Exemple enfant :** - Profil "Chambres" → pièces : Chambre 1, Chambre 2 → tâches : Faire le lit, Ranger - Compte `lucas` / rôle `user` / profil : Chambres - Lucas ne voit que ses tâches --- ## Notifications email Configurer l'email dans chaque compte (Admin → Comptes → ✏️). ```bash # Cron à 8h chaque matin crontab -e 0 8 * * * /usr/bin/php /var/www/menage/notify.php >> /var/log/menage_notify.log 2>&1 # Test sans envoi php /var/www/menage/notify.php --test # Forcer l'envoi php /var/www/menage/notify.php --force ``` --- ## Structure des fichiers ``` menage/ ├── login.html ← Page de connexion ├── setup.html ← Wizard 1ère installation (supprimer après) ├── index.html ← Application principale ├── admin.html ← Interface d'administration (admins) ├── notify.php ← Script cron notifications ├── api/ │ ├── config.php ← ⚙️ À configurer (BDD + resolve_visible_tasks) │ ├── auth.php ← Login / logout / session │ ├── index.php ← API checklist │ ├── admin.php ← API administration │ └── setup.php ← Backend wizard (supprimer après) └── sql/ ├── schema.sql ← Schéma complet v3 └── migration_v2_to_v3.sql ← Migration depuis v2 ```