# @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
React + Vite"] end subgraph monorepo ui["frontend/shared
@cohaise/ui"] end subgraph infrastructure web["nginx
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 ``. 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.