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