Aller au contenu principal

0009 — Contrats API partagés via Zod

Date : 2026-04-21 Statut : Acté

Contexte​

Le partage de contrats entre frontend et backend doit garantir une source unique de vérité, avec validation runtime et types statiques cohérents.

Décision​

Définir les contrats API via des schémas Zod dans packages/contracts. Les schémas servent de source unique de vérité. OpenAPI via @nestjs/swagger est conservé pour les clients externes.

Conséquences​

  • Types et validation dérivés du même schéma (côté front et back).
  • Pas de désynchronisation possible entre types client et types serveur.
  • OpenAPI reste disponible pour la documentation et les intégrations tierces.