~CIS1510EM03. Cero Fila. Autor: Javier Ayala Angel SOFTWARE REQUIREMENT SPECIFICATION DEL TRABAJO DE GRADO CERO FILA. Director. Efraín Ortiz Pabon

Transcripción

1

2 ~CIS1510EM03 Cero Fila Autor: Javier Ayala Angel SOFTWARE REQUIREMENT SPECIFICATION DEL TRABAJO DE GRADO CERO FILA Director Efraín Ortiz Pabon Página web del Trabajo de Grado PONTIFICIA UNIVERSIDAD JAVERIANA FACULTAD DE INGENIERIA CARRERA DE INGENIERIA DE SISTEMAS BOGOTÁ, D.C. Noviembre, 2015 Página 1 de 23

3 Contenido 1 Introducción Propósito Alcance Apreciación global Descripción global Perspectiva del producto Funciones del producto Características de usuario Entorno de funcionamiento Restricciones de diseño e implementación Suposiciones Requerimientos de interfaz externos Interfaces de usuario Interfaces de hardware Interfaces de software Interfaces de comunicación Gestión de requerimientos Especificación de requerimientos Requerimientos funcionales Clasificación de requerimientos Priorización de requerimientos Documentación de requerimientos Requerimientos no funcionales Clasificación de requerimientos Priorización de requerimientos Documentación de requerimientos...18 Apéndice A: Glosario...18 Apéndice B: Índice de tablas...19 Apéndice C: Índice de ilustraciones...20 Página 2 de 23

4 Bibliografía...21 Anexos...22 Página 3 de 23

5 1 Introducción Este documento presenta una serie de especificaciones que soporta el prototipo Cero Fila de tal manera que se entienda su funcionamiento. Se usa como base el estándar IEEE ComputerSociety 830[1]. Adicionalmente, en este documento entiéndase por sistema el prototipo a desarrollar Cero Fila. 1.1 Propósito En este trabajo se tiene como propósito detallar el comportamiento del prototipo funcional Cero Fila; en otras palabras, se pretende especificar las características, funcionalidades y especificaciones técnicas del prototipo de tal manera que cualquier persona que desee conocer el funcionamiento pueda remitirse a este documento y entenderlo. Por otro lado, con este documento se espera que se tenga una base inicial para el sistema final. 1.2 Alcance Durante este proyecto se desarrollará un prototipo totalmente funcional que se llama Cero Fila. Este sistema consiste en una aplicación móvil y a su vez una página web, mediante la cual los usuarios acceden a turnos, trámites o solicitudes de un catálogo de empresas que tienen al menos una sucursal, inicialmente en la ciudad de Bogota. Adicional a esto, los usuarios pueden ver en tiempo real el estado de la cola, la información básica de la empresa, la ubicación de la sede, solicitar turnos en todas las empresas y cancelarlos. Cada requerimiento del usuario es respondido por el servidor de acuerdo a las especificaciones dadas por el administrador de la sucursal. Las funciones del prototipo se encuentran especificadas en las funciones del producto (ver sección 2.2. Funciones del producto) y la descripción del servicio se encuentra especificado en la descripción global del sistema (ver sección 2.1. Perspectiva del producto). Durante el semestre académico en el que se desarrolló este proyecto, el alcance esperado para el producto a entregar se especifica con los requerimientos que se detallan más adelante en este documento (ver sección 4. Gestión de requerimientos) que permitirían a un usuario tener funciones básicas e interacción con el prototipo. Página 4 de 23

6 1.3 Apreciación global El presente documento detalla los requerimientos funcionales y no funcionales del sistema, además de la especificación de las interfaces que se tienen tanto en la aplicación móvil, como en el servidor. A continuación se exponen los apartes principales del documento: 1. Introducción: Presenta el propósito de elaborar este documento, el alcance del proyecto y por último un listado de referencias y bibliografía usada. 2. Descripción global: Describe las características generales del sistema junto con una vista global de los requerimientos. Esta sección describe además las características de los usuarios, del sistema, las suposiciones y dependencias. 3. Requerimientos de interfaz externos: Presenta los requerimientos de las interfaces de usuario, hardware, software y comunicaciones. 4. Gestión de requerimientos: Esta sección identifica y describe los requerimientos del sistema. 2 Descripción global 2.1 Perspectiva del producto Cero Fila es un sistema que se compone de tres grandes partes: una es la aplicación móvil, otra es el portal web y el último es el servidor. Tanto la aplicación móvil como el portal web son usados para la solicitud de turnos en las colas de todas las empresas y la gestión de turnos de cada usuario. El servidor es usado como centro para el intercambio de información entre los usuarios, la base de datos y/o el servidor de mapas de Google. En otras palabras, toda la información se obtiene, actualiza o carga a través del servidor con el fin de que tenga el control de todo lo que ve el usuario, como lo ve, y si le es permitido acceder a la información solicitada. Por tanto la aplicación móvil y el portal web cumplen las mismas funciones y el servidor no distingue entre uno o el otro teniendo como única restricción una autenticación para poder acceder a la información. Una vez se ha validado la autenticación se establece una sesión que permite el intercambio correcto de información de acuerdo al usuario. Página 5 de 23

7 2.2 Funciones del producto Los usuarios mediante la aplicación o el portal web pueden buscar la empresa, sede y cola de su interés. Los resultados se basarán en los criterios aplicados para la búsqueda. Estos criterios pueden ser modificados fácilmente tanto para la aplicación como para el portal según lo desee el desarrollador. Los resultados muestran, para cualquier búsqueda, un mapa de Google con la ubicación de la sede, la información básica de la empresa (horario, dirección, clasificación de la empresa, sede) y una sección que informa el estado de la cola mostrando tiempo estimado en ser atendido, personas actualmente en la cola y botón de ponerse en cola o cancelar. Cuando el usuario ya ha realizado la búsqueda con los criterios de su interés puede seleccionar el botón solicitar para ponerlo en cola en caso de que varias personas ya se encuentren esperando, caso contrario se le informa que la cola se encuentra vacía y ya podrá ser atendido. Una vez el usuario ha elegido la opción Solicitar y el tiempo estimado en ser atendido es mayor a cinco minutos será redirigido al módulo de Mis Turnos en donde se le indicarán todas las colas en las cuales se encuentra el usuario con la opción de cancelar cualquiera de estas. 2.3 Características de usuario Cero Fila no tiene distinción de personas, solamente existe la restricción de que el servicio debe ser accedido mediante un dispositivo con acceso a internet sin importar si es la aplicación móvil o el portal web, por lo cual se considera que los usuarios tienen conocimiento en el uso de dispositivos móviles, internet y cuentan con un correo electrónico. 2.4 Entorno de funcionamiento La aplicación móvil está diseñada para trabajar únicamente sobre dispositivos móviles con sistema operativo Android que además cuentan con acceso a internet ya sea mediante datos móviles o redes inalámbricas, mientras que el portal web no requiere más que un dispositivo con un navegador y acceso a internet. Página 6 de 23

8 2.5 Restricciones de diseño e implementación Para el total de este proyecto se cuenta con dieciséis semanas, de las cuales para el diseño e implementación del prototipo se destinaron nueve semanas. Por tanto, debido al tan corto tiempo solo se presentan las funciones que se han completado durante este lapso, mientras que las demás fueron totalmente retiradas para un correcto funcionamiento. Por otro lado, el servidor elegido para el servicio y la base de datos cuentan con ciertas limitaciones por ser gratuito, que para este prototipo son suficientes para que funcione de manera adecuada; estas limitaciones se detallan a continuación: Capacidad del servidor ITEM CAPACIDAD Espacio de disco 1500 MB Transferencia de datos 100 GB / Mes PHP 5.2 SSL No MySQL 5.1 Sistema operativo Apache Tabla 1. Capacidad del servidor. 2.6 Suposiciones Para un correcto funcionamiento del prototipo se hace la suposición de que algunas de las colas que se encuentran en el catálogo ya cuentan con dos o más personas en lista, además de que todas las empresas funcionan las 24 horas. Por otro lado, en cuanto a las solicitudes en las colas, se supone que los usuarios no pedirán dos turnos para ser atendidos al mismo tiempo y que siempre asistirán a todos los turnos solicitados. 3 Requerimientos de interfaz externos Esta sección da al lector una descripción detallada de todas las entradas y salidas del sistema, además de toda la descripción del software, hardware e interfaces de comunicación. Página 7 de 23

9 3.1 Interfaces de usuario El usuario podrá interactuar con el sistema mediante sus diferentes interfaces. A continuación se detallan cada una de estas junto con imágenes del portal web para un mayor entendimiento. La primera interfaz corresponde a la página de inicio de sesión que solicita al usuario el correo electrónico con el cuál se ha registrado y la clave. Ilustración 1. Inicio de sesión. De allí, en caso que el usuario no se encuentre registrado puede acceder a la interfaz de registro, la cual solicita datos básicos para darle de alta en el sistema. Página 8 de 23

10 Ilustración 2. Registro. Una vez el usuario ha iniciado sesión puede acceder al catálogo de búsquedas y a los resultados, además del panel de los turnos agendados. Página 9 de 23

11 Ilustración 3. Catálogo de búsquedas y resultados. Ilustración 4. Panel de turnos. Página 10 de 23

12 3.2 Interfaces de hardware La aplicación móvil es soportada en dispositivos móviles que cuenten con adaptador de red móvil o inalámbrico y hardware de entrada y salida como lo son el teclado que permita la entrada de textos, pantalla que muestre la respuesta del servidor, sistema touch que permita la selección de opciones; mientras que el portal web es soportado en dispositivos que cuenten con adaptador de red cableado o inalámbrico, hardware de entrada y salida como lo son teclado que permita la entrada de textos, mouse que permita la selección de opciones o sistema touch y pantalla que permita la respuesta del servidor. 3.3 Interfaces de software Para la aplicación móvil es necesario que el dispositivo móvil cuente con sistema operativo Android versión 4.0 o superior, mientras que el portal web puede funcionar en cualquier sistema operativo siempre y cuando el navegador soporte cookies. Tanto la aplicación como el portal usan también por defecto el API de Google Maps para mostrar las ubicaciones en la respuesta a las búsquedas hechas por los usuarios. 3.4 Interfaces de comunicación Tanto para la aplicación móvil y el portal web es necesario que para la correcta comunicación con el servidor se use el protocolo HTTP y que el adaptador de red utilice el protocolo TCP/IP y cuente con una velocidad de transferencia de 1 MB o superior. 4 Gestión de requerimientos Los requerimientos han sido identificados y especificados buscando una atomicidad para luego poder clasificarlos en funcionales y no funcionales. Los requerimientos funcionales se asocian al comportamiento interno del sistema mientras que los no funcionales se asocian a las restricciones de hardware principalmente. Página 11 de 23

13 4.1 Especificación de requerimientos Los requerimientos han sido especificados usando la siguiente tabla: Documentación de Requerimiento ID Requerimiento Descripción Razón Criterio de medición Prioridad Versión Estado Requerimientos Asociados Autor Tipo de Requerimiento Escenario Asociado (Clasificación) Fecha Creación Dificultad Fecha Modificación Cada elemento de la anterior tabla se especifica a continuación: ID Requerimiento: Identificador único de requerimiento. Tipo de requerimiento: Funcional o no funcional. Descripción: Explicación de forma detallada del requerimiento. Razón: Justificación del requerimiento. Criterio de medición: Método de comprobación del requerimiento. Prioridad: Orden de desarrollo del requerimiento. Versión: Indica cambios en la especificación. Estado: Medición de la evolución del requerimiento (implementado, en espera, en proceso). Requerimientos asociados: Dependencia de un requerimiento respecto a otro. Autor: persona encargada en la especificación del requerimiento. Escenario asociado: clasificación del escenario en el que se encuentra el requerimiento.para requerimientos no funcionales se indica la clasificación solamente. Fecha de creación: fecha en donde se realizó la especificación del requerimiento por primera vez. Página 12 de 23

14 Dificultad: medición del nivel de complejidad al desarrollar el requerimiento (alto medio y bajo). Fecha de modificación: fecha en la que se realizó la última actualización del requerimiento. 4.2 Requerimientos funcionales Clasificación de requerimientos Más específicamente, los requerimientos funcionales han sido clasificados de acuerdo al escenario al que pertenecen y seguidamente estos al objetivo que cumplen. En otras palabras, se han identificado los sub-objetivos del servicio, seguidamente por cada sub-objetivo se ha identificado los escenarios y por último, por cada escenario se han identificado los requerimientos. Jerarquía de objetivos del sistema Solicitud de turnos virtualmente Manejo de sesión Búsqueda Solicitudes Acceso al servicio Ilustración 5. Jerarquía de objetivos. Página 13 de 23

15 La siguiente tabla muestra cada hoja del árbol ya identificada como sub-objetivo, los escenarios asociados y los requerimientos específicos. Tabla de clasificación de requerimientos funcionales Sub-Objetivo Escenario Requerimiento Acceso al Acceso a la aplicación Descarga de la aplicación servicio Acceso al portal Acceder al portal web Manejo de sesión Inicio de sesión Captura de datos de inicio de sesión Verificar datos de inicio de sesión Validar datos de inicio de sesión Inicio de sesión Fin de sesión Cierre de sesión Registro Captura de datos de registro Verificar datos de registro Validar datos de registro Dar de alta Búsqueda Acceso al catálogo Especificación de criterios Limpieza de criterios Acceso a resultados Validación de criterios Carga de resultados Solicitudes Solicitud de turnos Validación de solicitud Agendamiento Cancelación de Cancelación de turnos turnos Solicitud de estado Carga de turnos actuales Tabla 2. Clasificación de requerimientos funcionales Priorización de requerimientos En este trabajo se ha hecho una priorización de requerimientos basándose en la derivación desde escenarios y la descomposición de objetivos[2]. Es decir que, se divide el objetivo general del sistema en sub-objetivos y a cada sub-objetivo se le asocia un escenario que asegura que dicho sub-objetivo se va a cumplir. Una vez se tiene este árbol de sub-objetivos se asignan prioridades a las hojas del árbol de acuerdo a las necesidades. En resumen, se asignan prioridades a los sub-objetivos. Las prioridades de los sub-objetivos se calcularon usando la asignación numérica que divide las prioridades en tres grupos: deseada, obligatoria y no deseada, en donde las más importantes son las obligatorias, luego las deseadas y por último las no deseadas. Página 14 de 23

16 Posterior a esto, por escenario se especifican los requerimientos y a cada requerimiento, teniendo en cuenta la prioridad del sub-objetivo se hace una asignación de prioridades de 1 a N donde N es el número total de requerimientos del escenario siendo 1 la mayor prioridad y N la menor. A continuación se presenta el cuadro de priorización de todos los requerimientos del prototipo. Tabla de priorización de requerimientos funcionales Clasificación Prioridad Sub- Escenario ID Requerimiento Prioridad Objetivo Requerimiento Obligatoria 3 Acceso al Acceso a la R1 Descarga de la 2 servicio aplicación aplicación Acceso al portal R2 Acceder al portal web 1 Obligatoria 4 Manejo de Inicio de sesión R3 Captura de datos de 1 sesión inicio de sesión R4 Verificar datos 4 R5 Validar datos 2 R6 Inicio de sesión 3 Fin de sesión R7 Cierre de sesión 1 Registro R8 Captura de datos de 1 registro R9 Verificar datos 4 R10 Validar datos 2 R11 Dar de alta al usuario 3 Obligatoria 1 Búsqueda Acceso al catálogo R12 Especificación de 1 criterios R13 Limpieza de criterios 2 Acceso a resultados R14 Validación de criterios 1 R15 Carga de resultados 2 Obligatoria 2 Solicitudes Solicitud de turnos R16 Validación de solicitud 1 R17 Agendamiento 2 Cancelación de R18 Cancelación de turnos 4 turnos Solicitud de estado R19 Carga de turnos actuales 3 Tabla 3. Priorización de requerimientos funcionales. Página 15 de 23

17 4.2.3 Documentación de requerimientos Los requerimientos funcionales han sido documentados en el Anexo 1. (Ver Anexo 1. Sección 1. Requerimientos funcionales). 4.3 Requerimientos no funcionales Clasificación de requerimientos Los requerimientos no funcionales han sido clasificados en desempeño, seguridad, portabilidad, disponibilidad, software y hardware. A continuación se especifica cada clasificación. Requerimientos de desempeño: Hacen referencia a la velocidad y capacidad de respuesta del servicio a las diferentes solicitudes de los usuarios. Requerimientos de seguridad: Hacen referencia a como se mantiene la integridad de los datos. Requerimientos de portabilidad: Hacen referencia a cómo y dónde pueden acceder los usuarios al servicio. Requerimientos de disponibilidad: Hacen referencia a cuando pueden acceder los usuarios al servicio. Requerimientos de software: Hacen referencia al entorno en que debe funcionar el servicio. Requerimientos de hardware: Hacen referencia a que capacidad debe tener el dispositivo usado para acceder al servicio. Los requerimientos no funcionales han sido clasificados en la siguiente tabla: Tabla de clasificación de requerimientos no funcionales Clasificación ID Requerimiento Requerimiento Desempeño R20 Respuesta en menos de 3 segundos Seguridad R21 Cada cuenta debe estar protegida R22 Acceso a administración restringido R23 Uso de cifrado Portabilidad R24 Acceder al servicio en cualquier dispositivo Disponibilidad R25 Servicio disponible 24/7 Software R26 La aplicación debe correr en Android Página 16 de 23

18 R27 El portal web debe funcionar en cualquier S.O. R28 El servidor debe funcionar en Apache R29 La base de datos debe usar MySQL Hardware R30 El servidor debe usar 1500 MB de disco o menos R31 El servidor debe usar 100 GB de transferencias o menos. R32 Los dispositivos deben tener 40 MB libres o más R33 Los dispositivos deben tener 1GB de velocidad de internet. Tabla 4. Clasificación de requerimientos no funcionales Priorización de requerimientos Los requerimientos no funcionales han sido priorizados por asignación numérica, en donde a cada requerimiento se le da un único valor siendo 1 la mayor prioridad y N la menor prioridad donde N es el número total de requerimientos no funcionales. La siguiente tabla muestra la priorización de todos los requerimientos no funcionales. Tabla de priorización de requerimientos no funcionales Clasificación ID Requerimiento Requerimiento Prioridad Desempeño R20 Respuesta en menos de 3 segundos 3 Seguridad R21 Cada cuenta debe estar protegida 4 R22 Acceso a administración restringido 9 R23 Uso de cifrado 14 Portabilidad R24 Acceder al servicio en cualquier dispositivo 7 Disponibilidad R25 Servicio disponible 24/7 8 Software R26 La aplicación debe correr en Android 5 R27 El portal web debe funcionar en cualquier 6 S.O. R28 El servidor debe funcionar en Apache 2 R29 La base de datos debe usar MySQL 1 Hardware R30 El servidor debe usar 1500 MB de disco o menos 10 R31 El servidor debe usar 100 GB de 13 transferencias o menos R32 Los dispositivos deben tener 40 MB libres o 11 más R33 Los dispositivos deben tener 1GB de velocidad de internet 12 Tabla 5. Priorización de requerimientos no funcionales. Página 17 de 23

19 4.3.3 Documentación de requerimientos Los requerimientos no funcionales han sido documentados en el Anexo 1. (Ver Anexo 1. Sección 2. Requerimientos no funcionales). Apéndice A: Glosario Glosario CONCEPTO ANDROID API ARTEFACTO GPS HTTP MYSQL PHP PROTOCOLO TCP/IP SAD SISTEMA SSL SRS DEFINICIÓN Sistema operativo basado en Linux que trabaja en dispositivos móviles. Propiedad de Google Inc. Conjunto de reglas y especificaciones que las aplicaciones siguen para comunicarse entre ellas. Producto resultado de la ejecución del proyecto que se le entrega al cliente, o los consumidores finales. Sistema de posicionamiento global. Protocolo de transferencia de hipertexto. Base de datos de código abierto. Lenguaje de programación usado para diseñar páginas web con contenido dinámico. Protocolo de control de transmisión. Permite la creación de conexiones entre diferentes sistemas. Documento de Arquitectura del Software. Para efectos prácticos de este documento, sistema se considera a la aplicación móvil Cero Fila junto con su servidor. Tecnología usada para establecer una conexión segura entre un servidor y un navegador web. Especificación de Requerimientos del Software Tabla 6. Glosario. Página 18 de 23

20 Apéndice B: Índice de tablas Tabla 1. Capacidad del servidor Tabla 2. Clasificación de requerimientos funcionales Tabla 3. Priorización de requerimientos funcionales Tabla 4. Clasificación de requerimientos no funcionales...17 Tabla 5. Priorización de requerimientos no funcionales Tabla 6. Glosario...18 Página 19 de 23

21 Apéndice C: Índice de ilustraciones Ilustración 1. Inicio de sesión... 8 Ilustración 2. Registro Ilustración 3. Catálogo de búsquedas y resultados Ilustración 4. Panel de turnos Ilustración 5. Jerarquía de objetivos...13 Página 20 de 23

22 Bibliografía [1] IEEE Computer Society, « IEEE Recommended Practice for Software Requirements Specifications,» 20 Oct [En línea]. Available: lore.ieee.org%2fiel4%2f5841%2f15571%2f [Último acceso: 23 Ene 2015]. [2] G. Hadad, J. Doorn, M. Ridao y G. Kaplan, «Facilitando la asignación de prioridades a los requisitos,» [En línea]. Available: wer.inf.pucrio.br/werpapers/artigos/artigos_wer09/ridao.pdf. [Último acceso: 2015]. [3] J. León, «Calean - Software Requirements Specification,» Bogota, [4] S. Geagea, S. Zhang, N. Sahlin, F. Hasibi, F. Hameed, E. Rafiyan y M. Ekberg, «Software Requirement Specification - Amazing Lunch Indicator,» [5] R. Hernandez, «Priorización de Requerimientos de Software,» [6] C. Martin, «Un Enfoque de Priorización de Requerimientos, a partir de la Segmentación de las Preferencias de los Stakeholders,» Página 21 de 23

23 Anexos Anexo 1. Documentación de Requerimientos Cero Fila. Página 22 de 23