Files
2026-11-11 09:35:51 +01:00

3.8 KiB

🏡 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

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)

  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 → ✏️).

# 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