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:
+1
-1
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user