Files
Menage/README.md
T
2026-11-11 09:35:51 +01:00

147 lines
3.8 KiB
Markdown

# 🏡 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
<Directory /var/www/menage>
AllowOverride All
Require all granted
DirectoryIndex login.html
</Directory>
```
```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
```