@@ -0,0 +1,90 @@
|
||||
# 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 :
|
||||
|
||||
```css
|
||||
@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`.
|
||||
Reference in New Issue
Block a user