Le cahier des charges
Partie 3 sur 4
5Écrire des exigences claires
Un cahier des charges vaut ce que valent ses phrases. Une exigence bien écrite remplit six conditions.
| Qualité | Question à se poser | Mauvais exemple | Version corrigée |
|---|---|---|---|
| Claire | Deux lecteurs comprennent-ils la même chose ? | Le site doit être convivial. | Un nouvel utilisateur trouve la page de contact en moins de trois clics. |
| Unique | Une phrase, une exigence ? | Le système exporte en tableur et en document et envoie un courriel. | Trois phrases séparées, numérotées. |
| Vérifiable | Peut-on dire oui ou non à la recette ? | Le site doit être rapide. | La page d’accueil s’affiche en moins de deux secondes sur une connexion ordinaire. |
| Nécessaire | Que se passe-t-il si on la supprime ? | Le menu est bleu foncé. | Le site respecte la charte graphique de l’entreprise (document joint). |
| Cohérente | Ne contredit-elle pas une autre ? | Tout est chiffré ; les administrateurs lisent les données en clair. | Les données sont chiffrées ; les administrateurs accèdent aux données par un outil qui garde une trace. |
| Libre de solution | Décrit-elle le but, pas le moyen ? | Utiliser telle base de données. | Le système retrouve une commande en moins d’une seconde parmi dix millions. |
5.1Des mots précis
Quelques habitudes aident à rédiger. Employez « doit » pour ce qui est obligatoire, « devrait » pour ce qui est souhaitable, « peut » pour ce qui est facultatif, et tenez-vous-y dans tout le document. Évitez les mots qui ne se mesurent pas : « rapide », « simple », « convivial », « performant », « sécurisé », « évolutif », « etc. ». Remplacez-les par un nombre, une durée, une condition. Évitez aussi les phrases à plusieurs exigences, qu’on ne peut pas vérifier d’un seul « oui » ou « non ».
Numérotez chaque exigence (E-012, par exemple) : cela permet de s’y référer dans les tests, les avenants, les comptes rendus. Ajoutez, si possible, la raison de l’exigence en une phrase : le fournisseur y gagne des pistes pour proposer mieux, et l’on pourra retirer plus tard une exigence dont la raison a disparu.
5.2Classer par importance
Tout ne se vaut pas, et un client qui répond « tout est prioritaire » donne au fournisseur le pouvoir de choisir à sa place. Une méthode simple est la méthode « MoSCoW » (un jeu de mots, les voyelles ne signifient rien), qui classe chaque exigence en quatre catégories : ce qui doit absolument être fait (Must), ce qui devrait l’être (Should), ce qui pourrait l’être si le temps le permet (Could), et ce qui ne sera pas fait cette fois (Won’t). Cette dernière catégorie est la plus utile : elle écrit noir sur blanc ce que l’on renonce à faire, et évite les mauvaises surprises.
5.3Des chiffres réalistes, des preuves
Pour chaque exigence non fonctionnelle, trois éléments : un niveau à atteindre, un moyen de le mesurer, des conditions de mesure. « Le service est disponible 99,9 % du temps sur l’année, hors maintenance annoncée huit jours à l’avance, mesuré par la sonde du client ». Un niveau de 99,9 % de disponibilité laisse environ neuf heures d’arrêt par an ; un niveau de 99,99 % environ cinquante-trois minutes. Le second coûte beaucoup plus cher : mieux vaut choisir un chiffre justifié par l’usage que le plus beau chiffre possible.
Évitez de demander plus que nécessaire : chaque exigence a un coût, et le fournisseur le répercutera. Évitez aussi d’inventer des chiffres sans les justifier. Si l’on ne sait pas, on écrit : « à déterminer lors de l’étude, avant le jalon 1 », avec une date. C’est honnête et cela garde le texte vérifiable.
5.4Illustrer par des exemples et des cas limites
Un exemple chiffré vaut cent adjectifs. « Les frais de livraison sont gratuits au-delà d’un certain montant » devient : « Pour une commande de 60 euros ou plus, les frais de livraison sont de 0 euro ; pour une commande de 59,99 euros, ils sont de 4,90 euros. » Les cas limites (zéro, un, le maximum, une valeur absente, une date en fin d’année) sont ceux où se cachent les désaccords. Les écrire d’avance coûte peu.
Un schéma, un tableau de règles ou un modèle (voir la modélisation avec UML) complètent utilement le texte, à condition de rester cohérents avec lui. Quand un schéma et le texte se contredisent, on ne sait plus lequel croire ; indiquez dans le document lequel l’emporte.
Pour s’exercer
Exercice 2 : rendre vérifiable
Réécrivez de façon vérifiable : (a) « Le logiciel doit être rapide » ; (b) « La plate-forme doit être très disponible » ; (c) « L’interface doit être accessible » ; (d) « Les données doivent être bien protégées ».
Voir la réponse
Exemples possibles. (a) « L’enregistrement d’une commande prend moins d’une seconde pour 95 % des opérations, avec 200 utilisateurs simultanés. » (b) « Disponibilité de 99,9 % par mois, hors maintenance annoncée huit jours à l’avance, mesurée par une sonde externe. » (c) « Les pages respectent le référentiel général d’amélioration de l’accessibilité (RGAA) au niveau AA, vérifié par un audit avant la recette. » Le RGAA est le référentiel français d’accessibilité des services numériques. (d) « Les données sont chiffrées pendant le transport et au repos ; les accès administrateurs nécessitent une double vérification et sont journalisés pendant un an. » Chaque version contient un chiffre, une condition ou un contrôle.
Exercice 3 : une exigence, pas deux
L’exigence suivante est difficile à vérifier : « Le système envoie un courriel de confirmation et enregistre la commande dans la base, et ne fait pas payer deux fois ». Que faites-vous ?
Voir la réponse
On la découpe en trois exigences numérotées : E-1 « À la validation d’une commande, le système envoie un courriel de confirmation en moins d’une minute » ; E-2 « Une commande validée est enregistrée de façon durable avant l’envoi du courriel » ; E-3 « Si le client clique deux fois sur « payer », une seule transaction est débitée ». Chacune a son test à la recette. Si l’une échoue, on sait laquelle.
Exercice 4 : prioriser
Une mairie demande 24 fonctions pour son futur site, toutes « indispensables ». Le budget couvre environ la moitié. Que proposez-vous ?
Voir la réponse
Classer chaque fonction (méthode « doit, devrait, pourrait, ne sera pas fait ») avec les services concernés, en demandant pour chacune ce qui se passe si elle manque le jour de la mise en ligne. Les obligations légales (accessibilité, mentions, protection des données) vont en « doit ». Les fonctions utilisées par peu de personnes passent en « pourrait ». On écrit explicitement la liste des « ne sera pas fait cette fois », qui sert de feuille de route pour la suite. Le fournisseur peut alors chiffrer le premier lot et proposer des lots ultérieurs.
Exercice 5 : un changement en cours de route
À mi-parcours, le directeur demande d’ajouter la prise de rendez-vous en ligne, non prévue. Le fournisseur dit « on verra, on trouvera un arrangement ». Pourquoi est-ce risqué et que faire ?
Voir la réponse
Un arrangement oral laisse chacun avec sa version : le client croit que c’est gratuit, le fournisseur que ce sera compensé plus tard. Il faut une demande de changement écrite, l’évaluation de son effet sur le prix, le délai et les autres fonctions, une décision du client (accepter, reporter, refuser, ou échanger contre une autre fonction), puis un avenant ou une mise à jour signée du document. Le suivi des changements garde la trace de ce qui a été accepté et pourquoi.
Exercice 6 : la disponibilité
Un client demande « 99,99 % de disponibilité » pour un site interne utilisé de 8 h à 18 h du lundi au vendredi. Que lui répondez-vous ? Calculez l’indisponibilité annuelle permise pour 99,9 % et 99,99 % (année de 365 jours).
Voir la réponse
Une année compte 365 × 24 = 8 760 heures. À 99,9 %, l’arrêt permis est de 0,1 % soit 8,76 heures. À 99,99 %, il est de 0,01 % soit 0,876 heure, environ 53 minutes. Pour un site utilisé seulement aux heures de bureau, la vraie question est la disponibilité pendant ces heures : on peut demander 99,9 % de 8 h à 18 h en semaine et accepter des opérations de maintenance la nuit et le week-end, ce qui coûte beaucoup moins cher. On demande donc d’abord à quoi sert la disponibilité, puis on fixe un niveau et une plage horaire justifiés.
6Sécurité, données et sortie du contrat
Autrefois, la sécurité et les données personnelles se réglaient souvent après coup. Ce n’est plus tenable. Plusieurs textes de loi et plusieurs usages imposent d’y penser dès l’écriture du cahier des charges. Ajouter la sécurité à la fin du projet coûte beaucoup plus cher que de la prévoir au début, comme l’explique l’article sur le développement sécurisé.
6.1Exigences de sécurité
Un cahier des charges d’un produit ou d’un service numérique prévoit au minimum :
- les règles d’accès : qui peut voir et modifier quoi, avec quelle authentification (mot de passe, double vérification, clé d’accès) ;
- la protection des données : chiffrement lors du transport et du stockage, séparation des environnements, durée de conservation ;
- la traçabilité : quelles actions sont journalisées, pendant combien de temps, qui y a accès ;
- le traitement des défauts : délai de correction des failles de sécurité, mises à jour, signalement au client en cas d’incident ;
- les sauvegardes et la reprise après sinistre : fréquence, lieu, délai de remise en service ;
- les tests de sécurité demandés avant la mise en service (voir la gestion des risques).
Pour une organisation qui possède une politique de sécurité, le cahier des charges y renvoie : « le fournisseur respecte la politique de sécurité jointe en annexe ». Pour un fournisseur important, on y ajoute souvent un plan d’assurance sécurité, document où le fournisseur décrit les mesures qu’il s’engage à appliquer.
6.2Données personnelles et règles du secteur
Si le projet traite des informations sur des personnes (clients, salariés, patients), le règlement européen sur la protection des données (le RGPD, en vigueur depuis mai 2018) impose notamment de définir pourquoi on les collecte, de n’en collecter que le nécessaire, de les protéger, de limiter leur durée de conservation et de savoir où elles sont hébergées. Le cahier des charges doit en reprendre les points qui concernent le fournisseur (voir le RGPD), et préciser lequel des deux est responsable de quoi. Des secteurs ont leurs propres règles : santé, paiement par carte, services essentiels, marchés publics. Le texte du cahier des charges les nomme, plutôt que de supposer que le fournisseur les connaît.
6.3Réversibilité et dépendance
Un projet commence un jour ; il finit aussi. La réversibilité est la capacité, à la fin du contrat, de récupérer ses données dans un format ouvert, de continuer sans le fournisseur ou de passer chez un autre. Elle doit être écrite : quelles données, quels formats, dans quel délai, à quel prix, avec quelle aide du fournisseur sortant. Sans cela, le client peut se retrouver prisonnier d’un outil : changer coûte alors plus cher que de rester, et le fournisseur le sait. Les mêmes questions se posent pour les composants que le fournisseur utilise : un produit construit sur des briques logicielles qu’il ne maîtrise pas transmet ses risques à son client (voir la sécurité de la chaîne d’approvisionnement).
Les règles européennes récentes poussent dans ce sens. Le règlement sur la cyber-résilience (voir le règlement sur la cyber-résilience) impose à ceux qui vendent des produits comportant des éléments numériques de gérer les failles pendant toute la durée de support annoncée. Un cahier des charges d’achat peut donc légitimement demander la durée de support, la liste des composants (une « nomenclature logicielle ») et la façon dont les failles seront annoncées.