# Règles — Évolutions API ## Détection Si une demande ne peut pas être implémentée avec les endpoints API existants (endpoint manquant, champ absent, comportement insuffisant), ne pas contourner le problème côté frontend. ## Action requise Créer un fichier dans le dossier `api-issues/` à la racine du projet, nommé en kebab-case selon le besoin : ``` api-issues/nom-du-besoin.md ``` ## Contenu du fichier Le fichier doit décrire : 1. **Contexte** — quelle fonctionnalité frontend nécessite cette évolution 2. **Problème** — ce qui manque ou bloque dans l'API actuelle 3. **Besoin** — le ou les endpoints à créer / modifier, avec le corps de requête et la réponse attendus 4. **Priorité** — bloquant / important / nice-to-have ## Exemple de fichier ```markdown # Filtrage des issues par milestone ## Contexte La page Issues doit permettre de filtrer les issues déjà assignées à un milestone. ## Problème L'endpoint `GET /issues` ne retourne pas le champ `milestoneId` dans la réponse. ## Besoin Ajouter `milestoneId: number | null` dans le corps de réponse de `GET /issues` et `GET /issues/:id`. ## Priorité Important ``` ## Comportement attendu - Implémenter tout ce qui est possible avec l'API actuelle. - Informer clairement que le fichier a été créé et son emplacement. - Ne pas bloquer le reste de l'implémentation : simuler la donnée manquante si cela permet d'avancer.