Architecture

Données du nouveau front

De l'API aux écrans
  • Types : @clair/data est écrit à la main, d'après les réponses relevées sur l'API (la plupart des fichiers de packages/data/src/ datent leur relevé en tête). Il n'est pas généré depuis la spécification OpenAPI : un champ ajouté à l'API n'apparaît dans le front que si on l'ajoute au type, et seuls les champs utiles au site sont typés.
  • Accès : @clair/api-client fournit le client HTTP (createHttpClient) et un hook générique, useApiQuery(chemin, paramètres), au-dessus de TanStack Query. Les écrans n'appellent jamais fetch.
  • Rendu serveur : les routes de apps/site chargent la première page côté serveur (apps/site/lib/api-server.ts), avec le secret interne ; si l'API ne répond pas, la page est servie quand même et l'écran charge ses données dans le navigateur.
  • Navigateur : les appels passent par le proxy same-origin /api/v1 du site, qui ajoute le secret interne ; celui-ci ne quitte jamais le serveur.
  • Fixtures : des données fictives (« Camille Exemple »), à côté des écrans (packages/screens/src/<ecran>/fixtures.ts), servies par createFixtureClient dans les tests et les stories. Le site, lui, n'a pas de mode fixtures : sans API locale, il affiche ses listes vides. Les tests e2e le font tourner devant un faux serveur d'API (e2e/fake-api.mjs).
  • Donnée officielle et donnée calculée : les types distinguent ce qui vient des sources officielles de ce qui est calculé ou produit par IA, et l'interface l'affiche.