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:
+14
@@ -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
|
||||
|
||||
@@ -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
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user