maj 1

contracts/data_model.md

@@ -0,0 +1,24 @@
+# Modèle de données
+
+Décrit les entités clés et leurs relations.
+
+---
+
+## Légende des zones
+- `<A COMPLETER PAR AGENT>` : à compléter par un agent spécialisé backend.
+
+---
+
+## Entités principales
+- Entité : <A COMPLETER PAR AGENT>
+- Champs : <A COMPLETER PAR AGENT>
+- Contraintes : <A COMPLETER PAR AGENT>
+
+## Relations
+- Relation : <A COMPLETER PAR AGENT>
+- Cardinalité : <A COMPLETER PAR AGENT>
+
+---
+
+## Exemple (a supprimer)
+- `User` 1..N `Order`.

contracts/errors.md

@@ -0,0 +1,24 @@
+# Contrat d’erreurs API
+
+Ce document définit le format standard des erreurs.
+
+---
+
+## Légende des zones
+- `<A COMPLETER PAR AGENT>` : à compléter par un agent spécialisé backend.
+
+---
+
+## Format
+- Structure : <A COMPLETER PAR AGENT>
+- Codes d’erreur : <A COMPLETER PAR AGENT>
+- Messages utilisateurs vs techniques : <A COMPLETER PAR AGENT>
+
+## Conventions
+- Codes HTTP : <A COMPLETER PAR AGENT>
+- Champs obligatoires : <A COMPLETER PAR AGENT>
+
+---
+
+## Exemple (a supprimer)
+- `{ "error": { "code": "VALIDATION_ERROR", "message": "Email invalide" } }`

contracts/pagination.md

@@ -0,0 +1,24 @@
+# Contrat de pagination
+
+Ce document définit la pagination standard pour l’API.
+
+---
+
+## Légende des zones
+- `<A COMPLETER PAR AGENT>` : à compléter par un agent spécialisé backend.
+
+---
+
+## Stratégie
+- Type (page/offset/cursor) : <A COMPLETER PAR AGENT>
+- Paramètres : <A COMPLETER PAR AGENT>
+
+## Réponse
+- Structure des meta : <A COMPLETER PAR AGENT>
+- Liens (next/prev) : <A COMPLETER PAR AGENT>
+
+---
+
+## Exemple (a supprimer)
+- Paramètres : `page=1&limit=20`.
+- Meta : `total`, `page`, `page_size`.