Architecture
Données du nouveau front
- Types :
@clair/dataest écrit à la main, d'après les réponses relevées sur l'API (la plupart des fichiers depackages/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-clientfournit le client HTTP (createHttpClient) et un hook générique,useApiQuery(chemin, paramètres), au-dessus de TanStack Query. Les écrans n'appellent jamaisfetch. - Rendu serveur : les routes de
apps/sitechargent 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/v1du 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 parcreateFixtureClientdans 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.