Le Dossier d'Architecture Technique (DAT), c'est un peu le mammouth de l'IT :
Un gros document unique volumineux, poussiéreux dont on ne sait plus trop que faire, mais "il faut un DAT à jour pour faire la MEP".

Rajoutons que maintenant, avec l'agilité/le devops ("délivrer souvent"), l'Infra-as-Code, l'automatisation, la scalabilité et le finops, la plateforme évolue plus vite que sa documentation.

En plus, l'ancien archi sur le projet est parti sans laisser le fichier visio qu'il a utilisé pour le schéma d'archi alors on peut plus le mettre à jour.
De toute façon, j'ai pas de license Visio

Avec tout ça, la petite motivation de le mettre à jour s'écrase face à la montagne de dette à reprendre. Du coup, on l'abandonne avec son confrère le DEX (dossier d'exploitation) dans un coin de notre GED.

Moi, on m'a parlé de DAT ? DAG ? DAS ? DAF ? DAC ? DEX…

Dossier d'architecture…

• Technique (DAT) : vue infrastructure, système et réseau
• Générale (DAG) : vue entreprise, souvent avec cadre TOGAF
• Applicatif / Logiciel (DAL)
• Sécurité (DAS)
• Data (DAD) : commence à apparaitre
• Cloud (DAC)
• Dossier d'exploitation (DEX)

Un dossier d'architecture est un document qui porte les références pour la conception, le développement, le déploiement et la maintenance d'une solution informatique.
Le DAT (technique) et le DAG (Générale) sont les plus connus et employés.
Les autres sont des dossiers spécialisés sur un point d'architecture spécifique.

Note: je parle du DAT mais l'article s'applique globalement sur tous les types de dossier d'architecture qui tombent assez vite dans les mêmes travers.

Les problématiques du DAT

• 1 Document unique
• Document dense et indigeste
• Difficulté de mise à jour
• Manque de clarté sur les rôles et responsabilités
• Inutilité perçue face à l'automatisation croissante

La Promesse de cette série d'articles

Et si on pouvait dépoussiérer le DAT et le transformer en un outil plus collaboratif, plus simple et qui prouverait son intérêt ?

Est-ce qu'on pourrait trouver plusieurs solutions actuelles pour faciliter la rédaction et la maintenance ?

Dans cette série d'articles, on va aborder :

• Les erreurs les plus communes du DAT
• Diataxis
• Les ADR, Architecture Decision Record Et voir si on a répondu à cette fameuse promesse.