Universidade Espsanto

Documento de Especificação de Requisitos

1. Introdução O Laboratório de Engenharia de Software (LabES) da Universidade Federal do Espírito Santo deseja desenvolver um portal para melhor interagir com o público interessado na área de pesquisa de Engenharia de Software. Dessa forma, este projeto propõe-se a desenvolver uma etapa inicial desse portal, com serviços para controlar usuários e o nível de interação dos mesmos com as funcionalidades providas pelo sistema, bem como um conjunto básico de serviços provendo informações sobre os projetos em curso no LabES, publicações e materiais disponíveis. Além disso, será dada a oportunidade de organizações colocarem ofertas de trabalho no Portal do LabES Dentre os projetos do LabES, destaca-se o Projeto ODE, que visa à construção de um ambiente de desenvolvimento de software. Está em curso uma iniciativa de disponibilizar esse ambiente como software livre. Assim, ainda que não seja objeto deste projeto, algumas considerações foram feitas visando a facilitar o posterior desenvolvimento do Portal do ODE Livre.

2. Descrição do Mini-mundo Para prover uma maior interação com a comunidade, o LabES resolveu desenvolver o seu próprio Portal de Engenharia de Software, o Portal LabES, para disponibilizar informações e materiais desenvolvidos nessa área de estudos. Nesse portal estarão disponíveis informações estáticas e dinâmicas. As estáticas apresentarão um histórico do laboratório e do projeto ODE, que visa à construção de um ambiente de desenvolvimento de software. Já as dinâmicas disponibilizarão itens, incluindo informações sobre projetos, publicações e materiais. Esses dois últimos itens podem ou não estar associados a um projeto, que, por sua vez, pode possuir vários materiais e publicações. Um projeto também pode possuir sub-projetos. Um item está associado a uma ou mais áreas de interesse de pesquisa, que pode possuir sub-áreas. Uma publicação pode ser de vários tipos, incluindo: projeto de graduação, tese de mestrado, dissertação de doutorado, livro ou capítulo de livro, artigo publicado em evento e artigo publicado em periódico. Um capítulo de livro está sempre associado a um livro, que, por sua vez, está associado a uma editora. Um artigo em evento está sempre associado a um evento. Há, ainda, a necessidade de se definir um serviço de busca de itens. Por fim, ofertas de trabalho serão disponibilizadas por organizações no portal.

3. Modelo de Casos de Uso O gerenciamento e o acesso ao Portal do LabES serão feitos de acordo com o tipo de usuário. Para tal, os usuários são agrupados nas seguintes categorias: Internauta, 1

Usuário Padrão, Membro LabES, Colaborador, Professor e Administrador, como mostrado na Figura 1.

Figura 1 - Tipos de Usuários

Os tipos de usuários estão dispostos segundo as suas funcionalidades da seguinte forma: •

•

•

Internauta: representa qualquer pessoa que esteja navegando na Internet. Esse tipo de usuário pode se cadastrar como um Usuário Padrão, tem acesso às funcionalidades de visualização de qualquer material ou informação disponível, pode efetuar download de publicações e materiais e pode utilizar o mecanismo de busca do portal; Usuário Padrão: representa usuários cadastrados no LabES. Esse tipo de usuário poderá alterar seus dados e sua senha e terá de se autenticar no sistema para ter acesso às funcionalidades específicas dessa classe de usuário. Apenas usuários padrão poderão futuramente fazer o download do ambiente ODE. Além disso, poderão relatar falhas do ambiente e propor novas funcionalidades para o mesmo; Colaborador: representa um Usuário Padrão que se dispôs a colaborar com o Projeto ODE Livre, corrigindo alguma falha ou desenvolvendo uma nova funcionalidade para o ambiente; 2

• •

•

Membro LabES: agrupa todos os usuários que atuam dentro do laboratório. Esse tipo de usuário pode consultar os dados de qualquer outro membro do LabES e pode registrar materiais a serem disponibilizados no portal; Professor: representa os professores associados ao LabES. Esse tipo de usuário pode disponibilizar publicações e projetos, cadastrar áreas de pesquisa, além de poder consultar os dados dos membros do LabES e registrar materiais, como qualquer membro do LabES; Administrador: representa os administradores do sistema, que têm permissão para cadastrar novas funcionalidades, tipo de usuário, membros do LabES, professores e outros administradores. De fato, um administrador tem acesso a todas as funcionalidades do sistema.

Deve-se observar que essa descrição é uma contextualização do sistema e, portanto, os dados de cada um dos tipos de usuários a serem cadastrados são apresentados nas descrições dos casos de uso apresentados na próxima seção. A figura 2 mostra o diagrama de pacotes do sistema, subdividindo-o em dois subsistemas, a saber: •

Controle de Usuário: envolve toda a funcionalidade relacionada com o controle de usuários do Portal LabES, abrangendo controle de funcionalidades, tipos de usuários e usuários.

•

Controle de Itens: disponibiliza todas as funcionalidades do sistema aos seus usuários, abrangendo todo o controle de publicação, material, projeto e área.

•

Controle de Ofertas de Trabalho: envolve a funcionalidade relacionada com as ofertas de trabalho disponibilizadas no Portal por organizações parceiras.

Controle de Ofertas de Trabalho

Controle de Usuário

Controle de Itens

Figura 2 - Diagrama de Pacotes

3.1 – Pacote Controle de Usuário A figura 3 mostra o diagrama de caso de uso referente ao controle de usuários. Na seqüência, os casos de usos identificados são descritos usando o padrão proposto.

3

Cadastrar Funcionalidade

Administrador (from Use Case View)

Cadastrar Tipo Usuário

Membro LabES (from Use Case View)

Cadastrar Usuário

Internauta (from Use Case View)

Autenticar Usuário

Usuário Padrão

Cadastrar Área

(from Use Case View)

Figura 3 - Casos de Uso do Pacote Controle Usuário.

4

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Usuário Nome do Caso de Uso: Cadastrar Funcionalidade Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de funcionalidades, abrangendo a criação de uma nova funcionalidade, alteração, consulta e exclusão de funcionalidades existentes.

Caso de Uso Cadastrar Funcionalidade

Criar X

Alterar

Consultar

Excluir

X

X

X

Classes: Funcionalidade e TipoUsuario.

5

Observações Informar nome, descrição e tipos de usuários que podem ter acesso.

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Usuário Nome do Caso de Uso: Cadastrar Tipo Usuário Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de tipos de usuário, abrangendo a criação de um novo tipo de usuário, alteração, consulta e exclusão de tipos de usuário existentes.

Caso de Uso Cadastrar Tipo Usuário

Criar X

Alterar

Consultar

Excluir

Observações Informar nome e descrição

X

X X

Classes: TipoUsuario.

6

Não é permitida a exclusão de um tipo de usuário que tenha funcionalidades ou usuários associados a ele

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Usuário Nome do Caso de Uso: Cadastrar Área Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de áreas de interesse, abrangendo a criação de uma nova área, alteração, consulta e exclusão de áreas existentes.

Caso de Uso Cadastrar Área

Criar X

Alterar

Consultar

Excluir

Observações Informar nome, descrição e área da qual faz parte, quando pertinente.

X

X X

Classes: Área.

7

Não é permitida a exclusão de uma área que tenha usuários ou itens associados, ou que uma sub-área sua tenha. Ao excluir uma área, suas subáreas devem ser excluídas.

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Usuário Nome do Caso de Uso: Cadastrar Usuário Analistas: Geovando Carpanêdo Fiório, Julierme Leirosa da Silva e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de usuário, abrangendo a criação de um novo membro do LabES pelo Administrador ou de um usuário padrão pelo Internauta, consulta, alteração e exclusão de usuários existentes.

Caso de Uso

Cadastrar Usuário

Criar

Alterar

Consultar

Excluir

Observações Informar nome (ob), data de nascimento, sexo, escolaridade, instituição à qual está vinculado, áreas de interesse (ob), atuação profissional, email (ob), login (ob), senha (ob), endereço e telefone contato. Usuário é ativado. Se ação estiver sendo realizada pelo administrador, deve-se informar o tipo do usuário, senão o usuário cadastrado será um usuário padrão.

Internauta / Administrador

Usuário Padrão

Membro LabES

Classes:.Usuario, Area e TipoUsuario.

8

Administrador

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Usuário Nome do Caso de Uso: Autenticar Usuário Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pela autenticação do usuário no sistema, abrangendo a efetuação de login, logout e envio de senha. Curso Normal: Efetuar Login O usuário padrão informa seu login e sua senha. Verifica-se se o login existe. Caso exista, verifica-se se a senha corresponde ao login informado. Caso corresponda, o login é efetuado e o usuário tem acesso às funcionalidades do sistema que são específicas para seu tipo de usuário. Efetuar Logout O usuário padrão efetua o logout não tendo mais acesso às funcionalidades do sistema que são específicas para seu tipo de usuário. Enviar Senha O usuário padrão informa seu login e solicita o envio de senha. Caso o login exista, a senha é enviada para o email do usuário que possui o login informado.

Cursos Alternativos: Efetuar Login ! Caso o login não exista no sistema ou a senha não corresponda ao login informado, uma mensagem de erro é exibida. Enviar Senha ! Caso o login não exista, uma mensagem de erro é exibida. Classes:.Usuario.

9

3.2 Pacote Controle de Itens A figura 4 mostra o diagrama de casos de uso referente ao pacote Controle de Itens. Na seqüência, os casos de uso identificados são descritos usando o padrão de descrição proposto.

<<extend>>

Cadastrar Editora

Professor (from Use Case View)

<<extend>>

Cadastrar Publicação

Cadastrar Periódico

<>

Cadastrar Projeto

Membro LabES (from Use Case View) <<extend>>

Cadastrar Evento

Cadastrar Edição de Evento

Consultar Caledário de Eventos

Consultar Item

Cadastrar Material

<>

Internauta

Efetuar Busca de Itens

(from Use Case View)

Figura 4 – Diagrama de Casos de Uso do Pacote Controle Itens.

10

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Material Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de materiais, abrangendo a criação de um novo material, alteração, consulta e exclusão de materiais existentes.

Caso de Uso Cadastrar Material

Criar X

Alterar

Consultar

X

Excluir

X

X Classes:

11

Observações Informar título, resumo, autores, data em que foi disponibilizado, áreas de interesse, responsável pelo material, arquivo e projeto, se pertinente. Os dados de um material só podem ser alterados ou excluídos pelo seu responsável ou por um administrador.

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Projeto Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de projetos, abrangendo a criação de um novo projeto, alteração, consulta e exclusão de projetos existentes.

Caso de Uso Cadastrar Projeto

Criar X

Alterar

Consultar

Excluir

Observações Informar título, resumo, data em que foi disponibilizado, áreas de interesse, professor responsável, professores colaboradores, alunos envolvidos e projeto do qual faz parte, quando for o caso. Os dados de um projeto só podem ser alterados ou pelo professor responsável ou um de seus integrantes.

X

X X

Classes:

12

Um projeto só pode ser excluído pelo seu professor responsável. Ao excluir um projeto, seus sub-projetos serão excluídos. Não é permitida a exclusão de um projeto que possua publicações ou materiais associados ou que um de seus sub-projetos possua.

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Publicação Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de publicações, abrangendo a criação de uma nova publicação, alteração e exclusão de publicações existentes.

Caso de Uso Cadastrar Publicação

Criar X

Alterar

Consultar

X

Excluir

X

Observações Informar título, resumo, data em que foi disponibilizado, responsável, áreas de interesse, projeto no âmbito do qual foi produzido, país, idioma, autores e arquivo. Indicar qual é o tipo da publicação e os demais dados de acordo com tipo indicado conforme abaixo. Os dados de uma publicação só podem ser alterados ou excluídos pelo seu responsável ou por um administrador.

X Informações adicionais: • Artigo publicado em evento: edição do evento, volume, fascículo, série, página inicial e página final. Caso a edição do evento não esteja cadastrada, a mesma pode ser cadastrada, realizando o caso de uso “Cadastrar Edição de Evento”. • Artigo publicado em periódico: volume, fascículo, série, página inicial, página final e periódico. Caso o periódico não esteja cadastrado, o mesmo pode ser cadastrado, realizando o caso de uso “Cadastrar Periódico” • Livro: número de volumes, número de páginas, ISBN, número de edição, número de série e editora. Caso a editora não esteja cadastrada, a mesma pode ser cadastrada, realizando o caso de uso “Cadastrar Editora”. • Capítulo de livro: livro, página inicial, página final, número do volume. Caso o livro não esteja cadastrado, o mesmo pode ser cadastrado, realizando o fluxo de eventos “Criar Nova Publicação” para o livro em questão. • Trabalho Acadêmico: número de páginas, instituição, curso, orientador, co-orientador e tipo (monografia de conclusão de curso de graduação, monografia de conclusão de curso de pós-graduação em nível de especialização, dissertação de mestrado ou tese de doutorado). Classes:

13

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Editora Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de editoras, abrangendo a criação de uma nova editora, alteração, consulta e exclusão de editoras existentes.

Caso de Uso Cadastrar Editora

Criar X

Alterar

Consultar

Excluir

Observações Informar nome e cidade.

X

X X

Classes:

14

Não é permitida a exclusão de uma editora que tenha um livro associado.

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Periódico Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de periódicos, abrangendo a criação de um novo periódico, alteração, consulta e exclusão de periódicos existentes.

Caso de Uso Cadastrar Periódico

Criar X

Alterar

Consultar

Excluir

Observações Informar título, ISSN e local de publicação.

X

X X

Classes:

15

Não é permitida a exclusão de um periódico que tenha um artigo associado.

Descrição de Caso de Uso

UFES Projeto: Portal LabES

Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Edição de Evento Analistas: Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de edições de eventos, abrangendo a criação de uma nova edição de evento, alteração, consulta e exclusão de edições de evento existentes. Curso Normal:

Caso de Uso Cadastrar Edição de Evento

Criar X

Alterar

Consultar

Excluir

Observações Informar evento, ano e período de realização, cidade, país, endereço eletrônico do sítio do evento, prazo para submissão de trabalhos, ISBN dos anais, título dos anais e classificação Qualis da edição do evento.

X

X X

Classes:

16

Não é permitida a exclusão de uma edição de evento que tenha uma publicação associada.

Descrição de Caso de Uso

UFES Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Evento Analistas: Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pelo controle de eventos, abrangendo a criação de um novo evento, alteração, consulta e exclusão de eventos existentes.

Caso de Uso Cadastrar Evento

Criar X

Alterar

Consultar

Excluir

Observações Informar nome, sigla, descrição, classificação (Internacional, Nacional, Regional e Local), classificação Qualis atual e áreas de interesse.

X

X X

Classes:

17

Não é permitida a exclusão de um evento que tenha uma edição associada.

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Consultar Calendário de Eventos Analistas: Ricardo de Almeida Falbo Data: 27/04/2006

Descrição: Este caso de uso permite que o Internauta consulte o calendário de eventos cujas edições estão cadastradas no LabES. Curso Normal: Os seguintes dados das edições de eventos cadastradas no portal são apresentados por ordem de ano, incluindo também os dados do evento correspondente: nome do evento, sigla, período, cidade, país, sítio eletrônico e prazo de submissão. Detalhes poderão ser visto, apresentando-se as seguintes informações adicionais: descrição do evento, classificação, classificação no Qualis (usar a atual do evento, se não houver uma classificação definida pela a edição), título dos Anais e isbn dos Anais. Classes:

18

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Efetuar Busca de Itens Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso é responsável pela busca de itens (materiais, publicações e projetos) no portal. Curso Normal: O Internauta informa áreas e/ou um conjunto de palavras para busca de itens e os tipos de item (projeto, material, publicação, todos) que deseja consultar. É apresentada uma lista com os títulos dos itens encontrados que estão classificados nas áreas informadas e que têm alguma das palavras informadas em seu resumo. Os itens são apresentados por tipo de item. Caso deseje, o internauta poderá consultar algum item, realizando o caso de uso “Consultar Item”. Classes:

19

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Itens Nome do Caso de Uso: Consultar Item Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo Data: 25/04/2006

Descrição: Este caso de uso disponibiliza itens (projetos, materiais e publicações) para consulta. Curso Normal: Consultar Projeto O internauta seleciona um projeto e são mostrados os seguintes dados do mesmo: título, resumo, áreas, data em que foi disponibilizado, situação atual, professor responsável, professores colaboradores, alunos envolvidos e sub-projetos. Caso deseje, o internauta pode consultar sub-projetos, materiais e publicações do projeto selecionado. A consulta a subprojetos é feita da mesma forma que a consulta a projetos. Para consultar os materiais e publicações disponíveis para esse projeto, são realizadas as ações “Consultar Materiais” e “Consultar Publicações”, contudo, considerando apenas os itens relativos ao projeto em questão. Consultar Material O internauta seleciona um material e são mostrados os seguintes dados do mesmo: título, resumo, autores, data em que foi disponibilizado, áreas e um link para o arquivo do material. Caso deseje, ele pode abrir ou salvar o arquivo do material em seu computador. Consultar Publicação Uma lista com as publicações agrupadas por tipo (Artigo publicado em periódico, Artigo publicado em evento, Livro, Capítulo de Livro, Tese de Doutorado, Dissertação de Mestrado e Monografia de Conclusão de Curso) é apresentada, segundo as normas da ABNT. O internauta pode selecionar uma publicação para obter o arquivo da publicação ou detalhes da mesma, apresentando o resumo, a data de publicação e o arquivo. Classes:

20

3.3 Pacote Controle de Ofertas de Trabalho A figura 5 mostra o diagrama de casos de uso referente ao pacote Controle de Ofertas de Trabalho. Na seqüência, os casos de uso identificados são descritos usando o padrão de descrição proposto.

Cadastrar Oferta de Trabalho

Usuário Padrão

Cadastrar Organização

Administrador

Internauta

Consultar Oferta de Trabalho

Figura 5 – Diagrama de Casos de Uso do Pacote Controle de Ofertas de Trabalho.

21

Descrição de Caso de Uso

UFES Projeto: Portal LabES Sub-Sistema: Controle de Ofertas de Trabalho Nome do Caso de Uso: Cadastrar Organização Analistas: Ricardo de Almeida Falbo Data: 27/04/2006

Descrição: Este caso de uso é responsável pelo cadastro de organizações parceiras do LabES, abrangendo a criação de uma nova organização, alteração, consulta e exclusão de organizações existentes.

Caso de Uso Cadastrar Organização

Criar Administrador

Alterar

Consultar

Excluir

Observações Informar nome, endereço, telefone e pessoa de contato (tem de ser um usuário padrão do Portal). Os dados de uma organização só podem ser alterados por um usuário padrão, se ele for a pessoa de contato dessa organização.

Administrador / Usuário Padrão Administrador Classes:

22

Administrador

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Ofertas de Trabalho Nome do Caso de Uso: Cadastrar Oferta de Trabalho Analistas: Ricardo de Almeida Falbo Data: 27/04/2006

Descrição: Este caso de uso é responsável pelo cadastro de organizações parceiras do LabES, abrangendo a criação de uma nova organização, alteração, consulta e exclusão de organizações existentes.

Caso de Uso Cadastrar Oferta de Trabalho

Criar X

Alterar

Consultar

Excluir

X

X

Classes:

23

Observações Informar organização, cargo, salário, número de vagas, carga horária semanal e áreas. A data da oferta é registrada. Apenas a pessoa de contato da organização poderá criar uma oferta de trabalho. Apenas a pessoa de contato da organização poderá alterar uma oferta de trabalho. Na alteração, podese informar se a vaga ofertada já foi preenchida. Apenas a pessoa de contato da organização poderá excluir uma oferta de trabalho.

Descrição de Caso de Uso

UFES

Projeto: Portal LabES Sub-Sistema: Controle de Ofertas de Trabalho Nome do Caso de Uso: Consultar Ofertas de Trabalho Analistas: Ricardo de Almeida Falbo Data: 27/04/2006

Descrição: Este caso de uso permite que um internauta consulte ofertas de trabalho ainda não atendidas. Curso Normal: O internauta seleciona uma ou mais áreas e as ofertas de trabalho ainda não atendidas são exibidas, ordenadas pela data de registro. São apresentados, também, dados sobre as organizações que estão oferecendo as vagas e nome e email das pessoas de contato. Caso o internauta não informe uma área, todas as ofertas de trabalho não atendidas são apresentadas. Classes:

24