Plan de tests, nouveau endpoint API

---
name: plan-tests-nouveau-endpoint-api
description: "Rédige un plan de tests structuré (unitaires, intégration, cas limites, sécurité) pour un nouveau endpoint API REST ou GraphQL avant de l'ouvrir en revue. Sortie sous forme de tableau Markdown priorisé, avec noms de tests, fixtures minimales et assertion attendue par cas. À utiliser quand un dev backend, fullstack ou QA ajoute ou modifie une route serveur, un handler HTTP ou une mutation GraphQL, et veut cadrer la couverture attendue avant d'écrire le code des tests. Compatible pytest, Vitest, Jest, Supertest, Playwright API."
metadata:
  iaskills_title: "Plan de tests, nouveau endpoint API"
  metier_slug: dev
  metiers:
    - Devs et tech leads
  secteur: "Tech & DSI"
  tier: free
  compatible:
    - claude-code
    - cowork
    - cursor
    - codex
  version: "1.0.0"
  author: "iaskills"
  editorial:
    pitch: "Un plan de tests lisible en 2 minutes pour un nouvel endpoint API. Cas nominaux, erreurs, sécurité, limites, en tableau priorisé prêt à coder."
    long_description: "Ouvrir un nouvel endpoint sans plan de tests aboutit presque toujours au même scénario, deux tests happy path, la revue passe, puis un ticket de bug arrive trois semaines après en prod sur un cas 401, un input vide ou une injection. Ce skill produit un plan de tests structuré à partir d'une signature d'endpoint (méthode, chemin, contrat d'entrée, contrat de sortie, effets de bord). Il liste, en tableau priorisé, les cas nominaux, les erreurs métier attendues, les erreurs techniques, les cas limites (payload vide, taille max, unicode, dates limites), les checks d'authentification, d'autorisation et les patterns de sécurité OWASP à couvrir. Chaque ligne précise le fichier ou module de test, le nom du test à créer, la fixture minimale nécessaire et l'assertion attendue. Compatible pytest, Vitest, Jest, Supertest, Playwright API, et compréhensible par un QA engineer non familier du code."
    bullets:
      - "Cas nominaux, erreurs, limites, sécurité"
      - "Tableau priorisé prêt à coder"
      - "Fixtures minimales explicites"
      - "Aligné OWASP API Top 10"
      - "Compatible pytest, Vitest, Jest, Playwright"
    exemple_avant: "Un nouveau POST /orders part en revue avec 3 tests happy path. Deux semaines plus tard, un ticket signale qu'un payload sans champ items déclenche une 500, et qu'un utilisateur du tenant B peut lire les commandes du tenant A. Le fix rouvre le sujet, la revue se rejoue."
    exemple_apres: "Le skill produit un tableau de 14 cas pour POST /orders, priorisés P0 à P2, avec assertion attendue par cas. Le dev écrit 9 tests avant la PR, la revue voit une couverture explicite, le bug tenant est bloqué avant merge."
    recommended_metiers:
      - dirigeant-pme
    secteurs:
      - tech-dsi
      - startup-vc
      - assurance-banque
      - finance-comptabilite
      - conseil-audit
      - industrie-manufacture
      - secteur-public-associatif
    metiers_individuels:
      - dev-backend
      - dev-frontend
      - devops
      - qa-engineer
      - architecte-si
      - chef-de-projet-it
      - cto
      - product-manager
---

# Plan de tests, nouveau endpoint API

## Quand utiliser ce skill

Déclencher quand un dev backend, fullstack, QA engineer, tech lead ou DevOps ajoute ou modifie un endpoint HTTP (REST) ou une opération GraphQL (query, mutation) et veut cadrer la couverture attendue avant d'ouvrir la PR. Cas typiques :

- Nouvelle route REST (`POST /orders`, `GET /users/:id/invoices`, `DELETE /files/:id`)
- Nouvelle mutation ou query GraphQL sur un schéma existant
- Modification d'un handler existant qui ajoute une règle métier (nouveau statut, nouveau champ requis, nouvelle limite)
- Refonte d'une route legacy pour la remettre sous tests avant refacto
- Cadrage QA d'un endpoint dont le dev n'a livré que les tests nominaux

Ne pas utiliser pour :

- Un composant front pur (utiliser un plan de tests Playwright ou Cypress dédié)
- Une migration de base de données sans surface API
- Un simple changement de log ou de commentaire