0.7 Documentação da arquitetura  (Page 18/25)

Escopo

Nem todas as decisões arquiteturais são válidas durantetodo o ciclo de vida do software ou válidas em todos os módulosque o compõem. Por isso, surge a necessidade de registrar o escopoda decisão. Este registro tipo de registro se torna importanteem decisões de propriedades, uma vez que normalmente tratam de preocupaçõestransversais e abrangem grandes partes do sistema, e em decisõesexecutivas, que devem, por exemplo, especificar quais etapas do processode desenvolvimento devem usar tais metodologias.

O [link] , a seguir, descreve o escopo da Decisão Arquitetural001, que é bem abrangente. Já no [link] , podemos observar que o escopo da decisãode usar JMX Java Management Extensions (JMX): (External Link) como tecnologia de monitoração é mais limitado.

Histórico

A documentação da arquitetura, assim como o queela representa, evolui ao longo do tempo. Decisões são tomadas,avaliadas, modificadas ou mesmo contestadas ao longo do ciclo devida da arquitetura. Portanto, é de se esperar que exista um registrohistórico da evolução de cada decisão arquitetural. Por isso consideramoso atributo histórico.

O atributo histórico deve conter, para cada modificaçãoda decisão, uma marca de tempo, o autor da modificação e um resumoda modificação. Se o documento estiver armazenado em um wiki ououtra forma eletrônica, o histórico pode conter links para as versõesanteriores da decisão.

O [link] ilustra o registro histórico da DecisãoArquitetural 001.

Estado atual

O atributo estado atual de uma decisão serve parapermitir mais uma dimensão de organização das decisões. Da mesma forma queas decisões evoluem ao longo do tempo, elas podem ter diversosestados que merecem ser registrados. Como o conjunto de estados quepodem ser atribuídos a uma decisão arquitetural depende do processode desenvolvimento adotado, citamos apenas alguns estados mais comuns: