refactor: restructure frontend and backend by domain services
PR — Ouverture automatique / create-pr (push) Successful in 3s
PR — Ouverture automatique / create-pr (push) Successful in 3s
Split the monolithic backend (lib/, routes/, access.ts, storage.ts, media.ts) into a layered structure inspired by JeanXXIII-CRM: - config/: appConfig, db - middleware/: auth (session, roles, cookies) - models/: shared types - routes/: *Routes.ts (thin HTTP handlers) - services/: *Service.ts (business logic, one per domain) - utils/: errors, http, migrate, ratelimit, validators, service bootstrap Frontend likewise: services/*Service.ts + apiClient, contexts/, types/, utils/format. Route files now carry the "Routes" suffix; service files are named authService.ts, ratelimit.ts, etc. and live in their own files, frontend and backend separated. Updated docs and READMEs to reflect the new layout. Typecheck and builds pass.
This commit is contained in:
+30
-20
@@ -9,27 +9,36 @@ 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` |
|
||||
| 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 |
|
||||
| Hono | `backend/src/index.ts` (`src/utils` pour le socle HTTP) |
|
||||
| MariaDB (`mysql2`) | `backend/src/config/db.ts` |
|
||||
| Nodemailer | `backend/src/services/mailService.ts` |
|
||||
| sharp (vignettes) | `backend/src/services/mediaService.ts` |
|
||||
| Validation Zod | `backend/src/config/appConfig.ts`, `src/utils/validators.ts` et chaque route |
|
||||
|
||||
## Découpage
|
||||
|
||||
```
|
||||
backend/src/lib/ socle serveur : config, db, mail, mail-template, 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/src/config/ configuration et connexion base (appConfig, db)
|
||||
backend/src/middleware/ gardes HTTP (auth : session, rôles)
|
||||
backend/src/models/ types partages (types.ts)
|
||||
backend/src/routes/ routeurs HTTP fins, un par domaine (*Routes.ts)
|
||||
backend/src/services/ logique metier, un fichier par domaine (*Service.ts)
|
||||
backend/src/utils/ socle technique : errors, http, ratelimit, validators, migrate, service
|
||||
backend/src/ index.ts (bootstrap), cli.ts, admin.ts
|
||||
backend/migrations/ 000 … 010
|
||||
frontend/src/services/ clients API par domaine (*Service.ts + apiClient.ts)
|
||||
frontend/src/contexts/ SessionContext, ThemeContext, I18nContext
|
||||
frontend/src/types/ types partages du front
|
||||
frontend/src/utils/ formatage (format.ts)
|
||||
frontend/src/ui/ design system (boutons, cartes, champs, spinner)
|
||||
frontend/src/ router + AppShell + pages/
|
||||
docker/ Dockerfile(.app/.api), nginx/, publish.sh
|
||||
```
|
||||
|
||||
`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.
|
||||
`backend/src/utils` porte la mécanique générique (erreurs, HTTP, migrations,
|
||||
limitation de débit, validation), `backend/src/services` porte le métier :
|
||||
sessions, droits, quotas, chemins disque, traitement média, courriel.
|
||||
Tout vit dans un seul paquet, sans dépendance de workspace.
|
||||
|
||||
## Chaîne de démarrage
|
||||
|
||||
@@ -58,8 +67,9 @@ app-build (publish.sh, terminé avant nginx)
|
||||
- Pages : `Login`, `ForgotPassword`, `ResetPassword`, `ConfirmEmail`,
|
||||
`ChangePassword`, `Browser`, `Search`, `Gallery`, `Trash`, `Profile`,
|
||||
`Admin` (comptes / stockage / journal).
|
||||
- Client HTTP unique `lib/api.ts` (base `/api/cloud`, `same-origin`) ; contexte
|
||||
de session `lib/session.tsx` ; dialogues réutilisables dans
|
||||
- Client HTTP unique `services/apiClient.ts` (base `/api/cloud`, `same-origin`) ;
|
||||
services par domaine dans `services/*Service.ts` ; contexte de session
|
||||
`contexts/SessionContext.tsx` ; dialogues réutilisables dans
|
||||
`components/dialogs.tsx`.
|
||||
- En-têtes nginx : CSP stricte, HSTS, `nosniff`, `Referrer-Policy`,
|
||||
`Permissions-Policy` (`docker/nginx/snippets/`). `X-Frame-Options` est
|
||||
@@ -78,9 +88,9 @@ app-build (publish.sh, terminé avant nginx)
|
||||
## Stockage et médias
|
||||
|
||||
- `MEDIA_DIR=/data/media/originals`, `VARIANT_DIR=/data/media/variants`.
|
||||
- Chemin physique `${MEDIA_DIR}/<slug>/<uuid><ext>` (`storage.ts`), nom affiché
|
||||
jamais dans le chemin.
|
||||
- `media.ts` : classification (`image/video/audio/document/archive/other`),
|
||||
- Chemin physique `${MEDIA_DIR}/<slug>/<uuid><ext>` (`storageService.ts`), nom
|
||||
affiché jamais dans le chemin.
|
||||
- `mediaService.ts` : classification (`image/video/audio/document/archive/other`),
|
||||
vignette (`sharp`, seuil 480 px) écrite dans `VARIANT_DIR`, métadonnées dans
|
||||
`media_metadata` / `file_variants`. Indexation **best-effort** après upload.
|
||||
- Avatars dans `user_avatars`.
|
||||
|
||||
Reference in New Issue
Block a user