Files
CoHaiSe-CLOUD/docs/standards.md
T
Esiah 68d4d5dea0
PR — Ouverture automatique / create-pr (push) Successful in 3s
refactor: restructure frontend and backend by domain services
Split the monolithic backend (lib/, routes/, access.ts, storage.ts, media.ts)
into a layered structure inspired by JeanXXIII-CRM:
- config/: appConfig, db
- middleware/: auth (session, roles, cookies)
- models/: shared types
- routes/: *Routes.ts (thin HTTP handlers)
- services/: *Service.ts (business logic, one per domain)
- utils/: errors, http, migrate, ratelimit, validators, service bootstrap

Frontend likewise: services/*Service.ts + apiClient, contexts/, types/, utils/format.
Route files now carry the "Routes" suffix; service files are named
authService.ts, ratelimit.ts, etc. and live in their own files, frontend and
backend separated.

Updated docs and READMEs to reflect the new layout. Typecheck and builds pass.
2026-11-13 09:45:21 +01: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/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/{config,middleware,utils}` 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) |