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:
+11
-7
@@ -32,8 +32,8 @@ CI). L'exécuter avant de déclarer un travail fini.
|
||||
seulement. Le checksum bloquerait le démarrage.
|
||||
5. **API admin** : les routes `/api/cloud/admin/*` existent (UI Administration).
|
||||
La CLI (`make admin`) reste pour l'amorçage et les cas hors ligne.
|
||||
6. **Chemin disque** : toujours via `storage.ts` (`resolveInside`), jamais par
|
||||
concaténation depuis une entrée utilisateur.
|
||||
6. **Chemin disque** : toujours via `services/storageService.ts` (`resolveInside`),
|
||||
jamais par concaténation depuis une entrée utilisateur.
|
||||
7. **404 plutôt que 403** sur une ressource non accessible : ne pas introduire
|
||||
d'énumération.
|
||||
8. **CSP stricte** : pas de script en ligne dans `index.html` (utiliser un
|
||||
@@ -42,13 +42,17 @@ CI). L'exécuter avant de déclarer un travail fini.
|
||||
## Conventions
|
||||
|
||||
- TypeScript strict, project references racine.
|
||||
- Back : `routes/*Routes.ts` (HTTP fin) appellent `services/*Service.ts`
|
||||
(métier) ; le socle vit dans `config/`, `middleware/`, `utils/`, les types
|
||||
partagés dans `models/types.ts`.
|
||||
- Hono + Zod : toute route avec corps passe par un schéma Zod dédié.
|
||||
- Erreurs : `AppError` + codes (`errors.ts`) — jamais `throw` brut, jamais de
|
||||
détail de schéma dans une 500.
|
||||
- Erreurs : `AppError` + codes (`utils/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/src/lib/api.ts`),
|
||||
`credentials: "same-origin"`. React Router 7 (`App.tsx`) + `AppShell`, contexte
|
||||
de session dans `lib/session.tsx`.
|
||||
- Front : un client HTTP (`frontend/src/services/apiClient.ts`), puis un service
|
||||
par domaine (`services/*Service.ts`), `credentials: "same-origin"`. React
|
||||
Router 7 (`App.tsx`) + `AppShell`, contexte de session dans
|
||||
`contexts/SessionContext.tsx`.
|
||||
- `.editorconfig` : 2 espaces, LF, UTF-8.
|
||||
|
||||
## Design system
|
||||
|
||||
Reference in New Issue
Block a user