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.
2.3 KiB
2.3 KiB
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.cssest la source unique des couleurs : toute couleur ajoutée doit être déclarée là, puis exposée viatheme.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 danssrc/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,secureselon 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) |