Audit

L'architecture se mesure.
Pas à l'intuition. Par les données.

HexaGlue audite automatiquement la conformité de votre architecture DDD et hexagonale. Un score objectif, des écarts localisés, une estimation de l'effort de correction. Le tout intégré à votre pipeline CI/CD.

Installer et configurer le plugin Dépendance Maven, goals, paramètres et options.
Documentation
Constat

L'architecture se dégrade en silence

L'architecture d'un projet ne casse pas d'un coup. Elle se dégrade commit après commit : un raccourci ici, une dépendance mal orientée là, un concept métier qui fuit dans l'infrastructure. Quand les symptômes deviennent visibles (tests fragiles, refactoring risqué, onboarding lent), la dette technique est déjà installée.

Sans mesure objective, l'état de l'architecture reste une impression. Chaque développeur a son opinion, chaque revue de code ses angles morts. Les décisions se prennent sans données.

L'audit HexaGlue remplace les impressions par des mesures. À chaque build, il analyse le code source et produit un diagnostic : un score, des écarts précis, et une estimation de l'effort nécessaire pour corriger. C'est un outil de pilotage autant qu'un outil de développement.

Un score, un grade, un statut. Un verdict clair et précis.
Verdict d'audit HexaGlue : score 13/100, grade F, statut Failed sur fond rouge
Score

Un diagnostic en 5 dimensions

Le score d'audit condense l'état de votre architecture en un chiffre de 0 à 100, décomposé en 5 dimensions. Chaque dimension répond à une question concrète sur la santé de votre projet.

Conformité DDD

Vos concepts métier sont-ils correctement modélisés ? Agrégats cohérents, value objects immuables, identités typées.

Architecture hexagonale

Les couches sont-elles bien isolées ? Ports définis comme interfaces, adapters indépendants, domaine protégé.

Dépendances

Les dépendances vont-elles dans le bon sens ? L'infrastructure dépend du domaine, jamais l'inverse.

Couplage

Vos composants sont-ils indépendants ? Un changement dans un module ne devrait pas en impacter dix autres.

Cohésion

Les concepts liés sont-ils regroupés ? Un agrégat et ses value objects doivent cohabiter, pas être dispersés.

Le score n'est pas une note scolaire : c'est un indicateur de tendance. Un projet legacy démarre typiquement entre 10 et 20/100. Un projet bien structuré atteint 60 à 80. L'objectif n'est pas 100 : c'est la progression régulière qui compte, visible build après build.

Où perdez-vous des points ?
Tableau KPI du rapport d'audit HexaGlue : 5 dimensions avec statuts On Target, At Risk et Below Target
La cible vs la réalité, en un coup d'oeil
Radar chart du rapport d'audit HexaGlue : superposition du seuil cible et du score actuel sur 5 axes
Violations

Chaque écart est localisé, expliqué, priorisé

L'audit ne se contente pas d'un score global. Il identifie chaque écart par rapport aux principes DDD et hexagonaux, regroupé par thème : la classe concernée, la règle enfreinte, l'impact sur l'architecture, et un correctif illustré par un exemple de code.

15 contraintes vérifiées

8 contraintes DDD (cycles entre agrégats, identité des entités, immuabilité des value objects, pureté du domaine...) et 7 contraintes hexagonales (direction des dépendances, isolation des couches, couverture des ports...). Le catalogue complet est dans la documentation.

4 niveaux de sévérité

Chaque violation est classée de BLOCKER (bloque le build, non négociable) à MINOR (suggestion d'amélioration). Les niveaux BLOCKER et CRITICAL sont configurables pour adapter la rigueur à la maturité de votre projet.

Chaque violation est accompagnée d'une explication, d'un correctif illustré par un exemple de code et d'un chiffrage de l'effort. L'ensemble crée un plan d'actions clair, précis et actionnable.

Un problème, une action claire
Violation CRITICAL dans un rapport d'audit HexaGlue : Mutable Value Object avec correctif proposé en record Java
Remédiation

Un plan d'action chiffré, pas une liste de souhaits

L'audit ne s'arrête pas au diagnostic. Il produit un plan de remédiation consolidé : chaque action est priorisée par sévérité, chiffrée en jours d'effort, et comparée entre correction manuelle et génération automatique par HexaGlue. L'équipe sait exactement quoi faire, dans quel ordre, et combien ça coûte.

L'estimation compare l'effort manuel et l'effort automatisable, chiffrés en jours et en euros. Par exemple, retirer les annotations JPA d'un domaine est un travail manuel, mais régénérer toute la couche persistance correspondante peut être automatisé par le plugin JPA d'HexaGlue. Le rapport affiche le coût de chaque approche et les économies réalisables.

Un plan de remédiation consolidé et chiffré
Bandeau estimation de remédiation HexaGlue : comparaison effort manuel vs automatisable avec coûts en EUR
Métriques

20 indicateurs pour piloter l'amélioration

Les violations montrent ce qui ne va pas. Les métriques montrent où en est votre architecture : 20 indicateurs quantitatifs, répartis en 6 catégories, mesurent la santé structurelle de votre projet build après build.
1

Domain-Driven Design

Couverture du domaine, pureté des types, ratio value objects, couverture événementielle, couplage entre agrégats

2

Design des agrégats

Taille moyenne, respect des frontières, cohésion interne, stabilité

3

Architecture hexagonale

Couverture des ports repository, indépendance des adapters

4

Qualité du code

Complexité cyclomatique, taux de code boilerplate dans le domaine

5

Modularité

Coût de propagation, cyclicité, profondeur des dépendances, fan-out, visibilité, index de maturité modulaire

6

Stabilité des packages

Couplage afférent et efférent, instabilité, abstraction, distance à la Main Sequence

Chaque métrique a un seuil d'alerte intégré. Quand sa valeur est dépassée, elle apparaît en rouge dans le rapport afin de guider les équipes dans l'amélioration continue de leur application.

20 métriques quantitatives pour objectiver la qualité architecturale
Tableau des 20 métriques d'audit HexaGlue : couplage, cohésion, complexité, couverture DDD, avec seuils et statuts
Rapport

Un rapport lisible par toute l'équipe

Le rapport d'audit est conçu pour être partagé : avec l'équipe de développement pour prioriser les corrections, avec le management pour suivre l'évolution de la dette technique. Il contient 5 sections, du verdict synthétique au plan de remédiation chiffré.
Vue d'ensemble d'un rapport d'audit HexaGlue : verdict, inventaire, violations, métriques et estimation de remédiation
  1. 1

    Verdict

    Score global, grade (A à F), statut pass/fail, décomposition KPI sur 5 dimensions avec radar de conformité

  2. 2

    Cartographie de l'architecture

    Inventaire des types par rôle (agrégats, entités, value objects, ports...) et 5 diagrammes générés automatiquement : C4 System Context, C4 Component, modèle du domaine, couche des ports, vue d'ensemble

  3. 3

    Violations détectées

    Écarts groupés par thème (DDD, Ports & Adapters...), avec localisation, impact, sévérité et exemples de code pour le correctif

  4. 4

    Plan de remédiation

    Actions priorisées avec estimation chiffrée : effort manuel en jours, effort automatisable par HexaGlue, comparaison en euros et économies réalisées

  5. 5

    Annexe technique

    20 métriques de santé architecturale (DDD, hexagonal, qualité, modularité...) et stabilité des packages (couplage, instabilité, distance à la Main Sequence)

Votre architecture a besoin d'un diagnostic objectif.
Lancez votre premier audit.

L'étude de cas e-commerce montre l'audit en action : du diagnostic initial à l'architecture cible.

Interpréter un rapport d'audit Configurer l'audit