Files
CoHaiSe/docs/agents.md
T
Gitea Actions 723b68ea80
deploy / deploy (push) Successful in 1m24s
feat: migrate showcase to Next.js and overhaul CRM UI
rebuild the public site on the Next.js App Router with static export,

per-section SEO pages, metadata, sitemap, robots and a generated OG image

add full-screen scroll-snap regions, staged scroll reveals, a hash-free

tab navigation with a sliding indicator and region-by-region menu scrolling

replace the theme text toggle with animated sun/moon icons

restructure the CRM API into config, middleware, models, routes, services

and utils layers

redesign the CRM shell with a single surface, tab rail, full-width blurred

DataTable, record dialogs and mask-based icons

update Docker/Nginx publishing, Makefile targets, shared UI polish and docs

Co-authored-by: Gitea Actions <-[email protected]>
2026-11-16 00:08:17 +00:00

70 lines
3.0 KiB
Markdown

# 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
`<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 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`.