43d4b4011c6c159d10f2c8f4bef07de66a46a89b
🏡 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 filtresrole=usersans profil → voit rienrole=useravec profil sans pièces ou sans tâches → voit rienrole=useravec 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
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
mysql -u root -p
CREATE USER 'menage_user'@'localhost' IDENTIFIED BY 'MOT_DE_PASSE_FORT';
GRANT ALL PRIVILEGES ON menage.* TO 'menage_user'@'localhost';
FLUSH PRIVILEGES; EXIT;
mysql -u root -p < /var/www/menage/sql/schema.sql
3. Configurer api/config.php
define('DB_USER', 'menage_user');
define('DB_PASS', 'MOT_DE_PASSE_FORT');
Et dans notify.php :
define('APP_URL', 'http://192.168.1.XXX/menage/');
4. Vhost Apache
Alias /menage /var/www/menage
<Directory /var/www/menage>
AllowOverride All
Require all granted
DirectoryIndex login.html
</Directory>
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 :
rm /var/www/menage/setup.html /var/www/menage/api/setup.php
Migration depuis v2
# 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)
- Se connecter sur
login.html - Admin → Pièces : adapter (ajouter Chambre 1, Chambre 2, SDB du bas…)
- Admin → Tâches : créer/ajuster les tâches par pièce
- Admin → Profils : créer un profil (ex: "Enfants", "Cuisine")
- Cliquer 🎯 pour assigner pièces + tâches
- 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ôleuser/ profil : Chambres - Lucas ne voit que ses tâches
Notifications email
Configurer l'email dans chaque compte (Admin → Comptes → ✏️).
# 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
Description
Languages
HTML
59%
PHP
41%