Capítulo 2

A documentação de sistemas é sempre deixada de lado, ou por preguiça, ou por pressão do tempo . O autor sugere que para a documentação deixar de ser um problema, devemos nos preocupar com a documentação como uma das tarefas do desenvolvimento.

Eu queria fazer um a parte nesse momento. O que me deixou bastante entusiasmado com a UML é que gerando essa documentação nesse formato, a programação já estará no meio do caminho. Assim que criarmos Diagramas de classes e Diagramas de Sequência, o ato de programar se torna apenas o de traduzir o conteúdo dessa documentação em linguagem de programação.

Eu acredito que o maior trabalho estará em gerar essa documentação toda, mas assim que ela estiver definida uma equipe de programadores que saibam ler a UML poderão desempenhar sua atividade muito mais rapidamente e sem as dúvidas que passamos diariamente. Eu vejo um programador ler os casos de uso, analisar os diagramas e "mandar bala" e quando terminarem, os responsáveis pelos casos de uso verão que foi implementado o que estava "escrito". Tudo bem este é um cenário pouco comum, mas acho que temos muita capacidade para utilização desse processo....

Voltando ao livro ...
O Autor sugere três documentos iniciais:

Documento Visão

O documento visão é um relato resumido com os principais tópicos que o negócio deve fornecer. O autor usa este documento como parte do CONTRATO de desenvolvimento de software, mas eu acho que este é um documento sem muito segredo e quem tiver mais interesse pode consultá-lo na página 23 do livro.

Diagrama de Caso de Uso (Nível 0)

O Autor explica a notação, seguindo os itens na figura:

1. Ator - Sempre atua sobre um caso de uso, pode ser uma pessoa, um sistema, bem parecido com a ENTIDADE EXTERNA da análise estruturada.Dizemos que o ator "realiza uma atividade";

2. Caso de Uso - A Elipse representa o caso de uso que é uma ATIVIDADE ou uma macroação que o ator realiza;

3. Relação de dependência: A relação na figura indica que "Cadastrar beneficiário" depende diretamente da conclusão do caso de uso "Cadastrar Cliente";

4 e 5 - INCLUDE e EXTEND - Existem vários esteriótipos nos diversos diagramas em UML. Pra mim eles ainda são meio nebulosos, o autor explica que no caso do INCLUDE, o Caso de Uso Calcular Pontos utilizará integralmente a de Cálculo de Ponto de Fidalidade que se encontra documentada em Calcular Fidelidade.No caso do EXTEND, existe em cálculo em calcular bonificação e que esse cálculo irá se estender, ampliando o significado de uma fórmula já existente no Caso de Uso Calcular Fidelidade.

Conhecendo a notação, o autor sugere criar um Diagrama de Caso de Uso para a descrição que fez no documento visão, durante as explicações o autor utiliza a intenção de criar um software de locação de DVD pela internet, veja a descrição do documento visão e o diagrama criado em seguida:

"Este software tem o objetivo de disponibilizar a locação de DVDs, via Internet, a clientes já cadastrados ou ovos.

O software deve prever o cadastramento de usuários locadores, com seus dados pessoais, principalmente, os dados de endereço, que são tão importantes para a entrega como a recuperação de produtos alugados.
O software atenderá a todas as cidades onde o cliente contratante tiver depósito de DVD. Serão disponibilizados somente DVDs da cidade onde o cliente locador reside, visando à entrega.

O Cliente locador deve informar o modelo de seu equipamento de DVD, a fim de se avaliar se ele é ou não adequado a reproduzir o filme.

O cliente locador terá, no máximo, cinco dias para a devolução de um DVD alugado, sendo que esse período dependerá do tipo de DVD, que pode ser: desde Lançamentos até DVDs antigos. O processo de fidelizar o cliente locador leva em consideração tanto o número de locações quanto as decoluções pontuais.

A não devoluçào de um DVD no prazo estipulado implica pagamento de multa.

O Cliente locador pode designar, desde que apresente a documentação necessária, beneficiários capazes de efetivar um aluguel de DVD

As entregas serão feitas somente dentro da cidade em que o locador reside

Os administradores do site poderão, controlar Programa de Fidelidade, Programa de Promoções, Preços e Marketing

Os pagamentos serão feitos antecipadamente, pelo cartão de crédito ou boleto bancário."

Ainda nessa capítulo teremos o DOCUMENTO NOMENCLATURA.....
Capítulo 3 - Caso de USO