Artefacto: Descripción de la arquitectura

Descripción principal

La descripción de la arquitectura brinda contexto y orientación a los desarrolladores para construir el sistema. Es un artefacto crítico utilizado para ayudar a capturar y tomar decisiones arquitectónicas, y comunicar estas decisiones a los desarrolladores. Puede contener cualquier información y referencias que sean apropiadas para comunicar a los desarrolladores cómo deben construir el sistema (en alto nivel). Generalmente no contiene información de diseño detallado, aunque es probable que haga referencia a elementos de diseño que sean relevantes para la arquitectura.

Como mínimo, este producto de trabajo debe:

Listar las guías, las decisiones y restricciones que los desarrolladores deben seguir para construir el sistema
Justificar esas pautas, decisiones y limitaciones
Describir los mecanismos y patrones arquitectónicos y dónde deben aplicarse.

Los miembros del equipo que no estuvieron involucrados en esas decisiones arquitectónicas deben comprender el razonamiento que hay detrás del contexto de la arquitectura para poder abordar mejor las necesidades del sistema. Otro contenido recomendado para este producto de trabajo es:

Referencias a la especificación de los requerimientos relevantes a la arquitectura.
Referencias a elementos de diseño arquitectónicamente relevantes.
Instrucciones de empaquetado para subsistemas y componentes.
Capas y subsistemas críticos.
Interfaces críticas del sistema.
Abstracciones clave.
Escenarios de negocio claves que describen el comportamiento crítico del sistema.

Los arquitectos de sistemas deben usar este artefacto para colaborar con otros miembros del equipo en el desarrollo de la arquitectura para ayudar la comprensión de las motivaciones detrás de las decisiones arquitectónicas, para que puedan implementarse adecuadamente por el equipo de dearrollo. Por ejemplo, se pueden definir restricciones sobre cómo se empaquetan y comunican las diferentes partes del sistema. Esto puede parecer un trabajo innecesario, pero la justificación en el la descripción de la arquitectura puede explicar que existe un cuello de botella de rendimiento significativo cuando se comunica con un sistema heredado y justificar el por qué de esas restricciones de empaquetado y comunicación. El resto del sistema debe adaptarse a este cuello de botella siguiendo un esquema de empaquetamiento específico.

Este producto de trabajo debe informar al gerente de proyecto y a otros miembros del equipo cómo se divide o organiza el sistema. También da una idea en alto nivel del sistema y sus motivaciones técnicas para aquellos que se encarguen de mantener y evolucionar el sistema en el futuro.