Files
CoHaiSe-CLOUD/docs/standards.md
T
Esiah cc397e96d8
PR — Ouverture automatique / create-pr (push) Failing after 1s
chore: initial import of CoHaiSe Cloud
Standalone files & media application: React/Vite frontend with the @cohaise/ui design system, Hono + MariaDB backend, nginx reverse proxy, Docker Compose stack, migrations 000-006, and project docs.

Adds Gitea Actions workflows for deployment, automatic pull requests, and Renovate dependency updates.
2026-10-14 15:24:06 +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/shared/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/shared/fonts/, jamais par CDN.

Composants

@cohaise/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, pas dans frontend/shared.

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
shared vit dans ce dépôt, cycle de vie commun
Port HTTP 8083 (COHAISE_HTTP_PORT)
Dépôt autonome, importance égale front et back
.env jamais versionné (.env.example seulement)