feat: logo et favicon, confirmation modale, fil d'ariane, e-mails sombres (#4)
CD — Déploiement / deploy (push) Failing after 25s
CD — Déploiement / deploy (push) Failing after 25s
- logo embarque dans les e-mails (CID) et gabarit repense en mode sombre - favicon multi-tailles + icone PNG, logo a gauche du titre (app et auth) - modale de confirmation animee a la place de window.confirm - bouton retour et fil d'ariane dans l'explorateur --------- Co-authored-by: xEsiah <[email protected]> Reviewed-on: #4 Reviewed-by: Esiah <[email protected]> Co-authored-by: Gitea Actions <-[email protected]>
This commit was merged in pull request #4.
This commit is contained in:
+3
-3
@@ -46,18 +46,18 @@ CI). L'exécuter avant de déclarer un travail fini.
|
||||
- Erreurs : `AppError` + codes (`errors.ts`) — jamais `throw` brut, jamais de
|
||||
détail de schéma dans une 500.
|
||||
- SQL : requêtes préparées uniquement, pas de `raw()` hors DDL.
|
||||
- Front : un seul client HTTP (`frontend/cloud/src/lib/api.ts`),
|
||||
- Front : un seul client HTTP (`frontend/src/lib/api.ts`),
|
||||
`credentials: "same-origin"`. React Router 7 (`App.tsx`) + `AppShell`, contexte
|
||||
de session dans `lib/session.tsx`.
|
||||
- `.editorconfig` : 2 espaces, LF, UTF-8.
|
||||
|
||||
## Design system
|
||||
|
||||
`frontend/shared` (`@cohaise/ui`) vit dans ce dépôt.
|
||||
Le design system vit dans `frontend/src/ui`.
|
||||
|
||||
- `tokens.css` est la source unique des couleurs et typographies ; ne pas coder
|
||||
de couleur en dur ailleurs.
|
||||
- Un composant propre à une page se développe dans `frontend/cloud`, pas dans le
|
||||
- Un composant propre à une page se développe dans `frontend`, pas dans le
|
||||
design system.
|
||||
- Palette : accent carmin `#b71c1c`, destructif rouge `#d32f2f`/`#ef4444`,
|
||||
avertissement jaune. Aucune orange.
|
||||
|
||||
+20
-3
@@ -84,7 +84,7 @@ d'adresse).
|
||||
## Droits d'accès
|
||||
|
||||
Calculés **en base à chaque requête**, depuis la session — jamais depuis un
|
||||
en-tête (`backend/cloud/src/access.ts`).
|
||||
en-tête (`backend/src/access.ts`).
|
||||
|
||||
| Concept | Règle |
|
||||
| --- | --- |
|
||||
@@ -106,13 +106,30 @@ 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, bouton d'action et mention
|
||||
**ne pas répondre**. Un repli texte accompagne chaque envoi.
|
||||
|
||||
Le logo `backend/src/assets/logo.png` est **embarqué** dans le message (pièce
|
||||
jointe `cid`), donc visible même quand le client bloque les images distantes.
|
||||
`MAIL_LOGO_URL` force une image distante à la place.
|
||||
|
||||
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/cloud/migrations/` — application stricte dans l'ordre, checksum SHA-256
|
||||
`backend/migrations/` — application stricte dans l'ordre, checksum SHA-256
|
||||
par fichier, dérive refusée au démarrage.
|
||||
|
||||
| Fichier | Contenu |
|
||||
@@ -131,7 +148,7 @@ password_reset_tokens, email_change_requests, audit_logs`.
|
||||
|
||||
## Erreurs métier
|
||||
|
||||
`AppError` avec codes stables (`backend/shared/src/errors.ts`). Correspondances
|
||||
`AppError` avec codes stables (`backend/src/lib/errors.ts`). Correspondances
|
||||
MariaDB : `1062` → 409, `1146` → 503 `NOT_MIGRATED`, `1406` → 422. Le corps d'une
|
||||
500 ne contient jamais de détail de schéma. Réponse normalisée :
|
||||
|
||||
|
||||
+18
-17
@@ -8,27 +8,28 @@ Node/TypeScript, une base MariaDB, un stockage de fichiers monté en volume.
|
||||
|
||||
| Élément | Où |
|
||||
| --- | --- |
|
||||
| React 19 + Vite 8 + Tailwind 4 + react-router-dom 7 | `frontend/cloud` |
|
||||
| Hono | `backend/cloud/src/index.ts` (`@cohaise/server` pour le socle) |
|
||||
| MariaDB (`mysql2`) | `backend/shared/src/db.ts` |
|
||||
| Nodemailer | `backend/shared/src/mail.ts` |
|
||||
| sharp (vignettes) | `backend/cloud/src/media.ts` |
|
||||
| Validation Zod | `backend/shared/src/config.ts` et chaque route |
|
||||
| React 19 + Vite 8 + Tailwind 4 + react-router-dom 7 | `frontend` |
|
||||
| Hono | `backend/src/index.ts` (`src/lib` pour le socle) |
|
||||
| MariaDB (`mysql2`) | `backend/src/lib/db.ts` |
|
||||
| Nodemailer | `backend/src/lib/mail.ts` |
|
||||
| sharp (vignettes) | `backend/src/media.ts` |
|
||||
| Validation Zod | `backend/src/lib/config.ts` et chaque route |
|
||||
|
||||
## Découpage
|
||||
|
||||
```
|
||||
backend/shared/ @cohaise/server : config, db, mail, ratelimit, http, service, auth, errors
|
||||
backend/cloud/ routes/, access.ts, storage.ts, media.ts, cli.ts
|
||||
backend/cloud/migrations/ 000 … 006
|
||||
frontend/shared/ @cohaise/ui : Design System (boutons, cartes, champs, spinner)
|
||||
frontend/cloud/ router + AppShell + pages/
|
||||
docker/ Dockerfile(.app/.api), nginx/, publish.sh
|
||||
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)
|
||||
frontend/src/ router + AppShell + pages/
|
||||
docker/ Dockerfile(.app/.api), nginx/, publish.sh
|
||||
```
|
||||
|
||||
`backend/shared` est générique (sessions, erreurs, migrations, courriel,
|
||||
limitation de débit) ; `backend/cloud` porte le métier : droits, quotas, chemins
|
||||
disque, traitement média.
|
||||
`backend/src/lib` porte la mécanique générique (sessions, erreurs,
|
||||
migrations, courriel, limitation de débit), le reste de `backend` porte le
|
||||
métier : droits, quotas, chemins disque, traitement média. Tout vit dans un seul
|
||||
paquet, sans dépendance de workspace.
|
||||
|
||||
## Chaîne de démarrage
|
||||
|
||||
@@ -41,7 +42,7 @@ db ──healthy──▶ migrate (runMigrations + assertNoDrift, puis s'arrête
|
||||
app-build (publish.sh, terminé avant nginx)
|
||||
```
|
||||
|
||||
- `migrate` monte `./backend/cloud/migrations:/migrations:ro`.
|
||||
- `migrate` monte `./backend/migrations:/migrations:ro`.
|
||||
- `api` refuse de démarrer si une migration appliquée a été modifiée (dérive de
|
||||
checksum). `onReady` purge les sessions et la corbeille expirées.
|
||||
- stockage : `app_data` (volume Docker, HTML), `$CLOUD_DB_DIR` (MariaDB) et
|
||||
@@ -50,7 +51,7 @@ app-build (publish.sh, terminé avant nginx)
|
||||
## API et front
|
||||
|
||||
- API `/api/cloud` : voir [`api.md`](api.md).
|
||||
- Front : React Router (`frontend/cloud/src/App.tsx`) avec gardes
|
||||
- Front : React Router (`frontend/src/App.tsx`) avec gardes
|
||||
`RequireAuth` / `RequireReady` / `RequireAdmin` et `AppShell`
|
||||
(`components/AppShell.tsx`) : navigation latérale, en-tête, contenu.
|
||||
- Pages : `Login`, `ForgotPassword`, `ResetPassword`, `ConfirmEmail`,
|
||||
|
||||
+29
-3
@@ -12,7 +12,7 @@ Réponse sur **`http://localhost:8083`**.
|
||||
|
||||
La configuration est validée **avant** l'ouverture d'aucun port : si une variable
|
||||
manque ou est mal formée, le process s'arrête en listant exactement ce qui
|
||||
pose problème (`backend/shared/src/config.ts`).
|
||||
pose problème (`backend/src/lib/config.ts`).
|
||||
|
||||
## Variables
|
||||
|
||||
@@ -35,6 +35,7 @@ pose problème (`backend/shared/src/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 distant des courriels (sinon logo embarqué `backend/src/assets/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
|
||||
|
||||
|
||||
+3
-3
@@ -17,7 +17,7 @@
|
||||
|
||||
### Limitation de débit
|
||||
|
||||
- **Applicatif** : `createRateLimiter` (`backend/shared/src/ratelimit.ts`) par IP
|
||||
- **Applicatif** : `createRateLimiter` (`backend/src/lib/ratelimit.ts`) par IP
|
||||
sur `auth/login`, `account/forgot-password`, `account/reset-password`,
|
||||
`account/email-change`. Réglages `RATE_LIMIT_LOGIN_MAX` (10) et
|
||||
`RATE_LIMIT_LOGIN_WINDOW_MS` (60 s).
|
||||
@@ -27,14 +27,14 @@
|
||||
### Droits d'accès
|
||||
|
||||
Calculés **en base à chaque requête**, depuis la session — jamais depuis un
|
||||
en-tête (`backend/cloud/src/access.ts`). Lecture : propriétaire, permission
|
||||
en-tête (`backend/src/access.ts`). Lecture : propriétaire, permission
|
||||
`folder_permissions` (`read`/`write`/`admin`), ou dossier `public`. Écriture :
|
||||
`write`/`admin`. **404 plutôt que 403** : jamais d'indice sur l'existence d'une
|
||||
ressource.
|
||||
|
||||
### Courriel
|
||||
|
||||
Nodemailer (`backend/shared/src/mail.ts`) avec `SMTP_HOST`. `PUBLIC_ORIGIN`
|
||||
Nodemailer (`backend/src/lib/mail.ts`) avec `SMTP_HOST`. `PUBLIC_ORIGIN`
|
||||
(obligatoire) construit les liens de réinitialisation et de confirmation ;
|
||||
aucun HTML utilisateur n'est injecté dans les messages.
|
||||
|
||||
|
||||
+7
-6
@@ -9,7 +9,7 @@ désactivé pour les `.md`. Aucun Prettier/ESLint installé.
|
||||
|
||||
## Palette
|
||||
|
||||
Source unique : `frontend/shared/src/styles/tokens.css`.
|
||||
Source unique : `frontend/src/styles/tokens.css`.
|
||||
|
||||
| Jeton | Rôle | Valeur |
|
||||
| --- | --- | --- |
|
||||
@@ -32,15 +32,16 @@ Règles :
|
||||
## Typographies
|
||||
|
||||
Poppins (texte), Orbitron et Cinzel (display), JetBrains Mono (code) —
|
||||
woff2 hébergés dans `frontend/shared/fonts/`, jamais par CDN.
|
||||
woff2 hébergés dans `frontend/src/fonts/`, jamais par CDN.
|
||||
|
||||
## Composants
|
||||
|
||||
`@cohaise/ui` : `Button`, `Card`, `Input`, `Skeleton`, `Spinner`, `cn`.
|
||||
Design system local à `frontend/src/ui` : `Button`, `Card`, `Input`,
|
||||
`Skeleton`, `Spinner`, `cn`.
|
||||
|
||||
- Les composants du design system ne connaissent **jamais** le métier du Cloud.
|
||||
- Une variante propre à cette app se développe dans `frontend/cloud`, pas dans
|
||||
`frontend/shared`.
|
||||
- Une variante propre à cette app se développe dans `frontend/src`, jamais
|
||||
dans `src/ui`.
|
||||
|
||||
## Côté serveur
|
||||
|
||||
@@ -53,7 +54,7 @@ woff2 hébergés dans `frontend/shared/fonts/`, jamais par CDN.
|
||||
|
||||
| Élément | Attendu |
|
||||
| --- | --- |
|
||||
| `shared` | vit dans ce dépôt, cycle de vie commun |
|
||||
| Socle & design system | internes à `backend/src/lib` et `frontend/src/ui` |
|
||||
| Port HTTP | `8083` (`COHAISE_HTTP_PORT`) |
|
||||
| Dépôt | autonome, importance égale front et back |
|
||||
| `.env` | jamais versionné (`.env.example` seulement) |
|
||||
|
||||
+13
-13
@@ -33,18 +33,18 @@ fichier est copié dans l'image, pas monté.
|
||||
|
||||
## Modifier une route
|
||||
|
||||
1. Schéma d'entrée : Zod dans `backend/cloud/src/routes/<entity>.ts`.
|
||||
2. Droits : passer par `backend/cloud/src/access.ts` (jamais par un paramètre
|
||||
1. Schéma d'entrée : Zod dans `backend/src/routes/<entity>.ts`.
|
||||
2. Droits : passer par `backend/src/access.ts` (jamais par un paramètre
|
||||
venu du client).
|
||||
3. Réponse : renvoyer **404** si la ressource n'est pas censée exister pour ce
|
||||
compte, 403 seulement pour une règle explicite.
|
||||
4. Erreur métier : `AppError` depuis `backend/shared/src/errors.ts`.
|
||||
4. Erreur métier : `AppError` depuis `backend/src/lib/errors.ts`.
|
||||
5. Audit si l'action est sensible (`audit()` dans `access.ts`).
|
||||
6. `make check`, puis redémarrage de l'API (`docker compose up -d api`).
|
||||
|
||||
## Modifier le schéma
|
||||
|
||||
1. Écrire `backend/cloud/migrations/00N_….sql` (número suivant, jamais éditer
|
||||
1. Écrire `backend/migrations/00N_….sql` (número suivant, jamais éditer
|
||||
un fichier déjà appliqué).
|
||||
2. Vérifier : `docker compose run --rm migrate node dist/cli.js --dir /migrations --check`
|
||||
3. Appliquer : `make migrate` ou redémarrage de l'API.
|
||||
@@ -56,24 +56,24 @@ migration, pas en éditant l'ancienne (le checksum bloquerait le démarrage).
|
||||
|
||||
## Modifier le design system
|
||||
|
||||
`frontend/shared` (`@cohaise/ui`) vit dans ce dépôt.
|
||||
Le design system vit dans `frontend/src/ui` (+ `src/styles`).
|
||||
|
||||
- `tokens.css` porte les couleurs et typographies ; ne pas en coder ailleurs.
|
||||
- Après modification : `npm run build --workspace=frontend/shared && make front`.
|
||||
- Après modification : `make front` (le build Vite reprend tout).
|
||||
|
||||
## Où changer quoi
|
||||
|
||||
| Besoin | Fichier |
|
||||
| --- | --- |
|
||||
| Droit d'accès à un dossier/fichier | `backend/cloud/src/access.ts` |
|
||||
| Droit d'accès à un dossier/fichier | `backend/src/access.ts` |
|
||||
| Taille/quota par défaut | migration `004`, table `users` / `settings` |
|
||||
| Chemin physique des fichiers | `backend/cloud/src/storage.ts` |
|
||||
| En-têtes, CORS, healthz | `backend/shared/src/http.ts` |
|
||||
| Chemin physique des fichiers | `backend/src/storage.ts` |
|
||||
| En-têtes, CORS, healthz | `backend/src/lib/http.ts` |
|
||||
| Durée de session | `SESSION_TTL_HOURS` |
|
||||
| Port | `COHAISE_HTTP_PORT` (nginx), `COHAISE_API_PORT` (API) |
|
||||
| Interface (parcours dossiers) | `frontend/cloud/src/pages/Browser.tsx` |
|
||||
| Routes et gardes du front | `frontend/cloud/src/App.tsx` |
|
||||
| Couleurs / composants | `frontend/shared/src/styles/tokens.css` |
|
||||
| Interface (parcours dossiers) | `frontend/src/pages/Browser.tsx` |
|
||||
| Routes et gardes du front | `frontend/src/App.tsx` |
|
||||
| Couleurs / composants | `frontend/src/styles/tokens.css` |
|
||||
|
||||
## Git
|
||||
|
||||
@@ -86,7 +86,7 @@ migration, pas en éditant l'ancienne (le checksum bloquerait le démarrage).
|
||||
|
||||
1. **`.env` local désynchronisé** de `.env.example` : les clés `COHAISE_*`
|
||||
manquantes basculent silencieusement sur les défauts compose.
|
||||
2. **README de paquet** (`docker/README.md`, `backend/cloud/README.md`) : états
|
||||
2. **README de paquet** (`docker/README.md`, `backend/README.md`) : états
|
||||
antérieurs du dépôt. Se fier à ce dossier `docs/`.
|
||||
3. **Limitation de débit active** (applicatif + nginx) : une rafale peut renvoyer
|
||||
`419`/`503`.
|
||||
|
||||
Reference in New Issue
Block a user