Chapitre A03
Transformer le besoin en contrat vérifiable
Approfondir ce chapitreDans ce chapitre
Ce que tu sauras faire
Écrire une demande que deux personnes peuvent comprendre et vérifier de la même manière.
Première synthèse
« Le client doit pouvoir envoyer son PDF » laisse trop de choix invisibles. La demande devient exploitable lorsqu'elle précise le client concerné, la commande, la limite de taille, la reprise après coupure et le moment où l'atelier peut utiliser le document.
Un critère d'acceptation raconte une vérification : lorsqu'un client tente d'ouvrir le fichier d'une autre organisation, l'accès est refusé. Un autre protège la réception : après une coupure, le fichier ne doit pas apparaître comme prêt à fabriquer. Ces phrases permettent de discuter du sens avant les détails techniques.
Écris aussi ce qui n'est pas prévu dans la tranche. Un petit résultat complet est plus facile à accepter qu'une longue liste d'écrans partiellement reliés. Les décisions difficiles à changer méritent une courte note avec leurs alternatives et leurs conséquences.
Déroulé prévu
- Partir du résultat utilisateur.
- Décrire scénario, cas limites et exclusions.
- Nommer les règles qui restent toujours vraies.
- Garder la trace des décisions importantes.
Mise en pratique
Écrire une fiche de réception de fichier avec cinq critères et trois exclusions.
Critère de réussite
Chaque critère correspond à une observation possible ; les unités et acteurs sont explicites.
Sources et limites
O-MD §3, §12 ; I-MD §3, §9.3, §10.2 .
Cette amorce est une synthèse éditoriale, pas la preuve d'une implémentation exécutée. Les rectifications et vérifications externes sont consignées dans le registre critique . Les exemples techniques restent à développer et à tester dans la tranche.
Références pour approfondir
- TypeScript — assertions de type (référence externe, nouvel onglet) — Les assertions de type ne vérifient pas les données à l'exécution. Notice et chapitres associés .