Files
CoHaiSe/frontend/web/README.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

137 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# @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<br/>Next.js (export statique)"]
end
subgraph monorepo
ui["frontend/shared<br/>@cohaise/ui"]
end
subgraph infrastructure
web["nginx<br/>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 (`<Section>`, `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.