COPIA NO CONTROLADA. ININ No: P.SI-2 Rev.: 2 Fecha de Emisión: Agosto de 2010 Hoja: 1 de: 9. FIRM~.J Qu 1E.; hajo

Transcripción

1 f I Area: Departamento de Sistemas Informáticos ININ No: P.SI-2 Rev.: 2 Hoja: 1 Contenido Página 1. Objetivo y Alcance Objetivo... : Alcance Notaciones y Definiciones Notaciones Definiciones Desarrollo Proceso Contenido Introducción... 5 a) Propósito... :... 5 b) Alcance... 5 c) Definiciones... 5 d) Acrónimos... 5 e) Referencias... 5 f) Resumen Descripción de la Descomposición... 6 a) Descomposición de Módulos... 6 b) Descomposición de Procesos... 6 c) Descomposición de Datos Descripción de la Dependencia... 6 a) Dependencia de Módulos... 6 b) Dependencia de Procesos... 6 c) Dependencia de Datos Descripción de la Interfaz... ~... 7 a) Interfaz de Módulos... 7 b) Interfaz de Procesos Descripción del Diseño Detallado... 7 a) Diseño Detallado de Módulos... 7 b) Diseño Detallado de Datos Anexos Responsabilidades... GARANltA.. DE... CAlIDAD Referencias... Q9.~~H~~r9... y.~~!~!~~.q9... J Anexos... (~:~~,~Rr.. Y.,G.(:S.I.. f FIRM~.J Qu 1E.; hajo :.'\..' Preparado por: Rafael Muñoz Goytia Fecha: Revisado por: Ing. David Valdivia Rosas.. :/ ~~ Fecha: Aprobado por: Ing. Alfonso Villarreal Martínez. r}/://///;-y////.:7 / /n Fecha:

2 Hoja: 2 1. Objetivo y Alcance 1.1. Objetivo Establecer el proceso para la preparación de la Descripción de Diseño de Software que describe los componentes y estructuras de datos que satisfacen los requerimientos identificados en el documento de Especificación de Requerimientos de Software, y que se empleará en la fase de Implementación del Software Alcance Este procedimiento se debe aplicar al software que desarrolla el personal del Departamento de Sistemas Informáticos bajo el Sistema de Garantía de Calidad del ININ. Este procedimiento esta considerado como Norma Interna de Administración al estar relacionado con el tema de Tecnologías de la Información, de conformidad con el Sistema de Mejora Regulatoria Interna del Programa de Mejora de la Gestión de la Administración Pública Federal Notaciones y Definiciones 2.1. Notaciones DDS Descripción de Diseño de Software ERS Especificación de Requerimientos de Software PDF Portable Document Format SI Departamento de Sistemas Informáticos 2.2. Definiciones Atributo Característica de una entidad Entidad Algo acerca de lo que se almacenan datos, pudiendo ser tangible ó intangible

3 Hoja: Módulo Componente de un sistema, Unidades individuales de código fuente que forman un programa Proceso Secuencia de pasos ejecutados para lograr un propósito Pseudocódigo Lenguaje de descripción procedural para expresar la lógica de un programa que utiliza las estructuras lógicas de control así como la identación para cada una de estas estructuras como una ayuda visual en la percepción de la lógica Responsable de Desarrollo Persona del SI con conocimiento detallado de las actividades del proceso de desarrollo de software quién coordina y participa en las actividades del desarrollo Revisor Personal con experiencia en software que no haya tenido contacto sustancial con el desarrollo o modificación del programa de cómputo, quién debe revisar y comprobar el cumplimiento de los requisitos establecidos Sistema Una colección de componentes organizados para lograr una función o conjunto de Funciones Software Programas de computadora, procedimientos, reglas y cualquier documentación asociada y datos relativos a la operación de un sistema de computadora.

4 Hoja: Usuario Organización, persona ó personas que definen los requerimientos, operan o interactúan directamente con el software Validación 3. Desarrollo 3.1. Proceso El proceso de evaluación de un sistema o componente durante ó al final del proceso de desarrollo para determinar si satisface los requerimientos especificados Verificación El proceso de evaluar un sistema o componente para determinar si el producto de una determinada fase de desarrollo satisface las condiciones impuestas al inicio de esa fase El proceso a seguir para la preparación de la Descripción de Diseño de Software se indica en forma gráfica en el Anexo I, y se describe a continuación: Preparación de la DDS El responsable de desarrollo ó la persona designada por él, prepara la DDS conforme a este procedimiento, basado en la ERS Revisión de la DDS a) El usuario revisa la interfaz de módulos descrita en la DDS b) El revisor verifica la DDS conforme al proceso de Verificación de software y la ERS c) En caso de existir observaciones, estas se turnan al responsable de desarrollo para su aplicación en la DDS.

5 Hoja: Aprobación de la DDS Una vez completada la preparación y revisión de la DDS, esta se envía al Jefe del SI para su aprobación Contenido El contenido de la DDS se documenta en formato PDF, empleando las formas FP.SI-1/0/4, FP.SI-2/0/4 y FP.SI-3/0/4, descritas en los Anexos II, III y IV del Procedimiento P.SI-4, Plan de Administración de la Configuración de Software, Rev. Vigente. Estas formas se utilizarán como página de portada, como página de continuación y como página de terminación respectivamente. A continuación se describe el contenido de la DDS Introducción a) Propósito Se describe el propósito de la DDS y se indica a que personal esta dirigida b) Alcance Se identifica el software que se describe en la DDS, y se explica lo que el software hará, incluyendo objetivos, metas, y beneficios relevantes tan preciso como sea posible. c) Definiciones Se definen los términos requeridos para interpretar la DDS apropiadamente, listándolos en orden alfabético. d) Acrónimos Se definen los acrónimos y abreviaturas requeridos para interpretar la DDS apropiadamente, listándolos en orden alfabético. e) Referencias Se proporciona una lista completa de los documento referenciados en la DDS, identificando cada documento por: título, número de reporte, número de versión, organización que publica y fecha de publicación.

6 Hoja: 6 f) Resumen Describir el contenido del resto de la DDS, y explicar como la DDS esta organizada Descripción de la Descomposición a) Descomposición de Módulos Identificar por nombre y descripción de su funcionalidad, cada uno de los módulos en que se divide el software b) Descomposición de Procesos Identificar por nombre y descripción cada uno de los procesos concurrentes c) Descomposición de Datos Se definen las entidades de datos que soportarán el software, identificando por nombre y descripción cada una de las entidades de datos del dominio del software Descripción de la Dependencia a) Dependencia de Módulos Identificar las relaciones entre los módulos para lograr la funcionalidad completa del software, proporcionado una lista que indique para cada módulo los módulos que se asocian. b) Dependencia de Procesos Identificar los componentes de software que emplean los procesos, proporcionando una lista que indique para cada proceso los componentes de software que emplea. c) Dependencia de Datos Identificar las asociaciones entre las entidades de datos del software, proporcionando Nombre de la asociación, entidades de datos asociadas y tipo de asociación

7 Hoja: Descripción de la Interfaz a) Interfaz de Módulos Para cada módulo, explicar su funcionalidad y como el usuario será capaz de usar el sistema para completar características esperadas, incluyendo formatos de pantallas b) Interfaz de Procesos Describir como los procesos identificados en el párrafo , inciso b) trabajan juntos Descripción del Diseño Detallado a) Diseño Detallado de Módulos Se describe cada uno de los módulos, indicando el nombre y función(es) que realiza. Se describe también el nombre de cada proceso, y su descripción en un lenguaje de descripción procedural, por ejemplo: pseudocódigo. b) Diseño Detallado de Datos i) Entidades Se identifican los datos que forman las entidades de datos, Indicando nombre del dato y tipo de atributo del dato Anexos ii) Atributos Se describen los datos contenidos en las entidades de datos, indicando nombre del dato, tipo de dato, longitud del dato, y si procede, valores que puede almacenar Se proporciona una lista de los documentos anexos, identificando cada documento con: el título Anexo seguido de un número consecutivo, y nombre del mismo.

8 Hoja: 8 4. Responsabilidades 4.1. Jefe del SI Asegurar la correcta aplicación de este procedimiento Firmar de Aprobado la DDS generada en el SI 4.2. Responsable de desarrollo Designar a la persona que elabora la DDS Preparación de la DDS conforme a este procedimiento 4.3. Revisor 4.4. Usuario 5. Referencias Realizar la verificación y validación de la DDS Firmar de revisado la DDS Revisar la interfaz de módulos descrita en la DDS Firmar de revisado la DDS 5.1. Recommended Practice for Software Design Description, IEEE Std Programa de Aseguramiento de Calidad de Software de la GCN, PAG-14, Rev. 4, CFE, Diciembre de Elaboración de Procedimientos e Instrucciones, P.SGC.DG-21, Rev. 14, ININ, Agosto de Plan de Garantía de Calidad de Software, PL.GC-2, Rev. Vigente, ININ. 6. Anexos Anexo I Diagrama de Flujo

9 Hoja: 9 Anexo I Diagrama de Flujo

10 Control ININ de Revisión y Aprobación de Documentos Título del documento: Identificación: P.SI-2 r PREPARADO POR: Rafael Muñoz Go tia May de 2007 May de 2007 Ma de 2007 PREPARADO POR: Rafael Mufioz Go~ia Jun de 2010 REVISADO POR: Ing. David Valdivia Rosas,/~ Jun de 2010 / // APROBADO POR: In. Alfonso Villarreal Martínez..;~:-:' Jun de 2010 DESCRIPCiÓN DE LA REVISiÓN: /" /' Actualización para mantener la vigencia del procedimiento PREPARADOPOR:R~aeIMufio_z_G_o~~_ia~~~~~~~~~~~~~~~~~~~~~ REVISADO POR: Ing. David Valdivia Rosas /,,/ ~~7/:.~!--!o#"';'~~-=-=-' '-~--i APROBADO POR: In. Alfonso Villarreal Martínez /' ECHA: A o de 2010,,, /..'. ~ DESCRIPCION DE LA REVISION: Indicar ci~e FP.SI-1/0/4, FP.SI-2/0/4, FP.SI-3/0/4 PREPARADO POR: REVISADO POR: APROBADO POR: DESCRIPCiÓN DE LA REVISiÓN: Revisión N 3 e la referencia donde se encuentran las Formas "1 Revisión N 4 PREPARADO POR: REVISADO POR: APROBADO POR: DESCRIPCiÓN DE LA REVISiÓN:./