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:
2026-10-16 11:50:55 +02:00
parent 75da61ac93
commit f564908650
91 changed files with 70 additions and 67 deletions
+12 -12
View File
@@ -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`.