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 Internauta (from Use Case View) Cadastrar Usuário Membro LabES (from Use Case View) Usuário Padrão (from Use Case View) Autenticar Usuário Cadastrar Área Figura 3 - Casos de Uso do Pacote Controle Usuário. 4
Sub-Sistema: Controle de Usuário Nome do Caso de Uso: Cadastrar Funcionalidade Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo 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. Cadastrar Funcionalidade Informar nome, descrição e tipos de usuários que podem ter acesso. Funcionalidade e TipoUsuario. 5
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 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. Cadastrar Tipo Usuário Informar nome e descrição Não é permitida a exclusão de um tipo de usuário que tenha funcionalidades ou usuários associados a ele TipoUsuario. 6
Sub-Sistema: Controle de Usuário Nome do Caso de Uso: Cadastrar Área Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo 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. Cadastrar Área Informar nome, descrição e área da qual faz parte, quando pertinente. 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. Área. 7
UFES 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 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. Usuário Padrão Membro LabES Cadastrar Internauta / Informar nome (ob), Usuário Administrador 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. Administrador.Usuario, Area e TipoUsuario. 8
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 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..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 <<include>> Membro LabES <<extend>> (from Use Case View) Cadastrar Evento Cadastrar Edição de Evento Consultar Caledário de Eventos Consultar Item Cadastrar Material <<include>> Internauta (from Use Case View) Efetuar Busca de Itens Figura 4 Diagrama de Casos de Uso do Pacote Controle Itens. 10
Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Material Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo 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. Cadastrar Informar título, resumo, Material 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. 11
Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Projeto Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo 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. Cadastrar Projeto 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. 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. 12
Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Publicação Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo 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. Cadastrar Informar título, resumo, data Publicação 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. 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). 13
Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Editora Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo 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. Cadastrar Editora Informar nome e cidade. Não é permitida a exclusão de uma editora que tenha um livro associado. 14
Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Periódico Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo 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. Cadastrar Periódico Informar título, ISSN e local de publicação. Não é permitida a exclusão de um periódico que tenha um artigo associado. 15
Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Edição de Evento Analistas: Ricardo de Almeida Falbo 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: Cadastrar Edição de Evento 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. Não é permitida a exclusão de uma edição de evento que tenha uma publicação associada. 16
Sub-Sistema: Controle de Itens Nome do Caso de Uso: Cadastrar Evento Analistas: Ricardo de Almeida Falbo 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. Cadastrar Evento descrição, Informar nome, sigla, classificação (Internacional, Nacional, Regional e Local), classificação Qualis atual e áreas de interesse. Não é permitida a exclusão de um evento que tenha uma edição associada. 17
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. 18
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 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. 19
Sub-Sistema: Controle de Itens Nome do Caso de Uso: Consultar Item Analistas: Geovando Carpanêdo Fiório e Ricardo de Almeida Falbo 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. 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. Usuário Padrão Cadastrar Oferta de Trabalho Administrador Cadastrar Organização Internauta Consultar Oferta de Trabalho Figura 5 Diagrama de Casos de Uso do Pacote Controle de Ofertas de Trabalho. 21
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. Cadastrar Administrador Informar Organização Administrador / Usuário Padrão Administrador Administrador 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. 22
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. Cadastrar Oferta de Trabalho 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. 23
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. 24