Initial commit
This commit is contained in:
@@ -0,0 +1,146 @@
|
||||
# 🏡 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
|
||||
```
|
||||
Reference in New Issue
Block a user