Files
CoHaiSe/docs/agents.md
T
Esiah 858d862fed
deploy / deploy (push) Canceled after 0s
feat: init repo
2026-11-10 19:56:03 +01:00

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

  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. Ne pas créer de backend : ce dépôt est une vitrine statique. Toute fonctionnalité nécessitant une API appartient à CoHaiSe-CLOUD ou CoHaiSe-CRM.
  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, 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, cn depuis @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é :

  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 mais inutilisé : une erreur de types ici ne casse pas le site.
  • 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.