Files
CoHaiSe-CLOUD/docs/standards.md
T
Esiah f564908650 refactor: aplatir backend/cloud et frontend/cloud
Le niveau `cloud` etait redondant : il ne reste qu'une seule application.

- backend/cloud/* -> backend/*, frontend/cloud/* -> frontend/*
- workspaces npm : frontend et backend ; reference tsconfig ./backend
- extends tsconfig.base corrige (../ au lieu de ../../)
- docker-compose : APP_DIR backend/frontend, montage ./backend/migrations
- deploy.yml : reconstruit aussi l'image migrate
- chemins mis a jour dans les docs, le Makefile et docker/README.md
2026-10-16 11:50:55 +02:00

2.2 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/lib 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)