CD — Deployment / deploy (push) Successful in 34s
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. --------- Co-authored-by: xEsiah <[email protected]> Reviewed-on: #26 Reviewed-by: Esiah <[email protected]> Co-authored-by: Gitea Actions <-[email protected]>
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) |