feat: e-mails brandes, controle d'espace disque, maintenance

Courriels
- gabarit HTML brande (logo, couleur #b71c1c, bouton, mention ne pas repondre)
  dans backend/src/lib/mail-template.ts ; repli texte conserve
- MailMessage gagne un champ html optionnel
- MAIL_LOGO_URL (defaut PUBLIC_ORIGIN/logo.png) + logo.png servi par le front
- notification au nouvel utilisateur a la creation du compte admin
- forgot-password, email-change et reset-password passent par le gabarit

Espace disque
- diskUsage() (statfs) dans storage.ts (total/free/available)
- upload et avatar refuses si le disque est plein (507 INSUFFICIENT_STORAGE)
- quota d'emplacement borne par la capacite reelle du disque
- statistiques disque exposees aux endpoints admin

Exploitation
- make purge-logs : vide le journal d'audit
- make reset : cloud vierge en conservant les administrateurs
- docker/reset-cloud.sql ; documentation deployment.md et api.md
This commit is contained in:
2026-10-16 11:59:34 +02:00
parent f564908650
commit 739bc26b43
18 changed files with 382 additions and 11 deletions
+14
View File
@@ -106,10 +106,24 @@ par tous les membres authentifiés, en écriture pour son propriétaire.
| Corps | `PUT /files` en flux brut (pas de multipart), `?name=` et `?folderId=` |
| Taille | plafond `users.max_file_bytes`, vérifié en flux (coupure si dépassement) |
| Quota | `users.used_bytes` + quota `storage_locations`, revérifiés avant écriture |
| Disque | `diskUsage()` (`statfs`) avant écriture ; `507` `INSUFFICIENT_STORAGE` si le support est plein |
| Quota support | un quota d'emplacement ne peut dépasser la capacité réelle du disque (`assertQuotaFits`) |
| Chemin disque | dérivé du slug + UUID, jamais du nom affiché (`storage.ts`) |
| Renommage | `PATCH /files/:id { name }`, `PATCH /folders/:id { name, description }` |
| Déplacement | `folderId`/`parentId` : refuse de placer un dossier dans son propre sous-arbre |
## Courriels
Les messages sortants sont construits par `backend/src/lib/mail-template.ts` :
gabarit HTML aux couleurs de l'app (`#b71c1c`), logo (`MAIL_LOGO_URL`, défaut
`PUBLIC_ORIGIN/logo.png`), bouton d'action et mention **ne pas répondre**. Un
repli texte accompagne chaque envoi.
Points d'envoi : réinitialisation du mot de passe, changement d'adresse, et
**notification au nouvel utilisateur** à la création d'un compte admin
(identifiants temporaires + lien de connexion). Un échec d'envoi n'annule jamais
l'opération en base.
## Modèle de données
`backend/migrations/` — application stricte dans l'ordre, checksum SHA-256
+1 -1
View File
@@ -18,7 +18,7 @@ Node/TypeScript, une base MariaDB, un stockage de fichiers monté en volume.
## Découpage
```
backend/src/lib/ socle serveur : config, db, mail, ratelimit, http, service, auth, errors
backend/src/lib/ socle serveur : config, db, mail, mail-template, ratelimit, http, service, auth, errors
backend/src/ routes/, access.ts, storage.ts, media.ts, admin.ts
backend/migrations/ 000 … 006
frontend/src/ui/ design system (boutons, cartes, champs, spinner)
+28 -2
View File
@@ -35,6 +35,7 @@ pose problème (`backend/src/lib/config.ts`).
| `SMTP_USER` / `SMTP_PASSWORD` | authentification (vides = relais local) | vide |
| `SMTP_FROM` | adresse d'expédition | — |
| `SMTP_SECURE` | TLS implicite (port 465) | `false` |
| `MAIL_LOGO_URL` | logo des courriels (défaut `PUBLIC_ORIGIN/logo.png`) | vide |
| `RATE_LIMIT_LOGIN_MAX` | tentatives par fenêtre | `10` |
| `RATE_LIMIT_LOGIN_WINDOW_MS` | largeur de fenêtre | `60000` |
| `LOG_LEVEL` | `silent…debug` | `info` |
@@ -85,13 +86,38 @@ make db # redémarrer la base
make migrate # rejouer explicitement les migrations (hors démarrage)
make backup # dump horodaté → ./backups/cloud-<stamp>.sql.gz
make admin ARGS=... # créer / réinitialiser un compte
make purge-logs # vider le journal d'audit
make reset # cloud vierge, administrateurs conservés (confirmation)
make dev # Vite 5174, proxy /api → 3101
make check # typecheck + build
make down # arrêt, volumes conservés
```
`make backup` lit le mot de passe **dans le conteneur** : il ne passe ni par la
commande, ni par le dépôt.
`make backup`, `make purge-logs` et `make reset` lisent le mot de passe **dans
le conteneur** : il ne passe ni par la commande, ni par le dépôt.
## Maintenance
### Vider les journaux
`make purge-logs` supprime le contenu de `audit_logs` (table
`docker/reset-cloud.sql` mise à part). Les comptes, fichiers et dossiers sont
intacts.
### Remettre le cloud à zéro
`make reset` repart d'une instance vierge **en conservant les comptes
administrateurs** :
- supprime fichiers, dossiers, partages, permissions, avatars, sessions, jetons
(réinitialisation, changement d'adresse) et journaux d'audit ;
- supprime tous les comptes **sauf** ceux dont le rôle est `admin` ;
- remet `storage_locations.used_bytes` à zéro ;
- efface les médias sur disque (`$CLOUD_MEDIA_DIR`), originaux, vignettes et
avatars compris.
La commande demande une confirmation (`o`/`y`). Enchaîner `make backup` avant
si l'état doit être conservé.
## Migrations