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

108 lines
4.3 KiB
Markdown

# @cohaise/web
Vitrine institutionnelle de `cohaise.dev`. Première application du monorepo CoHaiSe et premier consommateur réel du design system partagé.
## Rôle
| Responsabilité | Localisation |
| -------------------------------------------- | ----------------- |
| Design system, jetons, composants | `frontend/shared` |
| vitrine institutionnelle | `frontend/web` |
| Point d'entrée local, publication des builds | `docker/nginx` |
```mermaid
flowchart LR
subgraph navigateur
app["frontend/web<br/>React + Vite"]
end
subgraph monorepo
ui["frontend/shared<br/>@cohaise/ui"]
end
subgraph infrastructure
web["nginx<br/>cohaise.dev"]
end
app -->|import| ui
app -->|build statique| web
```
## Prérequis
- Node.js `>=22.23.1`
- npm `>=10`
## Commandes
| Commande | Effet |
| ----------------------------------- | ----------------------------------------------------------- |
| `npm run dev -w @cohaise/web` | serveur Vite sur `http://localhost:5173` |
| `npm run build -w @cohaise/web` | vérification de types puis build de production dans `dist/` |
| `npm run preview -w @cohaise/web` | sert le build de production localement |
| `npm run typecheck -w @cohaise/web` | vérification de types seule |
| `make web` | construit l'image et republie le build dans le volume Nginx |
## Publication dans l'infrastructure
Le `Dockerfile` est un build multi-étapes. Le contexte de construction est la racine du
monorepo, car le build a besoin des workspaces, du lockfile et des références
TypeScript partagées.
```text
node:22-alpine deps installation déterministe via npm ci
node:22-alpine builder tsc --build puis vite build
alpine:3.21 export /app/dist, copié dans le volume web_data
```
Le service `cohaise-web-build` copie le résultat dans le volume `web_data`, que Nginx
monte déjà sur `/usr/share/nginx/html/web`. Aucune modification de la configuration
Nginx n'est nécessaire, et la publication reste découplée des autres applications.
## Consommation du design system
L'application importe la feuille de style publique du package partagé une seule fois, dans `src/styles/index.css` :
```css
@import "tailwindcss";
@import "@cohaise/ui/styles";
@source "../../../../frontend/shared/src";
```
La directive `@source` est indispensable. Sans elle, Tailwind ignore `node_modules` et les classes utilisées par les composants de `frontend/shared` ne sont jamais générées : les composants s'afficheraient sans style.
## Thème
Le thème est appliqué par la classe `dark` sur `<html>`. Le script inline de `index.html` applique la préférence enregistrée ou celle du système avant le premier rendu, ce qui évite le flash de thème clair. `src/hooks/useTheme.ts` pilote le changement et persiste le choix dans `localStorage` sous la clé `cohaise-theme`.
## Structure
```text
frontend/web
├── index.html amorce de thème et point de montage
├── public/favicon.webp
├── src
│ ├── App.tsx composition de la page
│ ├── main.tsx point d'entrée React
│ ├── components
│ │ ├── DemoCard.tsx états repos, chargement, chargé
│ │ └── ThemeToggle.tsx
│ ├── hooks
│ │ └── useTheme.ts
│ └── styles/index.css import du design system
├── tsconfig.json
├── tsconfig.node.json
└── vite.config.ts
```
## Limites actuelles
- Aucun appel réseau : toutes les données de démonstration sont locales.
- Aucun routage : la page est un point d'entrée unique.
- Les URL d'API devront passer par un wrapper dédié, jamais codées en dur dans les composants.
## Variables d'environnement
L'application ne déclare aucune variable pour l'instant. Le gabarit `frontend/web/.env.example`
prendra une entrée `VITE_API_BASE_URL` au moment où le premier appel réseau existera, afin
que l'URL reste définie à un seul endroit. Seules les variables préfixées par `VITE_` sont
exposées au bundle ; aucun secret ne doit jamais être lu par le navigateur.