# Workflow — CoHaiSe Web ## Boucle de développement ```sh 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 ```sh 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é ```sh 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.