L’essentiel à retenir
- Statement : travail autorisé et engagements.
- Definition Document : architecture décrite et justifiée.
- Requirements Specification : conditions vérifiables de réalisation.
- 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.
Définir le travail et son résultat
Le Statement of Architecture Work formalise le travail à conduire : contexte, périmètre, approche, rôles, livrables, critères d’acceptation, plan et modalités d’approbation. Il permet aux parties concernées de s’accorder sur des engagements. Il ne constitue pas une liste détaillée de tous les choix de réalisation.
L’Architecture Definition Document décrit l’intention et les états de l’architecture. Il rassemble les vues pertinentes sur les domaines, les architectures baseline, target ou transition, la justification des choix et les écarts. Son rôle est principalement descriptif et qualitatif : il rend compréhensible l’organisation recherchée et les changements nécessaires.
Exprimer des exigences vérifiables
L’Architecture Requirements Specification précise les conditions à satisfaire par la réalisation. Elle peut inclure standards, contraintes, exigences d’interopérabilité, niveaux de service et conditions opérationnelles. Le contraste qualitatif/quantitatif explique leur fonction dominante ; ce n’est pas une interdiction de mettre des mesures dans un document de définition. Une exigence doit être nécessaire, non ambiguë et vérifiable par un test ou une mesure.
- Définir des critères d’acceptation explicites.
- Relier chaque exigence à un besoin et à une description.
- Distinguer engagement du travail et contraintes de la réalisation.
LES MOTS À CONNAÎTRE
Le vocabulaire, avec du sens.
- Requirement
- Condition nécessaire et vérifiable que la solution doit satisfaire.
- Architecture Definition Document
- Description cohérente des architectures et de leurs justifications.