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
61 lines
2.3 KiB
Markdown
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) |
|