Anlise de Requisitos

O objectivo deste sistema auxiliar o processo de gesto de mdulos reutilizveis de software. O processo de gesto de verses, erros e perguntas dos utilizadores j bastante complexo quando se trata de aplicaes. Quando o processo aplicado a mdulos reutilizveis a complexidade acrescida pois tambm necessria a gesto das dependncias entre verses de mdulos de software. Outro problema o facto dos mdulos no se destinarem ao comum utilizador, mas sim aos programadores e engenheiros que os utilizam na construo das aplicaes. Este captulo resume os requisitos informacionais e funcionais do sistema. Os requisitos so apresentados de uma forma informal recorrendo a exemplos quando conveniente. O processo de manuteno de mdulos de software, suas dependncias e disponibilizaes bastante complicado. O desenvolvimento de um sistema de informao que simplifique este processo pressupe a necessidade de especificar os processos envolvidos e a informao necessria. Quando se trabalham com pouco mdulos de software reutilizveis a utilizao de documentos simples suficiente para gerir os mdulos. Quando o nmero cresce, surgem dependncias entre os diferentes mdulos, surgem erros e pedidos de melhoramentos por parte dos utilizadores o processo torna-se complexo.

Requisitos Informacionais
Cada mdulo tem um nome, uma descrio breve e uma descrio das funcionalidades fornecidas. Cada mdulo possui uma ou mais pessoas responsveis pela sua manuteno. Juntamente com os responsveis podem-se registar todas as pessoas interessadas no mdulo com o objectivo de serem notificadas de eventos relativos ao mdulo. Para auxiliar os utilizadores do mdulo o sistema deve manter endereos de alguns documentos relacionados com o mdulo: Pgina de Internet sobre o mdulo, descrio da sua API1.1 e documentao do mdulo. Cada mdulo possui vrias verses. Cada verso possui as suas funcionalidades, os seus erros, pedidos de melhoramentos, testes unitrios e os seus resultados. Finalmente, cada verso tambm possui dependncias relativamente a outras verses de outros mdulos. Um erro pode ser submetido por qualquer pessoa. A cada erro pode ser associado um teste que mostre o erro. Os erros so acompanhados por um responsvel que o deve analisar e corrigir. Um erro corrigido s fica disponvel para os seus utilizadores no lanamento de uma nova verso do mdulo. O mesmo processo aplicado aos pedidos de melhoramentos efectuados. Cada verso de um mdulo possui um conjunto de testes unitrios. Os teste unitrios dividem-se em dois grandes grupos: testes unitrios de desenvolvimento e testes unitrios de regresso. Os testes unitrios de desenvolvimento so elaborados durante o

desenvolvimento do mdulo com o objectivo de verificar a funcionalidade bsica do mesmo. Os testes unitrios de regresso so testes que resultam de erros encontrados no mdulo que so adicionados para garantir que futuras correces de erros ou novas funcionalidades no fazem o erro reaparecer novamente. Para criar um ambiente de utilizao mais amigvel, a cada mdulo esto associados vrios fruns de discusso. Um frum de discusso iniciado por um responsvel pelo mdulo e semelhante a um lista de distribuio de correio electrnico. O utilizador que cria o frum indica um nome e uma descrio. Os restantes utilizadores podem criar temas fornecendo um ttulo e uma mensagem com o seu problema, dvida ou sugesto. Aps criado o tema, os utilizadores podem afixar mensagens no tema, permitindo assim o auxlio a problemas colocados ou o espao para a descrio das sugestes. Efectuada a apresentao inicial do sistema em termos de processo, foram identificadas as seguintes entidades: Mdulo - Entidade que representa um mdulo de software. Cada mdulo possui um nome, uma descrio, um ou mais responsveis pela sua manuteno, um conjunto de pessoas interessadas no seu desenvolvimento, um conjunto de fruns de discusso, um conjunto de ligaes para diferentes documentos, um conjunto de verses, um conjunto de pedidos de melhoramentos e um conjunto de notcias. Verso - Entidade que representa a verso de um mdulo de software. Uma verso est associada a um mdulo. Para cada verso existe um nmero, uma descrio das funcionalidades, um conjunto de testes possveis, o resultado da execuo dos diferentes testes, dependncias relativamente a verses de outros mdulos e erros conhecidos assim como erros de anteriores verses que foram corrigidos. Erro - Entidade que representa um erro de uma verso de um mdulo. O erro tem um ttulo, uma descrio do erro e opcionalmente um teste unitrio que o demonstra. Teste - Entidade que representa um teste unitrio que pode ser executado numa verso de um mdulo. Um teste possui um nome e uma descrio. Existem vrios tipos de testes: de funcionalidade, de desenvolvimento e de erros. Pedido de Melhoramento - Entidade que representa um pedido de melhoramento de um mdulo. Um pedido de melhoramento possui um ttulo, uma descrio da funcionalidade pretendida, opcionalmente um teste que demonstre a funcionalidade e um frum de discusso sobre o pedido de melhoramento. Pessoa - Entidade que representa os utilizadores do sistema. Cada pessoa tem um nome, um ou mais nmeros de telefone, um ou mais endereos de correio electrnico, um endereo de correio electrnico para notificaes automticas. Existem trs papeis que uma pessoa pode representar perante o sistema: o papel de utilizador, de responsvel por um mdulo e de administrador. A mesma pessoa pode desempenhar todos os papeis ou s um: o de utilizador. Frum de Discusso

- Entidade que representa um frum de discusso. Um frum possui um ttulo, uma breve descrio, um conjunto de temas e um conjunto de pessoas interessadas em serem notificadas quando um tema criado. Tema - Entidade que representa um tema em discusso num mdulo. Um tema possui um ttulo, uma mensagem de inicial, um conjunto de mensagens colocadas e um conjunto de pessoas interessadas em serem notificadas quando so colocadas mensagens. Mensagem - Entidade que representa uma mensagem num tema de um frum de discusso. Uma mensagem tem uma pessoa que o seu autor, um ttulo, um corpo e a data da sua colocao. Notcia - Entidade que representa uma notcia de um mdulo. Uma notcia possui um autor, um ttulo, um corpo e a data da sua publicao.

Requisitos Funcionais
O sistema deve possuir um ou mais Administradores. O objectivo da existncia de administradores controlar a criao de mdulos no sistema. Quando uma pessoa pretende criar um mdulo regista-se perante o sistema e efectua um pedido de criao de um mdulo. O pedido fica registado no sistema e os administradores so notificados. Os administradores podem ento verificar a veracidade do pedido e aprovar-lo. Aps a sua aprovao o seu proponente notificado e ficar registado como responsvel pelo mdulo. Tambm da responsabilidade dos administradores validarem a inscrio de novas pessoas. Quando uma pessoa se regista perante o sistema, este notifica os administradores e mantm o acesso desligado para essa pessoa. Aps os administradores confirmarem o registo a pessoa notificada e o acesso ao sistema -lhe permitido. Qualquer pessoa pode-se registar como interessada num mdulo. Ao registar-se como interessado por um mdulo a pessoa deve indicar que tipos de notificaes pretende receber por correio electrnico. Pode receber, por correio electrnico, notificaes quando uma notcia afixada, quando lanada uma nova verso ou quando um novo frum criado. Os fruns de discusso so criados pelos responsveis pelo mdulo. Num frum de discusso qualquer utilizador pode criar temas e adicionar mensagens a temas existentes. Uma pessoa pode registar-se como interessada num frum de discusso e ser notificada por correio electrnico dos novos temas criados. Tambm deve ser possvel para uma pessoa registar-se num tema e receber por correio electrnico todas as mensagens afixadas. Um pessoa pode afixar um pedido de melhoramento num mdulo. O sistema notificar os responsveis pelo mdulo. Se um responsvel aprovar o pedido de melhoramento criado um frum de discusso para o melhoramento. Quando lanada uma nova

verso de um mdulo os responsveis pelo mdulo podem escolher os pedidos de melhoramento que foram implementados e os erros que foram corrigidos. Um responsvel por um mdulo pode lanar uma nova verso do mesmo. Com o lanamento da verso o responsvel deve colocar os testes executados e o resultado destes. Os testes executados podem transitar da verso anterior para a verso actual do mdulo. Qualquer pessoa pode submeter um erro para uma verso de um mdulo. O responsvel pelo mdulo notificado do erro por correio electrnico. Os erros so corrigidos no lanamento de uma nova verso.

Requisitos No Funcionais
Os sistema a implementar deve seguir o Modelo Relacional-Objecto. Deve ser implementado utilizado aplicaes livres recorrendo s normas existentes quanto aplicveis. O interface com o utilizador deve ser realizado recorrendo a pginas estticas em Extended Hyper Text Markup Language, Java Server Pages, JavaScript e Cascade Style Sheets. No lado do servidor devem ser usados Beans para a realizao de todas as operaes. As Java Server Pages devem delegar todas as tarefas em beans que acedem base de dados. A base de dados deve ser acedida atravs da norma Java Database Connectivity. O objectivo destes Requisitos No Funcionais permitir a portabilidade da aplicao entre diferentes plataformas e tirar partido das ltimas tecnologias para o desenvolvimento de aplicaes, quer a nvel da base de dados, quer a nvel de interface atravs da Internet que foram leccionadas na cadeira.