Guide · Exigences
Comment rédiger de bonnes exigences système : exemples et liste de contrôle
Écouter ce guide (audio en anglais) 26 min
Une bonne exigence dit une seule chose que le système doit faire ou être, avec des mots que deux ingénieurs lisent de la même façon, et une valeur qu'un test ou une analyse peut vérifier. Ce guide traite des besoins et des exigences, des parties d'un énoncé d'exigence, des caractéristiques de qualité de l'ISO/IEC/IEEE 29148 et du Guide to Writing Requirements de l'INCOSE, d'une liste de contrôle avec des exemples avant/après, de la vérification et des critères d'acceptation, des valeurs TBD et TBR, et des types d'exigences, le tout appliqué à une même spécification de CubeSat.
Sur cette page
- Pourquoi la formulation d'une exigence compte
- Besoins des parties prenantes et exigences
- L'anatomie d'une exigence
- Caractéristiques de qualité d'une bonne exigence
- La liste de contrôle : règles avec exemples avant/après
- Rédiger la méthode de vérification et les critères d'acceptation avec l'exigence
- Gérer les valeurs TBD et TBR
- Types d'exigences
- Exemple détaillé : revue de la spécification d'EO-1
- Erreurs courantes
- L'essayer dans Holarch
- Télécharger la liste de contrôle
- Questions sur la rédaction des exigences
- Pour aller plus loin
Pourquoi la formulation d'une exigence compte
Une exigence est un contrat entre ceux qui demandent un système et ceux qui le construisent. Tout ce qui suit la lit : le concepteur dimensionne un composant d'après elle, l'ingénieur de test en tire un critère de réussite, le comité de modification évalue une modification par rapport à elle, et le client accepte le système sur sa base. Chacun lit la même phrase, généralement sans que l'auteur soit présent. Si la phrase peut être lue de deux façons, elle le sera, et la différence apparaît tard : lors d'un test qui « réussit » selon un critère que personne n'a convenu, ou à la réception, quand le client voulait dire autre chose.
Une mauvaise formulation casse aussi le reste du modèle. Une exigence sans valeur ne peut pas être allouée à un composant, car personne ne peut dire si le composant la satisfait. Elle ne peut pas être vérifiée, et apparaît donc comme une lacune de couverture dans la traçabilité et la matrice de vérification. Et quand elle change, personne ne peut dire si la conception liée tient toujours. Bien rédiger les exigences est le travail qualité le moins coûteux d'un projet : une heure passée sur une phrase au début épargne une campagne d'essais à la fin.
Le guide utilise un exemple continu, EO-1, un CubeSat 6U fictif qui photographie des terres agricoles dans quatre bandes spectrales. Sa spécification, SRS-001 EO-1 System Requirements Specification, compte 32 exigences, la plupart solides et trois volontairement faibles. C'est le même modèle que l'exemple de projet MBSE de bout en bout. Les besoins des parties prenantes N1 à N3 cités ici sont ceux que le guide de la traçabilité ajoute au modèle.
Besoins des parties prenantes et exigences
La rédaction des exigences commence une étape plus tôt, avec les besoins. Un besoin de partie prenante est ce qu'un utilisateur, un opérateur, un client ou un régulateur attend, dans ses propres termes. Une exigence est l'énoncé technique d'après lequel le système est conçu et vérifié. L'ISO/IEC/IEEE 15288 sépare les deux dans des processus techniques distincts : la définition des besoins et des exigences des parties prenantes (6.4.2) et la définition des exigences système (6.4.3). Le Needs and Requirements Manual de l'INCOSE fait la même séparation et traite les besoins comme des éléments à part entière, et non comme des ébauches d'exigences.
| Exemple EO-1 | Contrôlé par | |
|---|---|---|
| Besoin (N2 Twice-Weekly Revisit) | Les clients agricoles ont besoin d'images récentes de leurs champs au moins deux fois par semaine pendant la saison de croissance. | Validation : les clients obtiennent-ils ce dont ils ont besoin du système livré ? |
| Exigence (1.6 Revisit Time) | The mission shall revisit each target region within 72 hours. | Vérification : le système satisfait-il à l'énoncé, par test, analyse, inspection ou démonstration ? |
La différence se voit dans la façon dont chacun est contrôlé. Une exigence est vérifiée : le système est mesuré par rapport à l'énoncé. Un besoin est validé : quelqu'un confirme que le système, dans son usage prévu, fait ce que voulait la partie prenante. Un système peut réussir toutes les vérifications et échouer à la validation si les exigences sont passées à côté ; le guide vérification et validation traite cet écart. Pour la rédaction, la conséquence pratique est simple : rédigez d'abord le besoin, puis des exigences qui le satisferaient si elles étaient respectées, et reliez chaque exigence au besoin auquel elle répond.
La traduction est rarement terme à terme. N2 devient 1.6 Revisit Time, qui est ensuite décomposée en 1.6.1 Ground Track Repeat (3 jours) et 1.6.2 Off-Nadir Imaging (25 degrés). Certaines exigences ne répondent directement à aucun besoin : 3.1 Orbit Average Power est dérivée de 1.5 Daily Collection Volume, car la charge d'imagerie fixe la puissance que les panneaux doivent fournir. Aucun client n'a demandé 30 W, mais l'imagerie qu'ils ont demandée est impossible sans cela.
L'anatomie d'une exigence
Une exigence est plus que sa phrase. La phrase porte l'obligation ; un ensemble d'attributs autour d'elle porte les raisons, le plan pour la prouver et la tenue des registres. Les deux moitiés font partie de sa rédaction.
L'énoncé
La plupart des bons énoncés d'exigences suivent un même schéma. L'ISO/IEC/IEEE 29148 (5.2.4) le décrit comme un sujet, une action, un objet et des contraintes sur l'action, avec une condition facultative en tête ; le Guide to Writing Requirements de l'INCOSE recommande le même ordre et des modèles convenus pour chaque type d'exigence.
| Partie | Ce qu'elle dit | EO-1 4.3 Fault Detection |
|---|---|---|
| Condition (facultative) | Quand, dans quel mode ou quel état, l'exigence s'applique | « …of undervoltage detection » (l'événement déclencheur) |
| Sujet | Le système ou l'élément qui doit s'y conformer, nommé exactement | « The C&DH » |
| Verbe modal | La force de l'obligation | « shall » |
| Action | Ce que le sujet fait ou est, sous forme de verbe actif | « enter » |
| Objet | Ce à quoi l'action s'applique | « safe mode » |
| Performance ou contrainte | La valeur mesurable, avec l'unité et le sens de la limite | « within 10 seconds » |
Ensemble : « The C&DH shall enter safe mode within 10 seconds of undervoltage detection. » L'ordre peut varier (« When undervoltage is detected, the C&DH shall… » place la condition en tête, comme dans les modèles EARS qu'utilisent de nombreuses équipes), mais chaque partie doit être présente ou délibérément absente.
Trois mots portent l'essentiel du poids. Shall marque une exigence contraignante ; will énonce un fait ou une intention concernant quelque chose d'extérieur au système ; should énonce un objectif qui n'est pas vérifié. Quelle que soit la convention adoptée par un projet, définissez-la une fois dans la spécification et tenez-vous-y. EO-1 1.1 Reference Orbit (« The mission assumes a 500 km sun-synchronous orbit… ») est correctement rédigée comme une hypothèse, pas comme une exigence : elle fournit le contexte des exigences qui en dépendent, et le modèle la stocke comme un énoncé qui n'est ni noté ni vérifié.
Les attributs
Voici 3.1 Orbit Average Power telle que le modèle d'EO-1 l'enregistre, après la modification post-PDR de 28 W à 30 W :
| Attribut | 3.1 Orbit Average Power | Pourquoi il est là |
|---|---|---|
| Identifiant et nom | 3.1 Orbit Average Power | Une référence stable pour les liens, les revues et les demandes de modification |
| Énoncé | The solar arrays shall generate at least 30 W orbit-average power at end of life. | L'obligation elle-même |
| Justification | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. | Permet à un lecteur ultérieur de juger une modification sans l'auteur |
| Source et parent | Derived (systems analysis) ; dérivée de 1.5 Daily Collection Volume | Traçabilité amont : pourquoi l'exigence existe |
| Méthode et niveau de vérification | Test, au niveau sous-système | Le plan pour la prouver, décidé lors de la rédaction |
| Critères de réussite | End-of-life orbit-average power predicted from measured peak power. | Quel résultat compte comme satisfait |
| Responsable, priorité, criticité | Power Engineer ; haute ; haute | Qui en répond et quelle est son importance |
| Statut | En revue (elle était approuvée ; son texte a changé après l'approbation) | Où elle en est dans le processus d'accord |
| TBD/TBR | Aucun | Si une valeur est encore ouverte |
L'ISO/IEC/IEEE 29148 (5.2.8) liste des attributs de ce genre, et le guide de l'INCOSE en ajoute d'autres ; un projet choisit ceux qu'il maintiendra réellement. La justification est celle qu'on omet le plus souvent et qui manque le plus souvent ensuite. Sans « charge de 26 W, marge de 15 % », la prochaine personne qui verra 3.1 ne pourra pas dire si 30 W est une limite physique stricte, un chiffre client ou un choix de marge, et ne pourra donc pas dire ce qu'une modification de la charge signifie pour elle.
Caractéristiques de qualité d'une bonne exigence
Les règles de style sont plus faciles à appliquer quand on sait ce qu'elles protègent. L'ISO/IEC/IEEE 29148 (5.2.5) nomme neuf caractéristiques d'une exigence individuelle, et le Guide to Writing Requirements de l'INCOSE utilise les mêmes neuf, numérotées C1 à C9, chacune avec une courte définition et les règles qui la soutiennent. Le tableau formule chacune comme une question qu'un relecteur peut poser.
| Caractéristique | Question à poser | Exemple EO-1 |
|---|---|---|
| Nécessaire | Si elle était supprimée, quelque chose dont les parties prenantes ont besoin serait-il perdu ? N'est-elle pas un doublon ? | 3.1 est nécessaire : sans elle, rien ne dimensionne les panneaux pour la charge d'imagerie. |
| Appropriée | Est-elle rédigée au bon niveau, sans figer un choix de conception qui revient au niveau inférieur ? | 3.1 fixe un niveau de puissance pour les panneaux, pas un type de cellule ni un nombre de panneaux. |
| Non ambiguë | Ne peut-elle être lue que d'une seule façon ? | 6.4 « user friendly » échoue : deux relecteurs ne seront pas d'accord sur le fait qu'elle soit satisfaite. |
| Complète | Dit-elle tout ce qui est nécessaire, sans condition ni valeur manquante ? | 3.5 « warm enough (TBD) » échoue : la valeur manque. |
| Singulière | Énonce-t-elle une seule obligation ? | 2.5 échoue : elle demande de se rétablir et de reprendre l'imagerie, reliés par « and ». |
| Réalisable | Peut-elle être satisfaite dans les contraintes connues de technologie, de coût et de calendrier ? | 3.1 à 30 W est en question : les panneaux tels que conçus donnent environ 28 W en moyenne orbitale. |
| Vérifiable | Un test, une analyse, une inspection ou une démonstration peut-il montrer qu'elle est satisfaite ? | 2.5 « quickly » échoue ; « within 6 hours » réussit. |
| Correcte | Énonce-t-elle le besoin réel de sa source, avec la bonne valeur ? | 1.2, une distance d'échantillonnage au sol de 4,5 m, exprime correctement N3, des cartes à l'échelle de la parcelle, avec de la marge. |
| Conforme | Suit-elle les modèles et le vocabulaire convenus du projet ? | Chaque exigence d'EO-1 utilise « shall », un sujet nommé et des unités SI. |
Un ensemble d'exigences a ses propres caractéristiques, qu'aucun énoncé isolé ne peut montrer. L'ISO/IEC/IEEE 29148 (5.2.6) qualifie l'ensemble de complet, cohérent, réalisable dans son ensemble, compréhensible et validable ; le guide de l'INCOSE ajoute correct sous C15 et numérote les caractéristiques de l'ensemble de C10 à C15.
- Complet : l'ensemble couvre les besoins. EO-1 énonce ce qui se passe en cas de sous-tension (4.3), mais sa seule exigence de sortie du mode survie est 2.5, invérifiable telle qu'elle est rédigée ; la reprise n'est donc en pratique pas spécifiée.
- Cohérent : deux exigences ne sont jamais en conflit, et les termes et les unités sont employés de la même façon. 1.5 demande 3,2 Go de données d'image par jour et 5.4 3 Go reçus au sol ; elles ne concordent que parce que la justification de 5.4 indique « after compression ». Sans la justification, elles semblent en conflit.
- Réalisable : les exigences peuvent être satisfaites ensemble. Chaque exigence de puissance peut être réalisable seule, alors que 30 W en moyenne orbitale, la surface des panneaux et le budget de masse ensemble peuvent ne pas l'être.
- Compréhensible : un lecteur peut dire ce qui est attendu du système et comment les exigences sont liées, ce qui dépend autant de la structure, de la numérotation et de la traçabilité que de la formulation.
- Validable : on peut montrer que l'ensemble conduit à un système qui répond aux besoins, c'est pourquoi chaque exigence de plus haut niveau est reliée à un besoin.
La liste de contrôle : règles avec exemples avant/après
Les caractéristiques deviennent utilisables grâce à des règles de rédaction concrètes. Le Guide to Writing Requirements de l'INCOSE les numérote (R1, R2, etc.) ; le Systems Engineering Handbook de la NASA (annexe C) propose une liste de contrôle plus courte dans le même esprit. Le tableau rassemble les règles qui détectent la plupart des problèmes en pratique, avec pour chacune un exemple tiré de la spécification d'EO-1. « Avant » est le texte tel qu'il figure dans la démonstration ; « Après » est une réécriture. Les valeurs marquées comme illustratives montrent la forme, pas des résultats d'analyses d'EO-1.
| Règle | Question à poser | Avant (EO-1) | Après |
|---|---|---|---|
| Une obligation par énoncé | Exactement un « shall », sans « and », « or » ni « and/or » reliant deux demandes ? | 2.5 : « The spacecraft should recover from safe mode quickly and resume imaging as appropriate » | « The spacecraft shall resume imaging within 6 hours of a safe mode entry. » Les autres étapes de reprise qui comptent reçoivent leurs propres exigences. |
| Formulation impérative | « Shall » pour une exigence contraignante, et non « should », « will » ou « may » ? | 2.5 : « should recover » | « shall resume » |
| Valeur mesurable avec une unité | Chaque terme de performance a-t-il un nombre et une unité ? | 2.5 : « quickly » | « within 6 hours of a safe mode entry » |
| Sens de la limite indiqué | Est-il clair que la valeur est un minimum ou un maximum ? | 1.6.2 : « image targets up to 25 degrees off nadir » | « image targets at off-nadir angles from 0 to 25 degrees » (une plage de capacité, pas un plafond de pointage) |
| Pas de clauses échappatoires | Quelque chose est-il laissé à l'appréciation du fournisseur (« as appropriate », « if possible », « where practical ») ? | 2.5 : « as appropriate » | Supprimé ; la condition qui compte est énoncée |
| Pas de termes vagues ou subjectifs | Deux relecteurs pourraient-ils être en désaccord sur sa satisfaction (« user friendly », « easy », « adequate », « enough ») ? | 6.4 : « The operator interface shall be user friendly and/or easy to use. » | « The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes. » (illustratif ; une exigence par tâche qui compte) |
| Noms explicites, pas de pronoms | Chaque « it », « its » ou « this » a-t-il exactement un référent possible ? | 1.6.1 : « The reference orbit shall repeat its ground track every 3 days. » | « The reference orbit shall repeat the ground track every 3 days. » Le pronom est inoffensif ici, mais dans une phrase plus longue, c'est le premier élément qui dérive. |
| Conditions énoncées | Dit-elle quand la valeur s'applique : phase de vie, mode, environnement ? | « The solar arrays shall generate 30 W. » | « …at least 30 W orbit-average power at end of life. » |
| Valeurs arrêtées, ou TBD suivis | Chaque valeur ouverte est-elle suivie avec un responsable et une échéance, et pas seulement écrite dans le texte ? | 3.5 : « The thermal design shall keep the battery warm enough (TBD). » | « The thermal design shall keep the battery cell temperature at or above 0 °C while charging. » (illustratif ; tant que l'analyse thermique ne l'a pas fixée, l'attribut TBD nomme le Thermal Engineer et une échéance) |
| Pas de raisons ni de notes dans l'énoncé | Les formules de finalité (« so that », « in order to ») et les notes entre parenthèses sont-elles déplacées dans la justification ? | 3.5 : « (TBD) » | Énoncé sans parenthèses ; raison dans la Justification |
| Le quoi, pas le comment | Énonce-t-elle le besoin au lieu d'imposer une solution que le niveau inférieur devrait choisir ? | « The thermal design shall keep the battery warm by means of a 2 W film heater. » (illustratif) | La réécriture de 3.5 ci-dessus : une limite de température, le réchauffeur étant laissé à la conception thermique |
| Positive et atteignable | Évite-t-elle « not », « never », « always », « 100% » là où une limite mesurable est visée ? | « The C&DH shall never lose a stored command. » (illustratif) | « The C&DH shall execute each stored command within 1 second of the scheduled time. » (4.2 telle que rédigée) |
| Justification consignée | Dit-elle pourquoi la valeur a été choisie ? | 3.1 sans justification | Justification : « Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. » |
| Méthode et critères de vérification | La méthode est-elle choisie et le critère de réussite dérivé de l'énoncé ? | 3.1 : méthode Test ; TC-06 attend une puissance crête ≥ 72 W | Critère de réussite dérivé par le budget de puissance : environ 80,6 W crête pour 30 W en moyenne orbitale (voir la section suivante) |
| Traçable vers le haut | Reliée à un besoin, à un parent ou à une exigence source ? | 3.1 sans lien amont | 3.1 dérivée de 1.5 Daily Collection Volume |
| Unique | Une autre exigence dit-elle la même chose avec d'autres mots ? | Un second « The battery shall store 77 Wh » dans la section thermique (illustratif) | Une seule exigence, 3.2 Battery Capacity, référencée là où c'est nécessaire |
Une liste de contrôle est un outil de relecteur, pas un modèle de rédaction. Lisez chaque exigence une fois au regard de toute la liste plutôt que de chercher une règle à la fois, et consignez le constat avec la règle enfreinte, pour que l'auteur sache quoi changer. Les règles ont aussi des faux positifs. Un contrôle par liste de mots signale « every » dans 1.6.1 comme un quantificateur universel, mais « every 3 days » est une période, pas une affirmation sur tous les cas ; un relecteur tranche.
Rédiger la méthode de vérification et les critères d'acceptation avec l'exigence
La caractéristique « vérifiable » est la plus facile à contrôler au moment où l'exigence est rédigée : si l'auteur ne peut pas dire comment on montrerait qu'elle est satisfaite, elle n'est pas terminée. Consignez deux choses avec chaque exigence.
- Méthode de vérification : test, analyse, inspection ou démonstration, et le niveau d'assemblage auquel elle s'applique (composant, sous-système, système). EO-1 utilise les quatre : 3.1 est vérifiée par test, 1.5 Daily Collection Volume par analyse, 3.4 Bus Regulation par inspection et 6.1 Contact Scheduling par démonstration. Le guide de la RVTM explique comment choisir entre elles.
- Critères de réussite (critères d'acceptation) : le résultat observable qui compte comme satisfait, énoncé de façon que le test ou l'analyse puisse en être rédigé. Pour 3.2 Battery Capacity : « Measured capacity of at least 77 Wh at C/2 and 20 °C. » Pour 6.2 Image Delivery : « Products on the portal within 6 h for 95% of passes in rehearsal. »
Rédiger les critères à côté de l'énoncé détecte une catégorie d'erreurs qui, sinon, n'apparaît qu'à la fin. La 3.1 d'EO-1 est vérifiée par TC-06 Solar Array Power Test, qui mesure la puissance crête sur un simulateur solaire et réussit à partir de 72 W. L'exigence porte pourtant sur la puissance moyenne en orbite, et le modèle convertit l'une en l'autre avec la fraction ensoleillée (0,62) et le rendement de la chaîne de puissance (0,6). Une crête de 72 W donne 72 × 0,62 × 0,6 = 26,8 W en moyenne orbitale, ce qui est inférieur aux 28 W d'origine, sans parler des 30 W actuels. Le seuil de test n'a pas été dérivé de l'exigence. TC-06 a mesuré 75,1 W et « réussi », pourtant 75,1 W correspondent à 27,9 W, en deçà des deux valeurs. Si le critère avait été rédigé à partir de l'énoncé, il aurait indiqué environ 30 / (0,62 × 0,6) = 80,6 W crête, et le déficit aurait été visible dès le premier test. Le guide de l'analyse d'impact des modifications suit le même constat à travers la modification de 28 W à 30 W.
La leçon se généralise : un critère de réussite doit pouvoir être relié à la valeur de l'exigence par un calcul que quelqu'un peut vérifier, et ce calcul a sa place dans la justification ou dans le plan de vérification, pas dans la mémoire d'un ingénieur.
Gérer les valeurs TBD et TBR
Au début d'un projet, certaines valeurs ne sont pas encore connues. Omettre l'exigence cache la lacune ; inventer un nombre cache l'incertitude. La pratique habituelle consiste à rédiger l'exigence avec une valeur provisoire et à suivre cette valeur comme un point ouvert.
- TBD (to be determined, à déterminer) : pas encore de valeur. « The thermal design shall keep the battery cell temperature at or above TBD °C while charging. »
- TBR (to be reviewed, parfois « to be resolved », à confirmer) : la meilleure valeur actuelle, non confirmée. « …within 60 seconds », avec 60 marqué TBR.
Préférez un TBR avec une estimation à un simple TBD dès qu'il existe une base pour un nombre : les concepteurs peuvent travailler avec une estimation, et une valeur qui bouge ensuite est une modification, que la traçabilité suivra. Chaque point ouvert a besoin de trois choses, sinon il n'est pas géré :
- Un responsable, la personne qui le clôturera.
- Une échéance ou un jalon, normalement avant les décisions de conception qui en dépendent.
- Un plan de clôture : l'analyse, le test ou la décision qui fixera la valeur.
La spécification d'EO-1 compte trois points ouverts. 3.5 Battery Thermal Control est un TBD dont le Thermal Engineer est responsable, déjà en retard. 2.4 Target Slew (« through 30 degrees within 60 seconds ») est un TBR dont l'ADCS Lead est responsable, et 5.3 Downlink Link Margin (« at least 3 dB link margin at 10 degrees elevation ») un TBR dont le Comms Lead est responsable ; les deux portent des valeurs de travail que les conceptions utilisent en attendant la fin des analyses.
Comptez les points ouverts à chaque jalon et attendez-vous à ce que le nombre baisse. Une référence d'exigences comportant de nombreux TBD ouverts n'est une référence que de nom. Les critères de revue du Systems Engineering Handbook de la NASA demandent, dès la revue des exigences système, que les points TBD et TBR ouverts soient identifiés avec un plan et un calendrier de clôture. Le suivi a sa place dans un attribut ou un registre, pas seulement dans le texte : un « TBD » tapé dans une phrase n'a ni responsable ni date, et rien ne rappelle à quiconque de le clôturer.
Types d'exigences
Classer les exigences aide les relecteurs à poser les bonnes questions et aide l'ensemble à rester complet. Les catégories ci-dessous sont les plus courantes ; l'ISO/IEC/IEEE 29148 et le guide de l'INCOSE décrivent des ensembles similaires, et de nombreux projets ajoutent les leurs.
| Type | Ce qu'il énonce | Exemple EO-1 | Points de vigilance |
|---|---|---|---|
| Fonctionnelle | Ce que le système doit faire | 4.3 Fault Detection : « The C&DH shall enter safe mode within 10 seconds of undervoltage detection. » | Une fonction sans performance associée ; la plupart des exigences fonctionnelles ont aussi besoin d'un « à quel point », ici « within 10 seconds » |
| Performances | À quel point une fonction est bien réalisée : quantité, cadence, précision, temps | 2.1 Pointing Accuracy : « The ADCS shall point the payload boresight within 0.1 degrees of the commanded target. » | Conditions manquantes (quel mode, quelle phase de vie) et sens de la limite manquant |
| Interface | Ce qui franchit une frontière avec un autre système ou élément, et ses caractéristiques | 5.2 UHF Command Uplink : « The UHF transceiver shall receive ground commands at 9.6 kbps. » La définition complète se trouve dans le document de contrôle d'interface. | Des exigences qui reformulent l'ICD au lieu d'y renvoyer, si bien que les deux divergent |
| Contrainte | Une limite imposée de l'extérieur à la conception ou à la façon dont le système est construit | 4.4 Downlink Encryption : « The C&DH shall encrypt each downlink frame with 256-bit keys. » Sa justification : le contrat client exige des images chiffrées en transit ; l'exigence vient donc de l'extérieur du projet, et non d'une étude de compromis interne. | Des choix de conception rédigés comme des contraintes alors que personne d'extérieur ne les a imposés |
| Environnement, fiabilité, sécurité | Les conditions à supporter et la sûreté de fonctionnement à atteindre | 1.7 Mission Lifetime : « The spacecraft shall operate in orbit for at least 730 days. » | Des valeurs sans la probabilité ou le niveau de confiance auxquels elles sont revendiquées |
La limite entre exigences fonctionnelles et de performance passe souvent à l'intérieur d'une même phrase : beaucoup d'exigences énoncent une fonction avec sa performance, comme le fait 4.3. Cela ne pose pas de problème tant que la phrase ne porte qu'une obligation. Les exigences d'interface sont traitées plus en détail dans le guide du document de contrôle d'interface, et les fonctions qui sous-tendent les exigences fonctionnelles dans le guide de l'analyse fonctionnelle.
Exemple détaillé : revue de la spécification d'EO-1
Une revue de SRS-001 au regard de la liste de contrôle répartit les 32 exigences en trois groupes. La plupart passent. Quelques-unes ont de petits constats qui valent une phrase chacun. Trois doivent être réécrites.
Un contrôle automatique de la même spécification concorde avec la revue : 29 des 32 exigences sont jugées bonnes, et les trois faibles sont à reprendre. Les constats pour 2.5 listent chaque règle enfreinte par son nom et son numéro, ce dont un auteur a besoin pour la corriger. Le contrôle signale aussi ce qu'il ne peut pas trancher : sur 3.1, la correction et la faisabilité attendent un relecteur, car le texte a changé depuis la dernière revue.
Petits constats
- 1.6.2 Off-Nadir Imaging, « up to 25 degrees off nadir » : « up to » se lit comme un maximum, mais l'intention est une capacité que le satellite doit avoir à tout angle de 0 à 25 degrés. Une mauvaise lecture permettrait à une conception qui ne photographie qu'au nadir d'être conforme.
- 1.6.1 Ground Track Repeat, « its ground track » : un pronom avec un seul référent possible, le constat est donc mineur. Le « every » de la même phrase est un faux positif d'une règle sur les quantificateurs universels.
- 1.5 Daily Collection Volume a une méthode (analyse) et des critères de réussite (« Simulated daily volume of at least 3.2 GB over a 30-day plan »), mais pas encore d'analyse liée. La formulation est correcte ; la vérification n'est pas faite.
- 3.1 Orbit Average Power est bien rédigée, mais son texte a changé après l'approbation ; sa correction et sa faisabilité demandent donc de nouveau le jugement d'un relecteur. La faisabilité est la vraie question : les panneaux tels que conçus donnent environ 28 W en moyenne orbitale.
Trois réécritures
2.5 Safe Mode Recovery. « The spacecraft should recover from safe mode quickly and resume imaging as appropriate » enfreint au moins six règles : « should » au lieu de « shall », deux obligations reliées par « and », « quickly » sans valeur, la clause échappatoire « as appropriate », pas de point final et pas de vérification. La réécriture garde le seul résultat qui compte pour le client et lui donne une valeur :
The spacecraft shall resume imaging within 6 hours of a safe mode entry.
La justification doit dire d'où viennent les 6 heures (N1 demande des alertes de stress des cultures le jour même, et 6.2 accorde 6 heures entre la transmission et la livraison). Si les étapes de la reprise comptent en elles-mêmes, comme la réacquisition du pointage solaire ou le compte rendu de la cause, chacune devient sa propre exigence. Méthode : test, par injection de pannes sur le flatsat ; critère de réussite : l'imagerie reprend dans les 6 heures pour chaque entrée en mode survie injectée.
3.5 Battery Thermal Control. « The thermal design shall keep the battery warm enough (TBD). » comporte un terme vague, un TBD dans le texte et des parenthèses. La correction sépare l'obligation, la valeur ouverte et la raison :
The thermal design shall keep the battery cell temperature at or above 0 °C while charging.
Les 0 °C sont illustratifs : les cellules lithium-ion ne sont généralement pas chargées en dessous du point de congélation, mais la limite réelle vient de la fiche technique de la cellule et de l'analyse thermique. Tant que cette analyse ne l'a pas fixée, la valeur est un TBR dont le Thermal Engineer est responsable, avec une échéance antérieure à la revue de conception thermique. La réécriture révèle aussi une lacune que l'original cachait : il n'y a pas d'exigence sur la plage de température en décharge, qui a besoin de son propre énoncé.
6.4 Operator Interface. « The operator interface shall be user friendly and/or easy to use. » comporte deux termes subjectifs et un « and/or ». L'utilisabilité peut être spécifiée, mais seulement au moyen de tâches observables :
The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.
La tâche et le temps sont illustratifs. Un ensemble réel listerait les quelques tâches qui comptent (réserver un contact, téléverser une liste de cibles, lire la dernière télémesure de santé), chacune avec un temps et une limite d'erreurs, mesurés lors d'une démonstration avec des opérateurs ayant suivi la formation.
Erreurs courantes
| Erreur | Ce qui ne va pas | Mieux |
|---|---|---|
| Rédiger des solutions de conception comme des exigences | La conception est figée avant l'étude de compromis, et une meilleure option est écartée sans que personne ne l'ait décidé. | Énoncer le besoin (« keep the cells at or above 0 °C while charging ») et laisser le niveau inférieur choisir le réchauffeur. |
| Recopier le langage des parties prenantes tel quel dans les exigences | « Des images récentes deux fois par semaine » est un besoin ; ce n'est pas vérifiable tel quel. | Garder le besoin, et rédiger une exigence avec une valeur et une condition qui le satisfait (1.6, within 72 hours). |
| Plusieurs exigences dans un paragraphe | Un identifiant porte plusieurs obligations, qui partagent un statut, un test et un sort. | Une exigence par élément, un « shall » par énoncé. |
| Des valeurs sans conditions | « 30 W » en début de vie et en fin de vie sont deux conceptions différentes. | Indiquer le mode, la phase de vie, l'environnement et le moyennage. |
| Pas de justification | Personne ne peut juger une modification ultérieure, et l'exigence survit longtemps après la disparition de sa raison. | Rédiger la raison et les nombres qui sous-tendent la valeur. |
| Des seuils de test non dérivés de l'exigence | Un test réussit alors que l'exigence n'est pas satisfaite (TC-06 à 72 W crête face à 28 W en moyenne orbitale). | Dériver le critère de réussite de l'énoncé par le calcul, et le consigner. |
| Un TBD tapé dans le texte et oublié | La valeur ouverte n'a ni responsable ni date et arrive dans la référence. | Suivre chaque TBD et TBR avec un responsable, une échéance et un plan de clôture. |
| La surqualité | Des exigences que personne n'a demandées consomment des efforts de conception et de test. | Vérifier que chaque exigence de plus haut niveau remonte à un besoin ou à une source. |
| Trop compter sur les contrôles automatiques | Un contrôle de mots sans constat est pris pour une exigence correcte. | Utiliser les outils pour les règles mécaniques ; une personne juge la correction, la faisabilité et la nécessité. |
L'essayer dans Holarch
Dans un projet LML, chaque exigence est une entité de la classe Requirement avec les attributs décrits ci-dessus : Justification, Statut, Priorité, Criticité, Responsable, Source, Méthode de vérification, Niveau de vérification, Critères de réussite et les champs TBD/TBR.
- Créez la démonstration avec Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée). Sa spécification contient les trois exigences faibles et les points TBD/TBR ouverts utilisés dans ce guide.
- Ouvrez Besoins et exigences → Qualité, choisissez le document dans la liste de portée et cliquez sur Contrôler la qualité. Chaque exigence est notée sur les neuf caractéristiques, et les suggestions donnent les numéros des règles du guide de l'INCOSE qu'une liste de mots ou un motif peut contrôler. Correcte et Réalisable demandent un relecteur : cliquez sur la marque pour consigner la décision.
- Réécrivez 2.5 comme ci-dessus et relancez le contrôle. Les constats sur le connecteur, la clause échappatoire et le terme vague disparaissent.
- Ouvrez Besoins et exigences → TBD/TBR pour voir les points ouverts avec leurs responsables et leurs échéances, et Clore l'un d'eux une fois sa valeur arrêtée.
- Pour un second avis sur les caractéristiques qu'une règle ne peut pas trancher, utilisez ✦ IA ▾ → Contrôle des exigences par l'IA ; chaque verdict et chaque réécriture sont présentés pour revue avant toute modification.
La référence complète se trouve dans la documentation Qualité des exigences et Registre TBD/TBR.
Télécharger la liste de contrôle
La liste de contrôle de la qualité des exigences avec des exemples avant/après d'EO-1 (CSV) contient les règles de la liste avec leurs questions de revue et leurs exemples, pour une revue ou comme point de départ des règles de rédaction propres à un projet. Le même fichier est proposé par le guide de la traçabilité.
Questions sur la rédaction des exigences
Shall, must ou will ?
Toute convention fonctionne si la spécification la définit et s'y tient. La plus répandue utilise « shall » pour les exigences contraignantes, « will » pour les faits et les intentions concernant ce qui est extérieur au système, et « should » pour les objectifs non vérifiés. Certains guides de style gouvernementaux préfèrent « must » par souci de langage clair. Les mélanger dans une même spécification est le vrai problème.
Combien d'exigences un système doit-il avoir ?
Il n'y a pas de bon nombre. Un petit satellite peut avoir quelques dizaines d'exigences système et quelques centaines en dessous ; un grand programme en a des milliers. Les questions plus utiles sont de savoir si chaque exigence remonte à un besoin ou à un parent, et si chaque besoin a des exigences en dessous de lui.
Les user stories sont-elles des exigences ?
Une user story consigne un besoin et sa finalité dans les termes de l'utilisateur. Elle joue le rôle d'un besoin de partie prenante, et ses critères d'acceptation sont proches de critères de vérification. Pour un système construit, intégré et vérifié comme un ensemble matériel et logiciel, les stories doivent tout de même être transformées en exigences qui peuvent être allouées et testées.
Un outil peut-il contrôler la qualité des exigences ?
Un outil peut contrôler de façon fiable les règles mécaniques : verbes modaux, connecteurs, mots vagues, clauses échappatoires, pronoms, liens manquants. Il ne peut pas savoir si 30 W est la bonne valeur ni si les panneaux peuvent la fournir. Utilisez le contrôle automatique pour éliminer les constats mécaniques avant une revue, afin que les relecteurs consacrent leur temps à la correction et à la faisabilité.
Pour aller plus loin
- Traçabilité des exigences et impact des modifications : relier ces exigences aux besoins, à la conception et aux tests, et suivre une modification.
- Analyse fonctionnelle : transformer les exigences en fonctions et les allouer.
- Matrice de vérification des exigences : planifier la méthode de vérification de chaque exigence et consigner les résultats.
- Besoins et exigences dans Holarch : documents, contrôles de qualité, références et traçabilité dans un seul modèle.