@@ -0,0 +1,87 @@
|
||||
# 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 |
|
||||
Reference in New Issue
Block a user