Files
CoHaiSe/docs/architecture.md
T
Esiah 858d862fed
deploy / deploy (push) Canceled after 0s
feat: init repo
2026-11-10 19:56:03 +01:00

3.8 KiB

Architecture — CoHaiSe Web

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

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)

package.json racine : workspaces: ["frontend/*", "backend/*"], scripts build (tsc --build puis build de chaque paquet), typecheck, clean.

Découpage

frontend/
  shared/   @cohaise/ui — design system, DUPLOQUÉ dans les 3 dépôts CoHaiSe
  web/      @cohaise/web — la vitrine
backend/
  shared/   @cohaise/server — couche serveur, PRÉSENTE mais INUTILISÉE ici
docker/     Dockerfile, Dockerfile.app, 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.

Chaîne de build

Deux images, deux rôles :

  1. docker/Dockerfile.app (target: export) — stage builder node:22-alpine : 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.

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

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 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.

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 :

@import "tailwindcss";
@import "@cohaise/ui/styles";
@source "../../../../frontend/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.