Doutor

Disponível somente no TrabalhosFeitos
  • Páginas : 6 (1295 palavras )
  • Download(s) : 0
  • Publicado : 28 de agosto de 2012
Ler documento completo
Amostra do texto
Desenvolvimento - C#
Como documentar a Arquitetura de Software
por Flávio Secchieri Mariotti
 

Introdução
No ciclo de vida do desenvolvimento de software podemos encontrar diversas etapas e todas com seus propósitos muito bem definidos, porém, uma que podemos dizer com segurança ser de extrema importância é a arquitetura do software.
Quando falamos em arquitetura logo nos vem algunspadrões como Zechman framework, TOGAF, DODAF e etc. Esses padrões existem para auxiliar e facilitar a arquitetura corporativa no intuito de prover uma abordagem ao design, planejamento, implementação e governança de uma arquitetura de informação corporativa.
Mas hoje em dia, com o conceito de agilidade sendo um dos principais diferenciais no desenvolvimento de software, como implementar uma arquiteturarobusta com uma documentação simples e eficiente? Na tentativa de responder a essa pergunta, esse artigo irá apresentar uma forma simples e eficiente para documentar a arquitetura dos seus sistemas.
O que é Arquitetura de Software?
A arquitetura de software é uma descrição do sistema que auxilia na compreensão de como o sistema irá se comportar.
Arquitetura é um meio de se obter uma análiseantecipada para garantir que a abordagem de design apresentada, produzirá um sistema que alcance os requisitos exigidos pelo cliente, tais como: desempenho, segurança, disponibilidade, integridade, flexibilidade e etc. Portanto, uma arquitetura de software consiste na definição de suas camadas, que podem envolver entidades como: componentes de software, aplicativos externos, sistemas legados epropriedades externas.
Por que devo documentar a arquitetura do sistema?
Segundo Steuart Henderson Britt, "Fazer negócios sem publicidade ou projetar uma arquitetura sem documentar, é como piscar para uma garota no escuro. Você sabe que está fazendo, mas ninguém mais sabe."
Acho essa frase engraçada, porém demonstra a verdadeira necessidade de uma documentação. Por mais perfeita e adequada que sejasua arquitetura, será inútil para outras pessoas que não a conhecem e que não podem entendê-la bem o suficiente para manuseá-la. Portanto, a documentação se faz essencial para todos os casos.
Na maioria das vezes, a documentação é tratada como algo secundário, algo que as pessoas fazem porque são obrigadas por um contrato ou gerente que a exige. Estas podem, sim, ser razões legítimas para sedocumentar algo, porém, não pode faltar a seriedade e comprometimento do arquiteto ao desenvolver esse documento, garantindo o valor e serenidade do mesmo.
Estrutura do documento
· Histórico de revisões
· Introdução
· Visão geral
· Requisitos não-funcionais
· Mecanismos arquiteturais
· Fundamentação
· Visão de casos de uso
· Componentes
· Implantação
Entendendo sua estrutura
Nesta partedo artigo vamos entender, detalhar e ver alguns exemplos para documentar cada fase apresentada na estrutura do documento.
1. Histórico de revisões: alguns dos principais objetivos que essa fase do documento pretende alcançar são: deixar explícito cada alteração feita no documento; controlar a versão do documento; deixar explícito o responsável pela alteração; controlar a veracidade do documento.Exemplo:
DATA | VERSÃO | DESCRIÇÃO | AUTOR |
11/12/2011 | 1.0 | Documento inicial | Flávio Mariotti |
03/01/2012 | 1.1 | Alteração no item 3 | Nome do autor |
| | | |
| | | |
2. Introdução: nesta fase do documento, o responsável deve apresentar de forma clara a objetividade do trabalho a ser documentado. De forma sucinta, descrever do que se trata o documento e quais assuntosserão abordados no mesmo.
3. Visão geral: a fase visão geral do documento, tem como objetivo, demonstrar de forma sucinta, os principais elementos que compõe a arquitetura do sistema. Geralmente essa etapa é apresentada com uma figura que deve servir como referência inicial para qualquer entidade que tenha ou pretende entender o sistema tecnicamente.
Exemplo:

Figure 1. Imagem que representa...
tracking img