Methodology Explorer Trabalho de Graduao 2002.

2
Graduando: Carlos Roberto da Silva Jnior
Orientador: Hermano Perrelli de Moura

Documento de Requisitos do Sistema

Methodology Explorer
Verso 3.0

Histrico de Alteraes
Data

Verso

Descrio

Autor

17/11/2002

3.0

Fechamentodoescopocomdefiniodetodosos
requisitosaseremimplementadosnoTGdeCarlos.

CarlosR.S.Jnior

12/08/2002

2.9

Reestruturaododocumento.Avaliaodos
requisitosanterioresecriaodenovosvisando
adequaosnovasfuncionalidadesdesejadas.

CarlosR.S.Jnior

28/09/2001

2.8

ModificaonaseoDescriodainterfacecomo
usurioenoscasosdeusodosistema.

SuzanaMesquita

24/09/2001

2.7

ModificaodocasodeusoCadastrareretiradade
vriosfluxossecundrios

SuzanaMesquita

25/08/2001

2.6

ModificaodocasodeusoExportar

SuzanaMesquita

18/08/2001

2.5

Modificaesgeraisnodocumento

SuzanaMesquita

13/08/2001

2.4

ModificaonaseoDescriodainterfacecomo
usurio

SuzanaMesquita

23/07/2001

2.3

Modificaesgeraisnodocumento

HermanoPerrellie
SuzanaMesquita

14/04/2001

2.2

Modificaodadefiniodaestruturadervoreno
tpicoInterfacecomousurio.

SuzanaMesquita

13/04/2001

2.1

ModificaodocasodeusoRF09:Colarum
Componente

SuzanaMesquita

Contedo
1.

INTRODUO..............................................................................................................................................4
1.1
VISO GERAL DO DOCUMENTO..............................................................................................................4
1.2
CONVENES, TERMOS E ABREVIAES................................................................................................4
1.2.1
Identificao dos requisitos..............................................................................................................4
1.2.2
Prioridades dos requisitos................................................................................................................4

2.

DESCRIO GERAL DO SISTEMA.........................................................................................................5

2.1

3.

ABRANGNCIA E SISTEMAS RELACIONADOS..........................................................................................5

REQUISITOS FUNCIONAIS (CASOS DE USO)......................................................................................5

3.1
CADASTRO..............................................................................................................................................5
[RF001] Criar componente............................................................................................................................5
[RF002] Excluir componente..........................................................................................................................5
[RF003] Alterar componente..........................................................................................................................6
3.2
INTERFACE..............................................................................................................................................6
[RF001] Visualizar Componente....................................................................................................................6
[RF002] Copiar componente..........................................................................................................................6
[RF003] Colar componentes..........................................................................................................................7
3.3
COMPILAO..........................................................................................................................................7
[RF001] Compilar componente......................................................................................................................7
3.4
IMPORTAO/EXPORTAO....................................................................................................................7
[RF001] Anexar documentos..........................................................................................................................7
[RF002] Exportar metodologia......................................................................................................................8
[RF003] Importar metodologia......................................................................................................................8
[RF004] Salvar metodologia..........................................................................................................................8
[RF005] Gerar site de metodologia................................................................................................................9

4.

REQUISITOS NO-FUNCIONAIS.............................................................................................................9
[NF001] Usabilidade......................................................................................................................................9
[NF002] Desempenho.....................................................................................................................................9
[NF003] Hardware e Software.......................................................................................................................9

5.

REFERNCIAS............................................................................................................................................10

Documento de Requisitos
Arquivo: 266094436.doc

Pgina 3 de 10
ltima Atualizao: 12/03/2003 10:34:00 PMh

1.

Introduo

Este documento especifica os requisitos do sistema Methodology Explorer, fornecendo aos

desenvolvedores as informaes necessrias para o projeto e implementao, assim como para
a realizao dos testes e homologao do sistema.

1.1

Viso geral do documento

Alm desta seo introdutria, as sees seguintes esto organizadas como descrito abaixo.
1.
Seo 2 Descrio geral do sistema: apresenta uma viso geral do sistema,
caracterizando qual o seu escopo e descrevendo seus usurios.
2.
Seo 3 Requisitos funcionais (casos de uso): especifica todos os casos de uso do
sistema, descrevendo os fluxos de eventos, prioridades, atores, entradas e sadas de cada caso
de uso a ser implementado.
3.
Seo 4 Requisitos no-funcionais: especifica todos os requisitos no funcionais do
sistema, divididos em requisitos de usabilidade, confiabilidade, desempenho, segurana,
distribuio, adequao a padres e requisitos de hardware e software.
4.
Seo 5 Referncias: apresenta referncias para outros documentos utilizados para a
confeco deste documento.

1.2

Convenes, termos e abreviaes

A correta interpretao deste documento exige o conhecimento de algumas convenes e

termos especficos, que so descritos a seguir.
1.2.1 Identificao dos requisitos
Por conveno, a referncia a requisitos feita atravs do nome da subseo onde eles esto
descritos, seguidos do identificador do requisito, de acordo com a especificao a seguir:
[nome da subseo. identificador do requisito]
Por exemplo, o requisito funcional [Recuperao de dados.RF016] deve estar descrito em
uma subseo chamada Recuperao de dados, em um bloco identificado pelo nmero
[RF016]. J o requisito no-funcional [Confiabilidade.NF008] deve estar descrito na seo de
requisitos no-funcionais de Confiabilidade, em um bloco identificado por [NF008].
Os requisitos devem ser identificados com um identificador nico. A numerao inicia com o
identificador [RF001] ou [NF001] e prossegue sendo incrementada medida que forem
surgindo novos requisitos.
1.2.2 Prioridades dos requisitos
Para estabelecer a prioridade dos requisitos, nas sees 4 e 5, foram adotadas as
denominaes essencial, importante e desejvel.
5.
Essencial o requisito sem o qual o sistema no entra em funcionamento. Requisitos
essenciais so requisitos imprescindveis, que tm que ser implementados impreterivelmente.
6.
Importante o requisito sem o qual o sistema entra em funcionamento, mas de forma
no satisfatria. Requisitos importantes devem ser implementados, mas, se no forem, o
sistema poder ser implantado e usado mesmo assim.
7.
Desejvel o requisito que no compromete as funcionalidades bsicas do sistema,
isto , o sistema pode funcionar de forma satisfatria sem ele. Requisitos desejveis podem
ser deixados para verses posteriores do sistema, caso no haja tempo hbil para implementlos na verso que est sendo especificada.
Documento de Requisitos
Arquivo: 266094436.doc

Pgina 4 de 10
ltima Atualizao: 12/03/2003 10:34:00 PMh

2.

Descrio geral do sistema

2.1

Abrangncia e sistemas relacionados

O sistema Methodology Explorer uma ferramenta para o processo de desenvolvimento de

software. Fornece uma maneira intuitiva e eficiente para definir componentes adequados a
uma empresa/projeto. Um componente uma unidade da metodologia que pode ser
manipulada isoladamente, por exemplo artefato, atividade etc.
Utilizando a ferramenta, o usurio - em geral, engenheiro de processos ou projetista de
metodologias - poder cadastrar novos componentes ou criar componentes a partir de outros
j existentes. Alm disso, poder alterar, remover e consultar componentes j criados. Tais
componentes podem ser exportados da ferramenta, gerando um documento texto, pginas
HTML ou um arquivo PDF que podem ser visualizados sem utilizar a ferramenta.
A ferramenta conter tambm testes de validao sobre os componentes criados. Estes so
baseados no Rational Unified Process [2] (metodologia proposta pela empresa Rational
Software Corporation [5]) e servem de ajuda aos usurios, evitando que este cometa pequenos
erros.
Diante da facilidade de se definir metodologias, o Methodology Explorer contribui de modo
decisivo para melhorar a qualidade do processo de desenvolvimento dos projetos de software
de uma empresa.

3. Requisitos funcionais (casos de uso)

3.1

Cadastro
[RF001] Criar componente

Descrio do caso de uso: Este caso de uso permite que o usurio crie e armazene um novo
componente no sistema.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: no tem.

Sadas e ps-condio: um componente cadastrado no sistema

[RF002] Excluir componente

Descrio do caso de uso: Este caso de uso permite que o usurio exclua um componente do
cadastro de componentes do sistema. Um componente pode ser excludo de qualquer
instanciao de metodologia (rvore).
Prioridade:
Documento de Requisitos
Arquivo: 266094436.doc

Essencial

Importante

Desejvel
Pgina 5 de 10
ltima Atualizao: 12/03/2003 10:34:00 PMh

Entradas e pr-condies: recebe como entrada o componente que se deseja excluir

Sadas e ps-condio: o usurio consegue excluir o componente que deseja
[RF003] Alterar componente
Descrio do caso de uso: Este caso de uso permite que o usurio altere os dados de um
componente.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: recebe como entrada o componente que se deseja alterar.

Sadas e ps-condio: um componente alterado no sistema.

3.2

Interface
[RF001] Visualizar Componente

Descrio do caso de uso: Este caso de uso permite que o usurio visualize os dados de um
determinado componente (todos os seus atributos, exceto aqueles que so considerados suas
propriedades).
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: deve receber como entrada o componente que se deseja visualizar.
Sadas e ps-condio: o usurio visualiza o componente desejado
[RF002] Copiar componente
Descrio do caso de uso: Este caso de uso permite que o usurio copie um componente do
cadastro de componentes do sistema. Ou seja, copia o componente de onde ele estava e manda
a cpia para a rea de transferncia.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: recebe como entrada o componente que se deseja copiar.

Sadas e ps-condio: o usurio consegue copiar o componente que deseja

Documento de Requisitos
Arquivo: 266094436.doc

Pgina 6 de 10
ltima Atualizao: 12/03/2003 10:34:00 PMh

[RF003] Colar componentes

Descrio do caso de uso: Este caso de uso permite que o usurio cole o componente
armazenado na rea de transferncia do sistema no local indicado. O contedo da rea de
transferncia continua inalterado. Aqui, local refere-se a uma pasta que contm componentes.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: recebe como entrada o componente que se deseja colar e tem
como pr-condio a necessidade de existncia de alguma informao na rea de transferncia
do sistema.
Sadas e ps-condio: o usurio consegue colar o componente no local desejado.

3.3

Compilao
[RF001] Compilar componente

Descrio do caso de uso: Este caso de uso permite que o usurio compile metodologias.
Essa compilao permite que as metodologias sejam analisadas e comparadas entre si.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: deve receber como entrada as metodologias a serem compiladas.

Sadas e ps-condio: os componentes das metodlogias so compilados no sistema.

3.4

Importao/Exportao
[RF001] Anexar documentos

Descrio do caso de uso: Este caso de uso permite que anexar documentos gerais a
componentes. Por exemplo, anexar o template do Documento de Requisitos ao fluxo de
requisitos.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: deve receber como entrada o caminho absoluto para um arquivo
no sistema de arquivos.
Sadas e ps-condio: O documento anexado ao componente.
Documento de Requisitos
Arquivo: 266094436.doc

Pgina 7 de 10
ltima Atualizao: 12/03/2003 10:34:00 PMh

[RF002] Exportar metodologia

Descrio do caso de uso: Este caso de uso permite ao usurio a possibilidade de exportar
uma metodologia num determinado formato, como XML, por exemplo. O usurio tambm
tem a opo de escolher se o componente deve ou no ser exportado juntamente com seus
anexos.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: A entrada uma metodologia a ser exportado e seus subcomponentes, ou seja, todos os componentes que um determinada metodologia.
Sadas e ps-condio: Os componentes so exportados para um arquivo em um determinado
formato (como XML).
[RF003] Importar metodologia
Descrio do caso de uso: Este caso de uso permite que componentes de uma metodologia
exportada sejam importados do sistema de arquivos e apresentados no Methodology Explorer.
Os componentes, para serem importados precisam estar no mesmo formato utilizado no caso
de uso [Importao/Exportao.RF002]. Importar um componente apenas permite manipular
o componente dentro do Methodology Explorer. Para inseri-lo de fato, preciso realizar o
caso de uso [Importao/Exportao.RF004]
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: A entrada o caminho absoluto para um arquivo no sistema de

arquivos.
Sadas e ps-condio: O componente importado ser inserido na(s) rvore(s) de
componentes adequada.
[RF004] Salvar metodologia
Descrio do caso de uso: Este caso de uso permite salvar as alteraes realizadas nos
componentes de uma metodologia.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: A entrada uma metodologia.

Sadas e ps-condio: um componente persistido no Methodology Explorer.

Documento de Requisitos
Arquivo: 266094436.doc

Pgina 8 de 10
ltima Atualizao: 12/03/2003 10:34:00 PMh

[RF005] Gerar site de metodologia

Descrio do caso de uso: Este caso de uso permite que um site seja gerado para uma
metodologia j compilada. O site deve conter tambm os possveis artefatos que foram
anexados.
Prioridade:

Essencial

Importante

Desejvel

Entradas e pr-condies: Um componente metodologia a entrada para o caso de uso que

tem, como pr-condio, que a toda a metodologia j esteja salva.
Sadas e ps-condio: um site completo gerado no sistema de arquivos contendo os
arquivos HTML e os artefatos anexados metodologia.

4.

Requisitos no-funcionais

[NF001] Usabilidade
A interface com o usurio de vital importncia para o sucesso do sistema. Principalmente
por ser um sistema que no ser utilizado diariamente, o usurio no possui tempo disponvel
para aprender como utilizar o sistema.
O sistema ter uma interface amigvel ao usurio primrio sem se tornar cansativa aos
usurios mais experientes. Em especial, o mdulo de publicao HTML possuir um wizard
para ajudar o usurio.

Prioridade:

Essencial

Importante

Desejvel

[NF002] Desempenho
Embora no seja um requisito essencial ao sistema, deve ser considerada por corresponder a
um fator de qualidade de software.
Prioridade:

Essencial

Importante

Desejvel

[NF003] Hardware e Software

Visando criar um produto com maior extensibilidade, reusabilidade e flexibilidade, deve ser
adotar como linguagem principal de desenvolvimento Java seguindo cuidadosamente as
tcnicas de orientao a objetos. Entretanto, outras linguagens tambm podero ser usadas
quando indicaes tcnicas recomendem.
Documento de Requisitos
Arquivo: 266094436.doc

Pgina 9 de 10
ltima Atualizao: 12/03/2003 10:34:00 PMh

O uso da linguagem Java permite no especificar qual ser o sistema operacional e a mquina
em que o programa ir executar. No entanto, essa mquina dever se comunicar com um
sistema de banco de dados.
Prioridade:

5.
1.
2.
3.
4.
5.
6.

Essencial

Importante

Desejvel

Referncias
Furlan, J. D. Modelagem de Objetos atravs da UML. So Paulo, Makron Books, 1998.
Kruchten, P. The Rational Unified Process An introduction. Addison-Wesley, 1998.
Pgina da disciplina Anlise e Especificao de Requisitos. www.cin.ufpe.br/~if119.
Pgina da disciplina Metodologia e Desenvolvimento de Software www.cin.ufpe.br/~mds.
Pgina da empresa Rational Software Corporation www.rational.com.
Pgina do projeto de instanciao de ambientes de desenvolvimento de software
convencionais e orientados a domnios (visitada em 18/01/2001) www.cos.ufrj.br/~taba.

Documento de Requisitos
Arquivo: 266094436.doc

Pgina 10 de 10
ltima Atualizao: 12/03/2003 10:34:00 PMh