Aller au contenu
Nodary
Commencer gratuitement

Modèle de document de conception technique

Six documents liés qui mènent un système des exigences au déploiement : le contexte, l’architecture, les données et les interfaces, comment il tourne et comment il tombe, et les options écartées. Téléchargez-les en fichiers Markdown : ils s’ouvrent dans n’importe quel éditeur, vivent à côté du code dans un dépôt, dessinent leurs diagrammes sur GitHub et dans Obsidian, et s’importent dans Nodary sous forme de carte.

Télécharger le modèleOuvrir la démo

6 fichiers Markdown dans un .zip, 8 ko

Gratuit, sans compte, sans e-mail. Utilisez-le, modifiez-le, partagez-le.

Document de conception techniqueContexte et exigencesArchitectureDonnées et interfacesExploitationAlternatives et risques

Lisez chaque page avant de télécharger

La vue d’ensemble tient sur un écran et renvoie à cinq parties : un relecteur lit le résumé, puis va droit à la partie qui le concerne. Les lignes en italique disent quoi écrire ; les exemples suivent une même fonctionnalité d’exemple, des liens de partage qui expirent.

Documents

Fichier Modèle de document de conception technique/Document de conception technique.md

Document de conception technique

Mode d’emploi : les lignes en italique sont des consignes. Remplacez-les par vos propres mots, puis supprimez-les. Les valeurs entre crochets sont à remplir. Gardez cette page sur un écran : un relecteur doit y comprendre ce qu’il approuve.

En bref

ChampCette conception
Système ou fonctionnalité[Nom]
Auteur[nom]
Relecteurs[noms]
Statut[brouillon, en relecture, approuvé, réalisé]
Exigences[lien vers le PRD]
Version visée[date ou version]

Résumé

Trois phrases : ce que vous allez construire, pourquoi, et la décision qu’un relecteur doit regarder en premier.

Exemple (une fonctionnalité d’exemple) : Les liens de partage reçoivent une date de fin facultative. Chaque requête vérifie la date : un lien cesse de marcher à l’instant où il prend fin. Une tâche planifiée révoque les liens expirés chaque minute ; elle ne fait que nettoyer, et un retard ne change rien pour qui ouvre le lien.

[Votre résumé]

Objectifs et non-objectifs

  • Objectif : [...]
  • Objectif : [...]
  • Non-objectif : [...]
  • Non-objectif : [...]

Le reste de la conception

Chaque partie est un document à part. Liez-la plutôt que de la recopier : chaque fait vit à un seul endroit.

Ce modèle est libre d’utilisation, de modification et de partage. Il vient de Nodary, où ces fichiers s’importent sous forme de carte de documents liés.

Télécharger le modèle6 fichiers Markdown dans un .zip, 8 ko

Comment s’en servir

  1. Partez des exigences

    Liez les exigences produit dans la page de contexte et listez celles qui façonnent la conception. Une conception qui ne répond à aucune exigence est un refactoring déguisé.

  2. Dessinez, puis écrivez

    Dessinez les composants et les appels entre eux avant la prose. Un relecteur repère une boîte manquante plus vite qu’un paragraphe manquant.

  3. Écrivez ce que vous avez écarté

    Remplissez les alternatives avec les options sérieusement envisagées. La relecture ne les rouvrira pas une par une.

  4. Mettez-le à jour après la réalisation

    Quand le code est livré, notez ce qui a changé par rapport au plan. Le suivant lit la conception pour savoir comment le système marche, pas comment on l’avait imaginé.

Importez-le dans Nodary en carte

Nodary est un espace de travail IA où les documents d’une équipe se relient au lieu de s’empiler. Importez le .zip : la conception arrive avec ses cinq parties rangées sous elle, ses liens conservés et son diagramme dessiné en diagramme Mermaid modifiable. Les relecteurs commentent un passage ou un élément de diagramme, l’auteur demande une approbation, et des agents de code comme Cursor, Claude Code ou VS Code, connectés par MCP, lisent la conception avant d’écrire le code.

  1. Ouvrez la carte d’un projet et choisissez Importer.
  2. Choisissez l’onglet Dossier ou ZIP, puis Choisir un ZIP.
  3. Sélectionnez le fichier téléchargé, vérifiez l’arborescence et importez.

L’offre gratuite compte dix documents par espace de travail, page du projet comprise : les six du modèle laissent la place pour trois autres. Nodary a aussi un modèle de conception technique d’une page intégré.

Connecter Cursor, Claude Code ou VS Code à Nodary
Un projet sur la carte de Nodary : 43 documents regroupés autour de huit pôles, reliés par des lignes de hiérarchie et des liens nommés, avec les pointeurs des coéquipiers sur la carte ; le projet d’exemple montré est un jeu.

Écrire une conception que les relecteurs peuvent approuver

Un document de conception technique échoue quand les relecteurs ne savent pas ce qu’ils approuvent, ou quand le système décrit n’est pas celui qui a été livré. Ces habitudes évitent les deux.

Commencez par la décision

Dites dans le résumé ce que vous allez construire et le choix qu’un relecteur doit regarder en premier. Personne ne devrait le trouver en page trois.

Dessinez avant d’écrire

Un diagramme de six boîtes et de leurs appels vaut six pages de prose, et montre tout de suite la pièce qui manque.

Dites ce que vous ne ferez pas

Les non-objectifs gardent la relecture sur la conception présentée, pas sur celle que quelqu’un aurait voulu lire.

Montrez les options écartées

Pour chaque choix important, dites ce que vous avez envisagé d’autre et pourquoi non. Les relecteurs discutent alors vos raisons, pas votre conclusion.

Prévoyez la panne

Dites ce qui se passe quand chaque partie tombe, comment vous le verrez et comment vous reprenez. L’exploitation fait partie de la conception, ce n’est pas une annexe.

Gardez-la vraie après la réalisation

Notez ce qui a changé pendant la réalisation et liez les décisions qui l’expliquent. Une conception fidèle au code est une documentation ; une conception qui ne l’est pas est un piège.

Questions sur le document de conception technique

Qu’est-ce qu’un document de conception technique ?

Un document de conception technique (en anglais technical design document, TDD) décrit comment un système ou une fonctionnalité sera construit avant l’écriture du code : son contexte et ses exigences, son architecture, ses données et interfaces, son déploiement et sa surveillance, les risques et les alternatives envisagées. Les développeurs l’écrivent pour que d’autres relisent l’approche tant qu’elle coûte peu à changer.

Que doit contenir un document de conception technique ?

Un résumé avec objectifs et non-objectifs, l’existant et les exigences, les composants et leurs échanges, le modèle de données et les API, le déploiement, la surveillance, la sécurité et les modes de panne, les alternatives envisagées, les risques, le plan de déploiement et les questions ouvertes. Ce modèle a un document pour chaque groupe.

Quelle différence avec un PRD ?

Le document d’exigences produit dit ce que la fonctionnalité doit faire et pourquoi. Le document de conception technique dit comment le système le fera. Écrivez d’abord le PRD, puis liez-le depuis la conception pour que chaque exigence se retrouve.

Quand un changement demande-t-il un document de conception ?

Quand il touche plusieurs composants ou équipes, change des données existantes, est difficile à défaire, ou porte un risque qui mérite un second regard. Un petit changement dans un seul composant demande en général une bonne pull request, pas un document de conception.

Qui doit relire un document de conception technique ?

Les développeurs qui vont le construire et l’exploiter, un développeur de chaque système concerné, et une personne responsable de la sécurité quand il touche à des données personnelles ou à des accès. Demandez la relecture tôt, avant que l’essentiel du code existe.

Les équipes de jeu écrivent-elles aussi des documents de conception technique ?

Oui. Le modèle de document de game design a une partie conception technique pour le moteur, les cibles et la chaîne de production ; un gros système, comme le réseau, les sauvegardes ou les outils, mérite son propre document de conception technique, relié depuis le GDD.

À lire ensuite

Gardez la conception à côté des personnes et des agents qui la construisent.

Importez le modèle dans Nodary et la conception devient une carte que votre équipe et vos agents de code lisent avant de toucher au système. Gratuit avec deux membres, un projet et dix documents, sans carte bancaire.

Commencer gratuitementOuvrir la démoTélécharger le modèle