L’essentiel à retenir
- La catégorie dépend du contexte d’usage, pas de la forme seule.
- Deliverable ⊃ artifacts ⊃ views sur des building blocks.
- Un artifact n’est un deliverable que si le contrat le prévoit.
- Les artifacts forment le contenu du Repository.
- Un deliverable clôturé est archivé ou réutilisé via le Repository.
- Architecture Definition Document
- Décrit l’architecture : par exemple, les applications et leurs relations. Il contient des artifacts comme un diagramme.
- Architecture Requirements Specification
- Précise les conditions vérifiables : par exemple, le service doit répondre en moins de deux secondes dans les conditions convenues.
- Architecture Roadmap
- Place les work packages et les transitions dans le temps pour atteindre la cible.
Exemple pédagogique : les noms, mesures et choix dépendent du contexte. Un artifact décrit un aspect ; un deliverable formalise un résultat soumis à revue et approbation.
Trois catégories définies par l’usage
Le Content Framework classe un produit de travail selon le rôle qu’il joue. Un deliverable est spécifié dans un contrat, puis revu, approuvé et signé par les stakeholders. Un artifact décrit un aspect précis de l’architecture. Un building block est un composant potentiellement réutilisable qui, combiné à d’autres, permet de livrer architectures et solutions.
Le même objet peut donc changer de catégorie selon le contexte : une matrice reste un artifact, mais elle devient aussi un deliverable si le contrat la mentionne explicitement.
- Deliverable : engagement contractuel, approuvé formellement
- Artifact : catalog, matrix ou diagram décrivant un aspect
- Building block : élément réutilisable décrit par les artifacts
La chaîne d’emboîtement
Prenons un Architecture Definition Document : c’est un deliverable qui documente une Architecture Description. Il contient des artifacts complémentaires, par exemple un diagramme de flux du processus cible de traitement des appels. Ce processus est un building block ; le même diagramme montre aussi un autre building block, l’acteur « conseiller du service client ».
Un artifact peut ainsi décrire plusieurs building blocks, et un deliverable contient en général plusieurs artifacts. Les artifacts constituent le contenu de l’Architecture Repository.
Que deviennent les produits après le projet
Les deliverables représentent la sortie des projets. À la clôture, ceux qui prennent la forme de documents sont soit archivés, soit versés dans l’Architecture Repository comme reference model, comme standard ou comme photographie de l’Architecture Landscape à un instant donné.
Les building blocks, eux, gagnent en détail au fil du travail : un simple nom au départ, puis une décomposition en blocs de support accompagnée d’une spécification complète. Ils se déclinent en Architecture Building Blocks et Solution Building Blocks.
- Archivage du deliverable documentaire
- Ou transition vers le Repository : reference model, standard, instantané du Landscape
Pièges fréquents
Trois confusions reviennent souvent. La première consiste à croire qu’un deliverable est forcément un gros document : c’est son statut contractuel et son approbation qui comptent. La deuxième assimile artifact et building block ; or l’artifact décrit, tandis que le building block est l’élément décrit. La troisième oublie que la classification catalog, matrix, diagram concerne les artifacts et non les deliverables.
Pour trancher, posez-vous trois questions : le produit est-il exigé et signé par contrat ? Décrit-il un aspect de l’architecture ? Représente-t-il une chose réutilisable que les experts du domaine reconnaissent ?
LES MOTS À CONNAÎTRE
Le vocabulaire, avec du sens.
- Deliverable
- Produit de travail spécifié par contrat, revu, approuvé et signé par les stakeholders.
- Artifact
- Produit décrivant un aspect de l’architecture, sous forme de catalog, matrix ou diagram.
- Building block
- Composant potentiellement réutilisable, combinable avec d’autres pour livrer architectures et solutions.
- Architecture Description
- Ensemble de views et de modèles qui documentent une architecture ; l’ADD en est le support.