DOCUMENTACIÓN REQUERIMIENTOS

Transcripción

1 DOCUMENTACIÓN REQUERIMIENTOS HERRAMIENTA PARA LA ADMINISTRACIÓN DE REQUERIMIENTOS DE LOS PROYECTOS DE LAS ASIGNATURAS DE INGENIERÍA Y ARQUITECTURA DE SOFTWARE DE LA PONTIFICIA UNIVERSIDAD JAVERIANA. CARLOS DAVID DUARTE ALFONSO PONTIFICIA UNIVERSIDAD JAVERIANA FACULTAD DE INGENIERÍA CARRERA DE INGENIERÍA DE SISTEMAS BOGOTÁ D.C 2014

2 Historial De Cambios El historial de cambios es una tabla que muestra la evolución y seguimiento del documento, todos los cambios realizados permiten elaborar, corregir y controlar la calidad del documento por parte del autor. Versión Fecha Sección del documento modificada V /03/2014 Documentación requerimientos V /03/2014 Capítulo 2, sección 2.1, 2.2 V /03/2014 Capítulo 2, sección 2.2 y 2.3. V /03/2014 Capítulo 2, sección 2.4, 2.5 V /03/2014 Capítulo 2, sección 2.5, 2.6 de cambios Estructura general Especificación requerimientos funcionales: REQ 001, REQ 002 y REQ 003. Especificación requerimientos funcionales: REQ 004, REQ 005 y REQ 006. Especificación requerimientos funcionales: REQ 007, REQ 008 y REQ 009. Especificación requerimientos funcionales: REQ 010, REQ 011 y REQ 012. Responsable V /04/2014 Capítulo 1 Diccionario de datos V //04/2013 Capítulo 3 Elaboración capitulo y subsecciones V /04/2014 Documentación requerimientos Entrega Tabla 1 Historial de cambios 2

3 Tabla de Contenido Historial De Cambios Diccionario de datos Funcionalidades ERMT Línea base de requerimientos Crear línea base de requerimientos Consultar línea base de requerimientos Eliminar línea base de requerimientos Control de versiones en los requerimientos Modificar requerimiento Consulta historial de cambios en los requerimientos Problemas en los requerimientos Asociar problema a un requerimiento Editar problema a un requerimiento Eliminar problema a un requerimiento Generar reporte problemas en los requerimientos Matriz de trazabilidad Reportes matriz de trazabilidad Gestión de riesgos Identificación de riesgos Editar riesgo a requerimiento Generar técnica de mitigación Documentación Requerimientos funcionales Control de versiones Seguimiento de estado Control de cambios Trazabilidad Riesgos Técnicas de mitigación

4 4. Documentación requerimientos no funcionales Desempeño Disponibilidad Usabilidad Mantenibilidad Portabilidad Funcionalidad Confiabilidad Referencias

5 Índice de Tablas Tabla 1 Historial de cambios... 2 Tabla 2 Crear línea base requerimientos... 8 Tabla 3 Consultar línea base requerimientos... 8 Tabla 4 Eliminar línea base requerimientos... 8 Tabla 5 Modificar requerimiento... 9 Tabla 6 Historial de cambios... 9 Tabla 7 Asociar problema a un requerimiento Tabla 8 Editar problema a un requerimiento Tabla 9 Eliminar problema a un requerimiento Tabla 10 Generar reporte problemas en los requerimientos Tabla 11 Matriz de trazabilidad Tabla 12 Reporte matriz Tabla 16 Identificación de riesgos Tabla 17 Editar riesgo Tabla 18 Técnica de mitigación Tabla 19 Requerimiento funcional Tabla 20 Requerimiento funcional Tabla 21 Requerimiento funcional Tabla 22 Requerimiento funcional Tabla 23 Requerimiento funcional Tabla 24 Requerimiento funcional Tabla 25 Requerimiento funcional Tabla 26 Requerimiento funcional Tabla 27 Requerimiento funcional Tabla 28 Requerimiento funcional Tabla 30 Requerimiento funcional Tabla 31 Requerimiento funcional Tabla 32 Requerimiento funcional Tabla 33 Requerimiento funcional Tabla 34 Requerimiento no funcional Tabla 35 Requerimiento no funcional Tabla 36 Requerimiento no funcional Tabla 37 Requerimiento no funcional Tabla 38 Requerimiento no funcional Tabla 39 Requerimiento no funcional Tabla 40 Requerimiento no funcional Tabla 41 Requerimiento no funcional Tabla 42 Requerimiento no funcional Tabla 43 Requerimiento no funcional Tabla 44 Requerimiento no funcional Tabla 45 Requerimiento no funcional

6 Tabla 46 Requerimiento no funcional Tabla 47 Requerimiento no funcional

7 1. Diccionario de datos En este capítulo se dan las definiciones de los diferentes conceptos y palabras que se usan a los largo de este documento, con el fin de minimizar la ambigüedad en la documentación de los requerimientos funcionales y no funcionales. Un diccionario de datos es un documento que describe la organización básica de una base de datos. Normalmente, un diccionario de datos contiene una lista de las variables de la base de datos, así como los nombres de las variables asignadas y una descripción de cada tipo de variable. El diccionario de datos tiene los valores aceptados para cada variable, y cualesquiera comentarios útiles tales como exclusiones importantes y las pautas de omisión. El diccionario de datos se utiliza principalmente para el análisis de datos. [5] Línea base de requerimientos: Una línea base define un conjunto de requerimientos acordados normalmente para un lanzamiento o iteración especifica. [1] Matriz de trazabilidad: Una matriz de trazabilidad de requerimientos es útil para confirmar que todos los requerimientos se aplican y se verifican. También es útil durante el mantenimiento, cuando un requerimiento tiene que ser modificado. [1] Problemas en los requerimientos: Los problemas más comunes con los requerimientos son los siguientes: Preguntas sobre requerimientos: Hay algo que no se entiende o decidir acerca de un requerimiento. Falla de un requerimiento: Los desarrolladores descubren un requerimiento perdido durante el diseño o implementación. Requerimiento incorrecto: Un requerimiento que estaba mal. Debe ser corregido o eliminado. Pregunta de implementación: Como lo desarrolladores implementan los requerimientos, tienen preguntas acerca de cómo debería funcionar algo o sobre alternativas de diseño. Requerimientos duplicados: Se descubren dos o más requerimientos equivalentes. Eliminar todos menos uno de ellos. Requerimientos innecesarios: Un requerimiento simplemente no se necesita más. [1] Proceso control de cambios: El proceso de cambios debe definir cómo se proponen los cambios de requerimientos, para luego analizarlos y resolverlos. [1] Requerimiento: Una descripción detallada de lo que el software tiene que hacer. [2] Requerimiento funcional: Son declaraciones de los servicios que debe proporcionar el sistema, de la manera en que esté debe reaccionar a entradas particulares y de cómo se debe comportar en situaciones particulares. [4] Requerimiento no funcional: Son restricciones de los servicios o funciones ofrecidos por el sistema. Incluyen restricciones de tiempo, sobre el proceso de desarrollo y estándares. [4] 7

8 2. Funcionalidades ERMT 2.0 El siguiente capítulo tiene como propósito definir el flujo de información necesaria para que cada funcionalidad de ERMT 2.0 correctamente y es proporcionada por el usuario final Línea base de requerimientos Crear línea base de requerimientos Variable Tipo Tamaño Valores Nom_LineaBase Texto 100 Indica el nombre correspondiente a línea base creada. Versión Alfanumérico 10 Indica una referencia única para [0...9].[0 9] esta línea base. Alfanumérico 500 Indica una breve explicación del porque se escogieron esos requerimientos y el responsable. Lista_Req Texto 50 Lista donde se muestran y seleccionan los requerimientos del proyecto que van hacer parte de esta línea base. Tabla 2 Crear línea base requerimientos Consultar línea base de requerimientos Variable Tipo Tamaño Valores Lista_LineasBase Texto 50 Lista donde se muestran las líneas base de requerimientos del proyecto. Tabla 3 Consultar línea base requerimientos Eliminar línea base de requerimientos Variable Tipo Tamaño Valores Lista_LineasBase Texto 50 Lista donde se muestran las líneas base de requerimientos del proyecto. Tabla 4 Eliminar línea base requerimientos 8

9 2.2. Control de versiones en los requerimientos Modificar requerimiento Variable Tipo Tamaño Valores Lista_Req Texto 50 Lista donde se muestran los requerimientos y se selecciona un requerimiento del proyecto. Fecha Texto 15 Este parámetro indica la fecha en que se realiza la modificación DD/MM/AAAA del requerimiento. Alfanumérico 300 Indica la descripción del requerimiento, el cual se puede editar Versión Alfanumérico 10 Indica la versión asociada a ese requerimiento, el cual cambia cuando se edita. Texto 20 Indica el actual estado del requerimiento, el cual puede ser modificado. Responsable Texto 25 Indica la persona responsable de cambiar la descripción, estado y versión del requerimiento. Tabla 5 Modificar requerimiento [0...9].[0 9] Propuesto Aprobado Verificado Eliminado Rechazado Consulta historial de cambios en los requerimientos Variable Tipo Tamaño Valores Lista_Req_Versiones Texto 50 Lista donde se muestran los requerimientos con sus correspondientes cambios, estados y versiones. Tabla 6 Historial de cambios 2.3. Problemas en los requerimientos Asociar problema a un requerimiento Variable Tipo Tamaño Valores Lista_Req Texto 50 Lista donde se muestran los requerimientos y se selecciona un requerimiento del proyecto. 9

10 Fecha Texto 15 Este parámetro indica la fecha en que se asocia el problema al requerimiento. Descripcion_Prob Alfanumérico 300 Indica la descripción del problema (el requerimiento es ambiguo, esta repetido etc.) asociado al requerimiento escogido. Stakeholders Alfanumérico 300 Indica los stakeholders que se ven afectados por el problema. Posible_Sol Alfanumérico 300 Indica la posible solución a ese problema. Tabla 7 Asociar problema a un requerimiento DD/MM/AAAA Editar problema a un requerimiento Variable Tipo Tamaño Valores Lista_Req_Pro Texto 50 Lista donde se muestran los requerimientos y se selecciona un requerimiento del proyecto que tiene asociado un problema. Descripcion_Prob Alfanumérico 300 Indica la descripción del problema (el requerimiento es ambiguo, esta repetido etc.) asociado al requerimiento escogido. Stakeholders Alfanumérico 300 Indica los stakeholders que se ven afectados por el problema. Posible_Sol Alfanumérico 300 Indica la posible solución a ese problema. Razon_Cambio Alfanumérico 300 Indica cual fue el motivo de editar el problema asociado a ese requerimiento. Tabla 8 Editar problema a un requerimiento Eliminar problema a un requerimiento Variable Tipo Tamaño Valores Lista_Req_Pro Texto 50 Lista donde se muestran los requerimientos y se selecciona un requerimiento del proyecto que tiene asociado un problema. Solucion_Prob Alfanumérico 300 Indica la descripción de cómo se pudo solucionar el problema asociado a ese requerimiento. Tabla 9 Eliminar problema a un requerimiento 10

11 Generar reporte problemas en los requerimientos Nombre proyecto Fecha Número de requerimientos Id Requerimiento Fecha creación Problema Stakeholders afectados Posible solución Razón cambio Solución Indica el nombre del proyecto DD/MM/AAAA Indica la cantidad de requerimientos con problemas asociados al proyecto. Identificador único del requerimiento DD/MM/AAAA Solucionado/No solucionado Tabla 10 Generar reporte problemas en los requerimientos 2.4. Matriz de trazabilidad Variable Tipo Tamaño Valores Opcion_Req Texto 50 Opción que permite seleccionar el eje donde aparecen los requerimientos y el tipo de matriz. Opcion_CU Texto 50 Opción que permite seleccionar el eje donde aparecen los casos de uso y el tipo de matriz. Tabla 11 Matriz de trazabilidad Verdadero, Falso Verdadero, Falso Reportes matriz de trazabilidad En esta sección se muestra la matriz de trazabilidad que se pueden generar a través de esta opción. Id Requerimiento Casos de uso asociados 1 CU 001, CU CU CU 001, CU CU CU 005. Tabla 12 Reporte matriz 1 11

12 2.5. Gestión de riesgos Identificación de riesgos Variable Tipo Tamaño Valores Lista_Req Texto 50 Lista donde se muestran los requerimientos y se selecciona un requerimiento del proyecto. Identidad Texto 10 Indica el nivel de riesgo cuando no se sabe o no se puede identificar requerimientos clave. Volatilidad Texto 10 Indica el nivel de riesgo los requerimientos pueden cambiar fácilmente. Complejidad Texto 10 Indica el nivel de riesgo cuando los requerimientos son difíciles de entender y especificar. Tabla 13 Identificación de riesgos Alto Medio Bajo Alto Medio Bajo Alto Medio Bajo Editar riesgo a requerimiento Variable Tipo Tamaño Valores Lista_Req Texto 50 Lista donde se muestran los requerimientos y se selecciona un requerimiento del proyecto. Identidad Texto 10 Indica el nivel de riesgo cuando no se sabe o no se puede identificar requerimientos clave. Volatilidad Texto 10 Indica el nivel de riesgo los requerimientos pueden cambiar fácilmente. Complejidad Texto 10 Indica el nivel de riesgo cuando los requerimientos son difíciles de entender y especificar. Tabla 14 Editar riesgo Alto Medio Bajo Alto Medio Bajo Alto Medio Bajo Generar técnica de mitigación Variable Tipo Tamaño Valores Lista_Req_Riesgos Texto 50 Lista donde se muestran los requerimientos que tiene asociado un riesgo. Tabla 15 Técnica de mitigación 12

13 3. Documentación Requerimientos funcionales 3.1. Control de versiones ID Requerimiento REQ 001 Versión /03/ /05/2014 El sistema debe permitir crear una línea base de requerimientos. CU 001, SRS. Se pudo crear un conjunto de requerimientos como línea base. Verificado REQ 003. Tabla 16 Requerimiento funcional 001 ID Requerimiento REQ 002 Versión Media 25/03/ /05/2014 El sistema debe permitir consultar las líneas base de requerimientos. CU 001, SRS. Se pudo listar todas las líneas base de requerimientos del proyecto. Verificado REQ 001. Tabla 17 Requerimiento funcional 002 ID Requerimiento REQ 003 Versión Baja 25/03/ /05/2014 El sistema debe permitir eliminar una línea base de requerimientos. 13

14 CU 001, SRS. Se pudo eliminar la línea base, sin que se vean afectados los requerimientos asociados a ella. Verificado REQ 001, REQ 002. Tabla 18 Requerimiento funcional Seguimiento de estado ID Requerimiento REQ 004 Versión Media 26/03/ /05/2014 El sistema debe permitir asociar un problema a un requerimiento. CU 004, SRS. El usuario puede visualizar el problema a un requerimiento. Verificado REQ 007. Tabla 19 Requerimiento funcional 004 ID Requerimiento REQ 005 Versión Media 26/03/ /05/2014 El sistema debe permitir editar un problema a un requerimiento. CU 005, SRS. El usuario puede modificar el problema asociado a un requerimiento. Verificado REQ 007. Tabla 20 Requerimiento funcional

15 ID Requerimiento REQ 006 Versión Media 26/03/ /05/2014 El sistema debe permitir eliminar un problema a un requerimiento. CU 006, SRS. El usuario puede eliminar el problema asociado a un requerimiento. Verificado REQ 007. Tabla 21 Requerimiento funcional 006 ID Requerimiento REQ 007 Versión /03/ /05/2014 El sistema debe permitir generar un reporte de problemas en los requerimientos. CU 007, SRS. El usuario puede visualizar y guardar el reporte general de los problemas asociados a los requerimientos. Verificado REQ 004, REQ 005, REQ 006. Tabla 22 Requerimiento funcional Control de cambios ID Requerimiento REQ 008 Versión Media 25/03/ /05/2014 El sistema debe permitir modificar un requerimiento. CU 002, SRS. 15

16 Cada requerimiento del proyecto de puede modificar su descripción, estado y versión. Verificado REQ 009. Tabla 23 Requerimiento funcional 008 ID Requerimiento REQ 009 Versión Baja 27/03/ /05/2014 El sistema debe permitir consultar el historial de cambios en los requerimientos. CU 003, SRS. El usuario puede consultar los cambios realizados a un requerimiento. Verificado REQ 008. Tabla 24 Requerimiento funcional Trazabilidad ID Requerimiento REQ 010 Versión /03/2014 El sistema debe permitir generar una matriz de trazabilidad de casos de usos relacionados. CU 008, SRS. El usuario puede visualizar y guardar la matriz de trazabilidad entre las relaciones de requerimientos y casos de uso. Aprobado REQ 011. Tabla 25 Requerimiento funcional

17 3.5. Riesgos ID Requerimiento REQ 012 Versión /03/ /05/2014 El sistema debe permitir asociar un riesgo a un requerimiento. CU 009, SRS. El usuario puede escoger Verificado REQ 013. Tabla 26 Requerimiento funcional 012 ID Requerimiento REQ 013 Versión /03/ /05/2014 El sistema debe permitir editar un riesgo a un requerimiento. CU 009, SRS. El usuario puede editar el nivel de prioridad del riesgo asociado al requerimiento. Verificado REQ 012. Tabla 27 Requerimiento funcional Técnicas de mitigación ID Requerimiento REQ 014 Versión /03/2014 El sistema debe generar el nivel de énfasis para cada técnica de mitigación. CU 010, SRS. 17

18 El usuario puede visualizar los diferentes niveles para cada técnica. REQ 012, REQ 013, REQ 015. Tabla 28 Requerimiento funcional 014 ID Requerimiento REQ 015 Versión /03/2014 El sistema debe permitir consultar los riesgos en los requerimientos. CU 010, SRS. El usuario puede visualizar los diferentes niveles para cada técnica. REQ 012, REQ 013, REQ 014. Tabla 29 Requerimiento funcional Documentación requerimientos no funcionales 4.1. Desempeño ID Requerimiento REQ 016 Versión /01/2014 El tiempo de respuesta no debe ser superior a los 30 segundos. El tiempo de respuesta del sistema ante cualquier consulta no debe superar los treinta segundos. REQ 017, REQ 018. Tabla 30 Requerimiento no funcional

19 ID Requerimiento REQ 017 Versión /01/2014 El sistema deberá generar el grafo de los requerimientos en no más de 60 segundos. El grafo se genera en un tiempo máximo de 60 segundos. REQ 016, REQ 018. Tabla 31 Requerimiento no funcional 017 ID Requerimiento REQ 018 Versión /01/2014 El sistema debe calcular la priorización en un tiempo máximo de 60 segundos. Los valores de priorización de los requerimientos deben realizarse en no más de 60 segundos. REQ 016, REQ 017. Tabla 32 Requerimiento no funcional Disponibilidad ID Requerimiento REQ 019 Versión REQ /01/2014 El sistema debe iniciarse cada vez que el usuario así lo desee. La disponibilidad de la herramienta debe estar disponible y funcional 24/7. 19

20 Tabla 33 Requerimiento no funcional 019 ID Requerimiento REQ 020 Versión /01/2014 El sistema solo se debe ejecutar una vez. La aplicación no se debe ejecutar más de dos veces de manera concurrente. REQ 019. Tabla 34 Requerimiento no funcional Usabilidad ID Requerimiento REQ 021 Versión Media 02/01/2014 El sistema debe contar con una ayuda. El usuario tiene la opción de ayuda a través del manual de usuario. REQ 022. Tabla 35 Requerimiento no funcional 021 ID Requerimiento REQ 022 Versión Media 03/01/2014 El sistema debe contar con un tutorial. 20

21 El manual de usuario debe permitir al usuario instalar y manejar la aplicación de manera correcta. REQ 021. Tabla 36 Requerimiento no funcional Mantenibilidad ID Requerimiento REQ 023 Versión Medio 03/01/2014 El sistema debe estar organizado por módulos. Los componentes de GUI, lógica y persistencia, deben estar en diferentes componentes. REQ 024. Tabla 37 Requerimiento no funcional 023 ID Requerimiento REQ 024 Versión Medio 03/01/2014 El sistema debe estar documentado por medio de la herramienta JavaDoc. Toda clase y método de la aplicación debe estar documentado mediante la herramienta JavaDoc. REQ 023. Tabla 38 Requerimiento no funcional Portabilidad ID Requerimiento REQ 025 Versión

22 04/01/2014 El sistema debe ser instalado en Sistemas Operativos Windows XP o superior. La aplicación no debe tener inconvenientes en la instalación en sistemas operativos Windows. Ninguno Tabla 39 Requerimiento no funcional Funcionalidad ID Requerimiento REQ 026 Versión Media 04/01/2014 El sistema debe ser compatible con Microsoft Word Los documentos generados por los diferentes tipos de reportes que existen en la herramienta, se deben poder abrir con Microsoft Word 2007 o superior. REQ 027. Tabla 40 Requerimiento no funcional 026 ID Requerimiento REQ 027 Versión Media 05/01/2014 El sistema debe ser compatible con Microsoft Excel Los documentos generados por los diferentes tipos de reportes que existen en la herramienta, se deben poder abrir con Microsoft Excel 2007 o superior. 22

23 REQ 026. Tabla 41 Requerimiento no funcional Confiabilidad ID Requerimiento REQ 028 Versión /01/2014 El sistema debe informar sobre los fallos en la creación de artefactos. Cada vez que ocurra un fallo por la creación de artefactos, se mostrará una ventana de advertencia por pantalla. REQ 029. Tabla 42 Requerimiento no funcional 028 ID Requerimiento REQ 029 Versión Media 05/01/2014 El sistema debe informar sobre los fallos en la modificación de artefactos. Cada vez que ocurra un fallo por la modificación de artefactos, se mostrará una ventana de advertencia por pantalla. REQ 028. Tabla 43 Requerimiento no funcional Referencias [1] K. E. Wiegers and J. Beatty, Software requirements

24 [2] Software Project Management Boot Camp Construx. [Online]. Available: /#0. [3] ERMT. [Online]. Disponible: [4] I. Sommerville, Software Engineering. Addison-Wesley, [5] J. Beatty and A. Chen, Visual Models for Software Requirements: An Rml Handbook. [s.l.]: Microsoft Pr,