Documentação de Requisitos de Software

Esta é uma pré-visualização de arquivo. Entre para ver o arquivo original

Requisitos de Sistemas
Marcelo Vasques de Oliveira
Aula 5
Aula 5 – Documentação de Requisitos de Software
O documento de requisitos
 O que é? 
 Importância 
 Pontos prioritários na redação
 Quem são os envolvidos ?
 Composição do documento
2
Revisão Aulas 1 
Requisito é a descrição de algo que o sistema precisa realizar, ou uma de suas características, para atinge a seus objetivos. 
A qualidade do sistema (produto final) dependerá do adequado levantamento e identificação dos requisitos do sistema.
Para que o sistema (produto) tenha qualidade é preciso aferir qualidade em seu processo de desenvolvimento
É preciso que os requisitos sejam descritos de forma adequada.
3
Revisão Aulas 2 
Essa adequação tem relação direta com as expectativas dos interessados (stakeholders) no sistema.
Requisitos de Usuário – descrição informal, sem detalhes, descrevendo uma função ou característica do sistema. 
Útil para usuários que não demandam detalhes técnicos ou operacionais. Por exemplo gestores, patrocinadores e etc
Requisitos de Sistema – descrição em detalhes do requisito
Útil para desenvolveres e usuários da tarefa
4
Revisão Aula 3 
Requisitos: Funcionais e Não Funcionais
Funcionais – o que o sistema deve fazer (funcionalidades) e o que não deve fazer
Não confundir com Regras de Negócio (Como funcionalidades devem operar)
Não funcionais –características e restrições do sistema. Podem estar relacionados a uma função específica (requisito funcional) ou ao sistema como um todo.
Estão associados a aspectos como Usabilidade, Confiabilidade, Segurança, Eficiência, Portabilidade e manutenibilidade
5
Revisão Aula 4 
Conceito de stakeholders
 Stake – Interesse, participação, risco
 Holder – Aquele que possui
Técnicas de levantamento de dados
Workshop
Entrevistas
Questionários
Brainstorm
JAD
Etnografia
6
Relembrando......
7
Documento de Requisitos
Antes de codificar em uma LP, precisamos entender OS REQUISITOS – Levantamento 
A empresa
O contexto do sistema
As necessidades dos usuários
É preciso documentar os requisitos e “coisas” relevantes do levantamento.
Documento de Requisito de Software (SRS – Software Requeriments Specification)
Clareza
Completo, no sentido de “conversar” com os principais interessados.
8
Documento de Requisitos
Não é um documento estritamente técnico
Deve atender a diversidade de stakeholders (dentro da visão de requisito de usuário e de sistemas – aula 2).
Foco: comunicação com os stakeholders
Deve ser organizado 
Deve trazer tópico voltado a manutenção e implementações futuras
9
Documento de Requisitos - Problemas
Disparidade no nível das especificações
alguns requisitos foram especificados em um nível alto e outros em um nível muito baixo.
Situações
Utilizaram diferentes estilos de escrita
Diferentes níveis de detalhes nos requisitos.
Mesclam requisitos com soluções parciais
Requisitos excessivamente especificados,
requisitos pouco especificados, em geral ao descreverem o ambiente de operação, manutenção, simulação para treinamento
10
Exemplos de Usuários
Clientes do sistema
Especificam e acessam os requisitos para verificar se satisfazem suas necessidades. 
Os clientes especificam as mudancas nos requisitos.
Gerentes
 Usam documentos de requisitos para planejar uma proposta para o sistema e planejar o processo de desenvolvimento.
Engenheiros de software
 Usam os requisitos para entender o sistema que será desenvolvido.
11
Exemplos de Usuários
Engenheiros de testes
Usam os requisitos para desenvolver testes de validação de sistema.
Engenheiros de manutenção do sistema
Usam requisitos para entender o sistema e os relacionamentos entre suas partes.
12
Template do documento – Sommerville 2009
Prefácio
Define os possíveis leitores do documento e histórico de versões, incluindo justificativa para a criação de nova versão e um resumo das mudanças feitas em cada versão.
Introdução
 Descreve a necessidade do sistema. 
 Descreve brevemente as funções do sistema 
 Explica como funciona integração com outros sistemas. 
 Descreve como o sistema atende aos objetivos globais do negócio ou estratégicos
13
Template do documento – Sommerville 2009
Glossário
 Definir os termos técnicos usados no documento, sem julgamentos do conhecimento das pessoas. 
Definição de requisitos do usuário
 Descrever os serviços oferecidos ao usuário. 
 Apresenta os requisitos não funcionais do sistema.  
 Essa descrição pode usar linguagem natural, diagramas ou outras notações compreensíveis para os clientes. 
14
Template do documento – Sommerville 2009
Modelos do sistema
Pode incluir modelos gráficos que mostram relacionamentos entre os componentes do sistema, o sistema e seu ambiente, além de funcionalidades (diagrama de casos de uso)
Evolução do sistema
Descreve as premissas do sistema
Descreve quaisquer mudanças previstas, em decorrência da evolução do hardware, de mudanças nas necessidades do usuário, etc.
 Útil para projetistas de sistemas, pois pode ajudá-los a evitar decisões capazes de restringir possíveis mudanças futuras no sistema.
15
Template do documento – Sommerville 2009
Apêndices
Deve fornecer informações especificas em relação ao sistema, além das descrições do hardware e ambiente necessário
Índice
Vários índices podem ser incluídos no documento: índice alfabético normal, um índice de diagramas, de funções, dentre outros que sejam pertinentes.
16
Documentação de Requisitos de Software
Marcelo Vasques de Oliveira
Atividades
Exercícios
1) Sobre o Documento de Requisitos analise as assertivas
I. É um documento estritamente técnico.
II. Atende aos diferentes interessados técnicos
III. Os engenheiros de software usam o documento para entender o que o sistema fará
Com base em sua análise, assinale a opção correta
( ) Estão corretos apenas I e II
( ) Estão corretas apenas II e III
( ) Estão corretos I, II e III
( ) Está correto apenas III
( ) Estão corretos I e III.
18
Exercícios
2) Diferentes grupos de usuários tem objetivos diferentes ao usar Documento de Especificação de Requisitos.
Assinale o grupo cujo objetivo é: Usam documentos de requisitos com a finalidade de planejar o processo de desenvolvimento do sistema
a.( ) Clientes
b.( ) Engenheiros de Software
c.( ) Engenheiros de testes
d.( ) Gestores
e.( ) Engenheiros de manutenção
19
Exercícios
3) Das especificações abaixo relacionados, assinale o que deve estar contido dentro da estrutura no template do documento de requisitos no item DEFINIÇÃO DE REQUISITOS DE USUÁRIO.
( ) Descreve como o sistema deve atender aos objetivos estratégicos da empresa
( ) Descreve os modelos gráficos, que por exemplo apresentam as funcionalidades do sistema
( ) Descrevem mudanças previstas
( ) Apresenta os termos técnicos
( ) Descreve os requisitos não funcionais
20
Exercícios
4) O documento de requisitos deve permitir que sejam especificados as necessidades dos usuários, requisitos do sistema , características, restrições e outros dados relacionados ao levantamento de requisitos do sistema.
Para tanto, tal documento deve ser elaborado contendo uma série de itens. 
- “Descrever os serviços oferecidos aos usuários” é uma das especificações que devem constam no documento.
Assinale o item do documento em que tal especificação deve estar presente
( ) Introdução
( ) Evolução do sistema
( ) Definição de Requisitos de usuários
( ) Apêndices
( ) Modelos de sistemas
21
Exercícios
5) Diferentes tipos de usuários devem acessar o documento de Especificação de Requisitos, com diferentes finalidades.
Que tipo de usuário usa o documento para a finalidade abaixo:
Usam os requisitos para entender o sistema que será desenvolvido, do ponto de vista técnico
( ) Engenheiros de teste
( ) Gestores
( ) Engenheiros de manutenção
( ) Engenheiros de software
( ) Gerentes
22
Exercícios
6) Sobre o Documento de Requisitos,
analise as assertivas
I. Devem ser completos no sentido de atender aos diferentes stakeholders
II. Muitas vezes encontramos disparidades nos níveis de especificação, no que tange aos detalhes.
III. Deve especificar apenas aspectos técnicos , do desenvolvimento
IV. Deve conter apenas elementos textuais, devendo ser evitados diagramas.
Assinale a única alternativa correta
( ) Estão corretos apenas I, II e IV
( ) Está correto apenas I
( ) Estão corretos apenas I e III
( ) Estão corretos apenas I e II
( ) Está correto apenas II
23