0.7 Documentação da arquitetura

Após entendermos os conceitos e a importância e termos noções de design dearquitetura de software, precisamos saber como capturar a informação do projeto e documentá-lo.Para isso, introduzimos os conceitos de visões e de pontos de vista arquiteturais, que facilitama documentação por mostrar diferentes dimensões que uma arquitetura apresenta. Este capítulonão dita uma única linguagem ou modelo de documentação de arquitetura, mas apresenta exemplos de comofazê-lo.

Este capítulo tem como objetivo fazer com que o leitor seja capaz de entenderque:

• O documento de arquitetura auxilia no processo de design, é uma ferramentade comunicação entre stakeholders e pode servir de modelo de análise do software;
• Toda informação presente numa arquitetura é uma decisão arquitetural;
• Decisões arquiteturais podem ser existenciais, descritivas ou executivas;
• Decisões arquiteturais se relacionam, podendo restringir, impedir, facilitar,compor, conflitar, ignorar, depender ou ser alternativa a outras decisões arquiteturais;e
• Um único diagrama não é suficiente para conter a quantidade de informaçãoque deve ser mostrada por um arquiteto. Por isso, a necessidade de múltiplas visõesarquiteturais;

Arquitetura e documento da arquitetura

A arquitetura de um software existe independente dela ser projetadaou documentada. No entanto, ao deixarmos a arquitetura simplesmente “emergir” apartir do software, ou seja, evoluir ao longo do processo de desenvolvimento semprojeto ou documentação, corremos o risco de não tirar proveito dos benefícios queela proporciona.

Por outro lado, apenas realizar o design arquitetural e não documentá-lo(ou documentá-lo de forma precária), pode minimizar as vantagens a serem obtidaspela arquitetura. Isto pode ocorrer porque documentar a arquitetura, além de auxiliaro próprio processo de design, também proporciona:

• uma ferramenta de comunicação entre os stakeholders;
• a integridade conceitual ao sistema e ao processo de desenvolvimento;
• um modelo para análise antecipada do sistema; e
• uma ferramenta de rastreabilidade entre os requisitos e os elementosdo sistema.

Auxílio ao processo de design

Apesar de dividirmos conceitualmente o processo de designdo processo de documentação, é comum que ambos aconteçam em paralelo naprática. Quando isto ocorre, a documentação ajuda no design, principalmente nosentido de separação de preocupações.

Ao documentarmos visões arquiteturais diferentes separadamente,preocupamo-nos separadamente com o design de diferentes aspectos do software.Entre os diversos aspectos de um software, podemos citar os aspectos funcionais,de dados, de concorrência, de desenvolvimento, de implantação e operacionais. Estaseparação se torna benéfica porque há diferentes linguagens, que podemser gráficas ou textuais, que melhor se encaixam à descrição de cada aspecto,ajudando não só numa melhor representação, como também numa melhor modelagem eavaliação em relação aos objetivos.