# @cohaise/web Vitrine institutionnelle de `cohaise.dev`, en Next.js 16 (app router, export statique). Ses routes sont servies par nginx : aucun serveur Node en production. ## Rôle | Responsabilité | Localisation | | --- | --- | | Design system, jetons, composants | `frontend/shared` | | Vitrine institutionnelle | `frontend/web` | | Publication des builds | `docker/` | ```mermaid flowchart LR subgraph navigateur app["frontend/web
Next.js (export statique)"] end subgraph monorepo ui["frontend/shared
@cohaise/ui"] end subgraph infrastructure web["nginx
cohaise.dev"] end app -->|import| ui app -->|out/| web ``` ## Prérequis - Node.js `>=22.23.1` - npm `>=10` ## Commandes | Commande | Effet | | --- | --- | | `npm run dev -w @cohaise/web` | serveur Next sur `http://localhost:3000` | | `npm run build -w @cohaise/web` | build de production dans `out/` | | `npm run typecheck -w @cohaise/web` | vérification de types seule | | `make web` | construit l'image et republie le build dans le volume nginx | Le premier build de la vitrine exige que `frontend/shared` soit construit : `npm run build` à la racine exécute `tsc --build` avant les workspaces. ## Routes | Route | Contenu | | --- | --- | | `/` | accueil : Hero + toutes les sections, JSON-LD | | `/services` | développement web, mobile, UI/UX, logiciels sur mesure | | `/demos` | CRM, inventaire IT, gamification scolaire | | `/stack` | technologies utilisées | | `/about` | présentation | | `/contact` | formulaire de contact → `POST /api/crm/leads` | | `/sitemap.xml` | généré depuis `app/lib/site.ts` | | `/robots.txt` | généré par `app/robots.ts` | | `/opengraph-image` | image 1200×630 générée par `app/opengraph-image.tsx` | ## SEO - `app/layout.tsx` : métadonnées par défaut, canonical, OpenGraph, Twitter, icônes, `metadataBase`. - Chaque page exporte son propre `metadata` (titre, description, canonical). - L'accueil injecte un JSON-LD `Organization`, `WebSite` et `ProfessionalService`. - Le HTML prérendu est en **français** : le toggle FR/EN est purement client et ne change pas l'URL indexée. ## Animations et défilement - Chaque section est une région d'un écran (`
`, `min-h-dvh`, `data-region`). Sur l'accueil, Stack et About partagent la même région. - `app/globals.css` : `scroll-snap-type: y mandatory` + `scroll-snap-stop: always` sur `main[data-scroll-snap] > section[data-region]`. On ne peut donc pas s'arrêter entre deux régions, ni en sauter une d'un geste. Le footer s'aligne sur la fin du viewport (`scroll-snap-align: end`) pour rester atteignable. Snap désactivé en `prefers-reduced-motion`, sous 620 px de haut, et dès qu'une région dépasse l'écran (`html[data-snap="off"]`, posé par `useScrollReveal`) pour ne jamais bloquer son contenu. - `app/hooks/useScrollReveal.ts` observe chaque région via une bande centrale du viewport. Après 0,25 s d'arrêt sur la région, ses `[data-reveal]` apparaissent en cascade (`data-reveal-delay` pour le décalage, le hero est à 0,2 s). Quitter la région avant la fin annule le minuteur. - `app/globals.css` définit `.reveal-init` / `.is-revealed` (fade-in-up). - Le contenu reste visible sans JavaScript ; `prefers-reduced-motion` désactive les animations et le scroll-snap. ## Thème et langue - Thème : script inline dans `app/layout.tsx` (anti-FOUC), état lu après montage par `ThemeContext`, persisté sous `cohaise-theme`. - Langue : `LanguageContext`, français au premier rendu, préférence persistée sous `cohaise-lang` puis appliquée après hydratation. ## Structure ```text frontend/web ├── app │ ├── layout.tsx shell, providers, métadonnées, script thème │ ├── page.tsx accueil + JSON-LD │ ├── globals.css Tailwind, régions (snap), reveal │ ├── providers.tsx │ ├── components/ Section (région), Header, Hero, Services, │ │ Demos, StackAbout, Contact, Footer, │ │ Background, ScrollReveal… │ │ └── background/ Topography (WebGL, client uniquement) │ ├── contexts/ LanguageContext, ThemeContext │ ├── data/ services, demos, stack │ ├── hooks/ useScrollReveal │ ├── lib/ site, api, gsap │ ├── services/ … une page par dossier │ ├── sitemap.ts, robots.ts, opengraph-image.tsx │ └── not-found.tsx ├── public/ favicon, images ├── next.config.ts export statique, trailingSlash ├── postcss.config.mjs └── tsconfig.json ``` ## Variables d'environnement | Variable | Usage | | --- | --- | | `NEXT_PUBLIC_CRM_API_URL` | URL de l'API CRM au build (défaut : `https://crm.cohaise.dev`, ou `http://localhost:8082` en local) | Seules les variables préfixées par `NEXT_PUBLIC_` sont exposées au navigateur. Aucun secret ne doit jamais être lu par le front. ## Limites - Export statique : pas de route dynamique serveur, pas d'optimisation d'image Next (`images.unoptimized: true`). - Le fond WebGL et les animations sont chargés côté client uniquement. - Les tests navigateur réels (hydratation, WebGL, reveals) restent manuels.