[sowibrr]

Closes #176 (la partie API) · Suivi : #166 · Contrat : #183 · Proposition : #182

Ce qui a été fait

Le module missions de l'API (contracts/missions.yaml, tag « missions »), avec sa migration V20261114_1830__missions.sql :

• créer un brouillon, seul ou depuis sa demande (404 si la demande n'est pas la mienne) ;
• lire une mission et lister les missions publiques ou les miennes, par curseur ;
• publier : au plus 5 par période de 24 h et par compte, sinon 429 avec Retry-After et rien n'est publié. Deux publications simultanées se comptent l'une après l'autre (verrou en base) ;
• fermer une mission publiée ;
• inviter un développeur (deux fois la même personne : sans effet).

Qui voit quoi : le client toujours ; tout le monde une annonce publique publiée, fermée ou terminée ; un invité une mission sur invitation dès qu'elle n'est plus un brouillon. Pour tous les autres, la mission n'existe pas (404), jamais 403. Les lectures publiques sont ouvertes sans connexion dans SecuriteConfig (GET /api/missions et GET /api/missions/*) ; le détail du travail restera fermé.

Toutes les erreurs de champ sont signalées ensemble dans un seul 400. Le budget est un entier d'unité mineure avec sa devise ISO 4217 ; la base refuse un budget sans devise.

Comment c'est vérifié

• tests : MissionsTest, 14 tests écrits avant le code (ils échouaient en 404), puis verts :
  • un brouillon n'est visible que de son client ;
  • une mission sur invitation n'est visible que des invités, et un brouillon invité reste invisible ;
  • publier deux fois ou avec une version périmée (409) ;
  • budget négatif ou devise inconnue ;
  • plus de 5 publications par jour (429) sans publication à moitié, et un autre compte n'est pas limité ;
  • le curseur sans doublon.
• suite complète de l'API en local : 384 tests, 0 échec, y compris ModulesTest (le module n'appelle que Annuaire et Demandes). Après la mise à jour sur main : MissionsTest et ModulesTest repassent.

Décisions et alternatives écartées

• 404 plutôt que 403 pour tout ce que la personne n'a pas le droit de savoir exister (conventions §5).
• La limite par jour répond 429 et non 409 limite_atteinte comme le disait Missions · M2 : publier une mission #176 (conventions §6).
• Pas de 409 demande_non_publiee pour l'instant : demandes n'a pas encore d'état « publiée » (Module · Freelance : du besoin au cahier des charges publié (@sowibrr) #158). Pour l'instant on exige seulement que la demande soit la mienne.
• Pas de clé étrangère vers demande : un module ne lit pas les tables d'un autre.

Ce qui n'est pas dans cette PR (reste de #176)

• PATCH /api/missions/{id} (modifier l'annonce) ;
• les écrans du front, qui utilisent les types générés de feat: contrat des missions freelance, types et maquettes (#175) #183.

Pistes d'amélioration

• 🔴 Risque : supprimer un compte supprime ses missions (ON DELETE CASCADE). Missions · M6 : avis, profil prouvé, données personnelles #180 doit les fermer à la place, pour ne pas perdre les propositions des autres.
• 🟡 La PR fait environ 1 080 lignes dont 294 de tests, au-delà des 400 recommandées. Elle est cohérente (une migration, un module) ; je peux la découper si la revue le demande.
• 🟡 nombrePropositions vaut 0 jusqu'à Missions · M3 : candidater, choisir, fixer le devis #177.
• ❓ Cette PR suit le contrat de feat: contrat des missions freelance, types et maquettes (#175) #183 (pas encore fusionné) : à fusionner après lui.

Outils d'IA utilisés : Claude Code (Claude Sonnet 5.5) pour le code et les tests.

🤖 Generated with Claude Code