refactor: fold shared ui/server packages into the cloud app

Le depot ne contient plus qu'une seule application : plus de paquets
@cohaise/ui ni @cohaise/server.

- backend/shared/src -> backend/cloud/src/lib (socle serveur inline)
- frontend/shared/src -> frontend/cloud/src/{ui,styles,fonts}
- imports @cohaise/server / @cohaise/ui remplaces par des chemins relatifs
- package.json, tsconfig, Dockerfiles et docker-compose sans workspace partage
- docs (README, architecture, standards, workflow, agents, api, security,
  deployment, docker) alignes sur la structure autonome
This commit is contained in:
2026-10-16 11:47:20 +02:00
parent 25b6e0669a
commit 75da61ac93
79 changed files with 1838 additions and 477 deletions
+1 -1
View File
@@ -53,7 +53,7 @@ CI). L'exécuter avant de déclarer un travail fini.
## Design system
`frontend/shared` (`@cohaise/ui`) vit dans ce dépôt.
Le design system vit dans `frontend/cloud/src/ui`.
- `tokens.css` est la source unique des couleurs et typographies ; ne pas coder
de couleur en dur ailleurs.
+1 -1
View File
@@ -131,7 +131,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/cloud/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 :
+14 -13
View File
@@ -9,26 +9,27 @@ 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` |
| 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/shared/src/config.ts` et chaque route |
| Validation Zod | `backend/cloud/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/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/
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/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
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
+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/shared/src/config.ts`).
pose problème (`backend/cloud/src/lib/config.ts`).
## Variables
+2 -2
View File
@@ -17,7 +17,7 @@
### Limitation de débit
- **Applicatif** : `createRateLimiter` (`backend/shared/src/ratelimit.ts`) par IP
- **Applicatif** : `createRateLimiter` (`backend/cloud/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).
@@ -34,7 +34,7 @@ ressource.
### Courriel
Nodemailer (`backend/shared/src/mail.ts`) avec `SMTP_HOST`. `PUBLIC_ORIGIN`
Nodemailer (`backend/cloud/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
View File
@@ -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/cloud/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/cloud/src/fonts/`, jamais par CDN.
## Composants
`@cohaise/ui` : `Button`, `Card`, `Input`, `Skeleton`, `Spinner`, `cn`.
Design system local à `frontend/cloud/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/cloud/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/cloud/src/lib` et `frontend/cloud/src/ui` |
| Port HTTP | `8083` (`COHAISE_HTTP_PORT`) |
| Dépôt | autonome, importance égale front et back |
| `.env` | jamais versionné (`.env.example` seulement) |
+5 -5
View File
@@ -38,7 +38,7 @@ fichier est copié dans l'image, pas monté.
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/cloud/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`).
@@ -56,10 +56,10 @@ 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/cloud/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
@@ -68,12 +68,12 @@ migration, pas en éditant l'ancienne (le checksum bloquerait le démarrage).
| Droit d'accès à un dossier/fichier | `backend/cloud/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` |
| En-têtes, CORS, healthz | `backend/cloud/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` |
| Couleurs / composants | `frontend/cloud/src/styles/tokens.css` |
## Git