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.
61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
# Standards — CoHaiSe Cloud
|
|
|
|
Conventions appliquées dans ce dépôt.
|
|
|
|
## Formatage
|
|
|
|
`.editorconfig` : UTF-8, LF, indentation 2 espaces, `trim_trailing_whitespace`
|
|
désactivé pour les `.md`. Aucun Prettier/ESLint installé.
|
|
|
|
## Palette
|
|
|
|
Source unique : `frontend/src/styles/tokens.css`.
|
|
|
|
| Jeton | Rôle | Valeur |
|
|
| --- | --- | --- |
|
|
| `--cohaise-accent` | marque : liens, focus, primaire | carmin `#b71c1c` |
|
|
| `--cohaise-destructive` | suppression, erreurs, champs invalides | `#d32f2f` clair / `#ef4444` sombre |
|
|
| `--cohaise-destructive-foreground` | texte posé dessus | `#ffffff` clair / `#1a0505` sombre |
|
|
| `--cohaise-warning` | avertissement, badges d'état | jaune `yellow-500` |
|
|
|
|
Règles :
|
|
|
|
- **Aucune orange** : `--cohaise-amber-*` a été retiré de la palette. Ne pas le
|
|
réintroduire.
|
|
- `tokens.css` est la source unique des couleurs : toute couleur ajoutée doit être
|
|
déclarée là, puis exposée via `theme.css`.
|
|
- Toute couleur ajoutée doit passer deux contrastes : comme **texte** sur le fond
|
|
d'application, et comme **fond** avec un texte posé dessus (≥ 4.5:1).
|
|
- Une règle sombre va dans le bloc `.dark`, jamais en
|
|
`@media (prefers-color-scheme: dark)` : la préférence utilisateur prime.
|
|
|
|
## Typographies
|
|
|
|
Poppins (texte), Orbitron et Cinzel (display), JetBrains Mono (code) —
|
|
woff2 hébergés dans `frontend/src/fonts/`, jamais par CDN.
|
|
|
|
## Composants
|
|
|
|
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/src`, jamais
|
|
dans `src/ui`.
|
|
|
|
## Côté serveur
|
|
|
|
- Toute entrée validée par Zod, tout chemin disque via `storage.ts`.
|
|
- `AppError` + code stable ; les erreurs 500 renvoient un message générique.
|
|
- Journal JSON (`LOG_LEVEL`), audit en base pour les actions sensibles.
|
|
- Cookies : `httpOnly`, `SameSite=Lax`, `secure` selon le schéma réel.
|
|
|
|
## Git et exploitation
|
|
|
|
| Élément | Attendu |
|
|
| --- | --- |
|
|
| Socle & design system | internes à `backend/src/{config,middleware,utils}` 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) |
|