10 min de lecture

Comment rédiger un cahier des charges technique efficace ?

William

Rédacteur prestataires et recrutement · Anaska

Pour rédiger un cahier des charges technique efficace, décrivez le contexte, l’existant, les interfaces et les conditions d’exploitation. Transformez chaque attente en exigence identifiable, justifiée et vérifiable. Précisez les livrables, les responsabilités et les scénarios de recette. Lorsque des données manquent, consignez les questions ouvertes au lieu d’inventer des seuils. Demandez enfin aux prestataires de répondre sur une grille commune, en explicitant leurs hypothèses, leurs réserves et les contributions attendues de votre équipe.

Résumer avec l'IA ChatGPT Perplexity Claude Google IA

Un cahier des charges technique doit permettre de comprendre ce qui sera livré et comment sa réception sera décidée. Dans quel environnement la solution fonctionnera-t-elle ? Avec quels systèmes échangera-t-elle ? Que devra faire l’équipe lorsqu’un échange échoue ? Pour rédiger ce document, nous recommandons de relier chaque contrainte à sa justification et à une preuve attendue.

Ce guide Anaska, comparateur édité par WebGuard Agency, propose un exemple de cahier des charges consacré aux interfaces, à l’exploitation et à la validation technique. Il complète les modèles propres aux applications mobiles, aux ERP ou aux plateformes marchandes. Les méthodes présentées sont des conseils de la rédaction. Le projet utilisé comme fil conducteur est fictif.

Clarifier la commande et les choix encore ouverts

Commencez par la décision que le document doit permettre : consulter des prestataires, préparer un développement interne ou organiser une intégration. Le degré de détail peut ensuite être adapté. Pour une première consultation, certaines solutions peuvent rester ouvertes ; lorsque plusieurs équipes doivent développer ensemble, précisez davantage les règles de leurs échanges.

Nous proposons de distinguer trois éléments dans la rédaction :

  • Le besoin fonctionnel : ce que la personne doit pouvoir accomplir et dans quel but.
  • La contrainte technique : une condition à respecter, accompagnée de sa justification.
  • La proposition d’architecture : une manière envisagée de répondre au besoin dans ces conditions.

Dans notre exemple fictif, une organisation souhaite transmettre les dossiers approuvés de son portail vers un outil de suivi existant. Le gestionnaire doit connaître l’état de cette transmission. L’accès à l’interface du destinataire constitue une dépendance ; le choix du composant chargé des échanges reste à proposer.

Délimitez aussi ce que la commande exclut. Le remplacement de l’outil de suivi ou la reprise des dossiers anciens ne doivent pas être supposés inclus parce qu’ils concernent les mêmes données. Une courte note approuvée par le commanditaire peut fixer ces frontières. Si une technologie est imposée, expliquez pourquoi : environnement déjà administré, interface existante ou autre contrainte documentée du projet.

Réunir les informations nécessaires au chiffrage

Préparez un état des lieux lisible par une personne extérieure à votre organisation. Recensez les applications concernées, leurs responsables, les environnements disponibles et la documentation connue. Associez un statut aux informations importantes : confirmées, à vérifier ou indisponibles. Signalez notamment lorsqu’un document décrit une ancienne version.

Le candidat doit pouvoir reconnaître ce qu’il sait et ce qu’il devra examiner.

Joignez des exemples de données préparés pour la consultation. Des jeux fictifs cohérents peuvent montrer un dossier courant, un champ absent ou une référence inconnue sans nécessiter l’envoi de dossiers réels. Expliquez les termes internes : « dossier approuvé » doit renvoyer à un état précis, avec un acteur autorisé à le déclencher.

Décrivez les conditions pratiques du travail. Qui ouvre l’environnement d’essai ? Qui fournit les comptes et répond aux questions sur l’application destinataire ? Indiquez les contributions de votre équipe et celles attendues du prestataire. Si une intervention d’un autre fournisseur est nécessaire, faites apparaître cette dépendance dans le calendrier proposé.

Pour les inconnues, tenez un registre court comprenant la question, son responsable et la décision qu’elle bloque. Un format d’export indisponible peut justifier une phase d’examen préalable. Demandez alors un livrable précis, comme une description des données accessibles et des limites constatées, avant de solliciter un engagement sur l’intégration complète.

Passer des usages aux exigences vérifiables

Le Service Manual de GOV.UK présente les user stories autour de l’acteur, du besoin et de l’objectif recherché. Il décrit les critères d’acceptation comme des résultats permettant de vérifier que le service répond au besoin. Cette méthode peut guider la rédaction ; elle ne constitue pas une obligation générale pour votre projet.

Exemple fictif : « En tant que gestionnaire, je souhaite connaître l’état de transmission d’un dossier approuvé afin de décider si une intervention est nécessaire. » Cette phrase donne une finalité. Il reste à décrire l’événement déclencheur, les informations transmises et le résultat visible en cas de refus du destinataire.

Attribuez un identifiant stable à chaque exigence, puis ajoutez sa justification, sa priorité et sa méthode de vérification. Utilisez ces identifiants dans la réponse des candidats et dans les scénarios de recette. Vous pourrez ainsi retrouver la même demande sans dépendre de son emplacement dans une version du document.

Divisez les formulations qui regroupent plusieurs résultats indépendants. Transmettre un dossier, signaler un échec et autoriser une reprise appellent des précisions différentes. Pour décider de la priorité, décrivez la conséquence d’une absence : opération impossible, contrôle manuel nécessaire ou amélioration différable. Évitez de donner à toutes les demandes le même caractère impératif.

Relisez enfin la chaîne complète : problème observé, usage, exigence et preuve. Une exigence sans justification mérite une discussion. Un usage prioritaire sans contrôle associé reste insuffisamment préparé pour la réception.

Définir les mesures sans choisir des seuils arbitraires

« Rapide », « robuste » et « compatible » laissent trop de place à l’interprétation lorsqu’ils apparaissent seuls. Remplacez-les par une situation observable. Pour une attente de performance, précisez l’opération mesurée, les données utilisées, la charge envisagée et l’environnement d’essai. Le seuil doit ensuite être approuvé sur une base documentée.

Exemple fictif : préciser une attente et sa preuve de validation
Attente initialeDécisions à consignerPreuve proposée
Transmission fiableÉtats possibles, traitement des échecs et conditions de repriseInterruption suivie d’une reprise avec contrôle du dossier reçu
Consultation rapideOpération, données, charge et seuil après cadrageCompte rendu de mesure dans l’environnement convenu
Accès maîtrisésActions autorisées et refusées pour chaque profilEssais réalisés avec des comptes de rôles distincts
Exploitation transmissibleDocuments et opérations nécessaires à la reprise du serviceProcédure exécutée par l’équipe destinataire

Lorsque les volumes sont inconnus, demandez une collecte ou un examen des historiques disponibles. Notez qui les fournira et quand les critères pourront être arrêtés. Une valeur provisoire peut servir à explorer une solution, à condition de rester clairement identifiée comme hypothèse.

Définissez également les limites des preuves. Une mesure réalisée dans un environnement d’essai ne permet pas, à elle seule, de conclure pour l’environnement final. Si celui-ci reste inaccessible, consignez les vérifications différées et la personne chargée de les organiser. Prévoyez ce qui sera décidé si les résultats conduisent à revoir l’architecture proposée.

Documenter les interfaces et le sens des données

Décrivez chaque échange avec son émetteur, son destinataire et son déclencheur. Désignez le système qui fait référence pour chaque donnée. Dans le fil conducteur fictif, le portail peut porter l’approbation du dossier tandis que l’outil destinataire fournit la confirmation de réception. Cette répartition doit être explicitée avant de décrire l’affichage des états.

Préparez un dictionnaire des champs : sens, format, valeurs admises et traitement d’une absence. Deux équipes peuvent utiliser le mot « référence » pour désigner des informations différentes. Ajoutez donc des exemples cohérents et faites valider leur interprétation par les responsables des systèmes concernés.

Pour les API HTTP, la spécification OpenAPI définit une description standard indépendante du langage de programmation. Elle permet notamment de décrire les opérations et les mécanismes de sécurité. Vous pouvez demander une description OpenAPI comme livrable, en convenant de la version et des outils avec lesquels elle devra être utilisable.

Complétez cette description par les règles de traitement : que se passe-t-il si le même dossier est envoyé à nouveau, si une réponse arrive après une relance ou si le contenu est refusé ? Demandez une proposition explicite pour chaque cas retenu. Ces décisions doivent aussi apparaître dans les essais, sans rester cantonnées à une annexe technique.

Prévoyez enfin l’évolution de l’interface. Indiquez qui annonce un changement, qui met la documentation à jour et quels échanges devront être revérifiés. Faites relire cette rubrique aux deux équipes en suivant un dossier jusqu’à sa réception.

Rendre les accès et les responsabilités explicites

Le guide de la sécurité des données personnelles de la CNIL aborde notamment l’authentification, les habilitations, les développements, les échanges extérieurs et la sous-traitance. Ces thèmes fournissent des points d’examen pour un projet traitant des données personnelles. Les mesures à retenir doivent ensuite être précisées avec les interlocuteurs compétents pour votre contexte.

Établissez une matrice par action et par catégorie de données. Distinguez la consultation, la modification, l’export et l’administration. Un intitulé de rôle ne suffit pas à définir les pouvoirs associés : dans notre exemple, une personne chargée de reprendre les transmissions peut consulter leur état sans être autorisée à modifier les dossiers.

Décrivez le parcours des droits, depuis leur attribution jusqu’à leur retrait. Qui autorise un accès ? Qui le crée ? Comment vérifier qu’une personne ayant quitté la mission ne peut plus intervenir ? Inscrivez les contrôles attendus dans les scénarios de recette.

  • Précisez les accès nécessaires dans chaque environnement.
  • Désignez la personne autorisant une intervention de maintenance.
  • Définissez les traces attendues pour les actions sensibles retenues.
  • Faites proposer une procédure de transmission des informations confidentielles de configuration.

Ne placez pas ces informations confidentielles directement dans le dossier de consultation. Pour les décisions non résolues, indiquez un responsable et les éléments nécessaires à l’arbitrage. Une déclaration générale de conformité ne remplace pas la description des actions permises et des contrôles associés.

Préparer le fonctionnement après la livraison

Rédigez cette partie avec les personnes qui exploiteront le service. Elles doivent pouvoir reconnaître une opération en attente, comprendre une alerte et savoir à qui transmettre un incident. Demandez au candidat de décrire les moyens proposés et les tâches qui resteront à votre charge.

Le guide de la CNIL traite aussi de la traçabilité, des sauvegardes, de la continuité, de la reprise d’activité et de la maintenance. Utilisez ces rubriques pour préparer vos questions, puis définissez les modalités attendues : éléments concernés, responsabilités et vérifications après restauration.

Dans notre exemple fictif, une interruption laisse des transmissions incomplètes. Le cahier des charges demande une procédure permettant de les retrouver, de décider lesquelles reprendre et de contrôler le résultat côté destinataire. L’équipe chargée du service exécute cette procédure sur un jeu d’essai convenu ; ses difficultés servent à corriger la documentation avant réception.

Préparez également la transmission à une autre équipe. Définissez les éléments à remettre selon le périmètre convenu : code, configurations, documentation d’installation ou procédures d’exploitation. Pour chacun, précisez le destinataire et le contrôle de remise. Faites examiner les conditions d’utilisation et de transmission lorsqu’elles nécessitent un accord contractuel.

Une démonstration par l’auteur ne suffit pas à vérifier cette transmission. Nous recommandons de prévoir une opération réalisée par l’équipe destinataire à partir des documents remis, avec consignation des explications supplémentaires nécessaires.

Assembler un exemple de cahier des charges cohérent

Organisez le dossier pour permettre une lecture progressive. Présentez d’abord le contexte et le périmètre, puis l’existant et les exigences. Placez ensuite les interfaces, les conditions d’exploitation et les modalités de validation. Les annexes volumineuses doivent être référencées depuis les passages concernés et porter une version identifiable.

Voici une formulation fictive à adapter :

TRANS-APPROUVE : lorsqu’un gestionnaire approuve un dossier du périmètre défini, la solution prépare sa transmission à l’outil destinataire. Elle présente au gestionnaire l’état de cette opération. Si le contenu est refusé, elle affiche un motif exploitable et permet le traitement prévu dans la procédure de correction.

Cette formulation doit être accompagnée des références utiles : liste des champs, profils autorisés et interface destinataire. Ajoutez sa priorité et sa justification. Pour la recette, prévoyez un dossier accepté, un contenu refusé et une opération interrompue, avec un résultat attendu écrit pour chaque situation.

Relisez ensuite les rubriques ensemble. Si une reprise manuelle est demandée, la matrice des droits doit permettre à la personne désignée de l’effectuer. Si une confirmation dépend d’un système extérieur, indiquez comment elle sera obtenue pendant les essais.

Pour détailler les règles propres à un système de gestion, complétez cette trame avec le guide du cahier des charges ERP. Conservez toutefois dans le dossier technique la description précise des échanges entre applications.

Comparer les propositions sur le même périmètre

Joignez une grille reprenant les identifiants des exigences. Demandez au candidat sa réponse, la solution envisagée et ses réserves. Il doit pouvoir distinguer ce qui est inclus, proposé en option ou soumis à un examen préalable. Une réponse positive mérite une explication lorsque sa mise en œuvre dépend d’un accès encore indisponible.

Examinez particulièrement les travaux situés autour du développement : préparation des données, ouverture des environnements, essais et rédaction des procédures. Vérifiez à qui ils sont confiés. Si deux offres répartissent ces tâches différemment, demandez une clarification avant de comparer leurs montants.

Pour le calendrier et le budget, faites préciser les hypothèses. Une dépendance non résolue ne doit pas disparaître derrière une date de livraison. Vous pouvez prévoir une première mission limitée à l’examen de l’existant, puis demander une proposition révisée à partir de ses livrables.

Conservez les questions et réponses dans un registre de consultation. Lorsqu’une clarification modifie la demande, transmettez une version corrigée aux candidats concernés. La méthodologie d’Anaska peut compléter votre préparation ; votre grille de choix doit rester liée au travail effectivement demandé et aux responsabilités proposées.

Prévoir la recette et les modifications du document

Préparez les scénarios de recette pendant la rédaction. Chaque contrôle doit préciser les conditions de départ, les actions à effectuer et le résultat attendu. Désignez les personnes qui préparent les données, réalisent les essais et décident du traitement des écarts.

Si le projet suit Scrum, le Scrum Guide de novembre 2020 prévoit l’affinement du Product Backlog et la possibilité de clarifier ou renégocier le périmètre avec le Product Owner à mesure des apprentissages. Dans ce contexte, nous recommandons de conserver une référence technique partagée et de mettre à jour les exigences concernées par les décisions.

Pour chaque modification, notez la demande, sa justification et ses conséquences sur les essais. Distinguez une correction visant à satisfaire une exigence approuvée d’une nouvelle attente. En cas de désaccord, revenez au texte et aux scénarios convenus avant de réviser le périmètre.

Avant diffusion, confiez le dossier à un lecteur extérieur à sa rédaction. Demandez-lui d’expliquer ce qu’il devrait livrer et comment son travail serait accepté. Ses hésitations indiquent les passages à préciser. Les questions restantes doivent avoir un responsable et une étape de résolution identifiée.

Questions fréquentes

Quelle différence faire entre cahier des charges fonctionnel et technique ?

Pour structurer votre document, réservez la partie fonctionnelle aux usages et aux résultats recherchés. Décrivez dans la partie technique les contraintes d’environnement, les interfaces, les données et les conditions d’exploitation. Reliez les deux parties par des identifiants d’exigences et des critères de validation.

Faut-il imposer une technologie dans le cahier des charges ?

Nous recommandons de l’imposer seulement lorsqu’une contrainte explicitée le justifie. Sinon, décrivez les résultats et les conditions attendus, puis demandez aux candidats de proposer une architecture argumentée. Distinguez clairement les décisions arrêtées des choix encore ouverts.

Comment rédiger une exigence lorsque les volumes sont inconnus ?

Indiquez l’information manquante, la personne chargée de la réunir et la décision qu’elle conditionne. Vous pouvez prévoir une phase de mesure ou d’examen préalable. Le seuil et les conditions d’essai seront ensuite approuvés sur une base documentée.

Peut-on utiliser ce modèle pour une application mobile ou une marketplace ?

Cette trame peut cadrer les exigences techniques communes, mais elle doit être complétée par les règles propres au produit. Pour une application mobile, précisez notamment les appareils et les interruptions. Pour une marketplace, décrivez les pouvoirs des intervenants et les règles de transaction.

Comment vérifier que le document est prêt à être envoyé ?

Faites vérifier le périmètre, les dépendances et les responsabilités par les personnes concernées. Demandez ensuite à un lecteur extérieur d’expliquer les livrables attendus et leurs conditions d’acceptation. Corrigez les ambiguïtés et attribuez un responsable à chaque question encore ouverte.

Sources

Vous avez un projet ?Décrivez-le, vous êtes recontacté rapidement
Déposer mon projet
WilliamRédacteur prestataires et recrutement · Anaska

À lire ensuite

Comparer d'abord, signer ensuite.

Données publiques datées, notes toujours sourcées

Échap

Tapez au moins deux lettres : classements, fiches d'agences, logiciels et articles publiés.