Ajouter issue depuis milestone

2026-05-28 05:39:52 +02:00
parent ef48bf4b73
commit e65571051c
4 changed files with 125 additions and 7 deletions
@@ -0,0 +1,40 @@
+# 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.