Files
CoHaiSe-CLOUD/docs/standards.md
T
Esiah 75da61ac93 refactor: fold shared ui/server packages into the cloud app
Le depot ne contient plus qu'une seule application : plus de paquets
@cohaise/ui ni @cohaise/server.

- backend/shared/src -> backend/cloud/src/lib (socle serveur inline)
- frontend/shared/src -> frontend/cloud/src/{ui,styles,fonts}
- imports @cohaise/server / @cohaise/ui remplaces par des chemins relatifs
- package.json, tsconfig, Dockerfiles et docker-compose sans workspace partage
- docs (README, architecture, standards, workflow, agents, api, security,
  deployment, docker) alignes sur la structure autonome
2026-10-16 11:47:20 +02: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/cloud/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/cloud/src/fonts/, jamais par CDN.

Composants

Design system local à frontend/cloud/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/cloud/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/cloud/src/lib et frontend/cloud/src/ui
Port HTTP 8083 (COHAISE_HTTP_PORT)
Dépôt autonome, importance égale front et back
.env jamais versionné (.env.example seulement)