Files
CoHaiSe-CLOUD/docs/standards.md
T
Gitea ActionsandEsiah 9dd1ad72e0
CD — Déploiement / deploy (push) Failing after 25s
feat: logo et favicon, confirmation modale, fil d'ariane, e-mails sombres (#4)
- logo embarque dans les e-mails (CID) et gabarit repense en mode sombre
- favicon multi-tailles + icone PNG, logo a gauche du titre (app et auth)
- modale de confirmation animee a la place de window.confirm
- bouton retour et fil d'ariane dans l'explorateur

---------

Co-authored-by: xEsiah <[email protected]>
Reviewed-on: #4
Reviewed-by: Esiah <[email protected]>
Co-authored-by: Gitea Actions <-[email protected]>
2026-10-16 11:08:47 +00:00

61 lines
2.2 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/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/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
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/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) |