Files
Gitea Actions 723b68ea80
deploy / deploy (push) Successful in 1m24s
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

Co-authored-by: Gitea Actions <-[email protected]>
2026-11-16 00:08:17 +00:00

5.3 KiB
Raw Permalink Blame History

@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/
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

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.