Este artefato fornece o contexto e a orientação para que os desenvolvedores construam o sistema. É um artefato crítico,
usado para ajudar a registrar e tomar as decisões arquiteturais, e explicar essas decisões para os desenvolvedores. Ele
pode conter qualquer informação e referência que seja apropriada para a comunicação de como os desenvolvedores devem
construir o sistema. Ele normalmente não contém informações de design, embora pareça referenciar elementos de design
arquiteturalmente significantes.
No mínimo, esse artefato deverá:
-
Listar as orientações, decisões e as restrições que os desenvolvedores devem seguir na construção do sistema
-
Justificar essas orientações, decisões e restrições
-
Descrever os mecanismos arquiteturais e onde eles devem ser aplicados.
Os membros da equipe que não estiveram envolvidos nessas decisões arquiteturais precisam compreender o raciocínio por
trás do contexto da arquitetura para que possam melhor atender às necessidades do sistema.
Outros conteúdos recomendados são:
-
Referências aos requisitos arquiteturalmente significantes
-
Referências aos elementos de design arquiteturalmente significantes
-
Instruções de empacotamento para subsistemas e componentes
-
Camadas e subsistemas críticos
-
Interfaces de sistema críticas
-
Principais abstrações
-
Classes de análise importantes
-
Principais cenários que descrevam comportamento crítico do sistema
Os arquitetos devem usar este artefato para colaborar com os outros membros da equipe quando do desenvolvimento da
arquitetura, e para ajudar aos membros da equipe a entender as motivações por trás das decisões arquiteturais de forma
que essas decisões possam ser implementadas com robustez. Por exemplo, o arquiteto pode definir restrições sobre a
forma como os dados são empacotados e comunicados entre as diferentes partes do sistema. Isso pode parece cansativo,
mas a justificação no Caderno de Arquitetura pode explicar que existe um significante gargalo de desempenho na
comunicação com um sistema legado. O resto do sistema deve adaptar-se a este gargalo, seguindo um esquema específico de
empacotamento de dados.
Este artefato também deve informar ao Gerente de Projeto e outros membros da equipe como o sistema está dividido ou
organizado de modo que a equipe possa se adaptar às necessidades do sistema. Ele indica também quem deve manter e
alterar a arquitetura após a primeira concepção do sistema e das motivações técnicas.
Este artefato é diferente da Arquitetura Executável. Este artefato descreve como o sistema deve ser construído,
enquanto que a Arquitetura Executável é uma construção que contém parte da arquitetura validada.
|