Aller au contenu principal

ADR-012 — Architecture Foundation Frozen

Statut​

Accepted

Date​

2026-07-19

Contexte​

Depuis la création de DMV, une phase importante de conception architecturale a été menée.

Cette phase a permis de définir les fondations de la plateforme :

  • la vision produit ;
  • les principes architecturaux ;
  • l'organisation de la documentation ;
  • l'architecture globale de la plateforme ;
  • la distinction entre Applications, Engines, Platform Services et Infrastructure ;
  • les principes de gouvernance ;
  • les responsabilités des principaux composants.

Cette architecture a été construite avant la montée en charge afin de limiter les évolutions structurelles coûteuses à long terme.

Les principaux documents fondateurs sont désormais disponibles et cohérents entre eux.

Décision​

À compter de cette ADR, l'architecture fondatrice de DMV est considérée comme suffisamment mature pour entrer dans une phase d'exécution.

Les documents fondateurs deviennent la référence officielle de la plateforme.

Les évolutions futures devront respecter les principes décrits dans :

  • la Vision ;
  • The DMV Way ;
  • Platform Architecture ;
  • Architecture Governance ;
  • les ADR existantes.

Les décisions architecturales majeures continueront d'être documentées sous forme d'ADR.

Les développements seront désormais organisés sous forme de Work Packages.

Conséquences​

La priorité du projet évolue.

Nous passons d'une phase de conception à une phase de construction.

Cela implique notamment que :

  • les nouvelles fonctionnalités doivent s'appuyer sur l'architecture existante ;
  • les composants existants doivent être privilégiés avant d'en créer de nouveaux ;
  • les décisions importantes doivent être prises avant le développement lorsqu'elles modifient l'architecture ;
  • les Work Packages deviennent l'unité de développement privilégiée.

La documentation d'architecture continue d'évoluer, mais principalement par enrichissement des documents existants plutôt que par création de nouveaux documents fondateurs.

Principes​

À partir de cette décision :

  • la Vision reste le niveau le plus stable de la plateforme ;
  • l'architecture évolue de manière exceptionnelle ;
  • les ADR documentent les décisions structurantes ;
  • les Work Packages implémentent ces décisions ;
  • le code n'est jamais la source de vérité de l'architecture.

Ce que cette ADR ne signifie pas​

Cette décision ne fige pas DMV. Elle fige les fondations.

La plateforme continuera d'évoluer :

  • de nouveaux Engines pourront apparaître ;
  • de nouveaux Platform Services pourront être introduits ;
  • de nouvelles applications pourront être développées ;
  • les technologies pourront être remplacées.

En revanche, ces évolutions devront respecter les principes de gouvernance établis et préserver la cohérence globale de la plateforme.

Alternatives envisagées​

AlternativeRaison de non-priorisation
Continuer à enrichir l'architecture avant de développerLe niveau actuel de maturité est jugé suffisant pour commencer le développement tout en laissant la possibilité de faire évoluer ponctuellement l'architecture via le processus de gouvernance.
Geler totalement la documentationLa documentation reste vivante. Seuls les principes fondateurs deviennent particulièrement stables.

Risques​

Le principal risque serait de considérer cette ADR comme un blocage empêchant toute évolution. Ce n'est pas son objectif.

L'objectif est d'éviter les modifications structurelles non maîtrisées tout en conservant la capacité d'adaptation de la plateforme.

Liens associés​

  • docs/00-foundation/08-the-dmv-way.md
  • docs/06-architecture/26-platform-architecture.md
  • docs/06-architecture/27-architecture-governance.md
  • docs/00-governance/08-decision-process.md
  • docs/decisions/README.md