2.7 KiB
2.7 KiB
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 (Vite 5173) |
| 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
- Ne pas toucher aux volumes : pas de
docker volume rm, pas dedocker compose down -v. Les volumes ne sont jamais supprimés par les cibles. - Ne pas committer ni pousser sans demande explicite.
- Ne pas lire
.env: il contient des secrets d'autres apps. ÉcrireSESSION_SECRETest autorisé, le recopier depuis un autre dépôt aussi, le diffuser non. - Ne pas créer de backend : ce dépôt est une vitrine statique. Toute
fonctionnalité nécessitant une API appartient à
CoHaiSe-CLOUDouCoHaiSe-CRM. .env.examplen'est pas la vérité : il contient des clés héritées que le compose n'utilise pas. SeulCOHAISE_HTTP_PORTest lu.
Conventions de code
- TypeScript strict, project references (
tsconfig.jsonracine). - React 19, pas de routeur : la navigation est un état dans
App.tsx. - Tailwind 4 via
@import "tailwindcss"; pas de classes arbitraires en dur : passer par les jetons--cohaise-*(@theme inline). - Style visuel :
Button,Card,cndepuis@cohaise/ui. Pas de<div class="bg-…">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é :
- chercher d'abord si le besoin n'est pas déjà couvert par un jeton ;
- si modification : appliquer dans les trois dépôts ;
- 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.devest HSTS-preloadé :/etc/hostsne sert à rien, tester vialocalhost:8080.backend/sharedest construit mais inutilisé : une erreur de types ici ne casse pas le site.docker/README.mddé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.