147 lines
3.8 KiB
Markdown
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
|
|
```
|