refactor: aplatir backend/cloud et frontend/cloud
Le niveau `cloud` etait redondant : il ne reste qu'une seule application. - backend/cloud/* -> backend/*, frontend/cloud/* -> frontend/* - workspaces npm : frontend et backend ; reference tsconfig ./backend - extends tsconfig.base corrige (../ au lieu de ../../) - docker-compose : APP_DIR backend/frontend, montage ./backend/migrations - deploy.yml : reconstruit aussi l'image migrate - chemins mis a jour dans les docs, le Makefile et docker/README.md
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
|
||||
|
||||
Le design system vit dans `frontend/cloud/src/ui`.
|
||||
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.
|
||||
|
||||
+3
-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 |
|
||||
| --- | --- |
|
||||
@@ -112,7 +112,7 @@ par tous les membres authentifiés, en écriture pour son propriétaire.
|
||||
|
||||
## 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 +131,7 @@ password_reset_tokens, email_change_requests, audit_logs`.
|
||||
|
||||
## Erreurs métier
|
||||
|
||||
`AppError` avec codes stables (`backend/cloud/src/lib/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 :
|
||||
|
||||
|
||||
+15
-15
@@ -8,26 +8,26 @@ 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` (`src/lib` pour le socle) |
|
||||
| MariaDB (`mysql2`) | `backend/cloud/src/lib/db.ts` |
|
||||
| Nodemailer | `backend/cloud/src/lib/mail.ts` |
|
||||
| sharp (vignettes) | `backend/cloud/src/media.ts` |
|
||||
| Validation Zod | `backend/cloud/src/lib/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/cloud/src/lib/ socle serveur : config, db, mail, ratelimit, http, service, auth, errors
|
||||
backend/cloud/src/ routes/, access.ts, storage.ts, media.ts, admin.ts
|
||||
backend/cloud/migrations/ 000 … 006
|
||||
frontend/cloud/src/ui/ design system (boutons, cartes, champs, spinner)
|
||||
frontend/cloud/src/ router + AppShell + pages/
|
||||
backend/src/lib/ socle serveur : config, db, mail, 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/cloud/src/lib` porte la mécanique générique (sessions, erreurs,
|
||||
migrations, courriel, limitation de débit), le reste de `backend/cloud` porte le
|
||||
`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.
|
||||
|
||||
@@ -42,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
|
||||
@@ -51,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`,
|
||||
|
||||
+1
-1
@@ -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/cloud/src/lib/config.ts`).
|
||||
pose problème (`backend/src/lib/config.ts`).
|
||||
|
||||
## Variables
|
||||
|
||||
|
||||
+3
-3
@@ -17,7 +17,7 @@
|
||||
|
||||
### Limitation de débit
|
||||
|
||||
- **Applicatif** : `createRateLimiter` (`backend/cloud/src/lib/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/cloud/src/lib/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.
|
||||
|
||||
|
||||
+5
-5
@@ -9,7 +9,7 @@ désactivé pour les `.md`. Aucun Prettier/ESLint installé.
|
||||
|
||||
## Palette
|
||||
|
||||
Source unique : `frontend/cloud/src/styles/tokens.css`.
|
||||
Source unique : `frontend/src/styles/tokens.css`.
|
||||
|
||||
| Jeton | Rôle | Valeur |
|
||||
| --- | --- | --- |
|
||||
@@ -32,15 +32,15 @@ Règles :
|
||||
## Typographies
|
||||
|
||||
Poppins (texte), Orbitron et Cinzel (display), JetBrains Mono (code) —
|
||||
woff2 hébergés dans `frontend/cloud/src/fonts/`, jamais par CDN.
|
||||
woff2 hébergés dans `frontend/src/fonts/`, jamais par CDN.
|
||||
|
||||
## Composants
|
||||
|
||||
Design system local à `frontend/cloud/src/ui` : `Button`, `Card`, `Input`,
|
||||
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/src`, jamais
|
||||
- Une variante propre à cette app se développe dans `frontend/src`, jamais
|
||||
dans `src/ui`.
|
||||
|
||||
## Côté serveur
|
||||
@@ -54,7 +54,7 @@ Design system local à `frontend/cloud/src/ui` : `Button`, `Card`, `Input`,
|
||||
|
||||
| Élément | Attendu |
|
||||
| --- | --- |
|
||||
| Socle & design system | internes à `backend/cloud/src/lib` et `frontend/cloud/src/ui` |
|
||||
| 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) |
|
||||
|
||||
+12
-12
@@ -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/cloud/src/lib/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,7 +56,7 @@ migration, pas en éditant l'ancienne (le checksum bloquerait le démarrage).
|
||||
|
||||
## Modifier le design system
|
||||
|
||||
Le design system vit dans `frontend/cloud/src/ui` (+ `src/styles`).
|
||||
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 : `make front` (le build Vite reprend tout).
|
||||
@@ -65,15 +65,15 @@ Le design system vit dans `frontend/cloud/src/ui` (+ `src/styles`).
|
||||
|
||||
| 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/cloud/src/lib/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/cloud/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 @@ Le design system vit dans `frontend/cloud/src/ui` (+ `src/styles`).
|
||||
|
||||
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