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 :
docker/Dockerfile.app(target: export) — stagebuildernode:22-alpine:npm ci, puisnpm run build --workspace=frontend/sharedet--workspace=${APP_DIR}(APP_DIR: frontend/webpassé par compose). Stageexportalpine:3.21: recopiedist/dans/app/dist.docker/publish.sh— tourne dans le conteneurapp-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 | 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.tsximporteAppen statique, aucunReact.lazy. - Thème clair/sombre : script inline dans
index.html(anti-FOUC) litlocalStorage["cohaise-theme"], sinonprefers-color-scheme, puis pose la classe.darksur<html>. Le basculeur écrit viauseTheme. - Design system :
Button,Card,cnsont les seuls composants utilisés.Inputest un<input>brut,DemoCard(seul utilisateur deSkeleton) n'est jamais monté. - Aucun appel réseau : pas de
fetch,axios,WebSocket, niimport.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.