# Agents — CoHaiSe Web Conventions de travail pour un agent (ou un nouveau contributeur) reprenant ce dépôt seul. Paired avec `README.md` (démarrage rapide) et les autres fichiers de `docs/`. ## Commandes | Action | Commande | | --- | --- | | Dev hot-reload | `make dev` (Next.js 3000) | | Vérifier les types | `npm run typecheck` | | Builder | `npm run build` | | Reconstruire + publier | `make web` | | Santé | `curl -I http://localhost:8080/healthz` | | Conteneurs | `make ps`, `make logs` | Aucun linter, aucun test, aucune CI : `typecheck` + `build` sont les seules vérifications automatiques. Exécuter les deux avant de déclarer un travail fini. ## Règles du dépôt 1. **Ne pas toucher aux volumes** : pas de `docker volume rm`, pas de `docker compose down -v`. Les volumes ne sont jamais supprimés par les cibles. 2. **Ne pas committer ni pousser** sans demande explicite. 3. **Ne pas lire `.env`** : il contient des secrets d'autres apps. Écrire `SESSION_SECRET` est autorisé, le recopier depuis un autre dépôt aussi, le diffuser non. 4. **La vitrine n'a pas d'API** : l'export Next est statique ; le formulaire de contact appelle le CRM séparé (`backend/crm`). Ne pas ajouter de route dynamique serveur ou de secret dans `frontend/web`. 5. **`.env.example` n'est pas la vérité** : il contient des clés héritées que le compose n'utilise pas. Seul `COHAISE_HTTP_PORT` est lu. ## Conventions de code - TypeScript strict, project references (`tsconfig.json` racine). - React 19, Next.js app router : les pages et layouts sont des Server Components ; `"use client"` uniquement quand un hook ou un événement l'exige. - Tailwind 4 via `@import "tailwindcss"` ; **pas de classes arbitraires en dur** : passer par les jetons `--cohaise-*` (`@theme inline`). - Un élément animé porte `data-reveal` et reste visible sans JavaScript. - Style visuel : `Button`, `Card`, `cn` depuis `@cohaise/ui`. Pas de `
` quand un composant existe. - `.editorconfig` : 2 espaces, LF, UTF-8. ## Duplication du design system `frontend/shared` existe à l'identique dans les trois dépôts CoHaiSe. Avant de modifier un fichier partagé : 1. chercher d'abord si le besoin n'est pas déjà couvert par un jeton ; 2. si modification : appliquer dans les **trois** dépôts ; 3. vérifier `md5sum */frontend/shared/src/styles/tokens.css` → trois digests identiques. Ne jamais « améliorer » un composant d'un seul dépôt sans répercuter : les palettes doivent rester synchronisées. ## Pièges - `cohaise.dev` est HSTS-preloadé : `/etc/hosts` ne sert à rien, tester via `localhost:8080`. - `backend/shared` est construit avec le reste et consommé par `backend/crm` : une erreur de types ici bloque `npm run typecheck` pour tout le monorepo. - `docker/README.md` décrit la build d'image uniquement ; pour le service, `docs/deployment.md`. - Après `make web`, vérifier que le symlink a bien basculé : `docker compose exec nginx ls -l /usr/share/nginx/html/current`.