IEEE Objetivo:

Transcripción

1 IEEE Recommended Practice for Software Design Description Creada y desarrollada por: José Luis Loarca de Avila. Fecha: 17/junio/2002 Objetivo: El objetivo de la recomendación IEEE es presentar una guía adaptable para elaborar la descripción de diseño de software (SDD-Software Design Description). 1

2 Definiciones: Entidad de diseño (Design entity): Es un elemento del diseño que es estructural y funcionalmente distinto de otros elementos. Es nombrado y referenciado en forma separada. Puede describir un componente discreto del sistema y puede ser implementado, cambiado y probado con el mínimo efecto de otras entidades. Módulo: Unidad del programa que es discreto e identificable con respecto al compilador, combinado con otras unidades y cargables. Paso de programa (Program step): Instrucción simple ejecutable en lenguaje de programación. Los bloques de programa, selecciones e interacciones son clasificados como simples instrucciones del programa. Definiciones (cont.) Especificaciones de la arquitectura del sistema (System Architecture Specifications): Provee una estructura para el desarrollo del diseño detallado. Este describe la división de la solución en módulos individuales de hardware y software. Además describe la interacción entre estos módulos. No provee una descripción detallada de sus funciones en cada módulo. Esta es la función de la descripción del diseño del software. Especificación requerida del software (Software Requirement Specification): Son los requerimientos de lo que el sistema debe hacer desde el punto de vista del usuario. 2

3 Definiciones (cont.) Descripción del diseño de software (Software Design Description): Describe en forma detallada las funciones de cada componente del software. Esquema estructural: Diagrama que identifica los módulos, actividades u otras entidades en un sistema o programa. Arquitectura del sistema: Conjunto de componentes hardware y software cuyas interfaces constituyen el sistema. Pruebas de caja blanca (White box testing): Pruebas aplicadas en el interior de una estructura del cuerpo del software para asegurar que todas las rutas sean utilizadas y todos los bloques ejecutados. Propósito El SDD es creado por el diseñador de sistemas y es generalmente proporcionado para el diseño de los procesos detallados. 3

4 Requisitos previos La documentación previa requerida para el SDD varia según el tamaño y complejidad del producto software a desarrollar. Sistemas grandes: Uso de las especificaciones de la arquitectura del sistema (SAS). En este contexto el SDD representa otro proceso de refinamiento en el diseño de entidades descrito en el SAS. El SDD puede proveer descripciones para uno o más entidades de diseño. Sistemas pequeños: Uso de la especificación de requerida del software (SRS). Este contexto es la forma sencilla del diseño de la solución a problemas comenzados en el SRS. Aplicación El SDD es la referencia primaria para el desarrollo del código. En sí, debe contener toda la información requerida por el programador para escribir el código. 4

5 Criterio de calidad Se definirá el criterio en el cual la calidad del SDD será evaluada. Trazabilidad (Traceability) Cada entidad de diseño descrita en el SDD debe satisfacer un requerimiento interno de diseño. 5

6 Cumplimiento de estándares Todos los SDD s deberán tener un encabezado de párrafo. Si un encabezado de párrafo no se utiliza en el diseño, este será incluido y marcado como no aplicable. Todos los párrafos aplicables deberán referenciar al checklist de los puntos cubiertos en cada subsección de este estándar. Diseño de la base de datos El diseño de la base... Comprensibilidad Están los conceptos de diseño en un lenguaje simple o ambiguo? Pueden los conceptos de diseño ser entendidos en la primera lectura? Pueden ser las descripciones de diseño obvias sin dejar nada a la imaginación del lector? 6

7 Modularidad Es el grado en el cual el problema (comprensión, pruebas, programación, etc.) es dividido en problemas más pequeños cuya solución puede ser alcanzada en forma independiente. Cohesión Es el grado en que los elementos internos de un módulo son relacionados otro otros. 7

8 Acople Es el grado en el cual módulos individuales son independientes entre sí. Bueno: Regular: Malo: Acople de datos (máx. 5 parámetros entre módulos) Acople de control (un módulo controla la sec. de instrucciones en otro módulo) Acople común (muchas rutinas referencian a un bloque común de datos) Muy malo: Acople de contenido (un módulo modifica valores de datos locales en otro módulo) Concentración (Fan-in) Es el número de módulos que llaman a un módulo. Una buena modularidad es cuando se maximiza la concentración. DIVISION DE CONTROL: Número de módulos subordinados llamados por un módulo. Una gran división de control (mayor a 7) puede indicar que el módulo es demasiado complejo. Esto es, contiene demasiado control y lógica de coordinación. 8

9 Implementabilidad El SDD deberá proveer toda la información que el programador requiere para codificar la entidad descrita. Modificabilidad El diseño de la información será presentada de una sola forma para dar un soporte a modificaciones futuras del documento. Una instancia de más de una ocurrencia de la misma información puede ser ambigua si todas las ocurrencias de la información no son actualizadas simultáneamente. 9

10 Extendibilidad Es la forma más sencilla en la que el diseño puede ser adaptado a los cambios de los requerimientos. Los elementos claves de la extendibilidad son: - Simplicidad del diseño - Modularidad Puntos a cubrir El SDD deberá cubrir: Formato y contenido Portada Página de comentarios Introducción Propósito Visión Definiciones, acrónimos y abreviaciones Referencias Descomposición del diseño Estructura del diseño Estructura del código Descripción detallada del diseño del módulo Identificación Propósito Función Subordinados Dependencias Interfaces Recursos Datos internos Procesamiento Información implementada al proceso Estrategia de prueba al módulo Descripción del diseño de la interfase - Identificación - Tipo - Propósito - Función - Protocolo - Códigos de error - Interacción con el usuario Diseño de la base de datos - Introducción - Diccionario de datos - Diseño de la base de datos Memoria global Mensajes generales Mensajes de usuario Mensajes interproceso Índice Apéndice 10

11 Referencias (IEEE ) Institute of Electric and Electronic Engineers. Software Design Description Software Requirements Specifications 11