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