# 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 n'est installé : l'éditeur et l'`.editorconfig` sont la seule norme mécanique. ESLint a été retiré de `frontend/web` : `typescript-eslint` ne supporte pas encore TypeScript 7.0. Ne pas le réintroduire tant que ce support n'existe pas. ## 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 ``. - Script inline dans `frontend/web/app/layout.tsx` (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. ## Next.js (vitrine) - Tout fichier qui utilise un hook, un événement ou une API navigateur porte `"use client"` ; les pages et le layout restent des Server Components. - Les métadonnées SEO vont dans `export const metadata` (page ou layout), pas dans un composant client. Une page = une entrée dans `app/lib/site.ts` pour rester alignée avec le sitemap. - Les données statiques vivent dans `app/data/`. Un objet contenant des fonctions ou des icônes React ne doit jamais traverser la frontière serveur → client : le composant importe la donnée lui-même. - Une section = une région plein écran : `
` pose `data-region` et `min-h-dvh`. Ne pas créer de section hors de ce composant, sinon elle échappe au scroll-snap. - Les reveals passent par `data-reveal` / `data-reveal-delay` et `useScrollReveal` (délai par région via `data-region-delay`) ; ne pas animer un élément sans prévoir son état sans JS. - `next build` produit `out/` (`output: "export"`). Ne pas ajouter de route dynamique sans vérifier la compatibilité avec l'export statique. - Le menu de l'en-tête est une barre d'onglets, pas une liste d'ancres : aucun `#` n'est écrit dans l'URL. Sur l'accueil, clic → séquence GSAP région par région et pastille qui glisse vers l'onglet ; ailleurs, la cible passe par `setPendingSection`/`sessionStorage` puis est rejointe après le retour à `/`. `scrollToSection` suspend le snap (`data-scroll-anim`) le temps de la séquence, sinon le navigateur saute directement à la destination ; la durée renvoyée prolonge le verrou d'onglet. L'onglet actif suit la région visible (bande centrale) sauf pendant le défilement déclenché par un clic, où il reste sur l'entrée choisie. Une cible imbriquée (About dans la région Stack) est ramenée à sa région par `scrollToSection`, car le snap opère par région. - Les pages SEO autonomes (`/services`, `/about`, …) réutilisent une seule région sans pied de page et tiennent dans le viewport (règle `section[data-region]:only-child` dans `globals.css`). Ne pas les laisser défiler : le menu est justement là pour ramener aux régions de l'accueil. ## Front CRM - La page ne défile **jamais** : le shell est en `h-dvh overflow-hidden`, et les zones de contenu (`DataTable`, dialogue) portent `min-h-0` + `overflow-auto`. Ne pas retirer `min-h-0` d'un parent flex, sinon le tableau repousse la page. - Toute liste passe par `components/DataTable.tsx` : colonnes triables, recherche, actions de ligne, squelette et cartes sous `md`. Ne pas recréer un `` dans une page. - Les formulaires de création/édition passent par `RecordDialog` ; seul son corps défile. Les boutons d'action de ligne utilisent `RowActionButton`. - Les pictogrammes viennent des WebP du dépôt, rendus par `MaskIcon` dans `components/icons.tsx` : `FolderMaskIcon`/`UsersMaskIcon`/`ActivityMaskIcon` pour le rail, `PenMaskIcon`, `TrashMaskIcon`, `SearchMaskIcon`, `CloseMaskIcon`, `LogoutMaskIcon` pour les actions. Le masque CSS + `background-color: currentColor` permet au survol de les teinter en accent ou en destructif sans filtre. Ne pas revenir à un `` : les fichiers sont blancs et disparaîtraient sur fond clair. `components/glyphs.tsx` ne garde que les flèches (`ChevronDownGlyph`, `ArrowUpGlyph`). - L'en-tête du CRM porte `.glass` (défini dans `theme.css`, commun à la vitrine et au CRM) ; la surface de travail reste sans flou et `DataTable` porte son propre fond translucide (`bg-surface/80 backdrop-blur-xl`), avec un en-tête sticky à `/90` pour garder le texte lisible quand les lignes passent dessous. - Les champs (`Input` partagé, selects, recherche) réagissent au survol par un bord accent ; le bouton de déconnexion est une icône seule (`LogoutMaskIcon`) avec `aria-label` et `title`, jamais un libellé visible. ## Backend CRM - Une route valide l'entrée (Zod), appelle un service, renvoie le statut HTTP. Aucune requête SQL directement dans `routes/`. - Un service reçoit `db` et des données déjà typées ; il lève `AppError` pour les cas métier (404, 409, 422) et laisse remonter le reste. - Les noms de colonnes SQL restent dans les services et `models/types.ts` ; l'API expose ses propres champs. - Les erreurs de contrainte MariaDB passent par `utils/dbErrors.ts` (1062, 1451, 1452), jamais par une comparaison de message. ## 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/`, `.next/`, `out/`, `*.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 |