Aller au contenu
Perrine HonoréPerrine Honoré · Blog
MéthodePar Perrine Honoré · · mis à jour le · 8 min de lecture

Dette technique d'un MVP : laquelle accepter, laquelle refuser

Dette acceptable ou toxique, les raccourcis interdits, le registre de dette, les signaux de remboursement et la grille refactoriser ou réécrire.

En bref

Sur un MVP, la dette technique est un outil : elle achète de la vitesse. Elle devient toxique quand elle touche l'authentification, les paiements, le modèle de données, les sauvegardes ou la sécurité, ou quand personne ne l'a notée. On la consigne dans un registre, on la rembourse par une part fixe de chaque sprint, et on refactorise bien plus souvent qu'on ne réécrit.

« Il faut zéro dette technique. » Quand un fondateur me dit ça au lancement d'un MVP, je sais qu'on va devoir en parler. Un MVP sans aucune dette est un MVP qui a pris trop de temps. L'objectif d'un MVP est d'apprendre vite si le produit répond à un vrai besoin ; pour ça, on emprunte du temps au futur. La vraie question n'est donc pas « comment éviter la dette » mais « laquelle accepter, laquelle refuser, et comment savoir quand la rembourser ».

Voici la façon dont je la gère sur les produits que je construis, après treize ans à livrer du web, du mobile et du SaaS, de la startup aux grands comptes.

Ma règle : une dette est acceptable si elle est choisie, notée, bornée et réversible. Il suffit qu'un seul de ces quatre critères manque pour qu'elle devienne toxique.

Ce que la dette technique est vraiment

L'expression vient de Ward Cunningham, au début des années 1990. Sa métaphore est financière et elle est juste : livrer un code imparfait, c'est contracter un emprunt. On gagne du temps maintenant, et chaque fois qu'on retravaille ce code, on paie des intérêts sous forme de lenteur. Tant qu'on rembourse, l'emprunt est un levier. Quand on oublie qu'on a emprunté, les intérêts finissent par absorber toute la capacité de l'équipe.

Martin Fowler a proposé une grille utile pour la classer, selon deux axes : la dette est-elle délibérée ou involontaire, prudente ou imprudente ? « On livre ainsi et on reprendra quand on saura » est délibéré et prudent. « On n'a pas le temps de faire des tests » est délibéré et imprudent. « Maintenant qu'on comprend le métier, on aurait découpé autrement » est involontaire et prudent, et c'est inévitable : c'est précisément ce qu'un MVP sert à découvrir.

Dette acceptable, dette toxique : le tableau

CritèreDette acceptableDette toxique
OrigineChoix conscient, discuté avec le clientDécouverte par hasard, personne ne l'a décidée
TraçabilitéNotée dans le registre, avec un déclencheurConnue d'une seule personne, ou de personne
PérimètreIsolée dans un module, une page, un scriptDiffuse, contamine chaque nouvelle fonctionnalité
RéversibilitéSe corrige en quelques jours sans migrationExige une migration de données ou une refonte
Zone touchéeBack-office, écrans secondaires, outillage interneAuth, paiements, modèle de données, sauvegardes, sécurité
ExemplesAdmin brut, code dupliqué deux fois, pas de cache, tests absents sur une page vitrineMots de passe maison, montants en flottants, pas de restauration testée, secrets dans le dépôt

Les cinq raccourcis que je ne prends jamais

Ma liste est courte, et elle ne bouge pas, quels que soient le budget et la date de lancement. Ce qui réunit ces cinq zones : une erreur y coûte bien plus cher à corriger après coup qu'à éviter dès le départ, et elle peut coûter la confiance des utilisateurs.

  • L'authentification. Je ne code pas de gestion de mots de passe ou de sessions maison sur un MVP : j'utilise un service éprouvé. Une faille d'auth ne se corrige pas, elle se déclare. Les options sont comparées dans Clerk ou Supabase Auth.
  • Les paiements. Montants en entiers (centimes), webhooks idempotents, état de l'abonnement lu depuis le prestataire de paiement et pas deviné. Une erreur ici, c'est de l'argent encaissé deux fois ou pas du tout, et des clients qui s'en aperçoivent avant vous.
  • Le modèle de données. Le code se refactorise, les données s'accumulent. Un identifiant mal pensé, une relation absente, un champ fourre-tout deviennent une migration risquée dès qu'il y a de vrais clients. J'y passe le temps qu'il faut, même sur un MVP de quelques semaines.
  • Les sauvegardes. Automatiques, et surtout restaurées au moins une fois pour vérifier qu'elles marchent. Une sauvegarde jamais restaurée n'est qu'une hypothèse.
  • La sécurité de base. Secrets hors du dépôt, contrôle d'accès vérifié côté serveur sur chaque route, dépendances à jour, données personnelles traitées comme telles. Ce n'est pas un chantier de fin de projet, c'est une hygiène.

Tout le reste peut attendre : un back-office en tableau brut, une page d'admin laide, une absence de cache, un peu de duplication, une couverture de tests partielle sur du code isolé. J'explique où je place les tests sur un MVP dans tests unitaires pendant un MVP.

Tenir un registre de dette

Une dette non notée est une dette qu'on oubliera jusqu'au jour où elle bloquera une fonctionnalité urgente. Je tiens donc un registre, simple, versionné avec le code ou dans l'outil de tickets du client. Chaque entrée répond aux mêmes questions :

ChampExemple
idDETTE-007
quoiExport CSV généré en mémoire, sans pagination
pourquoiDémo client vendredi, volumes faibles aujourd'hui
oùsrc/exports/csv.ts
intérêtsChaque nouvelle colonne demande de toucher trois fichiers
déclencheurPremier client avec un export qui dépasse quelques milliers de lignes
coût estiméUne journée
décidé parLe produit et la tech, en revue de sprint

Dans le code, le raccourci porte un commentaire qui renvoie au registre, par exemple // DETTE-007 : export non paginé, voir registre. Un simple TODO sans référence ne vaut rien : il ne dit ni pourquoi, ni quand. Le champ le plus important est le déclencheur : il transforme « on verra plus tard » en condition vérifiable. Ce registre fait d'ailleurs partie de ce que je transmets en fin de mission, avec le reste de la documentation de passation.

Les signaux qu'il est temps de rembourser

  • Un déclencheur noté dans le registre est atteint.
  • Les estimations gonflent sur des fonctionnalités qui paraissent simples, et l'explication commence par « à cause de la façon dont… ».
  • Les mêmes zones produisent des régressions sprint après sprint.
  • On redoute les mises en production, ou on les regroupe pour en faire moins.
  • Une seule personne ose toucher un module.
  • Le produit a trouvé ses utilisateurs : ce qui était provisoire est devenu permanent, et les raccourcis pris pour apprendre doivent maintenant tenir la charge.

Rembourser ou pas : la grille de décision

Pour chaque entrée du registre, je croise deux questions : est-ce que ce code va bouger bientôt, et est-ce qu'il touche une zone critique ?

SituationDécision
Zone critique (auth, paiement, données, sauvegardes, sécurité)Rembourser maintenant, avant toute nouvelle fonctionnalité
Code modifié souvent, intérêts visiblesRembourser au prochain sprint, dans la part réservée
Code modifié souvent, intérêts faiblesRembourser au passage, quand on touche ce code
Code stable, rarement touchéLaisser vivre, revoir le déclencheur
Fonctionnalité dont l'avenir est incertainNe rien faire : si elle disparaît, la dette disparaît avec

Cette dernière ligne compte : rembourser la dette d'une fonctionnalité que personne n'utilise est du temps perdu. Mieux vaut parfois supprimer la fonctionnalité.

Budgéter le remboursement : une part de chaque sprint

Le « sprint de nettoyage » trimestriel ne marche pas : il est toujours repoussé par une urgence commerciale. Ce que je fais à la place, c'est réserver une part fixe de chaque sprint au remboursement, convenue dès le cadrage avec le client. Je ne vous donnerai pas de pourcentage magique : c'est une position, pas une statistique. Elle est plus faible juste avant un lancement, plus forte quand le produit a trouvé ses utilisateurs et que les raccourcis commencent à coûter.

Comme le périmètre et le budget sont fixés avant de commencer, cette part est visible dans le chiffrage au lieu d'apparaître comme une surprise. Et elle se voit en démo : chaque semaine, je montre ce qui a été livré, ce qui a été emprunté, et ce qui a été remboursé.

Fondateur non technique : voir la dette arriver

Vous n'avez pas besoin de lire le code pour suivre la dette. Trois réflexes suffisent :

  • Demandez le registre. S'il n'existe pas, la dette existe quand même, simplement personne ne la suit.
  • Posez la question à chaque démo : « qu'est-ce qu'on a emprunté cette semaine, et quand le rembourse-t-on ? » Une réponse claire est bon signe ; « rien » ne l'est presque jamais.
  • Suivez la vitesse dans le temps. Si des demandes comparables prennent de plus en plus longtemps, les intérêts s'accumulent.

Exigez aussi que le code et l'infrastructure soient sur vos propres comptes : c'est la condition pour qu'un autre développeur puisse un jour auditer la dette. J'ai réuni les autres réflexes dans piloter un prestataire tech sans être technique.

Refactoriser ou réécrire

La tentation de tout réécrire arrive presque toujours au moment où la dette devient visible. Je la déconseille dans la grande majorité des cas. Une réécriture gèle les évolutions pendant des mois, et l'ancien code contient des règles métier que personne n'a documentées : on les redécouvre une par une, en production.

Je préfère refactoriser par morceaux, en gardant le produit en ligne : isoler un module, le couvrir de tests, le remplacer, passer au suivant. Une architecture en monolithe modulaire rend ce travail beaucoup plus simple. Je n'envisage une réécriture que dans deux cas : la technologie n'est plus maintenue, ou le modèle de données ne correspond plus du tout au métier. Même alors, je commence par un audit, selon la méthode décrite dans auditer un code avant de reprendre un projet.

Une dette choisie, notée et remboursée régulièrement est un levier. Une dette oubliée devient une hypothèque sur toutes vos fonctionnalités futures.

Faisons le point sur votre dette

Vous lancez un MVP, ou le vôtre ralentit sans que vous sachiez pourquoi ? En un appel de 30 minutes, on peut repérer les zones critiques et décider de ce qui peut attendre. Réservez un créneau, vous repartirez avec une première version de votre registre de dette.

Questions fréquentes

Qu'est-ce que la dette technique dans un MVP ?

C'est l'écart entre le code livré et le code qu'on écrirait avec plus de temps ou plus de recul. Dans un MVP, une partie de cet écart est voulue : on accepte un raccourci pour apprendre plus vite du marché. Le problème n'est pas la dette elle-même, c'est la dette qu'on n'a pas choisie ou pas notée.

Quels raccourcis ne faut-il jamais prendre sur un MVP ?

L'authentification, les paiements, le modèle de données, les sauvegardes et la sécurité. Ce sont les zones où une erreur ne se corrige pas par un simple refactoring : elle se paie en données perdues, en fuite, en argent mal encaissé ou en migration lourde. Partout ailleurs, un raccourci assumé et noté est acceptable.

Combien de temps consacrer au remboursement de la dette technique ?

Je réserve une part fixe de chaque sprint, décidée à l'avance avec le client, plutôt que d'attendre un grand chantier de nettoyage. Le bon niveau dépend du produit et de la phase : c'est une position à tenir et à ajuster, pas un chiffre universel. L'essentiel est que ce temps existe à chaque sprint et ne soit pas le premier sacrifié.

Faut-il réécrire un MVP ou le refactoriser ?

Dans la grande majorité des cas, refactoriser par morceaux, en gardant le produit en production. Une réécriture complète gèle les évolutions, reproduit souvent les mêmes erreurs et sous-estime tout ce que l'ancien code gère sans qu'on le sache. Je ne l'envisage que si la technologie est abandonnée ou si le modèle de données ne correspond plus du tout au métier.

Comment un fondateur non technique peut-il repérer la dette technique ?

Par ses effets : les estimations qui gonflent sur des fonctionnalités simples, les régressions qui reviennent, les mises en production qu'on redoute, une seule personne capable de toucher certaines parties. Il peut aussi demander à voir le registre de dette et poser la question à chaque démo : qu'a-t-on emprunté cette semaine ?

Un produit à lancer, reprendre ou faire évoluer ?

Décrivez votre besoin en quelques lignes : je vous réponds sous 24 h ouvrées. Vous préférez un appel ? Il est gratuit et sans engagement.

Vous préférez en parler de vive voix ?

Réserver un appel gratuit30 minutes · Sans engagement

Champs obligatoires. Le reste est facultatif.

Quelques lignes suffisent : pour qui, ce que l'outil doit permettre, et ce qui existe déjà.

Précisions facultatives

Réponse sous 24 h ouvrées. Vos informations servent uniquement à vous répondre (confidentialité).