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:
2026-11-16 00:52:29 +01:00
parent ab4cde1ce2
commit 09cf07d79b
113 changed files with 6427 additions and 2364 deletions
+9 -7
View File
@@ -8,7 +8,7 @@ de `docs/`.
| Action | Commande |
| --- | --- |
| Dev hot-reload | `make dev` (Vite 5173) |
| Dev hot-reload | `make dev` (Next.js 3000) |
| Vérifier les types | `npm run typecheck` |
| Builder | `npm run build` |
| Reconstruire + publier | `make web` |
@@ -26,18 +26,20 @@ vérifications automatiques. Exécuter les deux avant de déclarer un travail fi
3. **Ne pas lire `.env`** : il contient des secrets d'autres apps. Écrire
`SESSION_SECRET` est autorisé, le recopier depuis un autre dépôt aussi, le
diffuser non.
4. **Ne pas créer de backend** : ce dépôt est une vitrine statique. Toute
fonctionnalité nécessitant une API appartient à `CoHaiSe-CLOUD` ou
`CoHaiSe-CRM`.
4. **La vitrine n'a pas d'API** : l'export Next est statique ; le formulaire de
contact appelle le CRM séparé (`backend/crm`). Ne pas ajouter de route
dynamique serveur ou de secret dans `frontend/web`.
5. **`.env.example` n'est pas la vérité** : il contient des clés héritées que le
compose n'utilise pas. Seul `COHAISE_HTTP_PORT` est lu.
## Conventions de code
- TypeScript strict, project references (`tsconfig.json` racine).
- React 19, pas de routeur : la navigation est un état dans `App.tsx`.
- React 19, Next.js app router : les pages et layouts sont des Server
Components ; `"use client"` uniquement quand un hook ou un événement l'exige.
- Tailwind 4 via `@import "tailwindcss"` ; **pas de classes arbitraires en
dur** : passer par les jetons `--cohaise-*` (`@theme inline`).
- Un élément animé porte `data-reveal` et reste visible sans JavaScript.
- Style visuel : `Button`, `Card`, `cn` depuis `@cohaise/ui`. Pas de
`<div class="bg-…">` quand un composant existe.
- `.editorconfig` : 2 espaces, LF, UTF-8.
@@ -59,8 +61,8 @@ palettes doivent rester synchronisées.
- `cohaise.dev` est HSTS-preloadé : `/etc/hosts` ne sert à rien, tester via
`localhost:8080`.
- `backend/shared` est construit mais inutilisé : une erreur de types ici ne
casse pas le site.
- `backend/shared` est construit avec le reste et consommé par `backend/crm` :
une erreur de types ici bloque `npm run typecheck` pour tout le monorepo.
- `docker/README.md` décrit la build d'image uniquement ; pour le service,
`docs/deployment.md`.
- Après `make web`, vérifier que le symlink a bien basculé :
+127 -44
View File
@@ -1,49 +1,70 @@
# Architecture — CoHaiSe Web
# Architecture — CoHaiSe
Vitrine statique. Il n'y a **ni API, ni base de données, ni session** : un bundle
Vite servi par nginx. Tout le reste (build, publication, en-têtes) tient dans
`docker/`.
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/web` |
| Vite | 8 | `frontend/web/vite.config.ts` |
| Tailwind CSS | 4 (`@tailwindcss/vite`) | `frontend/web/src/styles/index.css` |
| TypeScript | 7 (`typescript` en devDependency racine) | `tsconfig.json` (project references) |
| 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, DUPLOQUÉ dans les 3 dépôts CoHaiSe
web/ @cohaise/web — la vitrine
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 — couche serveur, PRÉSENTE mais INUTILISÉE ici
docker/ Dockerfile, Dockerfile.app, nginx/, publish.sh
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/shared` est référencé par `tsconfig.json` racine et donc **construit**
par `npm run build`, mais aucun paquet ne l'importe et `docker-compose.yml` ne
construit pas `Dockerfile.api`. C'est un reliquat du monorepo à trois apps :
inoffensif, mais inutile dans ce dépôt.
### Backend CRM
## Chaîne de build
```
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 :
1. **`docker/Dockerfile.app`** (`target: export`) — stage `builder` `node:22-alpine` :
1. **`docker/Dockerfile.app`** (`target: export`) — stage `builder` `node:22-slim` :
`npm ci`, puis `npm run build --workspace=frontend/shared` et
`--workspace=${APP_DIR}` (`APP_DIR: frontend/web` passé par compose). Stage
`export` `alpine:3.21` : recopie `dist/` dans `/app/dist`.
2. **`docker/publish.sh`** — tourne dans le conteneur `app-build` avec le volume
`app_data` monté : copie dans `releases/<UTC>-<pid>`, puis bascule atomique du
lien `current` (`ln -sfn` + `mv -T`). La version précédente reste servie
pendant la copie ; une release plus vieille que 5 minutes est purgée.
`--workspace=${APP_DIR}`. `OUTPUT_DIR` choisit le dossier produit (`out` pour
Next, `dist` pour Vite). Le stage `export` recopie ce dossier dans
`/app/dist`.
2. **`docker/publish.sh`** — tourne dans `app-build` avec le volume `app_data`
monté : copie dans `releases/<UTC>-<pid>`, puis bascule atomique du lien
`current` (`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.
@@ -51,38 +72,100 @@ Publication **atomique** : nginx ne voit jamais un répertoire à moitié écrit
`docker/Dockerfile` : `nginx:1.27-alpine` + `docker/nginx/web.conf`.
| Point | Comportement | Référence |
| --- | --- | --- |
| Racine | `/usr/share/nginx/html/current` (symlink) | `nginx/web.conf:6` |
| `/healthz` | `200 ok`, log coupé | `web.conf:16-20` |
| `/assets/` | `expires 1y`, `Cache-Control: public, immutable` | `cache-immutable.conf` |
| Racine applicative | `no-cache`, fallback SPA `try_files → @spa → /index.html` | `web.conf:29-37` |
| gzip | actif, `min_length 1024` | `web.conf:11-14` |
| En-têtes | `snippets/security-headers.conf` au niveau serveur **et** dans chaque `location` | `web.conf:9,23,30` |
| 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
- **Pas de routeur** : deux onglets commutés par `useState` (`src/App.tsx:25-29`).
- **Pas de code splitting** : `main.tsx` importe `App` en statique, aucun
`React.lazy`.
- **Thème clair/sombre** : script inline dans `index.html` (anti-FOUC) lit
- **App router** : `app/layout.tsx` porte 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 dans
`sessionStorage` puis rejointe après le retour à `/`. Ces pages tiennent en
un écran (voir `globals.css`, règle `:only-child`) et ne défilent pas.
- **SEO** : `metadata` par page, canonical, OpenGraph/Twitter, JSON-LD
`Organization`/`WebSite`/`ProfessionalService` sur l'accueil, `sitemap.ts`,
`robots.ts` et `opengraph-image.tsx` gé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) lit
`localStorage["cohaise-theme"]`, sinon `prefers-color-scheme`, puis pose la
classe `.dark` sur `<html>`. Le basculeur écrit via `useTheme`.
- **Design system** : `Button`, `Card`, `cn` sont les seuls composants utilisés.
`Input` est un `<input>` brut, `DemoCard` (seul utilisateur de `Skeleton`) n'est
jamais monté.
- **Aucun appel réseau** : pas de `fetch`, `axios`, `WebSocket`, ni
`import.meta.env`. Fonts (woff2) et favicon en local, aucune ressource tierce.
classe `.dark` sur `<html>`. `ThemeContext` lit 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-*`
dans `globals.css`).
- **Régions plein écran** : chaque section est un `<section data-region>`
(`Section`) en `min-h-dvh` ; Stack et About partagent une seule région sur
l'accueil (`StackAbout`). `scroll-snap-type: y mandatory` +
`scroll-snap-stop: always` (voir `globals.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), `useScrollReveal` pose
`html[data-snap="off"]` et le snap est coupé pour ne pas bloquer le contenu.
Snap aussi désactivé en `prefers-reduced-motion` et sous 620 px de hauteur.
- **Animations** : `useScrollReveal` observe 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-delay` décale les voisins et
`prefers-reduced-motion` dé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 de
`scroll-behavior: smooth` global, qui entrerait en conflit avec GSAP. Le snap
s'applique aux sections de `main[data-scroll-snap]`.
- **Fond WebGL** : `Topography` est un Client Component chargé via
`next/dynamic` avec `ssr: false`, en position fixed derrière le contenu.
- **Contact** : le formulaire POSTe vers `POST /api/crm/leads` du CRM
(`NEXT_PUBLIC_CRM_API_URL` au build, sinon `https://crm.cohaise.dev`).
## Front CRM
- **Shell fixe** : `Crm` occupe `h-dvh` en `overflow-hidden` ; l'en-tête reste
figé et le reste du viewport est **une seule surface** : rail d'onglets à
gauche (15 % à partir de `md`, 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 voile `bg-surface/40` sans flou ; c'est le
`DataTable` qui porte son propre fond translucide et flouté.
- **DataTable** : `components/DataTable.tsx` affiche 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** : `RecordDialog` borne le formulaire à la hauteur de l'écran ;
seul le corps du dialogue défile, y compris sur téléphone.
- **Fond** : `FaultyTerminalBackdrop` est 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`). L'application lit le fichier via :
les reçoit par `@theme inline` (`theme.css`). La vitrine importe le design system
depuis `app/globals.css` :
```css
@import "tailwindcss";
@import "@cohaise/ui/styles";
@source "../../../../frontend/shared/src";
@source "../../shared/src";
```
`--cohaise-destructive` est un rouge (`#d32f2f` clair / `#ef4444` sombre),
+33 -21
View File
@@ -1,35 +1,42 @@
# API et modèle de données — CoHaiSe CRM
Base : **`/api/crm`**, plus `GET /healthz` (sonde base, `503` si indisponible).
`attachUser` sur les quatre préfixes ; `requireAuth` sur chaque route sauf la
connexion. **Aucune route n'est protégée par un rôle** depuis `007_no_roles.sql`.
`attachUser` sur `auth`, `countries`, `organizations` et `contacts` ;
`requireAuth` sur toutes leurs routes sauf la connexion. `POST /leads` est
public (formulaire de la vitrine). **Aucune route n'est protégée par un rôle**
depuis `007_no_roles.sql`.
## Routes
| Méthode | Chemin | Fichier |
| --- | --- | --- |
| POST | `/api/crm/auth/login` | `routes/auth.ts:64` |
| POST | `/api/crm/auth/logout` | `routes/auth.ts:98` |
| GET | `/api/crm/auth/me` | `routes/auth.ts:105` |
| POST | `/api/crm/auth/change-password` | `routes/auth.ts:114` |
| GET | `/api/crm/countries?q=` | `routes/countries.ts:46` |
| POST | `/api/crm/countries` | `routes/countries.ts:57` |
| PATCH | `/api/crm/countries/:id` | `routes/countries.ts:88` |
| DELETE | `/api/crm/countries/:id` | `routes/countries.ts:132` |
| GET | `/api/crm/organizations?q&page&limit` | `routes/organizations.ts:105` |
| GET | `/api/crm/organizations/:id` | `routes/organizations.ts:135` |
| POST | `/api/crm/organizations` | `routes/organizations.ts:146` |
| PATCH | `/api/crm/organizations/:id` | `routes/organizations.ts:200` |
| DELETE | `/api/crm/organizations/:id` | `routes/organizations.ts:262` |
| GET | `/api/crm/contacts?q&organizationId&page&limit` | `routes/contacts.ts:96` |
| GET | `/api/crm/contacts/:id` | `routes/contacts.ts:140` |
| POST | `/api/crm/contacts` | `routes/contacts.ts:151` |
| PATCH | `/api/crm/contacts/:id` | `routes/contacts.ts:202` |
| DELETE | `/api/crm/contacts/:id` | `routes/contacts.ts:260` |
| POST | `/api/crm/auth/login` | `routes/authRoutes.ts` |
| POST | `/api/crm/auth/logout` | `routes/authRoutes.ts` |
| GET | `/api/crm/auth/me` | `routes/authRoutes.ts` |
| POST | `/api/crm/auth/change-password` | `routes/authRoutes.ts` |
| GET | `/api/crm/countries?q=` | `routes/countryRoutes.ts` |
| POST | `/api/crm/countries` | `routes/countryRoutes.ts` |
| PATCH | `/api/crm/countries/:id` | `routes/countryRoutes.ts` |
| DELETE | `/api/crm/countries/:id` | `routes/countryRoutes.ts` |
| GET | `/api/crm/organizations?q&page&limit` | `routes/organizationRoutes.ts` |
| GET | `/api/crm/organizations/:id` | `routes/organizationRoutes.ts` |
| POST | `/api/crm/organizations` | `routes/organizationRoutes.ts` |
| PATCH | `/api/crm/organizations/:id` | `routes/organizationRoutes.ts` |
| DELETE | `/api/crm/organizations/:id` | `routes/organizationRoutes.ts` |
| GET | `/api/crm/contacts?q&organizationId&page&limit` | `routes/contactRoutes.ts` |
| GET | `/api/crm/contacts/:id` | `routes/contactRoutes.ts` |
| POST | `/api/crm/contacts` | `routes/contactRoutes.ts` |
| PATCH | `/api/crm/contacts/:id` | `routes/contactRoutes.ts` |
| DELETE | `/api/crm/contacts/:id` | `routes/contactRoutes.ts` |
| POST | `/api/crm/leads` | `routes/leadRoutes.ts` |
Chaque route valide son corps puis délègue à `services/*Service.ts` ; aucune
requête SQL n'est écrite dans `routes/`.
### Conventions communes
- Corps validés par Zod (`createX`/`updateX`, `credentials`, `changePassword`).
- Corps validés par Zod dans les routes (`createXBody`, `updateXBody`,
`credentials`, `newPassword`, `leadBody`).
- `:id` UUID validé par regex ⇒ **404** sinon (pays : entier `> 0` sinon 404).
- Pagination : `limit` borné `1..100`, défaut 25 ; `q` fait une recherche
texte.
@@ -84,3 +91,8 @@ CLI : `cohaise-migrate --dir <dossier> [--dry-run] [--check]`, codes `0` / `1`
Le DDL MariaDB n'est pas transactionnel : une migration interrompue se corrige
par un **nouveau** fichier, jamais en éditant l'ancien.
`make crm-migrate` applique les migrations **puis reconstruit et redémarre
l'API** : un binaire plus ancien que le schéma (par exemple du code qui lit
encore `roles` après `007`) répondrait `NOT_MIGRATED` alors que la base est à
jour.
+2 -2
View File
@@ -16,7 +16,7 @@ make up # build + démarrage sur 8080
| Service | Image | Port | Rôle |
| --- | --- | --- | --- |
| `app-build` | `docker/Dockerfile.app` | — | build Vite, `restart: "no"` |
| `app-build` | `docker/Dockerfile.app` | — | build Next.js (`out/`), `restart: "no"` |
| `nginx` | `docker/Dockerfile` | `${COHAISE_HTTP_PORT:-8080}:80` | rendu, `restart: unless-stopped` |
Volume unique : `app_data` (`/usr/share/nginx/html`), monté par les deux. Aucun
@@ -45,7 +45,7 @@ make reload # nginx -s reload, sans coupure
make build # construire les images sans redémarrer
make ps # état
make logs # journaux suivis
make dev # Vite local sur 5173 (hors Docker)
make dev # Next.js local sur 3000 (hors Docker)
make down # arrêt, volumes conservés
```
+18 -15
View File
@@ -1,8 +1,9 @@
# Sécurité — CoHaiSe Web
Surface minimale : une application statique, sans comptes, sans cookies, sans
données. Ce document recense ce qui **est** protégé et ce qui **ne l'est pas**,
pour éviter de partir d'hypothèses fausses.
Surface minimale : un export statique Next.js, sans comptes ni cookies côté
vitrine. Seul appel réseau : le formulaire de contact vers l'API du CRM. Ce
document recense ce qui **est** protégé et ce qui **ne l'est pas**, pour éviter
de partir d'hypothèses fausses.
## Ce qui est en place
@@ -16,19 +17,20 @@ X-Frame-Options: DENY
Referrer-Policy: strict-origin-when-cross-origin
```
Le snippet est inclus au niveau `server` **et** dans chaque `location` (fichiers
`assets`, `/`, `/healthz`) : les réponses d'erreur et de santé portent les mêmes
en-têtes que la page.
Le snippet est inclus au niveau `server` **et** dans chaque `location` (assets
Next, image OG, `/`, `/healthz`) : les réponses d'erreur et de santé portent les
mêmes en-têtes que la page.
### Aucune donnée sensible
- Aucun appel réseau côté client (vérifié : pas de `fetch`, `XMLHttpRequest`,
`axios`, `WebSocket`).
- Aucune clé, aucun `import.meta.env` dans `frontend/`.
- Un seul appel réseau côté client : `POST /api/crm/leads` (formulaire de
contact), vers le CRM.
- Aucune clé : seule `NEXT_PUBLIC_CRM_API_URL` est lue au build, et elle est
publique par construction.
- `.env` exclu de git (`.gitignore`) et des images (`.dockerignore`).
- Seul stockage navigateur : `localStorage["cohaise-theme"]`.
- Aucun cookie : le design system ne pose pas de cookie, `backend/shared` n'est
pas déployé.
- Stockage navigateur limité à `cohaise-theme` et `cohaise-lang`.
- Aucun cookie posé par la vitrine ; les sessions appartiennent au CRM, sur son
propre domaine.
### Ressources
@@ -44,7 +46,7 @@ donc aucun en-tête `Referrer-Policy` à négocier avec un CDN et aucun
| HSTS | absent | le `.dev` est HSTS-preloadé par le navigateur, donc le trafic est déjà forcé en HTTPS : l'absence d'en-tête ici ne change rien côté navigateur, mais un autre domaine servirait en clair |
| `Permissions-Policy` | absent | caméra/micro/geolocalisation jamais sollicités |
| Bind `127.0.0.1` | non | le port `8080` est publié sur toutes les interfaces ; seul le tunnel définit l'accès réel. Pour un hébergement partagé, restreindre à `127.0.0.1:${COHAISE_HTTP_PORT}:80` dans `docker-compose.yml` |
| Rate limiting | non pertinent | aucun endpoint dynamique |
| Rate limiting | côté CRM | l'endpoint public `POST /api/crm/leads` porte honeypot + 5 envois/IP/15 min ; la vitrine n'a aucun endpoint |
| TLS | hors du dépôt | nginx n'écoute que le `80`, le terminus HTTPS est le tunnel |
## Chaîne de confiance
@@ -60,7 +62,8 @@ tunnel cloudflared → nginx:8080 → /usr/share/nginx/html/current → rele
## À ne pas faire
- Ne pas brancher de clé ou de token dans le front : ce dépôt n'a pas de back.
- Ne pas brancher de clé ou de token dans le front : la vitrine est publique,
tout ce qui est dans le bundle est lisible. Les secrets restent dans le CRM.
- Ne pas ajouter de ressource externe (font CDN, script analytics) sans réviser
les en-têtes et `index.html`.
les en-têtes et `frontend/web/app/layout.tsx`.
- Ne pas publier `.env` : il contient des clés héritées d'autres apps.
+76 -4
View File
@@ -13,8 +13,10 @@ Conventions à respecter pour que ce dépôt reste cohérent avec les deux autre
| Indentation | 2 espaces (pas de tabs) |
| `trim_trailing_whitespace` | `false` pour `*.md`, vrai ailleurs |
Aucun Prettier/ESLint n'est installé : l'éditeur et l'`.editorconfig` sont la
seule norme mécanique.
Aucun Prettier n'est installé : l'éditeur et l'`.editorconfig` sont la seule
norme mécanique. ESLint a été retiré de `frontend/web` : `typescript-eslint`
ne supporte pas encore TypeScript 7.0. Ne pas le réintroduire tant que ce
support n'existe pas.
## Palette
@@ -62,19 +64,89 @@ Chargées en local (`frontend/shared/fonts/*.woff2`), jamais par CDN :
## Thème
- Bascule clair/sombre par la classe `.dark` sur `<html>`.
- Script inline dans `index.html` (avant le bundle) : lit
- Script inline dans `frontend/web/app/layout.tsx` (avant le bundle) : lit
`localStorage["cohaise-theme"]`, sinon `prefers-color-scheme`. C'est lui qui
évite le flash de thème.
- `color-scheme: light dark` déclaré pour les contrôles natifs.
- Toute règle sombre va dans le bloc `.dark` de `tokens.css`, pas en
`@media (prefers-color-scheme: dark)` : la préférence utilisateur prime.
## Next.js (vitrine)
- Tout fichier qui utilise un hook, un événement ou une API navigateur porte
`"use client"` ; les pages et le layout restent des Server Components.
- Les métadonnées SEO vont dans `export const metadata` (page ou layout), pas
dans un composant client. Une page = une entrée dans `app/lib/site.ts` pour
rester alignée avec le sitemap.
- Les données statiques vivent dans `app/data/`. Un objet contenant des
fonctions ou des icônes React ne doit jamais traverser la frontière
serveur → client : le composant importe la donnée lui-même.
- Une section = une région plein écran : `<Section>` pose `data-region` et
`min-h-dvh`. Ne pas créer de section hors de ce composant, sinon elle
échappe au scroll-snap.
- Les reveals passent par `data-reveal` / `data-reveal-delay` et
`useScrollReveal` (délai par région via `data-region-delay`) ; ne pas
animer un élément sans prévoir son état sans JS.
- `next build` produit `out/` (`output: "export"`). Ne pas ajouter de route
dynamique sans vérifier la compatibilité avec l'export statique.
- Le menu de l'en-tête est une barre d'onglets, pas une liste d'ancres : aucun
`#` n'est écrit dans l'URL. Sur l'accueil, clic → séquence GSAP région par
région et pastille qui glisse vers l'onglet ; ailleurs, la cible passe par
`setPendingSection`/`sessionStorage` puis est rejointe après le retour à `/`.
`scrollToSection` suspend le snap (`data-scroll-anim`) le temps de la
séquence, sinon le navigateur saute directement à la destination ; la durée
renvoyée prolonge le verrou d'onglet. L'onglet actif suit la région visible
(bande centrale) sauf pendant le défilement déclenché par un clic, où il
reste sur l'entrée choisie. Une cible imbriquée (About dans la région Stack)
est ramenée à sa région par `scrollToSection`, car le snap opère par région.
- Les pages SEO autonomes (`/services`, `/about`, …) réutilisent une seule
région sans pied de page et tiennent dans le viewport (règle
`section[data-region]:only-child` dans `globals.css`). Ne pas les laisser
défiler : le menu est justement là pour ramener aux régions de l'accueil.
## Front CRM
- La page ne défile **jamais** : le shell est en `h-dvh overflow-hidden`, et les
zones de contenu (`DataTable`, dialogue) portent `min-h-0` + `overflow-auto`.
Ne pas retirer `min-h-0` d'un parent flex, sinon le tableau repousse la page.
- Toute liste passe par `components/DataTable.tsx` : colonnes triables,
recherche, actions de ligne, squelette et cartes sous `md`. Ne pas recréer un
`<table>` dans une page.
- Les formulaires de création/édition passent par `RecordDialog` ; seul son
corps défile. Les boutons d'action de ligne utilisent `RowActionButton`.
- Les pictogrammes viennent des WebP du dépôt, rendus par `MaskIcon` dans
`components/icons.tsx` : `FolderMaskIcon`/`UsersMaskIcon`/`ActivityMaskIcon`
pour le rail, `PenMaskIcon`, `TrashMaskIcon`, `SearchMaskIcon`,
`CloseMaskIcon`, `LogoutMaskIcon` pour les actions. Le masque CSS +
`background-color: currentColor` permet au survol de les teinter en accent ou
en destructif sans filtre. Ne pas revenir à un `<img>` : les fichiers sont
blancs et disparaîtraient sur fond clair. `components/glyphs.tsx` ne garde que
les flèches (`ChevronDownGlyph`, `ArrowUpGlyph`).
- L'en-tête du CRM porte `.glass` (défini dans `theme.css`, commun à la vitrine
et au CRM) ; la surface de travail reste sans flou et `DataTable` porte son
propre fond translucide (`bg-surface/80 backdrop-blur-xl`), avec un en-tête
sticky à `/90` pour garder le texte lisible quand les lignes passent dessous.
- Les champs (`Input` partagé, selects, recherche) réagissent au survol par un
bord accent ; le bouton de déconnexion est une icône seule
(`LogoutMaskIcon`) avec `aria-label` et `title`, jamais un libellé visible.
## Backend CRM
- Une route valide l'entrée (Zod), appelle un service, renvoie le statut HTTP.
Aucune requête SQL directement dans `routes/`.
- Un service reçoit `db` et des données déjà typées ; il lève `AppError` pour
les cas métier (404, 409, 422) et laisse remonter le reste.
- Les noms de colonnes SQL restent dans les services et `models/types.ts` ;
l'API expose ses propres champs.
- Les erreurs de contrainte MariaDB passent par `utils/dbErrors.ts` (1062,
1451, 1452), jamais par une comparaison de message.
## Git
- Branche `main` unique, remote `origin` sur `git.cohaise.dev`.
- Pas de convention de message imposée par l'historique (dépôt neuf).
- N'exclure de git que : `.env*` (sauf `.env.example`), `node_modules/`,
`dist/`, `*.log`, `backups/`.
`dist/`, `.next/`, `out/`, `*.log`, `backups/`.
- `docs/` est **versionné** (la ligne `docs/` de `.gitignore` a été retirée).
## Interdépôts
+19 -12
View File
@@ -3,11 +3,12 @@
## Boucle de développement
```sh
make dev # Vite sur http://localhost:5173, hot reload
make dev # Next.js sur http://localhost:3000, hot reload
```
Le serveur de dev sert `frontend/web` avec `server.host: true`, port `5173`
(`vite.config.ts`). Il n'a pas besoin de Docker ni de `.env`.
Le serveur de dev sert `frontend/web` avec Next.js. Il n'a pas besoin de Docker
ni de `.env`. Pour tester le formulaire de contact, l'API CRM doit tourner sur
`http://localhost:8082` (ou définir `NEXT_PUBLIC_CRM_API_URL`).
## Vérification avant de valider
@@ -53,26 +54,32 @@ dépôts CoHaiSe.** Il n'y a pas de version centrale.
| --- | --- |
| Couleur, rayon, police, ombre | `frontend/shared/src/styles/tokens.css` |
| Composant partagé | `frontend/shared/src/components/*.tsx` |
| Page, layout, contenu | `frontend/web/src/**` |
| Routage (onglets) | `frontend/web/src/App.tsx` |
| Cache, en-têtes, fallback SPA | `docker/nginx/web.conf` + `docker/nginx/snippets/` |
| Page, layout, contenu | `frontend/web/app/**` |
| Routes et métadonnées SEO | `frontend/web/app/*/page.tsx`, `frontend/web/app/lib/site.ts` |
| Sitemap / robots / image OG | `frontend/web/app/sitemap.ts`, `robots.ts`, `opengraph-image.tsx` |
| Animations d'entrée | `frontend/web/app/hooks/useScrollReveal.ts` + `globals.css` |
| Cache, en-têtes, 404 | `docker/nginx/web.conf` + `docker/nginx/snippets/` |
| Port public | `COHAISE_HTTP_PORT` dans `.env` |
| Thème par défaut | script inline de `frontend/web/index.html` |
| Thème par défaut | script inline de `frontend/web/app/layout.tsx` |
## Git
- Branche `main`, remote `origin https://git.cohaise.dev/Esiah/CoHaiSe.git`.
- Historique vierge (un commit initial) : aucune convention de message héritée.
- Pas de hooks, pas de CI (`.github/`, `.gitlab-ci.yml` absents).
- Ne jamais committer `.env`, `node_modules/`, `dist/` (exclus par `.gitignore`).
- Ne jamais committer `.env`, `node_modules/`, `dist/`, `out/`, `.next/`
(exclus par `.gitignore`).
## Pièges connus
1. **`.dev` en HSTS-preload** : `/etc/hosts` ne fera jamais fonctionner
`cohaise.dev` en local. Tester sur `localhost`.
2. **`backend/shared` est construit mais jamais utilisé** : une erreur de types
venant de là n'affecte pas le site, mais bloque `npm run typecheck`.
2. **`backend/shared` est construit avec le reste** : il est consommé par
`backend/crm`, mais une erreur de types ici bloque aussi `npm run typecheck`.
3. **`docker/README.md` historique** : ne sert que les images ; le
fonctionnement réel est dans `docs/deployment.md`.
4. **Aucun code splitting** : tout le site tient dans un seul bundle, ce qui est
volontaire pour une vitrine.
4. **Export statique** : `next build` écrit dans `out/`, pas `dist/`. Ne pas
ajouter de route dynamique sans vérifier la compatibilité avec
`output: "export"`.
5. **Pas d'ESLint** : `typescript-eslint` ne supporte pas TypeScript 7.0. Seuls
`typecheck` et `build` vérifient le code.