Files
CoHaiSe/docs/workflow.md
T
Esiah 09cf07d79b 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
2026-11-16 00:52:29 +01:00

3.4 KiB

Workflow — CoHaiSe Web

Boucle de développement

make dev          # Next.js sur http://localhost:3000, hot reload

Le serveur de dev sert frontend/web avec Next.js. Il n'a pas besoin de Docker ni de .env. Pour tester le formulaire de contact, l'API CRM doit tourner sur http://localhost:8082 (ou définir NEXT_PUBLIC_CRM_API_URL).

Vérification avant de valider

npm run typecheck          # tsc --build sur toutes les références
npm run build              # typecheck + build de chaque workspace
curl -I http://localhost:8080/healthz

Il n'y a ni linter, ni testeur, ni CI dans ce dépôt : typecheck et build sont les seules garanties automatiques. .editorconfig porte les conventions (2 espaces, LF, UTF-8 ; pas de trim_trailing_whitespace pour les .md).

Reconstruire le site publié

make web        # build + publication atomique
make reload     # uniquement si nginx/web.conf a changé

make web ne coupe jamais le service : la copie se fait à côté, le lien bascule ensuite.

Modifier le design system

Point le plus important : frontend/shared est dupliqué dans les trois dépôts CoHaiSe. Il n'y a pas de version centrale.

  • Un correctif de Button, Card, Input, Skeleton, Spinner ou cn doit être répliqué à la main dans :
    • CoHaiSe/frontend/shared
    • CoHaiSe-CLOUD/frontend/shared
    • CoHaiSe-CRM/frontend/shared
  • tokens.css doit rester strictement identique dans les trois (comparer par md5sum). Les composants, eux, peuvent diverger : chaque app les redéfinit à sa main.
  • Après modification : npm run build --workspace=frontend/shared, puis make web pour republier.

Où changer quoi

Besoin Fichier
Couleur, rayon, police, ombre frontend/shared/src/styles/tokens.css
Composant partagé frontend/shared/src/components/*.tsx
Page, layout, contenu frontend/web/app/**
Routes et métadonnées SEO frontend/web/app/*/page.tsx, frontend/web/app/lib/site.ts
Sitemap / robots / image OG frontend/web/app/sitemap.ts, robots.ts, opengraph-image.tsx
Animations d'entrée frontend/web/app/hooks/useScrollReveal.ts + globals.css
Cache, en-têtes, 404 docker/nginx/web.conf + docker/nginx/snippets/
Port public COHAISE_HTTP_PORT dans .env
Thème par défaut script inline de frontend/web/app/layout.tsx

Git

  • Branche main, remote origin https://git.cohaise.dev/Esiah/CoHaiSe.git.
  • Historique vierge (un commit initial) : aucune convention de message héritée.
  • Pas de hooks, pas de CI (.github/, .gitlab-ci.yml absents).
  • Ne jamais committer .env, node_modules/, dist/, out/, .next/ (exclus par .gitignore).

Pièges connus

  1. .dev en HSTS-preload : /etc/hosts ne fera jamais fonctionner cohaise.dev en local. Tester sur localhost.
  2. backend/shared est construit avec le reste : il est consommé par backend/crm, mais une erreur de types ici bloque aussi npm run typecheck.
  3. docker/README.md historique : ne sert que les images ; le fonctionnement réel est dans docs/deployment.md.
  4. Export statique : next build écrit dans out/, pas dist/. Ne pas ajouter de route dynamique sans vérifier la compatibilité avec output: "export".
  5. Pas d'ESLint : typescript-eslint ne supporte pas TypeScript 7.0. Seuls typecheck et build vérifient le code.