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]>
This commit was merged in pull request #1.
This commit is contained in:
+9
-7
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user