Files
CoHaiSe-CLOUD/docs/standards.md
T
Gitea ActionsandEsiah 9dd1ad72e0
CD — Déploiement / deploy (push) Failing after 25s
feat: logo et favicon, confirmation modale, fil d'ariane, e-mails sombres (#4)
- logo embarque dans les e-mails (CID) et gabarit repense en mode sombre
- favicon multi-tailles + icone PNG, logo a gauche du titre (app et auth)
- modale de confirmation animee a la place de window.confirm
- bouton retour et fil d'ariane dans l'explorateur

---------

Co-authored-by: xEsiah <[email protected]>
Reviewed-on: #4
Reviewed-by: Esiah <[email protected]>
Co-authored-by: Gitea Actions <-[email protected]>
2026-10-16 11:08:47 +00: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)