SRS Sistema AP
SRS Sistema AP
SRS Sistema AP
Global Mentoring
Sistema de Gestin de Alumnos (SGA)
Especificacin de Requerimientos del Sistema
SRS
Realizado por
Ing. Ubaldo Acosta Soto
Versin 1.0
31 de Mayo de 2010
Historial de Revisin
Fecha
31/05/10
Versin
1.0
Fecha
31/05/10
Versin
1.0
Autor
Ing. Ubaldo Acosta Soto
Descripcin
Visin Inicial del Proyecto
Informacin de Contacto
[email protected]
Versin
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 1 de 16
Informacin de Contacto
Tabla de Contenido
1. INTRODUCCIN
1.1
1.2
1.3
1.4
1.5
1.6
1.7
4
4
4
4
4
5
5
PROPSITO
ALCANCE
CONTEXTO DEL SISTEMA
ACTORES PRINCIPALES DEL PROCESO DE NEGOCIO
CMO EST ORGANIZADO ESTE DOCUMENTO
REGISTRO DE LOS CAMBIOS AL SGA
REFERENCIAS
2. RESTRICCIONES Y SUPOSICIONES
RIESGOS
RIESGOS
RIESGOS
RIESGOS
DE TECNOLOGA
DE HABILIDADES TCNICAS Y
DE REQUERIMIENTO
POLTICOS
RECURSOS DE INFORMTICA
4. REQUERIMIENTOS FUNCIONALES
6
6
7
7
7
7
7
7
7
7
8
8
8
8
9
9
9
10
5. REQUERIMIENTOS NO-FUNCIONALES
18
5.1.1 RENDIMIENTO
5.1.2 ESCALABILIDAD
5.2 DISPONIBILIDAD
18
18
19
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 2 de 16
5.3
5.4
5.5
5.6
5.7
SEGURIDAD
USABILIDAD
ACCESIBILIDAD
REUSABILIDAD
MANTENIMIENTO
19
19
20
20
20
21
21
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 3 de 16
1.
Introduccin
1.1
Propsito
El propsito de este documento es definir los requerimientos especficos del Sistema de Gestin
de Alumnos (por sus siglas SGA), y detallar las especificaciones respecto a las caractersticas,
capacidades y atributos principales del sistema. Este documento debe ser ledo por el equipo de
desarrollo del Sistema, para evaluar los beneficios y la viabilidad del proyecto, as como proveer
una estimacin bsica del tiempo y esfuerzo necesario para la construccin, pruebas, puesta en
marcha y mantenimiento del SGA. Este documento no describe como, cuando, o donde se
realizarn las actividades o quin las llevar a cabo, ya que se detallar en otros documentos.
1.2
Alcance
El SGA ser una aplicacin Web que permita gestionar los alumnos que participan en cursos en
Global Mentoring, a su vez tiene como uno de los principales objetivos ofrecer un seguimiento
claro y puntual de cada uno de los pendientes con cada uno de los alumnos, tales como venta de
cursos, pagos, envo de boletines, envo de mensajes SMS para noticias, entre otros.
Otra de las responsabilidades del SGA ser permitir al usuario realizar bsquedas de alumnos,
cursos, pendientes con alumnos, agregar al sistema fotos y/o documentos digitalizados asociados
al alumno.
La seguridad de la informacin es un tema inherente, por lo que se restringir a los usuarios
respecto a qu es lo que pueden consultar y/o modificar en el sistema.
1.3
1.4
1.5
Coordinador
Actor Principal
Ubaldo Acosta
N/A
Actores de Referencia
Instructor
Asistente
Alumno
Por definir
Por definir
Por definir
N/A
N/A
N/A
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 4 de 16
La seccin 2 describe las restricciones y suposiciones del sistema. La seccin 3 describe los
riesgos del proyecto y cmo pueden ser estos mitigados. La seccin 4 describe los
requerimientos funcionales (FRs) del sistema. La mayora de estos requerimientos existen por
que directamente soportan el proceso de negocio, otros existen debido a que soportan la correcta
operacin del sistema, aunque no sean parte esencial del negocio. Todos los requerimientos
funcionales estn descritos en trminos de casos de uso. La seccin 5 describe los requerimientos
no funcionales (NFRs) del sistema. La seccin 6 provee un glosario del proyecto, que incluye
trminos del negocio, como propios del sistema.
1.6
1.7
2.
No existen cambios
Referencias
Documento de Visin del Proyecto para el SGA, creado el 31 de Mayo del 2010.
Object-Oriented Analysis and Design Using UML, sun educational services, S00-226-V030
Restricciones y Suposiciones
La siguiente seccin provee el detalle de lo que se explic brevemente en el Documento de
Visin del Proyecto.
2.1
2.2
Restricciones Tecnolgicas
2.2.1
Restricciones de Software
El equipo de desarrollo de Global Mentoring ha decidido construir el SGA usando la tecnologa
Java (Java SE JDK, versin 6) debido a la portabilidad, flexibilidad y el costo de entre varios
productos.
http://java.sun.com
Pgina 5 de 16
2.2.2
Tomcat http://jakarta.apache.org/tomcat
iceFaces http://www.icefaces.org
Spring http://www.springframework.org
Hibernate http://www.hibernate.org/
Netbeans - http://www.netbeans.org/
Restricciones de Hardware
El SGA es una aplicacin Web con una base de datos centralizada, por lo que los equipos cliente
debern estar conectados a la intranet de Global Mentoring. Posteriormente se liberar el sistema
en la plataforma de Google GAE en Internet.
El SGA ofrecer la caracterstica para subir archivos digitalizados, por lo que los usuarios
requerirn de un scanner para realizar esta labor.
El servidor donde ser alojado el servidor Web y el servidor de base de datos, tendr las
siguientes caractersticas:
4 Gb Ram
Por parte de los usuarios del sistema puede tener las siguientes caractersticas como mnimo:
2.3
512 Mb Ram
Microsoft Office o Open Office para el manejo de hojas de clculo (version compatible
2007)
3.
3.1
Riesgos de Tecnologa
Debido a que el sistema utiliza una base de datos centralizada, la nica manera de accederlo es
por la Intranet de Global Mentoring. Por lo que si no se tiene acceso a la red por algn motivo o
causa, no se podr acceder a la informacin. Para mitigar este riesgo, se est planeando que la
aplicacin se pueda subir a internet apoyndonos de la infraestructura de Google (GAE).
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 6 de 16
3.2
Para mitigar el riesgo debido a que los mdulos se realizan por los alumnos que asisten a clases,
se establecern planes de trabajo, que independiente del programador, se puedan ir avanzando en
los mdulos, con ayuda del control de versiones de Sub version.
En este proyecto es la primera vez que el equipo de trabajo har una automatizacin de pruebas
de unidad del sistema. Esta prctica, al da de hoy es un estndar en el desarrollo de software, ya
que se puede ahorrar ms de un 60% de los recursos humando asignados a probar el sistema y la
calidad del sistema a liberar puede incrementarse en un 70%. Para mitigar este riesgo ser
necesario incrementar el tiempo de pruebas del sistema y tomar cursos y/o auto-capacitarse en
este rubro para reducir los tiempos lo ms posible. Las tecnologas a utilizar son JUnit, Ant y
Maven, apoyndonos de Subversion.
3.3
Riesgos de Requerimiento
Para mitigar el riesgo de requerimientos, se debe restringir el tiempo de recoleccin de
requerimientos en la etapa de elaboracin del proyecto. Si se recibieran ms requerimientos, se
revisar en si entran en la versin actual, o en una versin posterior a la primera liberacin, ya
que de lo contrario no se tendra una versin estable para liberar a produccin.
3.4
Riesgos Polticos
No existen riesgos polticos para este proyecto.
4.
Requerimientos Funcionales
Esta seccin define los actores que utilizan el sistema que a su vez se relacionan con los procesos
de negocio principales, as como los casos de uso que el sistema provee para los actores
mencionados.
4.1
Caractersticas Principales
En esta seccin, clasificaremos las caractersticas principales del SGA en tres tipos de categoras.
Caractersticas esenciales, de alto valor y futuras. En todos los casos la lista no es exhaustiva,
pero si incluye los procesos de negocio ms importantes.
4.1.1
Caractersticas Esenciales
El SGA ser una aplicacin Web con una base de datos centralizada capaz de mostrar la
informacin a los usuarios en cuanto sea capturada o modificada, es decir, en lnea.
El sistema deber proporcionar mecanismos para dar un seguimiento claro y oportuno de cada
uno de los pendientes con los alumnos.
El SGA deber ofrecer reportes para explotar la informacin almacenada en la base de datos.
4.1.2
El sistema permitir agregar archivos digitalizados de los alumnos y sus anexos, tales como
Currculo Vitae, para tener disponible la informacin en el sistema.
Uso de cmara web para tomar una foto de los alumnos y tenerla en sus registros.
4.1.3
Caractersticas futuras
El sistema permitir realizar consultas para encontrar la informacin de manera precisa y rpida.
En un principio con consultas esenciales, para posteriormente, en otra versin, agregar filtros de
bsqueda avanzados.
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 7 de 16
El sistema deber simplificar su interfaz para manejar el concepto de web 2.0, incluyendo AJAX.
4.2
Actores
La lista que se muestra a continuacin es una lista de los roles y/o sistemas que interactuarn con
el SGA.
4.2.1
Descripcin
Coordinador
Instructor
Asistente
Alumno
4.2.2
Actor: Coordinador
Persona encargada de administrar la informacin del sistema.
Genera reportes del sistema.
Revisa pendientes o tareas y capturar informacin en el sistema.
Es SGA tendr un sistema de bloqueo, es decir, se terminar la sesin del usuario al transcurrir
30 minutos de inactividad.
4.2.3
Actor: Instructor
Este rol se encarga de dar solucin a los pendientes con los alumnos en la cuestin de cursos a
impartir o cursos impartidos.
Distribuye avisos y comunicados a los alumnos.
4.2.4
Actor: Asistente
Encargado de capturar la mayora de la informacin relacionada con el alumno
Verificar que la informacin capturada es correcta
Captura los pendientes que se tenga para con los alumnos e indica el responsable para resolver
cada uno de los pendientes.
Distribuye avisos y comunicados de ndole administrativa con los involucrados en el sistema y/o
alumnos.
4.2.5
Actor: Alumno
Consulta los cursos actuales y puede consultar el estatus de sus pendientes en lnea.
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 8 de 16
4.3
Casos de Uso
La siguiente lista contiene los casos de uso del sistema. La prioridad se clasifica de la siguiente
manera:
Esencial: E
Alto Valor: A
Futuro: F
Nombre Caso Uso
Priorida
d
Nmer
o
Gestiona Usuarios
Gestiona Alumnos
Gestiona Catlogos
Gestiona Pendientes
Genera Reportes
Descripcin
Nota: No se incluyen todos los casos de uso futuros, ya que el objetivo es solamente ejemplificar la metodologa.
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 9 de 16
4.4
4.5
E1-1
E1-2
El sistema deber permitir asociar roles a cada uno de los usuarios. Ya que el manejo de la
seguridad en el sistema se manejar con roles.
E1-3
E1-5
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 10 de 16
Cdigo
Req.
E1-6
E2-1
E2-2
E2-3
E2-4
E2-5
F3-1
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 11 de 16
Cdigo
Req.
5.
F4-1
E5-1
F6-1
Requerimientos No-Funcionales
Los Requerimientos No Funcionales (por sus siglas en ingls, NFRs) se diferencian de los
Requerimientos Funcionales (por sus siglas en ingls, FRs) debido a que comienzan con el
nmero 100. Por lo tanto, el primer NFR para el caso de uso E1, tendr el Cdigo de
Requerimiento E1-101.
5.1.1
Rendimiento
Versin Actual
Cdigo
Req.
Descripcin Requerimiento
E1-101
Debido a que el SGA es una aplicacin Web, los tiempos de respuesta debern ser muy
reducidos (menor a 3 segundos en las consultas), ya que la velocidad de captura es esencial.
E1-102
E1-103
E1-104
Versin Futura
Cdigo
Req.
Descripcin Requerimiento
E1-105
E1-106
El SGA en un futuro podra crecer a ms de 100 usuarios al da, dependiendo del nmero de
alumnos y maestros que utilicen el sistema.
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 12 de 16
5.1.2
Escalabilidad
Versin Actual
Cdigo
Req.
E1-107
Descripcin Requerimiento
La capacidad de los registros de los oficios podra crecer a 150 registros por da,
dependiendo del uso y exactitud que el usuario almacene en el sistema, por ejemplo, si se
genera un registro de seguimiento por cada copia que se observa en los oficios.
Versin Futura
Cdigo
Req.
E1-108
5.2
Descripcin Requerimiento
El sistema podra crecer a tener ms de 50 usuarios concurrentes, dependiendo de las
dependencias que lo utilicen.
Disponibilidad
Versin Actual
Cdigo
Req.
E1-109
Descripcin Requerimiento
Debido a que es un sistema Web, por naturaleza debe tener una disponibilidad de 7 por 24
los 365 das del ao, excepto por una hora de baja del servicio (para mantenimiento del
software, respaldo de datos, etc.), siendo aceptable una vez a la semana en horarios que no
afecte la operacin, excepto en ocasiones de emergencia o extraordinarias, como puede ser
la falta de servicio de luz, falta de conexin a Internet o a la Intranet, entre otros.
Versin Futura
No existen requerimientos futuros para este rubro
5.3
Seguridad
Versin Actual
Cdigo
Req.
Descripcin Requerimiento
E1-110
E1.111
E1-112
El sistema tendr un mecanismo de autorizacin a los datos del sistema, basado en roles,
adems de asignacin de permisos de acceso de cada uno de los mdulos del sistema.
Adems el men del sistema se generar de manera dinmica, dependiendo de los permisos
que se hayan asignado a cierto rol por cada mdulo.
E1-113
El sistema registrar cada una de las acciones que cada usuario del sistema ejecute, teniendo
una bitcora que permita auditorias en caso de problemas o aclaraciones
E1-114
El sistema manejar una auditoria de las tablas de base de datos ms importantes, para tener
la historia de los registros, y saber cuando, qu y quin modific los registros en caso de
problemas o aclaraciones
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 13 de 16
Cdigo
Req.
E1-115
Descripcin Requerimiento
Los principales roles de seguridad del sistema sern: Administrador del sistema,
Coordinador, Instructor, Asistente y Alumno.
Versin Futura
No existen requerimientos futuros para este rubro
5.4
Usabilidad
Versin Actual
Cdigo
Req.
E1-116
Descripcin Requerimiento
El sistema deber tener una interfaz de fcil uso e intuitiva.
Versin Futura
Cdigo
Req.
E1-117
5.5
Descripcin Requerimiento
Se utilizarn frameworks como iceFaces para tener una interfaz con caractersticas web 2.0
Accesibilidad
Versin Actual
Cdigo
Req.
E1-118
Descripcin Requerimiento
El SGA deber poder accederse desde cualquier computadora conectada a la Intranet de
Global Mentoring
Versin Futura
Cdigo
Req.
E1-119
5.6
Descripcin Requerimiento
El SGA deber poder accederse desde cualquier computadora conectada a Internet
Reusabilidad
Versin Actual
Cdigo
Req.
E1-120
Descripcin Requerimiento
El sistema deber utilizar todos los componentes generados y/o utilizados en proyectos
anteriores desarrollados por los participantes en el proyecto
Versin Futura
No existen requerimientos futuros para este rubro
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 14 de 16
5.7
Mantenimiento
Las categoras de un problema de sistemas tpicamente se dividen como se muestra a
continuacin.
Severidad 1, Fatal El sistema complete no funciona y no puede ser utilizado para nada.
Severidad 2, Error Una parte crtica del sistema no funciona, y no se acepta otra
alternativa
Esta clasificacin nos permitir asignar la prioridad a los problemas que surjan durante la
operacin del sistema.
6.
6.1
Acrnimos y Abreviaciones
Acrnimo / Abreviacin
Nombre Completo
Descripcin
AJAX
Asynchronous
JavaScript And
XML
API
Application
Programmers
Interface
Conjunto de especificaciones de
comunicacin entre componentes de
software
DAOs
Database Objects
DBMS
Database
Motor de base de datos
Management System
FR
Functional
requirement
GUI
Graphical User
Interface
IDE
Integrated
Development
Enviroment
JDBC
Java Database
Connectivity
JSF
JavaServer Faces
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 15 de 16
Acrnimo / Abreviacin
Nombre Completo
Descripcin
iceFaces
iceFaces
JVM
Java Virtual
Machine
LAN / Intranet
NFR
Non-functional
requirement
SRS
System
Requirements
Specification
Documento de Especificacin de
Requerimientos del Sistema
ORM
Object Relational
Mapping
WAN
WUI
Web-based User
Interface
Confidencial:
Ing. Ubaldo Acosta Soto Global Mentoring
Pgina 16 de 16