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]>
8.7 KiB
Architecture — CoHaiSe
Monorepo à deux applications déployées séparément :
| Application | Sous-domaine | Stack | Compose |
|---|---|---|---|
| Vitrine | cohaise.dev |
Next.js 16 (export statique) + nginx | docker-compose.yml |
| CRM | crm.cohaise.dev |
Next/Vite + API Node + MariaDB | docker-compose.crm.yml |
Pile
| Élément | Version | Où |
|---|---|---|
| React | 19 | frontend/* |
| Next.js (app router) | 16 | frontend/web |
| Vite | 8 | frontend/crm |
| Tailwind CSS | 4 (@tailwindcss/postcss) |
frontend/web/app/globals.css |
| TypeScript | 7 | tsconfig.json (project references) |
| Hono + mysql2 + Zod | — | backend/shared, backend/crm |
package.json racine : workspaces: ["frontend/*", "backend/*"], scripts
build (tsc --build puis build de chaque paquet), typecheck, clean.
@cohaise/ui doit être construit avant la vitrine : tsc --build s'en charge.
Découpage
frontend/
shared/ @cohaise/ui — design system, dupliqué dans les 3 dépôts CoHaiSe
web/ @cohaise/web — la vitrine Next.js
crm/ @cohaise/crm-web — le front du CRM (React + Vite)
backend/
shared/ @cohaise/server — config, base, auth, http, migrations
crm/ @cohaise/crm — l'API du CRM
docker/ Dockerfile, Dockerfile.app, Dockerfile.api, nginx/, publish.sh
Backend CRM
backend/crm/src/
index.ts composition du service (routes + purge des sessions)
admin.ts création/réinitialisation de comptes hors HTTP
config/app.ts constantes métier (pagination, rate-limit, source lead)
middleware/auth.ts montage de `attachUser` sur une ressource
models/types.ts lignes SQL et formes exposées par l'API
routes/*Routes.ts routes minces : validation Zod, HTTP, statuts
services/*Service.ts requêtes et règles métier
utils/ dbErrors, normalize, pagination, rateLimit, sql, validation
Le socle (Db, App, sessions, erreurs) reste dans @cohaise/server : la
réorganisation n'a changé ni la stack ni les contrats HTTP.
Chaîne de build de la vitrine
Deux images, deux rôles :
docker/Dockerfile.app(target: export) — stagebuildernode:22-slim:npm ci, puisnpm run build --workspace=frontend/sharedet--workspace=${APP_DIR}.OUTPUT_DIRchoisit le dossier produit (outpour Next,distpour Vite). Le stageexportrecopie ce dossier dans/app/dist.docker/publish.sh— tourne dansapp-buildavec le volumeapp_datamonté : copie dansreleases/<UTC>-<pid>, puis bascule atomique du liencurrent(ln -sfn+mv -T). La version précédente reste servie pendant la copie ; une release plus vieille que 5 minutes est purgée.
Publication atomique : nginx ne voit jamais un répertoire à moitié écrit.
Service de rendu
docker/Dockerfile : nginx:1.27-alpine + docker/nginx/web.conf.
| Point | Comportement |
|---|---|
| Racine | /usr/share/nginx/html/current (symlink) |
/healthz |
200 ok, log coupé |
/_next/static/ |
expires 1y, Cache-Control: public, immutable |
/opengraph-image |
fichier sans extension servi en image/png |
/404.html |
page d'erreur générée par l'export Next |
| Racine applicative | no-cache, try_files $uri $uri/ =404 (pas de fallback SPA) |
| gzip | actif, min_length 1024 |
| En-têtes | snippets/security-headers.conf au niveau serveur et dans chaque location |
Chaque route Next est un dossier avec son index.html (trailingSlash: true).
Front
- App router :
app/layout.tsxporte le shell, les providers, le fond et les métadonnées par défaut. Une page SEO autonome par section (/services,/demos,/stack,/about,/contact), plus/qui compose les mêmes sections. Le menu se comporte comme une barre d'onglets : une pastille glisse d'une entrée à l'autre et l'URL ne reçoit aucun#. Sur l'accueil, le clic fait défiler jusqu'à la région et l'onglet actif suit le défilement ; depuis une page autonome, la cible est mémorisée danssessionStoragepuis rejointe après le retour à/. Ces pages tiennent en un écran (voirglobals.css, règle:only-child) et ne défilent pas. - SEO :
metadatapar page, canonical, OpenGraph/Twitter, JSON-LDOrganization/WebSite/ProfessionalServicesur l'accueil,sitemap.ts,robots.tsetopengraph-image.tsxgénéré (1200×630). - Bilingue : toggle client FR/EN (
LanguageContext). Le HTML prérendu est en français — c'est la version indexée. La préférence stockée est appliquée après le montage pour éviter tout mismatch d'hydratation. - Thème clair/sombre : script inline dans
app/layout.tsx(anti-FOUC) litlocalStorage["cohaise-theme"], sinonprefers-color-scheme, puis pose la classe.darksur<html>.ThemeContextlit cet état après le montage. Le bouton d'en-tête (ThemeToggle) est une icône seule : lune en clair, soleil en sombre, avec étoile et transition rotation/fondu (.theme-icon-*dansglobals.css). - Régions plein écran : chaque section est un
<section data-region>(Section) enmin-h-dvh; Stack et About partagent une seule région sur l'accueil (StackAbout).scroll-snap-type: y mandatory+scroll-snap-stop: always(voirglobals.css) empêchent de s'arrêter entre deux régions ou d'en sauter une. Le footer, hors région, s'aligne sur la fin du viewport pour rester atteignable. Si une région dépasse la hauteur de l'écran (téléphone étroit, texte long),useScrollRevealposehtml[data-snap="off"]et le snap est coupé pour ne pas bloquer le contenu. Snap aussi désactivé enprefers-reduced-motionet sous 620 px de hauteur. - Animations :
useScrollRevealobserve chaque[data-region]via une bande centrale du viewport. Une fois la région stable à l'écran, ses éléments[data-reveal]apparaissent en cascade après 0,25 s (le hero est réglé à 0,05 s). Quitter la région avant la fin annule le minuteur : elle se révélera au prochain passage.data-reveal-delaydécale les voisins etprefers-reduced-motiondésactive tout. Pendant une séquence de menu (data-scroll-anim), la région traversée est révélée sans délai. - Défilement : GSAP
ScrollToPlugin(scrollToSection) anime les sauts du menu région par région (une étape par région traversée, courte respiration entre chaque) ; le snap est suspendu le temps de la séquence (html[data-scroll-anim]) pour que le navigateur ne saute pas directement à la destination, et un geste de défilement l'interrompt. Pas descroll-behavior: smoothglobal, qui entrerait en conflit avec GSAP. Le snap s'applique aux sections demain[data-scroll-snap]. - Fond WebGL :
Topographyest un Client Component chargé vianext/dynamicavecssr: false, en position fixed derrière le contenu. - Contact : le formulaire POSTe vers
POST /api/crm/leadsdu CRM (NEXT_PUBLIC_CRM_API_URLau build, sinonhttps://crm.cohaise.dev).
Front CRM
- Shell fixe :
Crmoccupeh-dvhenoverflow-hidden; l'en-tête reste figé et le reste du viewport est une seule surface : rail d'onglets à gauche (15 % à partir demd, icônes seules en dessous), vue des données à droite. La page ne défile jamais ; seules les zones de contenu portent leur propre défilement (DataTable, formulaire du dialogue). - Profondeur : seul l'en-tête porte
.glass(flou d'arrière-plan). La surface de travail est un simple voilebg-surface/40sans flou ; c'est leDataTablequi porte son propre fond translucide et flouté. - DataTable :
components/DataTable.tsxaffiche la liste triable, la recherche, les actions de ligne, le squelette, l'état vide et les cartes mobiles. L'en-tête reste collé et le tableau défile dans son cadre (overflow-auto). Les pages ne réimplémentent plus de<table>. - Saisie :
RecordDialogborne le formulaire à la hauteur de l'écran ; seul le corps du dialogue défile, y compris sur téléphone. - Fond :
FaultyTerminalBackdropest monté sur l'écran connecté, la connexion, le changement de mot de passe et l'attente de session.
Jetons
frontend/shared/src/styles/tokens.css est la source des couleurs ; Tailwind 4
les reçoit par @theme inline (theme.css). La vitrine importe le design system
depuis app/globals.css :
@import "tailwindcss";
@import "@cohaise/ui/styles";
@source "../../shared/src";
--cohaise-destructive est un rouge (#d32f2f clair / #ef4444 sombre),
l'accent de marque est le carmin --cohaise-accent (#b71c1c), l'avertissement
reste jaune (--cohaise-warning). Voir standards.md.