Architecture
Architecture du nouveau front
Où mettre quoi
| Besoin | Emplacement |
|---|---|
| Valeur visuelle (couleur, taille, rayon…) | packages/theme/src/tokens.ts, puis pnpm --filter @clair/theme generate |
| Composant réutilisable | packages/ui/src/<catégorie>/<nom>/ (catégories : core, layout, filters, parliament, charts), export dans packages/ui/src/index.ts, page dans docs/04-front/03-composants/<famille>/ |
| Écran | packages/screens/src/<ecran>/ : XxxScreen.tsx, params.ts, XxxScreen.module.css, test |
| Route | apps/site/app/<route>/page.tsx : metadata et l'écran, rien d'autre |
| Type du domaine | packages/data/src/<domaine>.ts, écrit à la main d'après les réponses de l'API (pas de génération depuis l'OpenAPI) |
| Fixture (données fictives d'un écran) | packages/screens/src/<ecran>/fixtures.ts |
| Accès aux données | packages/api-client : client HTTP et useApiQuery (TanStack Query) |
Règles
- Aucun
next/*danspackages/: les liens passent parLink/useNavigationde@clair/ui, que l'application branche sur son routeur. - L'état de page vit dans l'URL : chaque écran a ses fonctions
parseXxxParamsetxxxParamsOf. - Jamais de
fetchdirect dans un écran : les données passent par les hooks de@clair/api-client. - Aucune valeur visuelle en dur : CSS modules et variables
--clair-*. apps/webne se modifie pas : le nouveau front se construit à côté.
Les pages de cette section
- Pages et écrans : les routes, l'écran de chacune et l'avancement de la migration.
- Données : de l'API aux écrans.
- Tests : la pyramide de tests du nouveau front.