- 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
3.0 KiB
3.0 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 (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
- 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. - 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 dansfrontend/web. .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, 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-revealet reste visible sans JavaScript. - 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 avec le reste et consommé parbackend/crm: une erreur de types ici bloquenpm run typecheckpour tout le monorepo.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.