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
2.2 KiB
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.cssest la source unique des couleurs : toute couleur ajoutée doit être déclarée là, puis exposée viatheme.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 danssrc/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,secureselon 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) |