Ensinar.

org
Documento de Requisitos
Verso 1.0

Equipe:

Eduardo Mazza Batista (emb@cin.ufpe.br) Ivanildo Jos de Sousa Aquino Jnior (ijsaj@cin.ufpe.br) Milton Burgos Josu Neto (mbjn@cin.ufpe.br) Tiago Marafante Lins de Souza (tmls@cin.ufpe.br)

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Histrico de Revises
Autor Ensinar.org Ensinar.org Ensinar.org

Verso: 1.0 Data: 14/06/2004

Data 07/06/2004 11/06/2004 14/06/2004

Verso 0.1 0.2 1.0

Descrio Verso inicial do documento Reviso do documento Definio da Verso Final

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

ndice ENSINAR.ORG .................................................................................................1 ENSINAR.ORG.................................................................................................4 1 INTRODUO............................................................................................4 1.1 PROPSITO DO DOCUMENTO DE REQUISITOS..............................................................4 1.2 ESCOPO DO PRODUTO....................................................................................4 1.3 CONCEPO DO SISTEMA.................................................................................4 1.4 CONVENES, TERMOS E ABREVIAES...................................................................4 1.4.1 Identificao dos Requisitos...............................................................4 1.4.2 Prioridade dos Requisitos...................................................................4 1.5 REFERNCIAS.............................................................................................5 1.6 VISO GERAL............................................................................................5 2 DESCRIO GERAL....................................................................................6 2.1 USURIOS DO SISTEMA...................................................................................6 ADMINISTRADORES: RESPONSVEIS PELO GERENCIAMENTO DAS ENTIDADES PERTINENTES INSTITUIO E PELA ALOCAO DE OUTROS ADMINISTRADORES;.....................................................................6 COORDENADORES: RESPONSVEIS PELA APROVAO DE DISCIPLINAS, TURMAS E MATRCULAS REALIZADAS PELA SECRETARIA DO CURSO, ALM DE SER RESPONSVEL PELA ALOCAO DA SECRETARIA...........................6 SECRETARIA: RESPONSVEIS PELO CADASTRAMENTO DE DISCIPLINAS E TURMAS, PELA ALOCAO DE PROFESSORES E MONITORES DE UM CURSO E MATRCULAS DOS ALUNOS........................................6 PROFESSORES: RESPONSVEIS PELA CRIAO DO PROGRAMA DA DISCIPLINA ATRAVS DE FERRAMENTAS DE PLANEJAMENTO E CRIAO DE ATIVIDADES......................................................................6 ALUNOS: SEGUEM O PROGRAMA DA DISCIPLINA CRIADA PELO PROFESSOR, TENDO COMO APOIO FERRAMENTAS DE COMUNICAO, TAL COMO: CHAT E FRUM................................................................6 2.2 ABRANGNCIA E SISTEMAS SIMILARES....................................................................6 SISTEMAS SIMILARES: .......................................................................................6 2.3 SUPOSIES E DEPENDNCIAS............................................................................7 3 REQUISITOS DO SOFTWARE......................................................................8 3.1 REQUISITOS NO-FUNCIONAIS...........................................................................8 3.1.1 Requisitos de Segurana...................................................................8 3.1.2 Requisitos de Interface......................................................................8 3.1.3 Requisitos de Operacionais................................................................8 3.1.4 Requisitos de Confiabilidade...............................................................8 4 CASOS DE USO..........................................................................................9 4.1 DIAGRAMA DE CASOS DE USO............................................................................9 4.1.1 Relacionamentos dos usurios............................................................9 4.1.2 Usurio...........................................................................................9 4.1.3 Administrador................................................................................10 4.1.4 Coordenador..................................................................................10 4.1.5 Secretaria......................................................................................10 4.1.6 Professor.......................................................................................11 4.1.7 Monitor.........................................................................................11 4.1.8 Aluno............................................................................................12 4.2 DESCRIO DOS CASOS DE USO........................................................................12 4.2.1 Enviar Mensagem...........................................................................12 4.2.2 Manter Aula...................................................................................13

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

Ensinar.org
_______________________________________________________________________________________________________________________________________________________________________________________________________

Documento de Requisitos
_______________________________________________________________________________________________________________________________________________________________________________________________________

1
1.1

Introduo
Propsito do documento de requisitos

Este documento destina-se aos clientes, engenheiros e gerentes envolvidos no desenvolvimento do sistema, doravante referido apenas como Ensinar.org. O propsito deste documento apresentar a descrio dos servios e funes que o sistema a ser desenvolvido deve prover, bem como as suas restries de operao e propriedades gerais, a fim de ilustrar uma descrio detalhada do sistema para um auxlio durante as etapas de anlise, projeto e testes. O documento especifica todos os requisitos funcionais e no funcionais do sistema e foi preparado levando-se em conta as funcionalidades levantadas durante a fase de concepo do sistema.

1.2

Escopo do produto

O projeto consiste na construo de uma ferramenta para gerenciamento de aprendizado (Learning Management System - LMS), que possa atender os requisitos da Universidade Federal de Pernambuco no fator de educao distncia. O projeto visa auxiliar o sistema de ensino atravs de ferramentas sncronas e assncronas que sero usadas por funcionrios e alunos da instituio de ensino. No fazem parte do escopo do projeto: Instalao e configurao do ambiente tecnolgico do cliente. Treinamento de instalao, configurao, administrao e utilizao do sistema; Integrao com quaisquer sistemas ou base de dados do ambiente tecnolgico do cliente;

1.3

Concepo do sistema Consulta com especialista: - Gustavo, coordenador de ps-graduao do curso de Cincias Contbeis da Universidade Federal de Pernambuco orientou na concepo do sistema devido sua experincia em trabalhar em cursos semi-presenciais e ser um dos consultores do Virtus; - Alex Sandro Gomes, professor do Centro de Informtica da Universidade Federal de Pernambuco orientou na anlise de requisitos devido a sua grande experincia em desenvolvimento de software educativo; - Silvio Zanchetti, coordenador do curso on-line ITUC/AL, foi outro entrevistado; - Manasses dos Santos Silva, responsvel pelo treinamento dos funcionrios do laboratrio HEXAL BRASIL.

Foram usados dois mtodos para que pudessem ser obtidos os requisitos do sistema:

1.4

Convenes, termos e abreviaes

Para evitar interpretaes incorretas deste documento, algumas convenes e termos especficos so descritos a seguir: 1.4.1 Identificao dos Requisitos

Cada requisito ser unicamente identificado no formato [tipoRequisito.numero]. Para requisitos funcionais, o cdigo do tipo de requisito ser RF, e para requisitos no funcionais, RNF. Um nmero ser assinalado a cada requisito de forma incremental, na ordem que forem mencionados neste documento. 1.4.2 Prioridade dos Requisitos

Foram adotadas as seguintes denominaes para estabelecer a prioridade dos requisitos: essencial, importante e desejvel.

Essencial: o requisito sem o qual o sistema no entra em funcionamento, ou seja, so requisitos imprescindveis tendo que ser implementados impreterivelmente. Importante: o requisito sem o qual o sistema entra em funcionamento, mas de maneira insatisfatria, ou seja, devem ser implementados, mas se no forem, o sistema poder ser implantado e usado mesmo assim.

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

Desejvel: o requisito que no compromete as funcionalidades bsicas do sistema, podendo funcionar de forma satisfatria sem ele, ou seja, so requisitos que podem ser deixados para verses posteriores do sistema, caso no haja tempo hbil para implement-los na verso que est sendo especificada. Referncias

1.5

Esta subseo apresenta as referncias aos documentos que utilizamos no auxlio construo deste documento de requisitos.

Peridicos da CAPES - http://www.periodicos.capes.gov.br/ Referncias da Disciplina Engenharia de Software Educativo http://www.cin.ufpe.br/~asg/nova_pagina_1.htm Pgina da Disciplina Especificao de Requisitos e Validao de Sistemashttp://www.cin.ufpe.br/~if716/

1.6

Viso Geral A seo 1 apresentou uma introduo ao documento de requisitos e ao sistema sendo especificado; A seo 2 apresenta uma descrio geral do sistema; A seo 3 apresenta as definies dos requisitos funcionais e no-funcionais do sistema; A seo 4 apresenta o diagrama de casos de uso do sistema, bem como as descries dos casos de uso definidos;

Este documento est organizado da seguinte forma:

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

2
2.1

Descrio geral
Usurios do sistema

Usurio: realizam as tarefas comuns a todos os usurios, tal como: logar e enviar mensagens. Todos demais usurios estendem as funcionalidades de Usurio; Administradores: responsveis pelo gerenciamento das entidades pertinentes instituio e pela alocao de outros administradores; Coordenadores: responsveis pela aprovao de disciplinas, turmas e matrculas realizadas pela secretaria do curso, alm de ser responsvel pela alocao da secretaria. Secretaria: responsveis pelo cadastramento de disciplinas e turmas, pela alocao de professores e monitores de um curso e matrculas dos alunos. Professores: responsveis pela criao do programa da disciplina atravs de ferramentas de planejamento e criao de atividades. Alunos: seguem o programa da disciplina criada pelo professor, tendo como apoio ferramentas de comunicao, tal como: chat e frum. 2.2 Abrangncia e sistemas similares

Abrangncia: O sistema ir conter ferramentas para construo de um plano de aulas que esteja de acordo com os objetivos e metodologia de uma turma ministrada pelo professor. O professor atravs de ferramentas (como Chat, Frum, Base de Documentos) ir montar o programa desta disciplina que dever ser seguido pelo aluno usurio do sistema. O professor ter a liberdade de crias atividades (textos e questionrios) e determinar prazos a serem cumpridos pelos alunos. Sero armazenadas as resolues dos alunos para serem corrigidas pelo professor posteriormente, gerando estatsticas do desempenho de cada aluno e da turma. O sistema tambm ir prover o gerenciamento das entidades que compem a instituio e os usurios do sistema. Dentre as ferramentas de comunicao do sistema existiro as assncronas, como Chat, onde podero ser feitas reunies, discusses, explicaes conjuntas ou qualquer outra atividade de comunicao. O Frum consiste na ferramenta sncrona usada para os mesmo fins do Chat. Das ferramentas de planejamento podemos citar: Avaliaes e Exerccios - sero criadas tarefas a serem entregues pelos alunos nos determinados prazos; Anncios - espao para criao de avisos e informes aos alunos de uma determinada turma; Manipulao de Arquivos - haver um diretrio onde podem ser acumulados arquivos de diversos tipos pelos usurios; Planejamento de Aulas - planejamento de uma aula estruturada com leituras e exerccios. Sistemas similares: No cenrio atual da universidade se encontra um sistema que responsvel por realizar tal tarefa, denominado Virtus, porm o sistema no atende todas as necessidades, no sendo considerado satisfatrio pela maioria dos usurios. No cenrio nacional encontram-se trs sistemas que se destacam: AulaNet - um ambiente de software baseado na Web, desenvolvido no Laboratrio de Engenharia de Software - LES - do Departamento de Informtica da PUC-Rio, para administrao, criao, manuteno e participao em cursos distncia. WebAula - um produto formado por solues integradas de gerenciamento de aprendizagem, conhecimento e contedos on-line, resultado de uma joint venture entre as empresas Zargon e Poliedro. TelEduc - um ambiente para a criao, participao e administrao de cursos na Web. Ele foi concebido tendo como alvo o processo de formao de professores para informtica educativa, baseado na metodologia de formao contextualizada desenvolvida por pesquisadores do Nied (Ncleo de Informtica Aplicada Educao) da Unicamp.

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

No cenrio internacional os sistemas de maior porte so: WebCT - O WebCT um programa que possibilita a criao de ambientes educacionais na Internet, desenvolvido pela University of British Columbia - Canad. Ele permite a colocao do contedo de um curso na Internet pelo professor e, em seguida, o cadastro os alunos que participaro daquele curso. O objetivo principal possibilitar a interao entre tais sujeitos atravs de ferramentas de trabalho em grupo, tais como: fruns de discusso, chat, palestras on-line, alm de facilitar a comunicao professoraluno, atravs da publicao de notas e gabaritos de avaliaes. Blackboard - um sistema de autoria extremamente amigvel, desenvolvido para ser utilizado por educadores e profissionais interessados em aplicar as novas tecnologias interativas da rede na educao, contribuindo para a metodologia de ensino presencial e potencializando o processo de ensino e aprendizagem a distncia. 2.3 Suposies e dependncias O cliente est responsvel pela aquisio de infra-estrutura necessria em seu ambiente de produo; O cliente ser responsvel pela disponibilizao de recursos de hardware, software, e outros requerimentos destinados implantao do sistema desenvolvido.

As seguintes suposies so vlidas no decorrer do desenvolvimento do sistema sendo especificado:

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

3
3.1

Requisitos do Software
Requisitos No-funcionais

Os requisitos que descrevem os aspectos no-funcionais do sistema so apresentados a seguir: 3.1.1

Ident. RNF/SEG-01

Requisitos de Segurana
Descrio O usurio autorizado dever efetuar logon no sistema para poder realizar as operaes de manuteno de cadastros de usurios autorizados e documentos. Casos de uso relacionados Todos menos [CDU-01], [CDU32] e [CDU-33]

3.1.2
Ident.

Requisitos de Interface
Descrio O sistema deve ter uma interface de fcil utilizao. Casos de uso relacionados

RNF/INT-01

3.1.3
Ident.

Requisitos de Operacionais
Descrio O sistema deve ser desenvolvido em C#. O sistema deve ser desenvolvido em uma arquitetura em camadas. A camada de aplicao para web compatvel com browsers de mercado (Internet Explorer, Netscape). Casos de uso relacionados

RNF/OPE-01 RNF/OPE-02 RNF/OPE-03

3.1.4
Ident.

Requisitos de Confiabilidade
Descrio O sistema deve estar disponvel 24 horas por dia durante os 7 dias da semana. Por no se tratar de um sistema crtico, o sistema poder ficar fora do ar at que seja corrigida alguma falha que possa ocorrer. Casos de uso relacionados

RNF/CON-01

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

4
4.1

Casos de uso
Diagrama de casos de uso

O diagrama de casos de uso, expresso em UML (Unified Modeling Language), expressa os requisitos funcionais do sistema na forma de casos de uso. Segundo o RUP (Rational Unified Process), para cada requisito funcional tem-se um caso de uso. A descrio textual detalhada dos requisitos funcionais, seus fluxos de atividades e requisitos no funcionais associados pode ser encontrada na prxima seo. Na figura abaixo mostramos a representao grfica em UML dos casos de uso do sistema.

4.1.1

Relacionamentos dos usurios

Admi nistrador
(from Actors)

Usurio Cadastrado
(from Actors)

Profes sor
(from Actors)

Coordenador
(from Actors)

Annimo
(from Actors)

Monitor
(from Actors)

Secretaria
(from Actors)

Aluno
(from Actors)

4.1.2

Usurio

Enviar Mensagem

Editar Perfil

Sair Us urio Cadastrado

Consultar Ajuda

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

4.1.3

Administrador

Manter Institui o Manter Curs o

Manter Departamento Administrador Alocar administrador Manter Centro

4.1.4

Coordenador

Aprovao de Disciplina

Alocar Secretaria

Aprovao de Turma

Coordenador

Aprovao de Matrcula

4.1.5

Secretaria

Matricular Aluno

Manter Disciplina

Alocar Professor

Manter Turma

Secretaria

Alocar Monitor

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

4.1.6

Professor

Planejar

Manter Documento

Manter Calendrio Professor

Manter Avaliao

Manter Anncio

Manter Aula

4.1.7

Monitor

Planejar
(from Professor)

Manter Aula
(from Professor)

Ma nter Cal end rio

(from Professor)

Monitor Manter Documento

(from Professor)

Manter Anncio
(from Professor)

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

4.1.8

Aluno

Realizar Avaliao Consultar Planejamento Consultar Documento

Consu ltar Anncio Comentar Aula

Consultar Calendrio

Aluno Comentar Documento

Consultar Aula Consultar Resultado Avaliao

4.2

Descrio dos casos de uso

Dentre os casos de uso do sistema mostrados no diagrama de casos de uso, foram escolhidos cinco para serem detalhados e trabalhados nas fases de anlise e projeto do sistema. 4.2.1 Enviar Mensagem

[CDU-01] Nome: Atores: Prioridade: Enviar Mensagem Usurio Cadastrado Essencial [RF-44] [RNF/SEG-01] Entradas e pr-condies: Sadas e ps-condies: Fluxos de eventos Fluxo principal: 1. 2. 3. 4. 5. O usurio efetua uma busca pelo nome do destinatrio. O sistema procura em sua base de dados usurios que contenham a palavra chave fornecida. O usurio seleciona itens do resultado. O usurio preenche o assunto e o corpo da mensagem. O usurio envia a mensagem. O usurio deve estar logado no sistema. O destinatrio recebe a mensagem.

Requisitos associados:

Ensinar.org Documento de Requisitos Equipe: Eduardo Mazza, Ivanildo Aquino, Milton Burgos, Tiago Marafante.

Verso: 1.0 Data: 14/06/2004

4.2.2

Manter Aula

[CDU-01] Nome: Atores: Prioridade: Manter Aula Usurio Cadastrado Essencial [RF-44] [RNF/SEG-01] Entradas e pr-condies: Sadas e ps-condies: Fluxos de eventos Fluxo principal: 6. 7. 8. 9. O usurio efetua uma busca pelo nome do destinatrio. O sistema procura em sua base de dados usurios que contenham a palavra chave fornecida. O usurio seleciona itens do resultado. O usurio preenche o assunto e o corpo da mensagem. O usurio deve estar logado no sistema. O destinatrio recebe a mensagem.

Requisitos associados:

10. O usurio envia a mensagem.