@@ -0,0 +1,67 @@
|
||||
# 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`.
|
||||
Reference in New Issue
Block a user