13 - Documentação de requisitos

Prévia do material em texto

Documentação de Requisitos
• Documento de Visão do Usuário
– Documento de Levantamento Preliminar do Sistema
– Objetivos
O objetivo do documento de visão é definir a descrição dos 
problemas, o detalhamento dos envolvidos e dos usuários, uma 
visão geral do software e os macro-requisitos.
– Público Alvo
• Clientes e Usuários;
• Gerência dos clientes;
• Gerência da organização a que pertence a equipe de 
desenvolvimento;
• Gerência do projeto;
• Equipe de desenvolvimento;
• Equipe encarregada da garantia de qualidade do produto
Documentação de Requisitos
• Escopo
– Descrição do domínio do problema;
– Descrição dos objetivos do sistema;
– Descrição dos benefícios esperados do sistema.
– Descrição das principais características do sistema.
– Descrição dos interessados e usuários.
– Diagnóstico da situação atual.
– Identificação preliminar de metas, restrições e riscos 
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Não há um padrão universal embora muitos autores 
apresentam modelos baseado no padrão IEEE STD 830
– Objetivos
• Definir as necessidades dos usuários que devem ser satisfeitas 
pelo sistema a ser desenvolvido;
• Derivar os requisitos implícitos do sistema que são condições 
básicas para que as necessidades dos usuários sejam 
satisfeitas;
• Estabelecer um contrato para negociação e concordância entre 
os clientes e a equipe de desenvolvimento;
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Objetivos
• Reduzir retrabalho com projeto, codificação e teste através da 
especificação rigorosa e completa dos requisitos;
• Prover uma base para avaliação de prazos e custos de 
desenvolvimento;
• Facilitar a transferência dos produtos do desenvolvimento para 
novos usuários, novos clientes, novos ambientes operacionais e 
novas equipes de desenvolvimento e manutenção;
• Prover uma base para a evolução futura do sistema
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Público Alvo
• Clientes e Usuários;
• Gerência dos clientes;
• Gerência da organização a que pertence a equipe de 
desenvolvimento;
• Gerência do projeto;
• Equipe de desenvolvimento;
• Equipe encarregada da garantia de qualidade do produto
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Escopo
• Descreve o que o sistema deve fazer e não como ele faz ou 
deverá fazer;
• Documento de análise e não de projeto;
• Deve descrever todos os requisitos do sistema, porém não mais 
que isto. Ele não deve conter nenhum detalhe de projeto, 
verificação, ou gerência de projeto, exceto quando isto implica 
em alguma restrição de projeto.
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Critérios de Qualidade
• Inequívoca: 
– Todo requisito incluído no documento deverá permitir um única 
interpretação. 
– No caso em que um termo utilizado para descrever um requisito 
permitir diversas interpretações, ele deverá ser incluído no 
glossário para estabelecer o seu significado no contexto em que 
estiver sendo utilizado.
• Completa: 
– O documento deverá descrever todas as condições às quais o 
sistema deve obedecer, incluindo requisitos funcionais, requisitos 
de informação, requisitos de desempenho, requisitos de 
segurança, requisitos operacionais, restrições de projeto, interfaces 
externas, etc.
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Critérios de Qualidade
• Verificável: 
– Todo requisito descrito no documento deverá ser passível de ser 
verificado através de um processo finito que permita comprovar se 
o produto do projeto atende àquele requisito.
• Consistente: 
– Nenhum subconjunto de requisitos poderá conter conflitos internos. 
Para tanto será necessário que:
– Um objeto referenciado por mais de um requisito, o seja sempre 
com mesmo nome;
– Descrições múltiplas de um mesmo objeto requisitos diversos não 
sejam conflitantes;
– Ações diversas não entrem em conflitos lógicos ou cronológicos 
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Critérios de Qualidade
• Modificável:
– O documento deverá ter uma estrutura e estilo tais que 
quaisquer modificações necessárias dos requisitos possam 
ser facilmente e consistentemente realizadas. 
– Assim, ele deverá conter uma tabela de conteúdo, um índice 
e referências cruzadas explícitas. 
– Todo tipo de redundância deverá ser evitado, mas se for 
impossível fazê-lo, ela deverá ser identificada através de 
referências cruzadas.
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Critérios de Qualidade
• Rastreável:
– Todo requisito definido no documento deverá ser capaz de ser 
rastreado. Para tanto ele deverá Ter um número de referência 
único. No caso de ele ser originado em outros documentos 
anteriores (ou padrões), a sua fonte deverá ser explicitamente 
identificada.
Documentação de Requisitos
• Especificação de Objetivos e Requisitos (EOR)
– Critérios de Qualidade
• Capaz de suportar a manutenção: 
– Quando aplicável todo requisito deverá mencionar:
» Criticalidade: impacto no caso de falha do atendimento do 
requisito;
» Volatilidade: Associação do requisito com necessidades 
temporárias;
» Origem: facilidades que deverão ser copiadas de outros 
sistemas já existentes