Artefato: Architecture Notebook
O artefato Descrição Arquitetural descreve a planta para o desenvolvimento do software. Ele contém o raciocínio, suposições, explicações e implicações das decisões que foram feitas na consolidação da arquitetura.
Domínio: Arquitetura
Tipos de Produto de Trabalho: Especificação
Objetivo

Descrever a parte essencial do design do sistema para garantir a integridade e inteligibilidade do sistema.

Relacionamentos
Descrição
Descrição Principal

Este artefato é veículo de comunicação que dia aos desenvolvedores que partes do sistema construir, bem como de que forma esta partes se comportam e interagem entre si. Determina a estrutura do projeto de modo que gerentes possam planejar o projeto. Também fornece a quem irá manter e modificar a arquitetura posteriormente a primeira visão elementar do sistema; e um entendimento da motivação por traz das decisões técnicas importantes.

Este artefato foca em aspectos específicos do design, concentrando-se em estrutura, elementos essenciais, cenários chaves e aspectos que possuem impacto duradouro nas qualidades do sistema como performance, confiabilidade, adaptabilidade e custo. Define o conjunto de mecanismos, padrões e estilos que irão guiar o restante do design, assegurando a sua integridade.

Elementos arquiteturais ajudam na construção de excelentes unidades de implementação, teste unitários, integração, gerência de configuração e documentação. A organização da arquitetura pode também ajudar o Gerente de Projeto decidir na organização do time.

Ilustrações
Gabaritos
Adaptação
Opções de Representação

A arquitetura pode ser representada em diferentes formas e de vários pontos de vista, dependendo das necessidades do projeto e das preferências do time do projeto. A arquitetura pode ser descrita como uma simples metáfora ou como uma comparação com um ou um conjunto de estilos arquiteturais pré-definidos. Pode ser um conjunto de modelos ou documentos específico que descreve os vários aspectos dos elementos chave do sistema. Expressá-la como um skeletal build é outra opção - embora este build talvez precise ser colocado sobre baseline e preservado para assegurar que a essência do sistema possa ser entendida na medida que o sistema cresce.

Freqüentemente um artefato de design precisa ser representado de uma maneira legível e acessível. Ele pode referenciar modelos que descrevem Visões Arquiteturais para comunicar a arquitetura. Uma visão é a representação de um sistema da perspectiva de um conjunto de preocupações relacionadas. Para escolher o conjunto apropriado de visões, identifique os Stakeholders que dependem da documentação arquitetural e a informação de que eles precisam.

Não precisa ser um documento formal. A essência da arquitetura pode frequentemente ser comunicada através de series simples de diagramas em uma whiteboard; ou como uma lista de decisões. Escolha o meio-termo que melhor se encaixa nas necessidades do projeto.

Informações Adicionais