Files
CoHaiSe-CLOUD/docs/standards.md
T
Esiah 68d4d5dea0
PR — Ouverture automatique / create-pr (push) Successful in 3s
refactor: restructure frontend and backend by domain services
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.
2026-11-13 09:45:21 +01:00

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.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)