Artefato: Caderno de Arquitetura
Este artefato descreve o contexto para o desenvolvimento do software. Ele contém as decisões, o raciocínio, as suposições, as explicações e as implicações da formação da arquitetura.
Domínios: Análise e Projeto
Finalidade

Descrever o contexto e a perspectiva do sistema para garantir a sua integridade e entendimento.

Relacionamentos
Descrição
Descrição Principal

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.

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

A arquitetura pode ser representada de diversas formas e sob vários pontos de vista, dependendo das necessidades do projeto e das preferências da equipe do projeto. Não precisa ser um documento formal. A essência da arquitetura pode ser comunicada através de uma série de diagramas simples desenhados em um quadro branco; ou como uma lista de decisões. Escolha o meio que melhor atenda as necessidades do projeto.

A arquitetura pode ser expressa como uma simples metáfora ou como uma comparação a um estilo arquitetural pré-definido ou conjunto de estilos. Pode ser um conjunto específico de modelos ou documentos que descrevem os vários aspectos dos principais elementos do sistema. Expressá-la como uma construção estrutural é outra opção - embora esta construção possa necessitar ser preservada e colocada em uma linha de base para assegurar que a essência do sistema possa ser entendida na medida em que o sistema cresça.

Freqüentemente, uma parte da arquitetura referencia porções arquiteturalmente significantes do design. Ela pode referenciar modelos que descrevam Visão Arquitetural para comunicar a arquitetura. Uma visão é a representação de um sistema sob a perspectiva de um conjunto de considerações relacionadas. Para escolher o conjunto apropriado de visões, identifique os Stakeholders que dependam da documentação arquitetural do sistema e as informações que eles precisam.

Informações Adicionais