Files
CoHaiSe/docs/standards.md
T
Esiah 858d862fed
deploy / deploy (push) Canceled after 0s
feat: init repo
2026-11-10 19:56:03 +01:00

88 lines
3.3 KiB
Markdown

# Standards — CoHaiSe Web
Conventions à respecter pour que ce dépôt reste cohérent avec les deux autres
(`CoHaiSe-CLOUD`, `CoHaiSe-CRM`), qui partagent le même design system.
## Formatage
`.editorconfig` fait foi :
| Réglage | Valeur |
| --- | --- |
| Charset | UTF-8, fin de ligne LF |
| Indentation | 2 espaces (pas de tabs) |
| `trim_trailing_whitespace` | `false` pour `*.md`, vrai ailleurs |
Aucun Prettier/ESLint n'est installé : l'éditeur et l'`.editorconfig` sont la
seule norme mécanique.
## Palette
Source unique : `frontend/shared/src/styles/tokens.css`.
| Jeton | Rôle | Valeur |
| --- | --- | --- |
| `--cohaise-accent` | accent de marque (liens, focus, éléments primaires) | carmin `#b71c1c` (`crimson-700`) |
| `--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` |
| `--cohaise-surface`, `--cohaise-background` | fonds | gris chaud `#f7f5f4` / `#050000` |
Règles :
- **L'orange n'existe plus** : `--cohaise-amber-*` a été retiré. Ne pas le
réintroduire — le rouge a remplacé l'ambre sur le bouton destructif pour des
raisons de contraste (≥4.5:1 en clair comme en sombre).
- Ne pas dériver la palette dans un seul dépôt : `tokens.css` doit rester
identique partout.
- Toute nouvelle couleur doit être lisible **comme texte** sur le fond
d'application ET comme fond avec un texte posé dessus. Vérifier les deux cas.
## Typographies
Chargées en local (`frontend/shared/fonts/*.woff2`), jamais par CDN :
| Usage | Police |
| --- | --- |
| Texte courant | Poppins 400/600 |
| Titres display | Orbitron, Cinzel |
| Code / monospace | JetBrains Mono |
## Composants
`@cohaise/ui` expose `Button`, `Card` (+ sous-composants), `Input`, `Skeleton`,
`Spinner` et l'utilitaire `cn`.
- Un composant partagé ne doit pas connaître le métier d'une app.
- Une variante visuelle propre à une app se développe **dans cette app**, pas
dans `frontend/shared`.
- `Skeleton` et `Spinner` sont prévus pour les états de chargement ; ne pas
réinventer un spinner.
## Thème
- Bascule clair/sombre par la classe `.dark` sur `<html>`.
- Script inline dans `index.html` (avant le bundle) : lit
`localStorage["cohaise-theme"]`, sinon `prefers-color-scheme`. C'est lui qui
évite le flash de thème.
- `color-scheme: light dark` déclaré pour les contrôles natifs.
- Toute règle sombre va dans le bloc `.dark` de `tokens.css`, pas en
`@media (prefers-color-scheme: dark)` : la préférence utilisateur prime.
## Git
- Branche `main` unique, remote `origin` sur `git.cohaise.dev`.
- Pas de convention de message imposée par l'historique (dépôt neuf).
- N'exclure de git que : `.env*` (sauf `.env.example`), `node_modules/`,
`dist/`, `*.log`, `backups/`.
- `docs/` est **versionné** (la ligne `docs/` de `.gitignore` a été retirée).
## Interdépôts
| Élément | Attendu |
| --- | --- |
| `frontend/shared/src/styles/tokens.css` | identique (même `md5sum`) |
| Composants `@cohaise/ui` | dupliqués, **peuvent diverger** |
| Ports | web `8080`, CRM `8082`, Cloud `8083` |
| Remotes | un dépôt Git autonome par app, aucun lien de code entre eux |