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: Arquitetura Tipos de Produto de Trabalho: Especificação
Objetivo
Para descrever o contexto e a perspectiva do sistema para garantir a sua integridade e entendimento.
Relacionamentos
Papéis | Responsável: Arquiteto | Modificado Por: Arquiteto
Tarefas | Entrada para: Projetar a Solução Refinar a Arquitetura Descrever a Arquitetura Planejar a Iteração | Saída de: Descrever a Arquitetura Refinar a Arquitetura
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 Mecanismo Arquitetural 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
Templates | Caderno de Arquitetura
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
Listas de Verificação | Caderno de Arquitetura
Conceitos | Arquitetura de Software Arquitetura Executável Componente Modelagem Visual Padrão
Diretrizes | Abstrair da Complexidade Dividir em camadas Visão Arquitetural
Este programa e o material que o acompanha são disponibilizados sob a Eclipse Public License v1.0 que acompanha esta distribuição. Direitos Autorais do OpenUP.