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

61 lines
2.3 KiB
Markdown

# 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) |