Au cours de ma carrière de 10 ans dans l’architecture informatique, j’ai rédigé plus d’une centaine de documents d’architecture dans différents contextes clients. Je sais à quel point cette partie documentaire est parfois mal perçue et qu’elle peut être un vrai point de douleur pour les projets. En effet, produire de la documentation est fastidieux, nécessite certaines compétences, demande de la mise à jour régulière, etc. J’ai donc décidé d’initier une série d’articles pour démystifier ce sujet avec l’intention de le rendre plus simple à appréhender.

Si je devais expliquer ce qu’est un DAT (Document d’Architecture Technique) à une personne non initiée, j’utiliserais une analogie avec les plans utilisés dans la construction d’un édifice. Imagineriez-vous construire une maison sans plans ?

Dans les standards, la construction d’une maison nécessite a minima :

• Un plan de situation pour déterminer la place de la maison sur le terrain
• Un plan d’aménagement pour indiquer les voies d’accès
• Un plan de façade pour décrire l’architecture
• Un plan de coupe qui détaille l’intérieur
• Un plan de masse qui décrit l'insertion électrique

Pourquoi a-t-on besoin de plans ? Tout simplement parce qu’ils jouent le rôle de supports de référence :

• Dans le cadre de la construction, cela est utile pour tous les corps de métiers intervenant afin d’arriver au résultat attendu, à savoir une maison fonctionnelle où la salle de bain n’est pas à la place de la cuisine et où la porte d’entrée n’est pas au premier étage.
• Ensuite, imaginez que vous vouliez modifier quelque chose dans votre structure à l’avenir. Il faut pour cela que vous sachiez exactement comment cette dernière est faite, cela dans le but de réaliser quelque chose dont vous maîtrisez les éventuels effets de bord. Il ne faudrait pas aller creuser dans un endroit où sont enterrées des conduites de gaz par exemple.

Considérez alors le DAT comme les plans d’une application ou d’un service d’infrastructure !

Dans les standards d'architecture, le DAT est constitué d’un corpus documentaire qui décrit une application ou un service d’infrastructure. Il y a 2 catégories d’information :

• Les informations d’ordre fonctionnel, qui visent à décrire le fonctionnement d’une application, et ainsi traduire le service rendu.
• Les informations d’ordre technique, qui vont décrire le socle d'infrastructure sur lequel repose ladite application.

En règle générale, le DAT est composé comme suit :

• Un schéma applicatif qui constitue la colonne vertébrale du DAT. Ce schéma vise à synthétiser le fonctionnement de l’application en faisant apparaître les informations suivantes : modules applicatifs, utilisateurs, zones réseaux et flux applicatifs. On y voit également les interactions avec les autres applications et services d’infrastructure du SI. Ce schéma se veut très visuel afin d’en faciliter la lecture et de comprendre en un coup d'œil la structure et le fonctionnement de l’application.

Voici ci-dessous un exemple de schéma applicatif d’une application que nous appellerons Zebra :

Comment se lit ce schéma ? Les utilisateurs sur internet se connectent à l’application Zebra située dans la zone réseau “Cloud Service” via son front-end. L’application Zebra est composée d’un front-end, d’un back-end et d’une base de données. Le front-end de Zebra utilise ce service de mail, ce dernier étant situé dans la zone réseau “Internal Infrastructure.”

• Une cartographie des flux qui reprend les flux décrits dans le schéma applicatif en y ajoutant d’autres informations techniques telles que les ports, la méthode d’authentification, le niveau de confidentialité, etc.
• Un tableau des matériels qui inventorie toute l’infrastructure sur laquelle l’application ou le service repose. Pour chaque machine, on renseignera les caractéristiques techniques (gabarit, stockage, sauvegarde, etc.) ainsi que les produits installés (OS, logiciels, etc.).
• Un schéma technique qui illustre visuellement l’inventaire matériel en plaçant chaque machine dans son datacenter et sa zone réseau.
• Un document de synthèse donnant une description générale de l’application ou du service. Il permet également d’historiser les justifications sur les choix techniques réalisés dans le cycle de vie de l’application.

De mon expérience, en appliquant ce découpage (ou en l’adaptant si besoin), vous assurez que votre documentation sera structurée et contiendra bien tous les niveaux d’information qui vous seront utiles à vous, mais aussi aux autres équipes de la DSI voire aux métiers.

N’oubliez pas que le DAT, en plus d’être un document technique, est également un support de communication !

Dans le prochain article, nous verrons comment garantir un DAT de qualité.

PS : Nous avons créé l'outil Uncia pour apporter une réponse simple à tous ces écueils. Allez visiter notre page et faites-nous signe pour plus d'information !