Guia de Levantamento de Requisitos

Verso 1.1

Guia de Levantamento de Requisitos

Histrico de Reviso
Data 26/05/2008 13/03/2012 Verso 1.0 1.1 Descrio Criao e detalhamento inicial do documento. Reviso do documento Autor Daniel Hatano Daniel Hatano

Guia de Levantamento de Requisitos

NDICE
1. 1.1 1.2 2. 3. Introduo .............................................................................................. 4 Objetivo ........................................................................................................................................ 4 Definies, Acrnimo e Abreviaes. ............................................................................................. 4 Documentos ............................................................................................ 4 Fluxo de atividades ................................................................................. 5

3.1 Primeira etapa .............................................................................................................................. 5 3.1.1 Reunies de levantamento...................................................................................................... 5 3.1.2 Consolidao das informaes levantadas .............................................................................. 6 3.1.3 Apresentao e Refinamento .................................................................................................. 6 3.2 Segunda etapa ............................................................................................................................... 7 3.2.1 Especificao dos casos de uso............................................................................................... 7 3.2.2 Validao dos Casos de Uso................................................................................................... 8 3.2.2.1 Formas de validao .......................................................................................................... 8 3.3 4. 4.1 4.2 5. 5.1 5.2 5.3 5.4 Mudana de requisitos .................................................................................................................. 9 Ferramentas ............................................................................................ 9 Rational RequisitePro................................................................................................................. 9 Microsoft Word .......................................................................................................................... 9 Padro de Especificao de Caso de Uso ................................................. 9 Estrutura bsica do caso de uso .................................................................................................... 9 Fluxos Alternativos ..................................................................................................................... 10 Explicaes e crticas .................................................................................................................. 10 Template ..................................................................................................................................... 10

Guia de Levantamento de Requisitos

1. Introduo
1.1 Objetivo Este documento descreve as diretrizes para efetuar o levantamento dos requisitos de sistema do projeto de software. Seu escopo abrange a definio de documentos, procedimentos, padres e as estratgias necessrias para o sucesso no processo de levantamento de requisitos de sistema. Os objetivos a serem atingidos so: Levantar as informaes para o desenvolvimento do sistema junto aos usurios gestores; Especificar o comportamento que o sistema deve possuir para que o mesmo seja capaz de executar aes especficas desejadas; Validar as especificaes para confirmao das informaes; Garantir o desenvolvimento de forma coerente com as necessidades dos usurios. Este documento detalha o processo de levantamento de requisitos a ser utilizado para a especificao de casos de uso, no abrangendo a parte anterior de levantamento de necessidades e caractersticas que definem o escopo inicial do projeto. Ou seja, este documento deve ser utilizado no processo de levantamento de requisitos de sistemas para especificao dos casos de uso e levantamento de requisitos no funcionais. 1.2 Definies, Acrnimo e Abreviaes. Vide glossrio do projeto.

2. Documentos
Documento Viso do Projeto Extenso VIS Objetivo Coletar, analisar e definir as necessidades e funcionalidades gerais do sistema. Seu foco est nas necessidades dos usurios e no motivo da existncia destas necessidades. Descrever as instncias (cenrios) de casos de uso, onde cada instncia representa um conjunto de passos que devem ser executados pelo sistema, com o objetivo de produzir algo significativo para o(s) ator(es). Definir os requisitos do sistema que no so capturados diretamente atravs dos casos de uso. So regras definidas que podem ser leis, polticas, restries ou condies que devem ser seguidas.

Especificao de Caso de Uso

CSU

Especificao Suplementar Regra de Negcio

SUP RNG

Guia de Levantamento de Requisitos

3. Fluxo de atividades
O processo de levantamento de requisitos consiste em entender e capturar as necessidades do usurio gestor e descrever de forma padronizada o que o sistema deve possuir para atender estas necessidades. Alm da documentao dos requisitos, este detalhamento ser o mesmo que a equipe de desenvolvimento e tambm a equipe de testes usaro como guia para desenvolver e testar o sistema, respectivamente. Para um trabalho mais eficiente, o fluxo de atividades deve ser dividido em duas etapas como segue: Primeira etapa: o Reunies de levantamento; o Consolidao das informaes levantadas; o Apresentao e refinamento dos produtos gerados.Segunda etapa: o Especificao dos casos de uso; o Validao dos casos de uso. Esta diviso foi uma adequao realidade do projeto, pois muitas vezes h a necessidade de deslocamento dos usurios gestores de outros estados para a matriz. Este perodo normalmente compreende 1 semana (5 dias teis). Por isso, este modelo foi dividido na primeira etapa presencial, com todos os usurios, e a segunda etapa no necessariamente necessita da presena de todos, pois a validao pode ocorrer remotamente por parte dos usurios de outros estados. A seguir sero detalhadas as atividades especficas de cada etapa. 3.1 Primeira etapa A primeira etapa consiste na primeira semana do levantamento dos requisitos de um caso de uso novo. O fluxo de atividades dividido nas atividades detalhadas a seguir. 3.1.1 Reunies de levantamento Nas reunies de levantamento o analista de sistemas deve utilizar as vrias tcnicas possveis para conseguir o envolvimento dos interessados (usurios gestores, clientes, etc). O analista de sistemas deve tambm atuar como o mediador para conduzir a reunio de forma objetiva, pois em muitos casos, os usurios comeam a tratar de assuntos envolvidos no negcio mas que no afetam diretamente aquela parte do processo especificamente. O aproveitamento do tempo da forma mais produtiva o ponto que sempre deve ser observado nesta atividade. Participantes: Usurios envolvidos, analistas de requisitos e Projetista de interface visual. Execuo: Exerccio de explorao de detalhes dos casos de uso; Prospeco de informaes dos usurios envolvidos. Objetivo: Definir o comportamento do sistema. Produtos Gerados: Ata de reunio.

Guia de Levantamento de Requisitos

3.1.2 Consolidao das informaes levantadas Esta atividade interna da equipe do projeto e consiste em consolidar as informaes obtidas nas reunies de levantamento. A consolidao das informaes deve ser feita j nos documentos formais de especificao de casos de uso e em um prottipo navegvel no funcional. Este passo o incio da traduo das solicitaes dos usurios gestores para o sistema. Participantes: Analistas de requisitos; Projetista de interface visual. Objetivo: Gerao dos produtos de acordo com as informaes levantadas. Produtos Gerados: Esboo da especificao dos casos de uso. Esboo do prottipo de interface.

3.1.3 Apresentao e Refinamento Esta atividade consiste em apresentar os esboos das especificaes do caso de uso e do prottipo de interface para que sejam ajustadas as possveis divergncias de entendimento sobre os requisitos que foram detalhados. Quando houver divergncias, estas devem ser discutidas e refinadas para que o entendimento do comportamento do sistema esteja de acordo com as necessidades apresentadas pelos usurios. Este ponto importante para que os usurios se acostumem com a metodologia adotada, assim como com a forma de leitura da especificao de caso de uso e a visualizao do prottipo. Deve deixado bem claro aos usurios que o prottipo, como o nome diz, um modelo que na medida do possvel ser seguido, mas que alteraes de formato e leiaute podem ocorrer no momento do desenvolvimento da soluo. Ao trmino desta atividade, a equipe do projeto deve possuir todas as informaes necessrias para finalizar a especificao dos requisitos, sem a presena dos usurios gestores. Participantes: Usurios envolvidos, analistas de requisitos e projetista de interface visual. Execuo: Apresentao dos produtos gerados; Refinamento das informaes paralelamente apresentao. Objetivo: Obter todas as informaes necessrias para a especificao do caso de uso. Produtos Gerados: Esboo da especificao dos casos de uso apresentados e refinados.

Guia de Levantamento de Requisitos

3.2 Segunda etapa A segunda etapa se divide no refinamento da especificao de casos de uso (detalhamento do esboo apresentado na primeira etapa) e tambm da validao dos requisitos por parte do usurio. 3.2.1 Especificao dos casos de uso Esta atividade consiste em consolidar todas as informaes nos documentos formais utilizados para especificar os requisitos de sistema. Na primeira etapa j se tem o esboo destes documentos, mas no com o detalhe e todas as possveis excees. O foco da primeira etapa ter clareza e modelar os requisitos de sistemas. Aqui, o foco detalhar os requisitos na forma como devem ser desenvolvidos. Ao final desta atividade, e da verificao de qualidade os produtos gerados devem ser encaminhados aos usurios gestores para validao. Participantes: Analistas de requisitos. Projetista de interface visual. Execuo: Detalhamento das regras de negcio; Especificao dos casos de uso; Definio das mensagens de interface e domnios e atributos; Criao dos prottipos de interface. Objetivo: Finalizao da especificao dos casos de uso. Produtos gerados: Regras de negcio definidas; Especificao de caso de uso finalizada; Documento de mensagens de interface; Documento domnios e atributos; Prottipos de interface. Abaixo segue o modelo como os documentos de levantamento de requisitos do projeto se relacionam.

Prottipo de Interface

Especificao de Caso de Uso

Documento de Mensagens

Regras de Negcio

Domnios e Atributos

Guia de Levantamento de Requisitos

A Especificao de Caso de Uso faz referncia direta ao Documento de Mensagens, Regras de Negcio e aos Domnios e Atributos. Estes trs documentos so documentos acessrios, que so utilizados por vrios casos de uso e concentra as mensagens, regras de negcio e os atributos de todo o sistema, facilitando a manuteno. O Prottipo de Interface referencia algumas mensagens do sistema. Entre a Especificao de Caso de Uso e o Prottipo de Interface no existe uma referncia descrita no documento nem nos prottipos, at porque no uma boa prtica vincular o caso de uso que deve descrever o qu deve ser atendido com o prottipo que j uma soluo de como as coisas sero feitas para atender as necessidades dos usurios gestores. Mas no fluxo da Especificao de Caso de Uso, acompanhando o prottipo juntamente com a leitura, sempre haver uma referncia das telas pelos atributos apresentados. 3.2.2 Validao dos Casos de Uso Esta atividade realizada pelos usurios envolvidos no levantamento, que devem ler a especificao dos casos de uso e validar se todas as informaes esto de acordo com as necessidades, inclusive se as crticas esto sendo efetuadas de forma correta, se os clculos esto sendo efetuados e se da forma como est o requisito de sistema atende as reais necessidades dos usurios. Participantes: Usurios envolvidos. Execuo: Leitura minuciosa dos produtos gerados. Objetivo: Validao dos produtos gerados. Produtos Gerados: Casos de uso validados. 3.2.2.1 Formas de validao A validao dos requisitos do sistema deve ser executada de acordo com os passos a seguir. Efetuar a leitura dos casos de uso e levar as observaes reunio de validao. Os pontos indicados sero discutidos em reunio; Aps a reunio, os casos de uso sero assinados e indicados como validados por todos os usurios. Aps a assinatura, o caso de uso no poder ser mais alterado a no ser por solicitao de mudana. No caso de algum usurio gestor estar lotado em outro estado que no seja o da Matriz, este usurio deve efetuar a leitura dos casos de uso e encaminhar as suas observaes equipe de analistas do projeto. Estas observaes sero colocadas durante a reunio de validao pelos analistas do projeto para serem discutidas. Caso haja alguma divergncia, durante a reunio poder ser feita uma consulta por telefone com esses usurios.

Guia de Levantamento de Requisitos

3.3 Mudana de requisitos O requisito especificado em um caso de uso j validado s pode ser alterado mediante uma solicitao de mudana formal pela rea gestora da funcionalidade em questo. Os impactos que uma mudana solicitada provocar no projeto sero mensurados de acordo com a verificao da equipe do projeto. Uma solicitao de mudana pode no ser atendida imediatamente, pois depender da prioridade de atividades e o impacto da mudana no projeto. Os impactos que esta mudana causar sero refletidas diretamente no cronograma do projeto, pois uma mudana aps a validao dos requisitos ser tratada como um tempo no previsto na execuo do projeto. Uma vez aprovada, a mudana ser efetuada em todos os documentos onde houver necessidade e estes devem ser novamente validados pelos usurios.

4. Ferramentas
Esta seo apresenta as ferramentas que daro suporte ao processo de levantamento de requisitos. 4.1 Rational RequisitePro Esta ferramenta deve ser utilizada para a manuteno de documentos, requisitos, atributos de requisitos e da rastreabilidade. 4.2 Microsoft Word Esta ferramenta utilizada para especificao dos documentos e requisitos cadastrados atravs dos modelos de documentos definidos no item 2.

5. Padro de Especificao de Caso de Uso

Algumas regras foram definidas no projeto para a Especificao de um Caso de Uso. Estas regras foram convencionadas com o intuito de padronizao. 5.1 Estrutura bsica do caso de uso Quando o caso de uso possuir cenrios de incluso, alterao e excluso, sendo que para efetuar a alterao e excluso necessitem de uma consulta, a estrutura do caso de uso ser: Fluxo Bsico Cenrio de consulta Ao final do cenrio de consulta, possibilitar que o ator escolha efetuar alterao ou excluso ou alguma outra operao. Subfluxo 1 Cenrio de incluso Subfluxo 2 Cenrio de alterao Subfluxo 3 Cenrio de excluso Se o caso de uso no necessita efetuar a consulta para alterar ou excluir (casos em que quando se escolhe alterar, o sistema j efetua a consulta automaticamente sem necessidade de parmetros informados pelo usurio), o caso de uso ficar da seguinte forma:

Guia de Levantamento de Requisitos

Fluxo Bsico O sistema apresenta as possibilidades que, neste caso, so: Subfluxo 1 Cenrio de incluso Subfluxo 2 Cenrio de alterao Subfluxo 3 Cenrio de excluso 5.2 Fluxos Alternativos Quando houver um fluxo alternativo a ser chamado, a estrutura ser seguinte: F1. O ator confirma a operao (A1)(A2)(A3) F2. O sistema atualiza as informaes.... Ser evitado a todo custo criar fluxo alternativo de fluxo alternativo. Nestes casos, os dois fluxos alternativos partiro diretamente do fluxo principal. Claro que existiro casos que ser difcil contornar esta situao. Entenda fluxo alternativo diferente de fluxo alternativo de erro. 5.3 Explicaes e crticas O texto do passo deve ser a ao de forma simples. Caso seja necessrio explicar algum detalhe do passo, este ser detalhado no pargrafo textual do passo. Se a explicao uma regra mais complexa, esta regra deve ser colocada na seo Observao e no passo deve ser colocado referncia, como segue: F1. O sistema apresenta as informaes para alterao. O sistema apresenta as informaes de acordo com o item 61 Dados de cadastro. F2. O ator efetua as alteraes e confirma a operao (A1). F3. O sistema valida as informaes. O sistema verifica que: Os dados obrigatrios foram informados (A2). O formato do CPF informado est correto (A3). F2. O sistema atualiza as informaes e apresenta a mensagem de sucesso M1. Neste passo, o sistema deve atualizar todas as informaes que foram alteradas. A situao do cadastro deve ser gravada como Ativo. Vide regra 10.1 Regra de atualizao de dados do cadastro. Quanto menos texto houver entre os passos do caso de uso, este se torna mais direto para entendimento do fluxo e menos confuso. Se existe uma regra mais complexa, a explicao desta deve ser colocada fora do passo e feito a referncia cruzada, mas no implica que no haver um fluxo alternativo para contemplar tal regra. Uma regra deve estar refletida nos fluxos do caso de uso, at porque, em muitos casos, uma regra possui uma crtica do sistema e esta deve estar descrita e detalhada como um comportamento que o sistema deve seguir. 5.4 Template Vide Anexo I Template de Especificao de Caso de Uso. Este template tambm est inserido como outline da ferramenta IBM Rational RequisitePro.

10