Documento de Requisitos

Dashboard de Viso Gerencial de Projetos

Cliente:

Responsvel: Isaac Bezerra

Dashboard de Viso Gerencial de Projetos

Pg 1 de 14

Histrico de Alteraes
Data

Verso

Descrio

Autor

03.10.11

0.01

Criao do Documento

Isaac Bezerra

05.10.11

0.02

Escrita da Introduo e Descrio Geral do Isaac Bezerra

Sistema

08.10.11

0.03

Escrita inicial dos Requisitos Funcionais

Isaac Bezerra

10.10.11

0.04

Continuao da escrita de Requisitos Funcionais

Isaac Bezerra

15.10.11

1.00

Fechamento da Primeira Verso

Isaac Bezerra

05.11.11

1.01

Criao da Sesso Matriz de Rastreabilidade para Carlos Barreto

Requisitos x Casos de Uso; Mapeamento
preliminar dos requisitos RF003, RF004 e RF006;
Atualizao do Sumrio.

10.11.11

1.02

Levantamento de novos requisitos, descrio e Isaac Bezerra

detalhamento de casos de uso.

Lista de Aprovadores
Nome

Cargo

ndice Analtico

1. Introduo __________________________________________________4
1.1. Objetivo ______________________________________________________________ 4
1.2. Viso Geral do Documento __________________________________________ 4
1.3. Origem dos Dados para Elaborao dos Requisitos________________ 4

2. Descrio Geral do Sistema ____________________________________5

2.1. Abrangncia e Sistemas Relacionados _____________________________ 5

3. Requisitos ___________________________________________________6

4.

3.1. Requisitos Funcionais _______________________________________________

3.1.1.
[RF001] Painel de Apresentao ________________________________________
3.1.2.
[RF002] Cadastrar Mtricas ___________________________________________
3.1.3.
[RF003] Pesquisa, Excluso e Alterao de Mtricas. _______________________
3.1.4.
[RF004] Apresentar Mtricas e Medidas__________________________________
3.1.5.
[RF005] Cadastrar Nvel de Criticidade __________________________________
3.1.6.
[RF006] Alterar, Excluir e Pesquisar Nveis de Criticidade ___________________
3.1.7.
[RF007] Importar Dados do AgiliZen ____________________________________
3.1.8.
[RF008] Personalizar Grfico __________________________________________
3.1.9.
[RF009] Formas Grficas de Apresentao das Medidas e Mtricas ____________
3.1.10. [RF010] Atualizao das Informaes Grficas ____________________________
3.1.11. [RF011] Apresentao dos Grficos _____________________________________

6
6
6
6
6
6
7
7
7
7
7
7

3.2. Requisitos No Funcionais __________________________________________

3.2.1.
[RNF001] Licena de software _________________________________________
3.2.2.
[RNF002] Framework para Programao ________________________________
3.2.3.
[RNF003] Framework para Criao de Grficos ___________________________
3.2.4.
[RNF004] Documentao de Cdigo Fonte _______________________________
3.2.5.
[RNF005] Ambiente de Programao ____________________________________
3.2.6.
[RNF006] Anlise de Cdigo Fonte______________________________________
3.2.7.
[RNF007] Integrao Contnua _________________________________________
3.2.8.
[RFN008] Controle de Verses e Repositrio de Arquivos ____________________
3.2.9.
[RFN009] Metodologia de Desenvolvimento _______________________________

8
8
8
8
8
8
8
8
9
9

Diagrama de Caso de Uso _________________________________________9

5. Caso de Uso ________________________________________________10

5.1.

[UC001] Importar Dados ________________________________________________ 10

5.2.

[UC002] Manter Mtricas _______________________________________________ 11

6. Matriz de Rastreabilidade ____________________________________13

6.1.

Requisitos x Casos de Uso__________________________________________________ 13

7. User Storie _________________________________________________14

Documento de Requisitos
1. Introduo

1.1.

Objetivo

Este documento tem por objetivo especificar os requisitos, apresentar os casos de uso e o
diagrama de caso de uso para o projeto denominado Dashboard de Viso Gerencial de
Projetos.

1.2.

Viso Geral do Documento

Este documento esta dividido em sees que apresenta separadamente a relao de

requisitos funcionais e no-funcionais, assim como os detalhamentos dos casos de uso e o
diagrama de caso de uso do projeto denominado Dashboard de Viso Gerencial de Projetos.
Estes sees em conjunto formam a base para a comunicao entre os Stakeholders e a
equipe de desenvolvimento a respeito do que o sistema deve fazer para satisfazer as
necessidades dos Stakeholders. A meta o entendimento dos requisitos em um alto nvel de
forma que o escopo inicial do trabalho possa ser determinado e descrever um ou mais
requisitos com detalhe suficiente para validar a compreenso do requisito, assegurando
concorrncia com as expectativas dos Stakeholders e permitir o incio do desenvolvimento do
software.

1.3.

Origem dos Dados para Elaborao dos Requisitos

Este documento foi elaborado com base em informaes contidas e disponibilizadas na

RFP (Request For Proposal), no Documento de Viso e atravs de Reunies contnuas com a
equipe e o cliente aps a avaliao do escopo do projeto.

2. Descrio Geral do Sistema

2.1.

Abrangncia e Sistemas Relacionados

O sistema Dashboard de Viso Gerencial de Projetos uma ferramenta de auxilio e

suporte ao gerenciamento de projetos de desenvolvimento de software. Fornece ao usurio
uma maneira intuitiva e eficiente de visualizar as mtricas de gerenciamento de um
determinado projeto de desenvolvimento de software atravs de apresentaes grficas destas
informaes.
Utilizando a ferramenta, o usurio em geral um gerente de projeto pode visualizar de
forma grfica as mtricas e medidas que deseje acompanhar referente a um determinado
projeto de desenvolvimento de software, tendo como base uma fonte de dados pr-definida e
externa ao sistema Dashboard de Viso Gerencial. O sistema visa ento facilitar a
visualizao e possibilitar um melhor acompanhamento destas mtricas e de seus respectivos
indicadores atravs de informaes em modo grfico. Alm disso, o sistema disponibilizar as
funes de criao de novas mtricas a partir das medidas importadas da fonte de dados,
podendo ainda alterar, remover e at personalizar a formas grficas das mtricas e medidas
que desejar acompanhar. A ferramenta conter um conector para importao de dados direto
para a ferramenta AgiliZen que fornecer os dados base para elaborao dos grficos a serem
apresentados. O AgileZen um aplicativo web, flexvel e de baixo custo para gerir projetos
de software inspirando em ideias de manufatura enxuta, hoje utilizado pela empresa RiSE
nossa cliente no projeto Dashboard de Viso Gerencial de Projetos - para auxiliar no
gerenciamento de projetos de desenvolvimento de software.
O Sistema Dashboard de Viso Gerencial de Projetos conter e disponibilizar uma API
(Application Programming Interface) para realizao de conexo de importaes de dados
com outras ferramentas que no a AgiliZen.

3. Requisitos

3.1.

Requisitos Funcionais

3.1.1. [RF001] Painel de Apresentao

O sistema dever disponibilizar ao usurio um ambiente grfico onde sejam
possvel a insero e a apresentao de forma personalizada, dos grficos das
mtricas e medias que lhe seja conveniente acompanhar referente a um
determinado projeto de desenvolvimento de software;

3.1.2.

[RF002] Cadastrar Mtricas

O sistema deve disponibilizar ao usurio a capacidade de cadastrar as mtricas

que lhe seja conveniente acompanhar mediante a juno de duas medidas
oriundas da importao dos dados da ferramenta externa.

3.1.3. [RF003] Pesquisa, Excluso e Alterao de Mtricas.

O sistema deve disponibilizar ao usurio a capacidade de alterar, excluir e
pesquisar as mtricas cadastradas referentes a um determinado projeto.

3.1.4. [RF004] Apresentar Mtricas e Medidas

O sistema deve disponibilizar ao usurio a capacidade de selecionar uma mtrica
ou media que lhe seja conveniente acompanhar para apresentao da mesma em
forma grfica em um painel na aplicao.

3.1.5. [RF005] Cadastrar Nvel de Criticidade

O sistema deve prover ao usurio a capacidade de cadastrar os nveis de criticidade
dos indicadores que lhe seja conveniente acompanhar, referente mtrica ou
medida especfica.

3.1.6. [RF006] Alterar, Excluir e Pesquisar Nveis de Criticidade

O sistema deve prover ao usurio a capacidade de alterar, excluir e pesquisar os
nveis de criticidade dos indicadores referentes s mtricas ou medidas de um
determinado projeto.

3.1.7. [RF007] Importar Dados do AgiliZen

O sistema dever possibilitar ao usurio a importao dos projetos e suas
respectivas medidas oriundas da ferramenta AgiliZen mediante acesso ao cadastro
na ferramenta externa.

3.1.8. [RF008] Personalizar Grfico

O sistema deve dispor ao usurio a capacidade de selecionar qual a forma grfica
que deseja apresentar as medidas e/ou mtricas juntamente com os seus
respectivos indicadores.

3.1.9. [RF009] Formas Grficas de Apresentao das Medidas e Mtricas

O sistema dever disponibilizar as seguintes formas grficas para apresentao
das medidas e mtricas: Coluna, Pizza, Linha, Barras, rea, Disperso, Aes,
Superfcie, Rosca, Bolhas e Roda.

3.1.10. [RF010] Atualizao das Informaes Grficas

O sistema dever disponibilizar ao usurio uma forma de atualiza os dados
apresentados nos grficos quando solicitado;

3.1.11. [RF011] Apresentao dos Grficos

O sistema dever disponibilizar ao usurio uma forma de ampliar e minimizar o
tamanho da apresentao grfica com o fim de facilitar a sua visualizao pelo
usurio;

3.2.

Requisitos No Funcionais

3.2.1. [RNF001] Licena de software

Os direitos associados ao sistema devem atender os termos de distribuio aos
usurios aplicando a Apache Licence V2.0.

3.2.2. [RNF002] Framework para Programao

O sistema dever ser desenvolvido utilizando a plataforma JAVA juntamente com o
framework GRAILS.

3.2.3. [RNF003] Framework para Criao de Grficos

Os grficos a serem apresentados no sistema devem ser gerados atravs do framework
Google Chart.

3.2.4. [RNF004] Documentao de Cdigo Fonte

A documentao do cdigo fonte deve ser gerada utilizando a ferramenta Javadoc.

3.2.5. [RNF005] Ambiente de Programao

O sistema dever ser desenvolvido fazendo uso da IDE Eclipse em computadores ou
notebooks com sistemas operacionais Windows ou Linux.

3.2.6. [RNF006] Anlise de Cdigo Fonte

Todo cdigo fonte antes de ser direcionado ao repositrio dever antes passar pela
anlise da ferramenta de gerenciamento de qualidade de cdigo denominada Sonar.

3.2.7.

[RNF007] Integrao Contnua

A integrao das partes desenvolvidas dever ser realizada atravs do uso da

ferramenta denominada Jenkins.

3.2.8. [RFN008] Controle de Verses e Repositrio de Arquivos

O sistema dever utilizar a ferramenta Google Code como repositrio de cdigo e de
arquivos, alm do uso desta para realizar o controle de verses das entregas.

3.2.9. [RFN009] Metodologia de Desenvolvimento

O sistema dever ser desenvolvido fazendo uso de metodologias geis de
desenvolvimento.

4. Diagrama de Caso de Uso

Diagrama UML Casos de Usos.

5. Caso de Uso

5.1.

[UC001] Importar Dados

Atores:
Usurio, Ferramentas Externas, AgileZen;
Pr-condies:

Possuir uma conta e os dados de acesso na ferramenta ao qual se deseja conectar para
importar os dados.

Fluxo Principal de Eventos

1. O usurio inicia o caso de uso;
Fluxo alternativo Atualizao de Dados
1.1. O Fluxo salta para a linha 10 do fluxo principal de eventos e segue ate o ltimo
passo do fluxo.
2. O sistema apresenta uma lista de ferramentas com o qual possvel conectar-se para
importao dos dados;
3. O usurio dever selecionar uma entre as ferramentas da lista;
4. O sistema solicita as demais informaes para realizao da conexo de importao
(dependendo da ferramenta poder solicitar informaes como: e-mail, senha, code e/ou
token);
5. O usurio dever informar as demais informaes necessrias para a importao dos
dados;
6. O sistema inicia a comunicao com a ferramenta e solicita os dados do ator Ferramentas
Externas/AgileZen;
7. Os dados so importados e uma mensagem apresentada sobre o sucesso da importao;
8. O sistema dever informar o nome da ferramenta ao qual se conectou e uma lista com os
projetos existentes nesta importao;
9. O usurio dever selecionar um entre os projetos listados;

10. O sistema importa os dados atualizados do projeto selecionado e persiste estas

informaes em um arquivo XML dentro da aplicao Dashboard;
11. O caso de uso finalizado.

5.2.

[UC002] Manter Mtricas

Atores:
Usurio;

Pr-condies:

Ter realizado o caso de uso Importar Dados;

Ter os dados das medidas de um determinado projeto persistidas em um arquivo

XML interno ao Dashbord de Viso Gerencial.

Fluxo Principal de Eventos:

1. O usurio inicia o caso de uso quando solicita uma das opes de Cadastrar uma nova
mtrica, Alterar, Excluir ou Pesquisar uma mtrica existente;

Subfluxo para Cadastrar Mtrica;

1. iniciado quando o usurio opta por cadastrar uma nova mtrica;
2. O sistema solicita o nome para a nova mtrica;
3. O usurio informa o nome para a mtrica;
4. O sistema disponibiliza uma lista com as medidas existentes daquele projeto para a
confeco de uma nova mtrica.
5. O usurio deve selecionar duas medias dentre as apresentadas;
6. O sistema gera a nova mtrica e persiste a mesma em um arquivo XML interno ao
Dashboard;

7. O sistema apresenta uma mensagem informando que o cadastro fora realizado com
sucesso e finaliza o subfluxo cadastro de mtricas.

Subfluxo - Alterar Mtrica;

1. iniciado quando o usurio opta pela opo Alterar uma Mtrica Existente;
2. O sistema apresenta uma lista com as mtricas cadastradas referentes a um determinado
projeto;
2.1. O usurio opta por solicitar a pesquisa da mtrica;
2.2. O sistema inicia o subfluxo pesquisar mtrica;
2.3. O sistema retorna a mtrica desejada e o caso de uso continua a partir da linha 4 do
subfluxo alterar mtricas;
3. O usurio deve escolher uma dentre as que foram listadas para realizar as alteraes;
4.

O sistema disponibiliza ao usurio a edio das medidas com a apresentao de uma lista
com as medidas cadastrada no sistema para um determinado projeto, assim com a
possibilidade de alterao do nome da mtrica;

5. O usurio realiza as devidas alteraes e informara a confirmao das alteraes;

6. O sistema atualizar o arquivo XML referente com os dados alterados e finaliza o
subfluxo alterar mtricas.

Subfluxo - Pesquisar Mtrica;

1. iniciado quando o usurio opta por pesquisar uma mtrica existente;
2. O sistema solicita o nome da mtrica que deseja ser localizada;
3. O usurio informa o nome da mtrica desejada;
4. O sistema realiza a busca no arquivo XML referente ao projeto e apresenta uma lista com
as mtricas com nomes similares ao informado;
5. O usurio deve escolher entre uma destas mtricas ou redigitar o nome da mtrica para

realizao de uma nova busca no XML;

6. O sistema retorna a mtrica selecionada;

Subfluxo - Excluir Mtrica;

1. iniciado quando o usurio opta por Excluir uma Mtrica Existente;
2. O sistema apresenta uma lista com as mtricas cadastradas referentes a um determinado
projeto;
2.1. O usurio opta por solicitar a pesquisa da mtrica;
2.2. O sistema inicia o subfluxo pesquisar mtrica;
2.3. O sistema retorna a mtrica desejada e o caso de uso continua a partir da linha 4 do
subfluxo excluir mtricas;
3. O usurio deve escolher uma dentre as que foram listadas para realizar a excluso;
4. O usurio confirma a excluso da mtrica;
4.1. O usurio opta por no excluir a mtrica;
4.2. O sistema finaliza o subfluxo excluir mtrica;
5. O sistema exclui o registro da mtrica no arquivo XML de um determinado projeto e
finaliza o subfluxo excluir mtricas.

6. Matriz de Rastreabilidade
6.1.

Requisitos x Casos de Uso

Requisitos
Casos de Uso

RF01

RF02

RF03

RF04

RF05

RF06

RF07 RF08 RF09

UC003
UC004

RF11

UC001
UC002

RF10

X
X

X
X

7. User Storie

Nome

Tipo

Descrio

Criador

Implementar a API de
conexo com o AgileZen.

User
Story

Com um usurio padro eu quero realizar o

cadastro de uma conta do AgileZen e
visualizar os projetos que so
disponibilizados referente a conta cadastrada.

Eduardo
Cruz

Permitir que um usurio

cadastre o seu projeto do
AgileZen para extrao
de dados.

User
Story

Com um usurio padro eu quero realizar o

cadastro de um projeto do AgileZen e
visualizar as informaes que so
disponibilizadas referente ao projeto
cadastrada.

Eduardo
Cruz

Listar um grafico de
barra com a quantidade
de tarefas de um projeto

User
Story

Com um usurio padro eu quero listar um

grfico de barras representando a mtrica
referente a medida de quantidade de tarefas
de um projeto.

Eduardo
Cruz

Grfico de Tarefas por

status

User
Story

Com um usurio padro eu quero listar um

grfico de linhas representando a mtrica
referente as medidas de tarefas por status de
um projeto.

Eduardo
Cruz

Apresentar mtricas de
performance do AgileZen

User
Story

Eduardo
Cruz

Criar a Interface Grfica

do Dashboard

User
Story

Com um usurio padro eu quero poder

navegar, ativar, desativar e escolher as
funcionalidades do sistema Dashboard de
forma grfica e interativa com o mouse.

Eduardo
Cruz

Quantificar esforo de
todas as histrias

User
Story

Eduardo
Cruz

Nvel de criticidade

User
Story

Quero que o sistema apresente um alerta

quando uma mtrica ultrapassar um valor prdefinido de nvel de criticidade e que o usurio
padro possa determinar este nvel para cada
mtrica existente.

Eduardo
Cruz