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
This commit is contained in:
+92
-63
@@ -1,19 +1,20 @@
|
||||
# @cohaise/web
|
||||
|
||||
Vitrine institutionnelle de `cohaise.dev`. Première application du monorepo CoHaiSe et premier consommateur réel du design system partagé.
|
||||
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` |
|
||||
| Point d'entrée local, publication des builds | `docker/nginx` |
|
||||
| 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/>React + Vite"]
|
||||
app["frontend/web<br/>Next.js (export statique)"]
|
||||
end
|
||||
subgraph monorepo
|
||||
ui["frontend/shared<br/>@cohaise/ui"]
|
||||
@@ -22,7 +23,7 @@ flowchart LR
|
||||
web["nginx<br/>cohaise.dev"]
|
||||
end
|
||||
app -->|import| ui
|
||||
app -->|build statique| web
|
||||
app -->|out/| web
|
||||
```
|
||||
|
||||
## Prérequis
|
||||
@@ -32,76 +33,104 @@ flowchart LR
|
||||
|
||||
## Commandes
|
||||
|
||||
| Commande | Effet |
|
||||
| ----------------------------------- | ----------------------------------------------------------- |
|
||||
| `npm run dev -w @cohaise/web` | serveur Vite sur `http://localhost:5173` |
|
||||
| `npm run build -w @cohaise/web` | vérification de types puis build de production dans `dist/` |
|
||||
| `npm run preview -w @cohaise/web` | sert le build de production localement |
|
||||
| `npm run typecheck -w @cohaise/web` | vérification de types seule |
|
||||
| `make web` | construit l'image et republie le build dans le volume Nginx |
|
||||
| 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 |
|
||||
|
||||
## Publication dans l'infrastructure
|
||||
Le premier build de la vitrine exige que `frontend/shared` soit construit :
|
||||
`npm run build` à la racine exécute `tsc --build` avant les workspaces.
|
||||
|
||||
Le `Dockerfile` est un build multi-étapes. Le contexte de construction est la racine du
|
||||
monorepo, car le build a besoin des workspaces, du lockfile et des références
|
||||
TypeScript partagées.
|
||||
## Routes
|
||||
|
||||
```text
|
||||
node:22-alpine deps installation déterministe via npm ci
|
||||
node:22-alpine builder tsc --build puis vite build
|
||||
alpine:3.21 export /app/dist, copié dans le volume web_data
|
||||
```
|
||||
| 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` |
|
||||
|
||||
Le service `cohaise-web-build` copie le résultat dans le volume `web_data`, que Nginx
|
||||
monte déjà sur `/usr/share/nginx/html/web`. Aucune modification de la configuration
|
||||
Nginx n'est nécessaire, et la publication reste découplée des autres applications.
|
||||
## SEO
|
||||
|
||||
## Consommation du design system
|
||||
- `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.
|
||||
|
||||
L'application importe la feuille de style publique du package partagé une seule fois, dans `src/styles/index.css` :
|
||||
## Animations et défilement
|
||||
|
||||
```css
|
||||
@import "tailwindcss";
|
||||
@import "@cohaise/ui/styles";
|
||||
- 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.
|
||||
|
||||
@source "../../../../frontend/shared/src";
|
||||
```
|
||||
## Thème et langue
|
||||
|
||||
La directive `@source` est indispensable. Sans elle, Tailwind ignore `node_modules` et les classes utilisées par les composants de `frontend/shared` ne sont jamais générées : les composants s'afficheraient sans style.
|
||||
|
||||
## Thème
|
||||
|
||||
Le thème est appliqué par la classe `dark` sur `<html>`. Le script inline de `index.html` applique la préférence enregistrée ou celle du système avant le premier rendu, ce qui évite le flash de thème clair. `src/hooks/useTheme.ts` pilote le changement et persiste le choix dans `localStorage` sous la clé `cohaise-theme`.
|
||||
- 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
|
||||
├── index.html amorce de thème et point de montage
|
||||
├── public/favicon.webp
|
||||
├── src
|
||||
│ ├── App.tsx composition de la page
|
||||
│ ├── main.tsx point d'entrée React
|
||||
│ ├── components
|
||||
│ │ ├── DemoCard.tsx états repos, chargement, chargé
|
||||
│ │ └── ThemeToggle.tsx
|
||||
│ ├── hooks
|
||||
│ │ └── useTheme.ts
|
||||
│ └── styles/index.css import du design system
|
||||
├── tsconfig.json
|
||||
├── tsconfig.node.json
|
||||
└── vite.config.ts
|
||||
├── 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
|
||||
```
|
||||
|
||||
## Limites actuelles
|
||||
|
||||
- Aucun appel réseau : toutes les données de démonstration sont locales.
|
||||
- Aucun routage : la page est un point d'entrée unique.
|
||||
- Les URL d'API devront passer par un wrapper dédié, jamais codées en dur dans les composants.
|
||||
|
||||
## Variables d'environnement
|
||||
|
||||
L'application ne déclare aucune variable pour l'instant. Le gabarit `frontend/web/.env.example`
|
||||
prendra une entrée `VITE_API_BASE_URL` au moment où le premier appel réseau existera, afin
|
||||
que l'URL reste définie à un seul endroit. Seules les variables préfixées par `VITE_` sont
|
||||
exposées au bundle ; aucun secret ne doit jamais être lu par le navigateur.
|
||||
| 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.
|
||||
|
||||
Reference in New Issue
Block a user