C121 Ingeniería de Software I
C121. Ingeniería de Software I PROYECTO SEMESTRAL OTOÑO 2009 Lineamientos para la Tercera Entrega:
ESPECIFICACIÓN DE REQUERIMIENTOS DE SOFTWARE
El objetivo del trabajo asociado a la tercera entrega del proyecto semestral es el de poner en práctica algunos métodos y herramientas de la Ingeniería de Requerimientos. Se entregará documentación asociada a la especificación de los requerimientos del software. El documento deberá entregarse impreso de acuerdo al calendario vigente del proyecto, a hora de clase, dentro de la carpeta del proyecto, la cual deberá contener todas las versiones de las entregas pasadas. Cabe recordar que la carpeta debe tener separadores para poder distinguir los diferentes documentos y versiones de éstos y que debe incluirse una portada general para la carpeta, y una portada por cada documento entregado. Este documento contendrá lo siguiente: 0. Portada. Incluye el título “Requerimientos del Software”, nombre del Proyecto, nombre de la compañía, nombre y número de los integrantes del equipo, fecha de realización, y número de versión del documento. 1. Introducción 1.1 Propósito del documento Esta sección describe en pocas palabras cual es la razón de escribir este documento. Este párrafo debe ir al principio de cualquier documento. 1.2 Descripción general del software Se incluye un resumen que incluye los objetivos del software y de sus principales funciones. Aún y cuando esta información ya está en el plan de software, se incluye para hacer este documento auto-sustentable. 1.3 Descripción de actores principales y secundarios Incluye al subconjunto de “stakeholders” del proyecto formado por todos los actores que aparecen en los casos de uso.
Lineamientos Esp. Requerimientos. Versión 6-Oct-09 © P. Gómez-.Gil INAOE
Pag. 1/3
C121 Ingeniería de Software I
1.4 Descripción de interfaces con otros sistemas Aquí se nombran otros sistemas de software, hardware y de comunicación con los cuales este software va a relacionarse en esta versión o en futuras versiones. De no existir, se escribe “ninguno” 2. Características del Sistema En esta parte del documento se especifican todos los requerimientos funcionales del sistema. 2.x Característica x 2.x.1 Descripción y prioridad 2.x.2 Secuencias de estímulo/respuesta 2.x.3 Requerimientos funcionales La “x” en el número de sección indica que, por cada requerimiento principal, hay asociada una sub-sección en esta sección del documento. Una explicación más detallada del contenido de esta parte del documento y ejemplos de cómo escribir estos requerimientos puede encontrarse en el capítulo 10 “Documenting the requirements” de (Wiegers 2003). 3. Diagramas de Casos de Uso y Descripción de Escenarios Se especifica la relación de los actores con el sistema a construirse. Cada caso de uso va acompañado de su correspondiente escenario, el cual puede hacer referencia diagramas de actividades o diagramas de estados descriptivos. Los diagramas de actividades o de estados se usarán solo en aquellos casos que se considere necesario, en lugar de la descripción de “pasos” en el escenario o complementándola. Utilice el formato en Excel de escenarios disponible en la página del curso, sección “material de apoyo”. Coloque todos los diagramas que no sean casos de uso en el apéndice “Otros diagramas”. 4. Descripción de Interfaz humano-computadora Incluye uno o varios dibujos del cómo será la interfaz y los menús que incluye el software. Contiene las subsecciones: 4.1 Prototipo(s) de la interfaz 4.2 Otras consideraciones especiales 5. Requerimientos no funcionales En esta sección se detalla la manera en que va a evaluarse si el software cumple con sus objetivos, en términos de funcionalidad, efectividad y usabilidad. Deben incluirse Lineamientos Esp. Requerimientos. Versión 6-Oct-09 © P. Gómez-.Gil INAOE
Pag. 2/3
C121 Ingeniería de Software I
parámetros cuantitativos sobre cómo van características de calidad. 5.1 Requerimientos de desempeño 5.2 Requerimientos de seguridad 5.3 Atributos de calidad de software
a
medirse
estas
6. Bibliografía Cualquier documento que se utiliza para realizar esta descripción se incluye aquí, haciendo referencia al respectivo lugar donde se obtuvo. La referencia bibliografía de información obtenida de Internet debe incluir Autor, titulo, fecha de publicación y dirección URL (incluya solo referencias de Internet publicadas por una entidad respetable y reconocida). 7. Apéndices 7.1 Glosario Incluye una definición de todas las palabras que se consideren necesarias para entender el documento o que puedan ser entendidas de manera diferente por diferentes personas. Un ejemplo de glosario puede encontrarse en la figura 10.3 titulada “The initial glossary of the MSG Foundation case study” de (Schach 2008) 7.2 Diccionario de datos Se incluye la definición de los principales entes de información utilizados en el sistema, siguiendo los lineamientos especificados en el capítulo 10 titulado: “Documenting the requirements” de (Wiegers 2003). 7.3 Otros diagramas Incluye diagramas de actividades y de estado que apoyan a la descripción de casos de uso. 7.4 Minutas de juntas Se incluyen las minutas realizadas durante las reuniones con el usuario, y minutas de las reuniones del equipo de trabajo. Utilice el formato que se encuentra disponible en la página del curso, en la sección “material de apoyo.”
Referencias Schach, R. Object Oriented Software Engineering. McGraw-Hill, Boston 2008. Wiegers, K.E. Software Requirements, Second Edition. Microsoft Press, Raymond 2003.
Lineamientos Esp. Requerimientos. Versión 6-Oct-09 © P. Gómez-.Gil INAOE
Pag. 3/3