- 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.4 KiB
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,Spinneroucndoit être répliqué à la main dans :CoHaiSe/frontend/sharedCoHaiSe-CLOUD/frontend/sharedCoHaiSe-CRM/frontend/shared
tokens.cssdoit rester strictement identique dans les trois (comparer parmd5sum). Les composants, eux, peuvent diverger : chaque app les redéfinit à sa main.- Après modification :
npm run build --workspace=frontend/shared, puismake webpour 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, remoteorigin 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.ymlabsents). - Ne jamais committer
.env,node_modules/,dist/,out/,.next/(exclus par.gitignore).
Pièges connus
.deven HSTS-preload :/etc/hostsne fera jamais fonctionnercohaise.deven local. Tester surlocalhost.backend/sharedest construit avec le reste : il est consommé parbackend/crm, mais une erreur de types ici bloque aussinpm run typecheck.docker/README.mdhistorique : ne sert que les images ; le fonctionnement réel est dansdocs/deployment.md.- Export statique :
next buildécrit dansout/, pasdist/. Ne pas ajouter de route dynamique sans vérifier la compatibilité avecoutput: "export". - Pas d'ESLint :
typescript-eslintne supporte pas TypeScript 7.0. Seulstypechecketbuildvérifient le code.