Universidad de Santiago de Chile.

Facultad de Ingeniera - Departamento de Ingeniera Informtica Ingeniera de Ejecucin en Computacin e Informtica Ctedra de Ingeniera del Software

Software para la Administracin de un Foro Conversacional

Documento de Requerimientos de Usuario (ADD)
Escrito de acuerdo a la Norma PSS-05. Estndar de Ingeniera de Software de la ESA

ESTADO DEL DOCUMENTO SISTEMA DE ADMINISTRACION DE PROYECTOS VERSION AUTOR FECHA RAZONES DEL CAMBIO 1.0 NN-JP-MS 27/05/2004 Creacin documento de Diseo Arquitectnico 1.1 NN-JP-MS 03/06/2004 Revisin segn reuniones (Ctedra) 1.2 NN-JP-MS 09/06/2004 Revisin segn reuniones (Ctedra) 1.3 NN-JP-MS 16/07/2004 Correcciones y refinamientos 1.4 NN-JP-MS 19/07/2004 Correcciones y refinamientos 1.5 NN-JP-MS 20/07/2004 Creacin del Documento de Requerimientos ADD Integrantes: Manuel Silva Curso: Profesor: Ayudante Ingeniera de Software JCCO. PQ

Mayo 2004

TABLA DE CONTENIDOS
1.INTRODUCCIN................................................................................................................................................................1 1.1 PROPSITO...........................................................................................................................................................1 1.2 ALCANCE.............................................................................................................................................................1 DEFINICIONES, SIGLAS Y ABREVIATURAS.........................................................................................................................1 1.4 REFERENCIAS........................................................................................................................................................2 2. APRECIACIN GLOBAL DEL SISTEMA...................................................................................................................3 3. CONTEXTO DEL SISTEMA............................................................................................................................................3 DEFINICIN DE LA INTERFASE EXTERNA................................................................................................................4 ARQUITECTURA DEL SISTEMA......................................................................................................................................4 MTODO USADO...........................................................................................................................................................5 DESCRIPCIN DE LA DESCOMPOSICIN ............................................................................................................................5 7 USO DE LA HERRAMIENTO DE ADMINISTRACIN...............................................................................................7

Software para la Administracin de un Foro Conversacional

ADD

ii

1. INTRODUCCIN
Este documento describe un primer paso en el diseo de la Herramienta de administracin de un Foro de Discusin, Se describe el resultado de la descomposicin de alto nivel (arquitectura) de los DFDs y requerimientos de software elaborados durante la fase de SR y documentados en el SRD.

1.1 Propsito
Este documento describe el primer paso de diseo arquitectnico. El propsito es el de definir la estructura del software. Este modelo es transformado en diseo arquitectnico asignando las funciones a componentes de software y definiendo el control y flujo de datos entre ellos. El propsito de este documento es de mostrar el tipo de desarrollo utilizado para as llegar al producto final, el Software para la Administracin de un Foro de Discusin, que se describir claramente por los desarrolladores y los componentes definidos.

1.2 Alcance
Este Documento, es una herramienta prctica y necesaria para un desarrollador, en este se describe cada componente (mdulos) que usara el software, de acuerdo a las definiciones anteriores. Este Documento, es una herramienta prctica y necesaria para un desarrollador, en el se describe cada componente (mdulos) que usara el software, de acuerdo a las definiciones anteriores del etapa URD y SRD. Se presenta a continuacin los diseos para la solucin a los requerimientos de la herramienta de software destinada a la administracin de un Foro.

Definiciones, Siglas y Abreviaturas

Glosario Informtico Browser o Navegador: Aplicacin utilizada para navegar por Internet y que despliega paginas tradas desde otros servidores a la pantalla del computador del usuario. Dominio: Es un conjunto de elementos de igual naturaleza e igual comportamiento.

Software para la Administracin de un Foro Conversacional

ADD

Instancia: Es la ejecucin particular de un proceso especfico, la cual posee un periodo de vigencia. Opcin habilitada: Opcin que puede ser usada por Usuario mientras est usando la aplicacin. Pgina WEB: Documento con informacin (texto, imgenes, video, audio) que se presenta en una misma pantalla mediante un navegador de Internet. Procesos: Conjunto de tareas y/o eventos ordenados, que puede poseer muchas instancias. Servidor: Computador y programa computacional, que brinda los servicios solicitados por otro computador llamado cliente. Software: Conjunto de programas, diseado para un propsito especifico. Abreviaturas ESA: Agencia Espacial Europea (European Space Agency) URD: Documento de requerimientos de usuario. SRD: Documento Requerimientos de Software. ADD: Documento Diseo Arquitectnico. PC: Computador Personal. 1.4 Referencias [1] URD de la Herramienta de software para la administracin de un Foro de Discusin [2] SRD [3] Ingeniera de Software, R.S. Presuman Referencias Textos Documento desarrollado en la fase URD. Noem Nuez, Jorge Prez P. Manuel Silva I.

Software para la Administracin de un Foro Conversacional

ADD

Ingeniera de Software, Un enfoque prctico. Roger Pressman V5. ESA Software Engineering Standards. ESA PSS-05-00 Issue 2. Apuntes de clase de Ingeniera de Software. Profesor Juan Carlos Cockbaine, Universidad de Santiago de Chile. Java Servlet Programming. Jason Hunter.

2. APRECIACIN GLOBAL DEL SISTEMA

El proyecto es la parte prctica de la ctedra de Ingeniera de Software de la USACH, para el cul se ha solicitado el desarrollo de una herramienta para la administracin de un Foro de discusin. Los criterios de seleccin de una arquitectura para este proyecto estn influenciados por los elementos siguientes: Cantidad de recursos humanos limitada: 3 RR.HH. Cantidad de HH. limitada: 480 Entrega en fecha fija, sin atraso: 19 de Julio de 2004. Desconocimiento del lenguaje mediante el cual desarrollara esta herramienta Estos elementos determinan los criterios siguientes: Uso de tcnicas no fciles de aprender Uso de lenguajes difciles para el desarrollo de esta herramienta Simpleza de diseo Una construccin lenta de construir Documentacin con herramientas de bajo costo

3. CONTEXTO DEL SISTEMA

Se opt por una arquitectura Web basada en Perl, de acuerdo a los requerimientos de Usuario, ofrece una infraestructura que permite el desarrollo rpido de aplicaciones Web. La ventaja de una aplicacin Web es que se ejecuta en un browser, con una alta capacidad de acceso a la aplicacin.

Software para la Administracin de un Foro Conversacional

ADD

El sistema no posee interfaces hacia otros sistemas.

USUARIO

BROWSER

INTERNET

Datos ingresados respuestas

Consulta a la Base de Datos

Ingreso de opiniones

Software administrador del Foro

PGINA WEB
Validacin de los datos

Bases de Datos

Respuesta de la Base de Datos

Figura 1

nicin de la interfase Externa No aplicable.

ARQUITECTURA DEL SISTEMA

En el contexto general del desarrollo del sistema se destacan los siguientes elementos: Browser Web. Permite la interfaz general entre el usuario maquina.
Software para la Administracin de un Foro Conversacional

ADD

Sistema Operativo En esta caso Windows XP SP2, fue impuesto como requerimiento. Este se encarga de administrar la ejecucin a bajo nivel de los componentes de software. Mtodo usado El mtodo utilizado es el anlisis estructurado se organiza en funcin a procedimientos, este se basa en la descomposicin de un programa en subprogramas, donde este ltimo pasa a ser la unidad fundamental de este tipo de descomposicin, el programa resultante toma la forma de un rbol, en la que cada unidad fundamental realiza su trabajo, llamando ocasionalmente a otro programa. El Anlisis estructurado se concentra en especificar y descomponer la funcionalidad del sistema total. El mtodo de diseo se baso en el documento de requerimiento del usuario, URD. En este se describe en que consiste el software de administracin de un Foro de Discusin y cuales son los requisitos para la realizacin de este. Para realizar este diseo se utiliza un modelo entidad relacin en el cual se identificaron los actores y objetos que participaran en el sistema, adems de ver como estn vinculados entre ellos. Una vez realizado esto, se define un modelo Relacional. Este fue indispensable para una posterior implementacin en Bases de Datos. (Visual Basic sern los mtodos de programacin y base de datos utilizada respectivamente para implementar el modelo.) Posteriormente se incluyen los requisitos de seguridad, de permisos, y de detalles propios del sistema, agregando nuevas tablas a las ya existentes, o modificndolas. Descripcin de la Descomposicin La descomposicin del sistema se baso principalmente en una estructura modular. A partir de los objetivos de extensibilidad y reutilizacin, dos de los factores de calidad ms importantes, se desprende la necesidad de tener arquitecturas de sistemas flexibles, hechas con componentes autnomos de software. Esto se logra con una adecuada modularidad. Un mtodo de diseo que merezca ser llamado modular, debera satisfacer cinco requisitos fundamentales: Descomposicin modular. Ayuda en la tarea de descomponer el problema en un nmero de subproblemas menos complejos, interconectados.

Software para la Administracin de un Foro Conversacional

ADD

 Composicin modular. Favorece la produccin de elementos de software que se puedan combinar libremente unos con otros para producir nuevos sistemas. Comprensibilidad modular. Ayuda a producir software en el cual un lector humano puede entender cada mdulo sin tener que conocer los otros (o examinando slo unos pocos). Continuidad modular. Se satisface si un pequeo cambio en la especificacin de un problema provoca slo cambios en un solo mdulo o en un nmero pequeo de mdulos. Proteccin modular. Si produce arquitecturas en las cuales el efecto de una situacin anormal ocurrida en un mdulo durante la ejecucin, queda confinado a ese mdulo (o se propaga slo a unos pocos vecinos). De los criterios anteriores para asegurar la modularidad, se derivan cinco reglas: Correspondencia directa. Conexin de un sistema de software con los sistemas externos con que est relacionado. La estructura modular obtenida, debe seguir siendo compatible con cualquier otra estructura modular en el dominio del problema. Pocas interfaces. Cada mdulo debe comunicarse con el menor nmero de mdulos posible. Interfaces pequeas (acoplamiento dbil). Si dos mdulos se comunican, deben intercambiar la menor informacin posible. Interfaces explcitas. Siempre que dos mdulos A y B se comuniquen, esto debe ser obvio a partir del texto de A, del de B o de ambos. Ocultar informacin. Mostrar slo lo necesario.

Software para la Administracin de un Foro Conversacional

ADD

USO DE LA HERRAMIENTO DE ADMINISTRACIN

Mdulo de Desarrollo de Herramienta Para el desarrollo de este mdulo principal identificado como AD1, es necesario previamente realizar el diseo arquitectnico del manejo de los Temas, las funciones del Administrador, responsabilidades de los usuarios y el manejo de los servicios, funciones integradas que nos permite la administracin de Foro de discusin, con estos antecedentes se lograra construir la herramienta definitiva, que integre estos mdulos para la realizacin del software.

AD2 Administrador

AD3 Temas AD1 Modulo principal AD4 Usuarios

AD5 Servicios

Figura 2 Secuencia de desarrollo de herramienta de Administracin

Software para la Administracin de un Foro Conversacional

ADD

Modulo Administrador Este mdulo es identificado como AD2 y es llamado desde el mdulo principal AD1, integra los mdulos AD2.1, que es el mdulo que representa a la consola de administracin desde donde se maneja el corazn del Sitio, este modulo esta asociado a los mdulos AD2.2, AD2.3, AD2.3, AD2.5 y AD 2.6, desde los cuales se recopila la informacin necesaria que interacta con el Administrador, es decir cuando se quiere modificar un Moderador, validar o eliminar usuarios etc. Estos datos deben esta con antelacin en la Base de datos correspondiente y tras una solicitud el administrador ejecuta las acciones tendientes a administrar, permitiendo que otros usuarios, es decir los Moderadores le den el dinamismo al Foro..

AD2.2.1 Validar Usuarios AD2.2 Modificar Moderador AD 2.2.2 Selecionar Moderador

AD2.3 Validar nuevos Usuarios

AD 2.3.1 Suspender usuarios

AD 2.3.2 Seleccionar Usuario

AD2 Administrador

AD2.1. Consola Administrador

AD2.4 Eliminar Usuarios AD 2.5.1 Si valida tema

AD2.5 Validar Tema

AD 2.5.2 Cambiar Nombre Tema

AD 2.61 Seleccionar Tema AD 2.6 Mantener lista de temas AD 2.6.2 Si valida tema

Figura 3 Secuencia del men de la consola del Administrador

Software para la Administracin de un Foro Conversacional

ADD

Modulo Temas
En este modulo se puede apreciar, la interactividad que tienen los temas dentro del Foro, y dependen directamente del Administrador de este, ya que es el nico que valida estos, proviene directamente del mdulo principal.

AD3.1 Propone temas

AD 3.1.1 Suspender tema

AD 3.1.2 Reactiva tema

AD3. Temas

AD3.2 Solicita nuevo Tema AD 3.3.1 no valida tema

AD3.3 Validar Tema

AD 3.3.2 Seleccionar Tema

AD 3.3.3 Si valida tema

Figura N 4 Mdulo temas

Software para la Administracin de un Foro Conversacional

ADD

Modulo del men de servicios

Este mdulo permite la interconectividad de los diversos servicios como lo son visualizacin de las polticas del sitio, del mapa del sitio, permitiendo adems un canal de comunicacin directa con el administrador para cualquier visitante del sitio del Foro, existe tambin un enlace con el mapa conversacional, que tericamente permite visualizar las comunicaciones que tienen los usuarios y su aporte a la dinmica de este.

AD3.2.1 Muestra mapa conversacional

AD5.4 Mapa conversacional AD3.2.1 Ingresa nombre completo

AD5.1 Contacta al Administrador AD3.1.5 Ingresa texto del contacto

AD5 Servicios AD5.2 Polticas del Sitio

AD3.2.1 Ingresa e-mail

AD3.2.2 Muestra polticas AD5.3 Mapa del sitio AD3.2.2 Muestra mapa del sitio

Figura N 5 Mdulo de Servicios Principalmente este Foro funciona con la participacin de los usuarios que son la fuente de informacin primaria, ya que son estos los que aportan los temas de discusin, proponen debates y realizan todo tipo de opiniones.
Software para la Administracin de un Foro Conversacional

ADD

10

Modulo del usuario

Este mdulo se identifica como AD 4, llamado desde el modulo principal, es este modulo el mayor implicancia tiene en este sistema, por el hecho de que este es el que mayor dinamismo tiene en comparacin con los otros, por este pasan todos los requerimientos que ingresan al foro, tanto de solicitud de nuevos temas, nuevos debates y opiniones vertidas por los usuarios.

AD 2.3.2 Seleccionar Tema

AD2.3 contacta moderador

AD2.2.1 Validar opiniones

AD 4.1. Propone opiniones

AD2.4 contacto administrador

AD 2.5.1 Debate eliminado

AD 4 Usuario AD2.5 Espera validacin AD 4.2. Propone debates AD 2.61 mapa conver. AD 2.6 Debates validades AD 2.6.2 Emite opinion AD 2.5.2 Vidita mapa del sitio

Figura N 6 Mdulo del usuario

Software para la Administracin de un Foro Conversacional

ADD

11

Actividades del usuario

En esta grfica se puede apreciar algunas de las actividades que realiza en usuario en el Foro, tal como se mencionaba anteriormente sin su participacin el Fono no tendra las actividades ni las desarrollara, en esta caso a travs del mdulo AD 4.2, el usuario solicita varios servicios los que son finalmente traspasados a la base de datos correspondiente.

AD4.2.1 Nombre del debate

AD4.2.2 Debate validado

AD4.2 propone nuevo debate

AD 4.2.3.1 Actualiza B.D. AD4.2.3 Agrega debate a B.D.

AD 4.2.4 Entrega opinion.

Figura N 7 Actividades del Usuario

Software para la Administracin de un Foro Conversacional

ADD

12

Opciones del Moderador A continuacin se pueden apreciar las opciones que tiene el moderador en la administracin del sitio, este es llamado desde el mdulo principal, desde donde a travs de su consola participa activamente en las funciones de administracin.

AD 2.2.4 Valida Opiniones

AD 2.2.4.1 Verifica contenido

AD 2.2.4.2 INuevo Moderador AD 2.2.2 Moderador AD 2.2.3 Consola Moderador AD 2.2.5 Valida Debates

AD 2.2.4.3 Actualiza base Datos AD 2.2.6 Rechaza debates

Figura N 8 Opciones del Moderador

Software para la Administracin de un Foro Conversacional

ADD

13

Descripcin de Componentes En esta seccin, se resumen detalles que interactan entre los mdulos, como son los flujos de entrada y salida.

Nmero
1 1.1 1.2 1.3 1.4

ID
AD1 Tipo Propsito Funcin Subordinados ----

Nombre
Herramientas de administracin

1.5 1.6 1.7 1.8 1.9 1.10 2 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 2.10 3

AD2 AD3 AD4 AD5 Dependencias 0 Interfases -Recursos -Referencias -Proceso -Modelo de datos -AD2 Tipo Propsito Funcin Subordinados Dependencias Interfases Recursos Referencias Proceso Modelo de datos AD3 --

Administrador Temas Usuarios Servicios

Administrador

AD2.1 0 ------

Consola de Administrador

Mdulo Temas
ADD 14

Software para la Administracin de un Foro Conversacional

3.1 3.2 3.3 3.4

Tipo Propsito Funcin Subordinados

3.5 3.6 3.7 3.8 3.9 3.10 3.9 3.10 4 4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 4.9 4.10 5 5.1 5.2 5.3 5.4

---AD3.1 AD3.2 AD3.3 Dependencias 0 Interfases -Recursos -Referencias -Proceso -Modelo de datos -Proceso -Modelo de datos -AD4 Tipo Propsito Funcin Subordinados ---AD4.1 AD4.2 Dependencias 0 Interfases -Recursos -Referencias -Proceso -Modelo de datos -Proceso -Modelo de datos -AD5 Tipo Propsito Funcin Subordinados ---AD5.1 AD5.2

Proponer temas Solicitar nuevo tema Validar tema

Mdulo Usuario

Propone opiniones Propone debates

Modulo del men de Servicios

Contacta al Administrador Polticas del sitio

ADD 15

Software para la Administracin de un Foro Conversacional

5.5 5.6 5.7 5.8 5.9 5.10 5.9 5.10 6 6.1 6.2 6.3 6.4 6.5

AD5.3 AD 5.4 Dependencias 0 Interfases -Recursos -Referencias -Proceso -Modelo de datos -Proceso -Modelo de datos -AD4.2 Tipo Propsito Funcin Subordinados Dependencias

Mapa del Sitio Mapa conversacional

Actividades del Usuario

6.6 6.7 6.8 6.9 6.10 7 7.1 7.2 7.3 7.4 7.5 7.6 7.7 7.8 7.9

---0 AD4.2.1 AD4.2.2 AD4.2.3 AD4.2.4 Interfases -Recursos -Referencias -Proceso -Modelo de datos -AD2.2.2 Tipo Propsito Funcin Subordinados Dependencias Interfases Recursos Referencias Proceso

Nombre del debate Debate validado Agregar debate a B.D. Entrega Opinin

Opciones del Moderador ---0 AD2.2.3 -----

Consola Moderador

Software para la Administracin de un Foro Conversacional

ADD

16

7.10

Modelo de datos --

TABLA. 1 Descripcin de Componentes

Software para la Administracin de un Foro Conversacional

ADD

17