• 10 heures
  • Moyenne

Ce cours est visible gratuitement en ligne.

course.header.alt.is_certifying

J'ai tout compris !

Mis à jour le 21/12/2023

Rédigez le cahier de spécifications techniques

Appréhendez les spécifications techniques

Une fois les spécifications fonctionnelles validées, vous passez maintenant à la phase n°3 du cycle en V. Vous allez travailler sur le document des spécifications techniques

La troisième étape du cycle en V : les spécifications techniques
La troisième étape du cycle en V : les spécifications techniques

Qu’est-ce que les spécifications techniques ?

Le cahier des spécifications techniques est un document qui décrit tous les outils et méthodes dont les développeurs auront besoin pour programmer l’application correctement. Par exemple, le langage informatique choisi pour coder l’application, le type de serveur utilisé pour stocker les données…

Avec ce support, les développeurs auront toutes les informations pour savoir “comment” construire l’application.

Dois-je rédiger les spécifications techniques ?

Exerçant la fonction de gestionnaire de projet, vous allez principalement organiser la rédaction. C’est-à-dire que les spécifications techniques seront écrites par vos collègues qui les complèteront selon leur domaine d’expertise. Votre rôle sera de les accompagner en leur proposant un plan de rédaction, des deadlines, et des ateliers pour travailler sur le document.

Quelles thématiques dois-je aborder dans les spécifications techniques ?

Dans les spécifications techniques, vous pourrez aborder 5 thématiques qui apparaissent régulièrement dans les projets de création logicielle.

  1. Premièrement, vous avez les infrastructures. Cette section permettra de définir le matériel et les pratiques nécessaires pour stocker l’application.

  2. Ensuite, vous aurez les choix technologiques. Cette section permet de décrire les langages et packages choisis pour coder l’application.

  3. En troisième lieu, vous avez les schémas de base de données. Il s’agit d’indiquer “comment” les données de l’application seront organisées et reliées entre elles.

  4. Puis vous avez l’architecture logicielle. Ici, vous expliquez comment les différentes parties de l’application seront assemblées et comment elles communiqueront entre elles pour accomplir les tâches nécessaires.

  5. Et pour finir, vous avez les contraintes. Cette section servira à déterminer les niveaux d’exigence au sujet de la sécurité, la compatibilité et les performances de l’application.

Qui rédige les spécifications techniques ?

La rédaction des spécifications techniques nécessite des compétences particulières en fonction des thématiques abordées. Pour mieux les discerner, je vous propose de les distinguer en deux catégories :

  1. Les spécialistes du développement : ils sont en lien avec toutes les thématiques concernant les technologies, l’architecture logicielle et les bases de données.

  2. Les spécialistes du cloud et des infrastructures : quant à eux, ils traiteront les aspects liés à l’hébergement des données et aux moyens d’optimiser les outils ou bien supports contenant les applications, données, etc.

Collaborez sur les spécifications techniques

La rédaction des spécifications techniques peut parfois nécessiter une préparation collective pour aider les rédacteurs à être alignés sur la proposition à rédiger. Pour faciliter ce travail, vous pouvez en tant que coordinateur réaliser des ateliers de travaux collectifs avec vos équipes.

Que dois-je faire pour préparer les ateliers des spécifications techniques ?

Dans un premier temps, vous pourrez préparer l’atelier en définissant un cadre clair. Et les actions utiles à réaliser avant l’atelier, puis celles qui permettront de réaliser une animation efficace.

Les étapes à suivre pour préparer l'atelier
Les étapes à suivre pour préparer l'atelier
  1. Commencez par définir l’objectif de cet atelier en ciblant un sujet. Cela vous permettra de vous focaliser sur une thématique en profondeur.
    Par exemple, parlerons-nous d’architecture ? d’infrastructure ? de contraintes techniques ? etc.

  2. Après la définition de l’objectif, vous pourrez solliciter les profils techniques pertinents pour cet atelier.
    Par exemple, il peut s’agir d’experts en développement et hébergement cloud…

  3. Lorsque votre sujet est défini, pensez à désigner un animateur pour cet atelier. Il s’agira d’inciter les participants à contribuer durant cet exercice collectif.
    Le chef de projet ou un profil technique pourraient être des animateurs.

  4. Afin de traiter le sujet des spécifications techniques efficacement, étudiez le cahier des charges et les spécifications fonctionnelles. Cette action vous aidera à orienter l’atelier dans la bonne direction pour éviter les hors-sujet.

  5. Enfin, organisez votre atelier en définissant les temps importants. Vous pourrez ainsi prévoir une meilleure gestion du temps pour aborder les points désirés.

Vos éléments étant prêts pour le déroulement de l’atelier, vous pouvez maintenant appliquer quelques principes lors de son déroulement.

Le cycle d'animation durant l'atelier
Le cycle d'animation durant l'atelier
  1. Encouragez les participants à intervenir en posant des questions, partageant des idées. Le brainstorming aidera à découvrir les idées pertinentes.

  2. Durant les moments de partage, prenez des notes. Vous pourrez également désigner quelqu’un pour remplir les supports pendant que vous gardez le fil de l’animation. Je trouve particulièrement pratique d’animer un atelier lorsqu’une autre personne est exclusivement dédiée à la prise de notes. 

  3. Lorsque vous récoltez les informations, pensez à faire un tri afin de distinguer les données essentielles pour prendre les meilleures décisions. Par exemple, tableaux, mindmaps, diagrammes ou post-it peuvent être de bons supports de capture d’idées.

  4. Grâce à vos supports et au tri des informations, vous pouvez faire une synthèse qui récapitule les orientations que vous aurez prises sur le sujet abordé durant l’atelier.
    Par exemple, l’équipe s’oriente clairement vers le choix d’une architecture particulière et cela devra être pris en compte dans la rédaction des spécifications techniques par chaque membre rédigeant leur section.

  5. Enfin, lorsque les actions sont définies, n’hésitez pas à communiquer régulièrement sur leur évolution en faisant le suivi de toutes les décisions prises.
    Par exemple, est-ce que la section d’architecture est rédigée conformément aux décisions de l’atelier ? Qui est chargé de faire quoi ? Catherine a-t-elle avancé sur son schéma de base de données ?

Les étapes après l'atelier
Les étapes après l'atelier

Avec une bonne préparation et une animation efficace vous aurez facilité la collaboration de vos équipes autour de la construction des spécifications techniques.

Analysez les spécifications techniques

J’ai peur de me sentir submergé. Que puis-je faire pour lutter contre ?

Lorsque vous travaillez sur des spécifications techniques sans avoir eu de formation technique, il est tout à fait normal que vous vous sentiez un peu dépassé ou de ressentir le syndrome de l'imposteur.
Mais soyez rassuré si vous êtes dans ce cas. Il existe des stratégies pour mieux comprendre ce type de document et vous sentir à l'aise lors des échanges avec vos collaborateurs. 

  1. Tout d'abord, prenez le temps de vous familiariser avec les termes les plus utilisés.

    Prenez des notes avec des outils comme les cartes mentales et n'hésitez pas à poser des questions à l'équipe technique pour clarifier les concepts qui vous semblent flous.

  2. Rappelez-vous que votre rôle est avant tout de coordonner l'équipe et de veiller à ce que les spécifications techniques soient claires et cohérentes, donc ne cherchez pas à tout maîtriser.

  3. Ne vous laissez pas décourager par les termes complexes. Vous gagnerez en confiance progressivement.

À vous de jouer

Contexte

Vous êtes le chef de projet pour AirGalaxy, une entreprise leader dans l'industrie aérospatiale. AirGalaxy développe une application pour tester et surveiller ses fusées en temps réel. Pour cela, une équipe de professionnels aux compétences diverses a été formée.

Consignes

Votre mission est d’affecter chaque sujet des spécifications à la bonne section et d'associer chaque profil de rédacteur à la section correspondante. Utilisez les profils donnés comme guides pour mener à bien votre tâche.

En résumé

  • Les spécifications techniques se concentrent sur les détails techniques de construction du logiciel, tels que l'architecture, les technologies, les normes de codage et les contraintes de performance.

  • Les spécifications techniques nécessitent des profils techniques pour la rédaction.

  • Le chef de projet MOE dirige l'équipe technique pour rédiger les spécifications ; en tant que chef de projet sans formation technique, prenez le temps de comprendre les mots techniques et posez des questions pour éclaircir les idées.

  • Regardez des schémas et demandez des explications claires à l'équipe pour mieux comprendre comment le logiciel est organisé.

Maintenant que vous avez clarifié ce que votre projet apporte d'important avec le cahier des charges et les cahiers de spécifications (fonctionnelles et techniques), vous pouvez passer à la prochaine étape où vous mettrez en place des outils de pilotage. 

Mais avant cela, je vous invite à tester vos connaissances dans le quiz clôturant cette partie du cours.

Exemple de certificat de réussite
Exemple de certificat de réussite