| Artefato: Caderno de Arquitetura |
 |
 |
|
Para descrever o contexto e a perspectiva do sistema para garantir a sua integridade e entendimento. |
| Papéis | Responsável: | Modificado Por: |
|---|---|---|
| Tarefas | Entrada para:
| Saída de: |
| 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á:
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:
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. |
|---|
| Templates |
|---|
| 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. |
|---|
| Listas de Verificação | |
|---|---|
| Conceitos | |
| Diretrizes |
Este programa e o material que o acompanha são disponibilizados sob a |