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
+1 -1
View File
@@ -32,7 +32,7 @@ jobs:
git pull --ff-only origin main
# Le build des images compile et typecheck chaque workspace (tsc) :
# aucune toolchain Node n'est requise sur l'hote.
docker compose build api nginx
docker compose build api migrate nginx
make front
docker compose up -d api nginx
docker image prune -f
+1 -1
View File
@@ -76,7 +76,7 @@ admin:
$(COMPOSE) run --rm --no-deps api node dist/admin.js $(ARGS)
dev:
npm run dev --workspace=frontend/cloud
npm run dev --workspace=frontend
typecheck:
npm run typecheck
+4 -4
View File
@@ -6,13 +6,13 @@ Application autonome — front **et** back dans ce dépôt.
## Structure
```
frontend/cloud application React + Vite, design system inclus (src/ui, src/styles)
backend/cloud API : socle serveur (src/lib), auth, dossiers, fichiers, médias
frontend application React + Vite, design system inclus (src/ui, src/styles)
backend API : socle serveur (src/lib), auth, dossiers, fichiers, médias
docker/ images nginx et API
```
Chaque application porte son propre code : le socle serveur (`backend/cloud/src/lib`)
et le design system (`frontend/cloud/src/ui`) appartiennent au Cloud et ne sont
Chaque application porte son propre code : le socle serveur (`backend/src/lib`)
et le design system (`frontend/src/ui`) appartiennent au Cloud et ne sont
partagés avec aucun autre dépôt.
## Démarrer
@@ -1,6 +1,6 @@
{
"$schema": "https://json.schemastore.org/tsconfig",
"extends": "../../tsconfig.base.json",
"extends": "../tsconfig.base.json",
"compilerOptions": {
"module": "NodeNext",
"moduleResolution": "NodeNext",
+4 -4
View File
@@ -28,7 +28,7 @@ x-migrate-build: &migrate-build
# DNS mort (routeur), ce qui casse `npm ci` dans le conteneur.
network: host
args:
APP_DIR: backend/cloud
APP_DIR: backend
services:
app-build:
@@ -39,7 +39,7 @@ services:
target: export
network: host
args:
APP_DIR: frontend/cloud
APP_DIR: frontend
volumes:
- app_data:/output
- ./docker/publish.sh:/publish.sh:ro
@@ -110,7 +110,7 @@ services:
DB_NAME: ${CLOUD_DATABASE}
command: ["node", "dist/cli.js", "--dir", "/migrations"]
volumes:
- ./backend/cloud/migrations:/migrations:ro
- ./backend/migrations:/migrations:ro
api:
container_name: cohaise-cloud-api
@@ -119,7 +119,7 @@ services:
dockerfile: docker/Dockerfile.api
network: host
args:
APP_DIR: backend/cloud
APP_DIR: backend
image: cohaise-cloud-api
restart: unless-stopped
depends_on:
+4 -4
View File
@@ -34,7 +34,7 @@ Supprime le `default.conf` par défaut, copie `cloud.conf` et les snippets,
### `Dockerfile.app` (front)
- `ARG APP_DIR` → `frontend/cloud` (passé par compose).
- `ARG APP_DIR` → `frontend` (passé par compose).
- Stage `builder` : `npm ci` (cache npm), puis
`npm run build --workspace=${APP_DIR}` — le design system est dans le même
paquet, aucun build préalable n'est nécessaire.
@@ -46,8 +46,8 @@ Supprime le `default.conf` par défaut, copie `cloud.conf` et les snippets,
| Service | `APP_DIR` | Résultat |
| --- | --- | --- |
| `migrate` | `backend/cloud` | CLI `cohaise-migrate` (`dist/cli.js`) |
| `api` | `backend/cloud` | serveur Hono (`dist/index.js`) |
| `migrate` | `backend` | CLI `cohaise-migrate` (`dist/cli.js`) |
| `api` | `backend` | serveur Hono (`dist/index.js`) |
Même image, deux cibles : le conteneur `migrate` sert, joue les migrations puis
s'arrête ; `api` tourne en continu (`restart: unless-stopped`).
@@ -79,7 +79,7 @@ Pendant la copie, nginx sert l'ancienne version : aucun reload, aucune coupure.
## Migrations
Le service `migrate` monte `./backend/cloud/migrations:/migrations:ro` (lecture
Le service `migrate` monte `./backend/migrations:/migrations:ro` (lecture
seule) et lance :
```sh
+3 -3
View File
@@ -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
View File
@@ -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
View File
@@ -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
View File
@@ -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
View File
@@ -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
View File
@@ -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
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`.
@@ -4,7 +4,10 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="color-scheme" content="light dark" />
<meta name="theme-color" content="#b71c1c" />
<title>CoHaiSe Cloud</title>
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="apple-touch-icon" href="/favicon.ico" />
<script src="/theme.js"></script>
</head>
<body>
Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

@@ -1,6 +1,6 @@
{
"$schema": "https://json.schemastore.org/tsconfig",
"extends": "../../tsconfig.base.json",
"extends": "../tsconfig.base.json",
"compilerOptions": {
"lib": ["ES2022", "DOM", "DOM.Iterable"],
"jsx": "react-jsx",
+6 -6
View File
@@ -8,8 +8,8 @@
"name": "cohaise-cloud",
"version": "0.0.0",
"workspaces": [
"frontend/*",
"backend/*"
"frontend",
"backend"
],
"devDependencies": {
"typescript": "^7.0.2"
@@ -18,7 +18,7 @@
"node": ">=22.23.1"
}
},
"backend/cloud": {
"backend": {
"name": "@cohaise/cloud",
"version": "0.0.0",
"dependencies": {
@@ -39,7 +39,7 @@
"typescript": "^7.0.2"
}
},
"frontend/cloud": {
"frontend": {
"name": "@cohaise/cloud-web",
"version": "0.0.0",
"dependencies": {
@@ -60,11 +60,11 @@
}
},
"node_modules/@cohaise/cloud": {
"resolved": "backend/cloud",
"resolved": "backend",
"link": true
},
"node_modules/@cohaise/cloud-web": {
"resolved": "frontend/cloud",
"resolved": "frontend",
"link": true
},
"node_modules/@emnapi/runtime": {
+2 -2
View File
@@ -7,8 +7,8 @@
"node": ">=22.23.1"
},
"workspaces": [
"frontend/*",
"backend/*"
"frontend",
"backend"
],
"scripts": {
"build": "tsc --build && npm run build --workspaces --if-present",
+1 -1
View File
@@ -3,7 +3,7 @@
"files": [],
"references": [
{
"path": "./backend/cloud"
"path": "./backend"
}
]
}