Files
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

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

  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.