108 lines
4.3 KiB
Markdown
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.
|