Tema 2

Documentacin de Software
Documentacin de software
Tema 2 El proceso de desarrollo de software
Introduccin al tema
El ciclo de vida de desarrollo de un software, est formado por fases estndares que son conocidas en la industria del software; dependiendo el tipo de proyecto a considerar, se debe aplicar el modelo de proceso adecuado, y en general se deben incluir las siguientes fases:
Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.
Introduccin al tema
Planeacin Anlisis Diseo Construccin/codificacin Pruebas Implementacin Mantenimiento
Introduccin al tema
En cada fase existen documentos importantes que generar y que servirn como elementos de entrada para la siguiente fase. En este tema aprenders detalladamente cules son las fases del ciclo de vida de desarrollo de software, los documentos tcnicos y administrativos ms importantes que deben generarse en cada una de las fases, as como una descripcin general de lo que cada uno de ellos contiene.
Ciclo de vida de desarrollo de software

El ciclo de vida de desarrollo de software (Software Development Life Cycle SDLC, por sus siglas en ingls) es un modelo lineal secuencial que comienza con la planeacin (donde se hace la definicin de requerimientos) y termina con el mantenimiento (Galin, 2004).
Planeacin
Anlisis
Diseo
Codificacin
Pruebas
Implementacin
Mantenimiento

Planeacin
Planeacin del proyecto de software. Generan las estimaciones de tiempo y recursos del proyecto. Definicin de los entregables. Levantamiento de requerimientos.

Documentos en la fase de planeacin:
La carta del proyecto (project charter). Plan de proyecto. Plan de verificacin y validacin de software. Visin y alcance del negocio. Diagrama de Gantt con las estimaciones de fechas y tiempos del proyecto. Casos de uso de negocio.

Anlisis El mayor esfuerzo en esta fase es analizar los requerimientos y sus implicaciones que formarn los modelos iniciales del sistema que ser construido. Algunos de los documentos que se generan en esta fase son los siguientes:
Casos de uso de sistema. Especificacin de requerimientos de software. Documentos de casos de uso. Documento de casos de pruebas de aceptacin de usuario.

Diseo Esta fase involucra la definicin detallada de las entradas y salidas de los procedimientos, funciones y mtodos que constituirn el software. Documentos de la fase de diseo: Diagramas de arquitectura. Descripcin de diseo de software. Diseo de la base de datos. Documentos de prototipos de interfaces grficas. Documento de casos de pruebas de sistema. Documento de casos de pruebas de integracin.

Construccin/codificacin En esta fase el diseo es traducido a cdigo. La codificacin involucra las actividades de aseguramiento de calidad como inspecciones, pruebas unitarias (unit testing) y pruebas de integracin (integration testing). Documentos que se pueden generar en esta fase: Documento de casos de pruebas unitarias. Documentacin interna de los cdigos.

Pruebas En esta fase se ejecutan las pruebas una vez que la fase de codificacin ha finalizado. La meta principal de las pruebas es descubrir la mayor cantidad de errores que contiene el software. Documentos que se pueden generar en esta fase: Reportes de pruebas Reportes de mtricas Manuales de usuario Manuales de instalacin

Implementacin Despus de que el software ha sido aprobado, el sistema es instalado. Si el nuevo sistema servir de reemplazo a uno ya existente, entonces se inicia un proceso de conversin para asegurar que las actividades del negocio continen funcionando de forma ininterrumpida. Documentos que se generan en esta fase: Notas de release Reportes de pruebas de instalacin

Mantenimiento El mantenimiento incorpora tres tipos de servicios:
1. Correctivo
Repara las fallas del software identificadas por el usuario durante la operacin.
2. Adaptivo
Utiliza las caractersticas actuales del software para incorporar nuevos requerimientos a lo ya existente.
3. Perfectivo
Agrega nuevas funcionalidades para mejorar el rendimiento del sistema.
El ciclo presentado es conocido como el modelo en

cascada sugerido por Royce (1970) y despus presentado en la forma ms comn conocida de Boehm (1981). Este modelo brinda los fundamentos para la mayora de los estndares de calidad utilizados como el estndar 1012 de la IEEE.
Es importante mencionar que el nmero de fases puede

variar de acuerdo a las caractersticas del proyecto. En proyectos complejos con modelos de gran escala, algunas fases son ms largas; mientras que en proyectos pequeos, algunas fases pueden juntarse y reducirse.
Documentos tcnicos de un sistema

Existen varios documentos que deben generarse en el desarrollo de un sistema, algunos de ellos contendrn especificaciones funcionales y tcnicas relacionadas directamente con el sistema, mientras que otros solamente servirn para llevar una administracin y control adecuados.
Los documentos tcnicos son aquellos que contienen informacin, modelos, tablas, diagramas y esquemas de especificaciones funcionales y no funcionales del sistema.
Especificaciones funcionales
Describen las caractersticas de lo que realizar el software. Ejemplos: funciones, acciones, pantallas, etc.

Especificaciones no funcionales Estn relacionadas con los requerimientos de calidad pero no tienen relacin con elementos que realizar el sistema, es decir, estn relacionadas con las necesidades de rendimiento, seguridad de informacin, licenciamiento y tiempos de respuesta, entre otras. Este tipo de requerimiento no afecta la funcionalidad, ya que si un sistema responde en un tiempo mayor al esperado, no quiere decir que el software no funcione correctamente.

Nombre del documento Visin y alcance del negocio Fase Planeacin/ Anlisis Descripcin Este documento muchas veces se conoce como el anlisis de factibilidad. Aqu debe documentarse la identificacin del problema, con una propuesta de solucin a travs de una herramienta de software. Es necesario analizar el mercado al que estar enfocado el sistema, evaluar diversas alternativas, identificar las necesidades bsicas o requerimientos de usuario ms importantes y presentar y defender la propuesta del sistema en comparacin con otras propuestas o competidores. Este documento puede ir acompaado del documento administrativo conocido como carta del proyecto (project charter), para la presentacin de la propuesta.

Nombre del documento Casos de uso de negocio Fase Anlisis Descripcin En este documento se modelan casos de uso de negocio utilizando UML, sirve para identificar y modelar los requerimientos de negocio que el cliente solicita como elementos primordiales para la realizacin de su sistema; tambin para identificar las caractersticas principales o funciones que contendr el software pero en trminos muy generales. Habitualmente establece todos los mdulos que necesitar cubrir el sistema.

Nombre del documento Casos de uso de sistema Fase Anlisis Descripcin Este documento se genera tomando como base los documentos descritos anteriormente. Aqu se modelan casos de uso que responden a las necesidades de los requerimientos de negocio; sin embargo, estos casos de uso debern identificar las funciones especficas de cada uno de los mdulos y cmo sern solucionadas. Adems, el documento tpicamente deber ir acompaado de diagramas de actividad en UML que modelan los procesos especficos de las tareas que sern automatizadas a travs del nuevo software.
10

Nombre del documento Especificacin de requerimientos de software Fase Anlisis Descripcin
Este documento es el producto de trabajo ms importante de la fase de anlisis, pese a que los documentos anteriores podran omitirse (en caso de falta de tiempo), el ERS debe existir siempre en el desarrollo de un proyecto de software. El documento toma como base todos los modelos generados en los casos de uso de sistema, y permite identificar todos los requerimientos especficos de manera detallada. El ERS documenta todos los requerimientos funcionales de usuario, de sistema y de software, todos los requerimientos no funcionales, los requerimientos de interfaces externas, as como otros requerimientos que no caen en las clasificaciones anteriores (requerimientos de licenciamiento, de estandarizacin, etc.).

Nombre del documento Descripcin de diseo de software Fase Diseo Descripcin As como el ERS, el DDS es el producto de trabajo ms importante de la fase de diseo y no debe omitirse. El documento presenta la modelacin de la arquitectura del sistema, mejor conocida como el diseo de alto nivel; as como la modelacin de los detalles especficos de cmo ser construido el software, mejor conocido como el diseo de bajo nivel. En muchas ocasiones este documento puede separarse en dos documentos (comnmente cuando el sistema es muy robusto), generando uno para el diseo de alto nivel y otro para el diseo de bajo nivel.
11
Documentos de administracin y control de desarrollo

Los documentos de administracin y control de desarrollo de un producto de software, son aquellos que como su nombre lo indica, permiten llevar la administracin del proyecto y controlar todas las actividades que se van realizando conforme el ciclo de vida de desarrollo se va ejecutando.
Estos documentos permiten llevar las estimaciones y control de tiempos, recursos y costos, el control de las mtricas, defectos y horas de trabajo, as como la generacin de reportes del estado del proyecto en todas sus fases y otros reportes de calidad.

Nombre del documento Carta del proyecto (project charter) Fase Planeacin Descripcin La carta del proyecto, documento mejor conocido como project charter, es un entregable que se realiza al analizar las necesidades generales del sistema que ser generado. Este documento debe mostrar una propuesta para el cliente en donde se especifican los takeholders involucrados, un resumen ejecutivo, el propsito del proyecto, el alcance, las principales actividades, limitaciones, metas y entregables, as como tiempos y costos. Es una propuesta que puede ir acompaada con el documento de visin y alcance del negocio.
12

Nombre del documento Plan de proyecto Fase Planeacin Descripcin Este documento debe generarse una vez que el cliente ha firmado la carta del proyecto como aceptacin. El plan de proyecto especifica detalladamente cmo se llevarn a cabo todas las actividades del ciclo de vida de desarrollo de software, debe ir acompaado de la divisin de tareas (WBS), un diagrama de Gantt con los tiempos, recursos y costos, todos los miembros del proyecto, sus roles y responsabilidades, as como las especificaciones de cmo se darn las actualizaciones del estado del proyecto y otras actividades administrativas.

Nombre del documento Plan de verificacin y validacin de software Fase Planeacin Descripcin El plan de verificacin y validacin es muy similar al plan de proyecto, la diferencia es que este plan debe de mostrar todas las actividades, tiempos, costos y recursos relacionados con las actividades de pruebas que sern realizadas a lo largo del ciclo de vida de desarrollo de software. En este documento se detallan todas las pruebas que se realizarn, quines estarn encargados de la ejecucin, cmo se reportarn los defectos, entre otras actividades relacionadas con testing.
13

Nombre del documento Casos de prueba Fase Anlisis/Diseo/ Codificacin Descripcin Los documentos de casos de prueba se generan para todas las fases de prueba que existirn en el proyecto, debe haber uno para cada una de ellas donde se detallen todos los diseos de las pruebas que se van a generar, las salidas esperadas, entradas necesarias para la ejecucin, etc. Al hablar de varios tipos de pruebas, significa que puede haber un documento de este tipo para las pruebas unitarias, pero tambin puede haber uno para las pruebas de integracin o las pruebas de aceptacin del usuario.

Nombre del documento Libro de mtricas Fase Anlisis/Diseo/ Codificacin/ Pruebas/ Implementacin Descripcin Este documento es muy importante porque permite llevar un control y concentracin de todas las actividades de verificacin y calidad del proyecto. Se utiliza en todas las fases del proyecto porque sirve para reportar los defectos encontrados en cada fase, la cantidad de tiempo dedicado para solucionarlos, documentacin de tiempos dedicados a la administracin del proyecto y la administracin de la configuracin, as como el establecimiento de las estimaciones de metas de calidad esperadas, reales, y las desviaciones de esas metas para crear planes de mejora continua de futuros proyectos.
14
Cierre
Ahora conoces detalladamente el ciclo de vida de desarrollo de software y es importante que reflexiones en los entregables y productos principales de trabajo que deben ser generados en cada una de ellas.
Cierre
Las organizaciones internacionales de xito mundial cuentan con procesos que se adaptan a los diversos proyectos de desarrollo que soportan y en cada uno de ellos se encuentran las plantillas y especificaciones de los productos de software, los cuales son el resultado de las fases, las entradas y salidas de cada paso del proceso.
15
Cierre
En este tema has conocido a detalle la descripcin de los documentos tcnicos y administrativos ms importantes que se realizan en un proyecto de desarrollo de software, por lo tanto, conoces perfectamente para qu se suman los esfuerzos de trabajo en cada una de las fases del ciclo de desarrollo.
Cierre
Analiza las siguientes preguntas:
Cmo se documentan los casos de uso

de negocio y los casos de uso de sistema? Qu debe de llevar un documento de Especificacin de requerimientos de software? Qu debe generarse en el documento de Descripcin de diseo y arquitectura de software?
En el siguiente tema Documentos tcnicos de un sistema, obtendrs el conocimiento para poder responderlas.
16
Referencias bibliogrficas
Galin, D. (2004). Software Quality Assurance: From theory to implementation. England: Pearson Addison Wesley
Crditos
Diseo de contenido: ITC. Christian Antonio Martnez Sols, MGTI Coordinador de Calidad Acadmica de rea: L.I. Oscar Andrs Rodrguez Mgica, MATI Universidad Tec Milenio Produccin y edicin del curso: Tecnologa Educativa Universidad Virtual, ITESM
17

Tema 2

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Tema 2

Enviado por

Direitos autorais:

Formatos disponíveis

Documentacin de Software

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Ciclo de vida de desarrollo de software

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Ciclo de vida de desarrollo de software

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Ciclo de vida de desarrollo de software

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Ciclo de vida de desarrollo de software

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Ciclo de vida de desarrollo de software

Ciclo de vida de desarrollo de software

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Ciclo de vida de desarrollo de software

Ciclo de vida de desarrollo de software

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Ciclo de vida de desarrollo de software

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Ciclo de vida de desarrollo de software

El ciclo presentado es conocido como el modelo en

Es importante mencionar que el nmero de fases puede

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos tcnicos de un sistema

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos tcnicos de un sistema

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos tcnicos de un sistema

Documentos tcnicos de un sistema

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos tcnicos de un sistema

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos tcnicos de un sistema

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos tcnicos de un sistema

Documentos tcnicos de un sistema

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos de administracin y control de desarrollo

Documentos de administracin y control de desarrollo

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos de administracin y control de desarrollo

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos de administracin y control de desarrollo

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos de administracin y control de desarrollo

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Documentos de administracin y control de desarrollo

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.

Enseanza e Investigacin Superior A. C. Todos los Derechos Reservados 2011.