Architecture

Architecture du nouveau front

Où mettre quoi

BesoinEmplacement
Valeur visuelle (couleur, taille, rayon…)packages/theme/src/tokens.ts, puis pnpm --filter @clair/theme generate
Composant réutilisablepackages/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>/
Écranpackages/screens/src/<ecran>/ : XxxScreen.tsx, params.ts, XxxScreen.module.css, test
Routeapps/site/app/<route>/page.tsx : metadata et l'écran, rien d'autre
Type du domainepackages/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éespackages/api-client : client HTTP et useApiQuery (TanStack Query)

Règles

  • Aucun next/* dans packages/ : les liens passent par Link / useNavigation de @clair/ui, que l'application branche sur son routeur.
  • L'état de page vit dans l'URL : chaque écran a ses fonctions parseXxxParams et xxxParamsOf.
  • Jamais de fetch direct 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/web ne 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.