Aller au contenu

Architecture

Audit de dette technique : la grille de scoring en 8 axes

Par , fondateur de SIMGSOFT ·Publié le 1 septembre 2026 · Mis à jour le 18 octobre 2026 · 11 min de lecture

Réponse courte

Un audit de dette technique utile score huit axes de 0 à 5 : couverture de tests, temps de build, complexité, dépendances obsolètes, sécurité, observabilité, documentation et bus factor. Chaque axe reçoit une métrique mesurable, pas une opinion. Le livrable chiffre l'intérêt annuel de la dette en jours-homme perdus.

Le format d'audit

Axes évalués
8
Durée d'audit
8–12 j
Budget
8–18 k€
Fréquence
18–24 mois

« On a beaucoup de dette technique » est une phrase inutilisable pour décider. Combien ? Où ? Ça coûte quoi par an ? Ce guide donne la grille que nous utilisons pour transformer une intuition partagée en chiffres qu'un comité de direction peut arbitrer.

Ce qu'est vraiment la dette technique

La dette technique est l'écart entre le coût actuel d'un changement et le coût qu'il aurait dans une base saine. Ce n'est ni de la laideur, ni de l'ancienneté : c'est un surcoût récurrent, mesurable en jours-homme.

Cette définition a une conséquence directe : du mauvais code jamais modifié ne produit aucune dette. Seule compte la dette située sur le chemin de ce que vous allez construire dans les douze prochains mois.

La grille en huit axes

Chaque axe est noté de 0 (critique) à 5 (excellent) sur une métrique mesurable.

AxeMétriqueScore 5Score 0
1. Couverture de tests% de lignes couvertes sur les modules critiques> 80 %< 10 %
2. Vitesse de livraisonDélai médian commit → production< 1 h> 30 j
3. Complexité% de fonctions à complexité cyclomatique > 15< 2 %> 20 %
4. DépendancesNb de dépendances avec CVE connue ou hors support0> 25
5. SécuritéFindings critiques et élevés d'une analyse SAST0> 10 critiques
6. Observabilité% d'incidents diagnostiqués sans accès à la production> 90 %< 20 %
7. DocumentationDélai d'autonomie d'un nouvel arrivant< 3 j> 30 j
8. Bus factorNb de modules critiques avec 1 seul contributeur0> 5

Lecture du score global

  • 32 à 40 — base saine. Continuez, mesurez trimestriellement.
  • 24 à 31 — dette maîtrisée. Traitez les deux axes les plus faibles.
  • 16 à 23 — dette coûteuse. Réservez 20 % de la capacité de l'équipe à la remédiation.
  • 8 à 15 — dette bloquante. Toute nouvelle fonctionnalité coûte deux à trois fois son prix nominal.
  • 0 à 7 — évaluez sérieusement une migration progressive plutôt que la réparation.

Cas réels : ce que la grille ne voit pas seule

Cas réel · simgsoft.com

Cinq outils qui ne faisaient rien en production

Les cinq outils de ce site restaient inertes en ligne. Leur script était écrit dans la page, et la politique de sécurité de production (script-src 'self') bloque tout script en ligne. Le serveur de développement n'envoie pas cette politique : aucun test local ne pouvait échouer. Le navigateur, lui, l'écrivait en toutes lettres :

Executing inline script violates the following Content Security Policy
directive 'script-src 'self''. [...] The action has been blocked.

Correctif : scripts externalisés, et serveur de test local qui renvoie la même politique que la production. Aucun des huit axes ne capte ce défaut à lui seul : c'est l'écart entre l'environnement de test et la production qui l'a caché.

Constaté et corrigé en octobre 2026 · console du navigateur ; version d'origine rejouée avec la politique de sécurité de production

Projet de l'éditeur, anonymisé

Un outil « infecté » qui ne l'était pas

Un outil interne de gestion clients, en PHP, était soupçonné d'infection. L'analyse de 4 053 fichiers PHP et de la base n'a trouvé aucun code malveillant. Le défaut était de configuration : le formulaire d'inscription publique restait ouvert sans protection contre les robots, et aucun des trois verrous prévus dans le code n'était activé. 7 575 fiches clients sur 7 587 et 8 140 comptes sur 8 141 avaient été créés par des robots.

Le script de purge préserve tout client rattaché à une facture, une commande, un projet, un devis ou un contrat. Pour l'axe sécurité, la leçon est nette : une analyse de code n'aurait rien signalé, parce que le code n'était pas en cause.

Août 2026 · dossier d'intervention sur l'outil de gestion clients interne de l'agence

Calculer l'intérêt annuel de la dette

C'est le chiffre qui rend l'audit actionnable en comité de direction. Il additionne le temps perdu, pas le temps qu'il faudrait pour tout corriger.

Intérêt annuel (jours-homme) =
    temps perdu en tests manuels de non-régression
  + temps perdu en reprise d'incidents évitables
  + surcoût moyen par évolution × nombre d'évolutions par an
  + temps d'attente sur les déploiements
  + temps d'onboarding excédentaire des nouveaux arrivants

Exemple illustratif pour une équipe de 5 développeurs et une application de 8 ans :

SourceCalculJours / an
Recette manuelle2 j × 24 livraisons48
Incidents évitables3 j/mois × 1236
Surcoût par évolution+1,5 j × 40 évolutions60
Attente déploiement0,5 j × 2412
Onboarding excédentaire15 j × 2 arrivées30
Total186 j/an

186 jours-homme par an, soit environ 0,75 équivalent temps plein sur une équipe de cinq personnes, ou près de 120 000 € au coût complet. Face à ce chiffre, un plan de remédiation à 60 jours devient une décision évidente.

Le déroulé en dix jours

  1. J1–J2 — Collecte automatisée. Analyse statique, historique git, dépendances, journaux de production, métriques de pipeline.
  2. J3–J4 — Entretiens. Trois développeurs, un exploitant, un référent métier. Question centrale : « Qu'est-ce qui vous fait perdre le plus de temps ? »
  3. J5–J6 — Lecture ciblée du code. Les cinq modules les plus modifiés et les cinq plus complexes, pas la base entière.
  4. J7 — Reproduction. Installation from scratch en suivant la documentation existante, chronométrée.
  5. J8 — Scoring et calcul de l'intérêt annuel.
  6. J9 — Plan de remédiation chiffré et priorisé.
  7. J10 — Restitution avec l'équipe technique et la direction, dans la même salle.

Ce que contient le livrable

  • Le tableau de scoring des 8 axes, avec la valeur mesurée pour chaque métrique.
  • Le calcul détaillé de l'intérêt annuel, avec ses hypothèses explicites.
  • Une cartographie des zones à risque, par module.
  • Un plan de remédiation en trois vagues, chiffré en jours-homme, avec le gain attendu par action.
  • Les correctifs immédiats déjà appliqués pendant l'audit (mises à jour de sécurité triviales).
  • Le script de mesure automatisée, pour rejouer le scoring chaque trimestre sans nous.

Prioriser la remédiation

Classez chaque action sur deux axes : gain annuel en jours-homme etcoût de mise en œuvre. Traitez dans cet ordre :

  1. Gain élevé, coût faible — pipeline de tests, mises à jour de sécurité, alerting. Presque toujours rentabilisé en moins d'un trimestre.
  2. Gain élevé, coût élevé — découpage d'un module central, refonte du modèle de données. À planifier sur deux à trois trimestres.
  3. Gain faible, coût faible — à faire au fil de l'eau, jamais en chantier dédié.
  4. Gain faible, coût élevé — à ne pas faire, et à écrire noir sur blanc dans le livrable pour clore le débat.

Si le score global est inférieur à 8, l'option à étudier est décrite dansMigrer un monolithe sans big bang. Quand l'audit précède un rachat, ses questions changent : voyezce qu'un acquéreur doit vérifier. Et si le code vient d'un prestataire qui ne répond plus, commencez parreprendre un projet abandonné.

Sources

Textes et pages officielles consultés le 18 octobre 2026.

  1. Technical Debt

    Martin Fowler, martinfowler.com

    La dette se paie en effort supplémentaire à chaque modification ; le code médiocre mais stable peut être laissé en l'état.

  2. DORA's software delivery performance metrics

    DORA

    Définition du délai de changement : temps entre le commit et le déploiement en production.

  3. Source Code Analysis Tools

    OWASP

    Définition des outils SAST, qui analysent le code source ou compilé pour y détecter des failles de sécurité.

  4. CVE Program Overview

    CVE Program

    Le programme CVE identifie et catalogue les vulnérabilités publiquement divulguées.

Questions fréquentes

En remplaçant chaque jugement par une métrique : couverture de tests en pourcentage de lignes critiques, durée du pipeline en minutes, nombre de dépendances avec CVE connue, délai médian entre commit et production, nombre de fichiers modifiés par plus de 40 % des commits. Ces valeurs se mesurent sans débat et se comparent dans le temps.

Entre 8 000 € et 18 000 € pour un audit de 8 à 12 jours sur une application de taille moyenne, incluant l'analyse statique, les entretiens avec l'équipe, le scoring des 8 axes et un plan de remédiation chiffré. Au-delà de 20 jours, l'audit devient plus cher que les premières corrections qu'il recommande.

Non. Un bon audit sépare la dette qui coûte de la dette qui dort. Du code laid, stable, jamais modifié et couvert par des tests de bout en bout ne coûte rien : le laisser est la décision rationnelle. La dette à traiter est celle qui se trouve sur le chemin des évolutions prévues dans les douze mois.

C'est le nombre de personnes dont le départ simultané bloquerait le projet. Il se mesure par l'analyse des contributions git : si une seule personne a écrit plus de 60 % d'un module critique, le bus factor de ce module vaut 1. C'est le seul axe de dette qui ne se corrige pas par du code, mais par de la documentation et du pairing.

Un audit complet tous les 18 à 24 mois, avec un suivi trimestriel léger des mêmes métriques automatisées. L'intérêt de la grille est la comparaison : un score isolé ne dit pas grand-chose, une trajectoire sur quatre trimestres dit tout.

À lire ensuite

Besoin d'un avis sur votre cas ?

Décrivez votre contexte en trois lignes. On répond avec une estimation argumentée, pas un formulaire de qualification.

Poser la question →