documento de trabajo de titulación de la carrera de análisis de sistemas

2014

INSTITUTO TECNOLGICO SUPERIOR CORDILLERA

Anlisis de Sistemas

Ing. Hugo Heredia M. Director de Carrera

Gua para la estructuracin del documento final del trabajo de titulacin de la Carrera

de Anlisis de Sistemas.

INSTITUTO TECNOLGICO SUPERIOR CORDILLERA CARRERA DE ANLISIS DE SISTEMAS

Direccin de Carrera Ing. Hugo Heredia M - Director

Propsito

Este documento es una gua para la estructuracin de un documento de proyecto de grado en donde se desarrolla un producto de software, a modo de propuesta de estndar. Con la estructuracin se busca que los productos de software cuenten con unas caractersticas mnimas de calidad en el proceso. Adems de presentar la estructura jerrquica para dicho documento, se propone una serie de plantillas para algunas de las labores de documentacin en el apndice A. Tanto la estructura como los formatos fueron tomados y depurados a partir del anlisis y la experiencia del manejo de desarrollo de software. Como herramienta comn de modelado se ha optado por UML (vase anexo C). Esto en general abarca la gran mayora de los desarrollos; cuando no aplique se recomienda hacer una adaptacin de los elementos tcnicos propios de UML al lenguaje de modelado requerido.

Estructura sugerida A continuacin encuentran la estructura jerrquica sugerida para el trabajo de titulacin. En azul e itlicas se encontrara la descripcin e indicaciones en consideracin. Vale la pena mencionar que la numeracin no hace parte de la propuesta ya que se mantendr la estructura que la Coordinacin de Proyectos del Instituto Tecnolgico Superior Cordillera tiene en su instructivo 002.



Captulo I: Antecedentes

1.01. Contexto

Es un enfoque del problema en forma general y dentro de la realidad ecuatoriana.

1.02. Justificacin

Se debe justificar las posibles soluciones del problema planteado, determinando las ventajas y desventajas desde la realidad de la organizacin que se est trabajando.

1.03. Definicin del Problema Central.

Se debe trabajar desde la construccin de la matriz de fuerzas T, determinando las fuerzas que impulsan y bloquean la situacin negativa dentro de la organizacin

Captulo II: Anlisis de Involucrados

2.01. Requerimientos

2.01.1 Descripcin del sistema actual

Se describir los procesos actuales que inciden directamente en el desarrollo del proyecto.

2.01.2 Visin y alcance

Profundizacin sobre el propsito del sistema en cuanto a principales objetivos, entregables e involucrados.

2.01.3 Entrevistas

Diseo de la(s) diferente(s) entrevista(s) que se llevar(n) a cabo para hacer levantamiento de informacin en el proceso de consecucin del producto, y recuento de las entrevistas hechas. Vase Anexo A.a para una plantilla sugerida para el diseo de la entrevista orientada por preguntas.

2.01.4 Matriz de requerimientos

Matriz de identificacin de requerimientos, tanto funcionales como no funcionales (eso s, separados). Vase anexo A.b para una plantilla sugerida.

2.01.5 Descripcin detallada

Descripcin detallada de los requerimientos identificados. Vase el anexo A.c para una plantilla sugerida.



2.02. Mapeo de Involucrados Mapa de identificacin de los involucrados directos e indirectos, deber salir del levantamiento de requerimientos y los usuarios

2.03. Matriz de Involucrados

La Matriz de Involucrados deber agrupar los involucrados, determinar los interese, los recursos, y los problemas percibido, estos debern guardar concordancia con el levantamiento de requerimientos realizado en ste mismo captulo.

Captulo III: Problemas y Objetivos

3.01. rbol de Problemas

Luego de levantar los requerimientos y obtener los involucrados es importante que se organice la informacin tomando en consideracin los causales que determinan el problema central motivo del trabajo, as como de los efectos que provocan estos causales.

3.02. rbol de Objetivos

Los objetivos identificados como componentes o productos de un proyecto se convierten en los medios para encarar el problema de desarrollo identificado y proporcionar un instrumento para determinar su impacto de desarrollo.

3.03. Diagramas de casos de uso

Diagrama de casos de uso (UML) de la iteracin.

3.04. Casos de uso de realizacin

Se realizar el diagrama y especificacin de los casos de uso de realizacin. Vase anexo A.d para una plantilla sugerida para la especificacin.

3.05. Diagrama de secuencias del sistema

Diagrama de secuencia (UML) a nivel del sistema.

3.06. Especificacin de casos de uso

Especificacin de casos de uso de la iteracin. Vase anexo A.e para una plantilla sugerida.

Captulo IV: Anlisis de Alternativas

4.01. Matriz de Anlisis de Alternativas

Esta matriz consiste en determinar las alternativas a partir del rbol de objetivos para promover el cambio deseado en la organizacin, despus de identificadas las distinta alternativas se debe evaluar cada



una con varias herramientas de anlisis que en realidad son filtros para ir seleccionando

4.02. Matriz de Impactos de Objetivos

Est evala la factibilidad tcnica, financiera, social y poltica de las estrategias representadas por los objetivos identificados en las alternativas

4.03. Estndares para el Diseo de Clases

Estndar para nombrar, clases, atributos, mtodos que sern utilizados para el Diseo de Clases de la solucin

4.04. Diagrama de clases

Diagrama de clases de la solucin y glosario de conceptos y tipos

4.05. Modelo Lgico - Fsico

Modelo Fsico de la solucin y su relacin con el diagrama de clases

4.06. Diagrama de Componentes

Diagrama de componentes de la solucin

4.07. Diagramas de Estrategias

Establece la Estructura y el alcance de las estrategias identificadas en la seccin 4.01 y 4.02 para vincularlo con los objetivos que pueden ser trabajados de forma articulada, con ello se determinar los lmites del proyecto en concordancia con la seccin 2.03.02

4.08. Matriz de Marco Lgico.

Es un resume del proyecto que destaca que se desea lograr, como se alcanzar el propsito, los factores externos indispensables, los indicadores de cumplimiento de los objetivos trazados y que recursos son necesarios

4.09. Vistas arquitectnicas

4.01.01. Vista lgica

Vista lgica del diseo de la solucin (diagrama de clases y de secuencia)

4.01.02. Vista fsica

Vista fsica del diseo de la solucin

4.01.03. Vista de desarrollo

Vista de desarrollo del diseo de la solucin



4.01.04. Vista de procesos

Vista de proceso del diseo de la solucin

Captulo V: Propuesta 5.01. Especificacin de estndares de programacin

Estndar de codificacin usado para la implementacin del producto

5.02. Diseo de Interfaces de Usuario

Especificacin (diseo y resultados) de las interfaces de Usuarios que sern desarrolladas en el transcurso de la implementacin, se debe destacar todos los componentes que se utilizan en el diseo.

5.03. Especificacin de pruebas de unidad

Especificacin (diseo y resultados) de pruebas de unidad. Vase A.e para una plantilla sugerida.

5.04. Especificacin de pruebas de aceptacin

Especificacin (diseo y resultados) de pruebas de aceptacin. Vase A.f para una plantilla sugerida.

5.05. Especificacin de pruebas de carga

Especificacin (diseo y resultados) de pruebas de unidad. Vase A.g para una plantilla sugerida.

5.06. Configuracin del Ambiente mnima/ideal

Descripcin de los requerimientos mnimos e ideales para la puesta en marcha del sistema: estructura de archivos, variables de ambiente, etc. Adems debe mencionar los puntos de interaccin (interfaz) con otros sistemas.

Captulo VI: Aspectos Administrativos

6.01. Recursos Se debe colocar los recursos que fueron utilizados en la construccin del proyecto, sean estos materiales, humanos y tecnolgicos.

6.02. Presupuesto

Incluir todos los gastos que se incurri en la ejecucin del proyecto

6.03. Cronograma Se colocar el cronograma de trabajo para la ejecucin, se debe considerara desde el inicio hasta el fin del proyecto debe ser realizado el project.

Captulo VII: Conclusiones y Recomendaciones

7.01. Conclusiones Este apartado responder a los resultados obtenidos durante todo el trabajo desarrollado.



7.02. Recomendaciones

Este apartado responder a las recomendaciones que se puedan realizar derivadas de las conclusiones.



A. ANEXOS: Formatos

Formato control de cambios de documentos PROYECTO Proyecto del cual forma parte el documento

DOCUMENTO Nombre del documento

AUTORES Autores del documento

Ultima versin Fecha de ltima versin

Fecha de creacin Fecha de creacin

Fecha de la ltima revisin

Fecha ltima revisin Fecha de la ltima actualizacin

Fecha ltima actualizacin

ADMINISTRACIN DE CAMBIOS

Fecha Versin Tipo (Ampliacin / Correccin / Revisin /

Verificacin / Validacin)

Descripcin Responsable(s)

Fecha cambio 1

Versin cambio 1

Tipo de cambio 1 Descripcin del cambio 1

Responsable(s) cambio 1

a. Diseo de entrevistas

DISEO ENTREVISTA

identificador: Identificador de la entrevista

Preguntas Objetivos Anlisis posterior

Pregunta 1 Objetivos de la pregunta 1

Anlisis posterior sobre la pregunta 1

Pregunta 2 Objetivos de la pregunta 2

Anlisis posterior sobre la pregunta 2



b. Matriz de requerimientos

MATRIZ DE REQUERIMIENTOS

Identificador Descripcin Fuente Prioridad Tipo Estado Usuarios Involucrados

REQUERIMIENTOS FUNCIONALES

Identificador 1 Descripcin del requerimiento 1

Interesados de acuerdo con las entrevistas

Prioridad del req. 1

Funcional/

no funcional

Estado del req. Revisin / Vlido

Usuarios involucrados en el req. 1




Funcional/

no funcional



REQUERIMIENTOS NO FUNCIONALES




Funcional/

no funcional






Funcional/

no funcional





c. Detalle requerimientos

Descripcin del requerimiento Estado Anlisis / Diseo / Implementacin / Pruebas / Liberado / Descartado

Creado por Nombre de quien crea el requerimiento

Actualizado por Nombre de quien actualiza por ltima vez el requerimiento

Fecha Creacin Fecha de creacin del requerimiento

Fecha de Actualizacin

Fecha de ltima actualizacin del requerimiento

identificador Identificador del requerimiento

Tipo de Requerimiento

Crtico / No crtico Tipo de Requerimiento

Funcional / No funcional

Datos de Entrada Datos de entrada

Descripcin Qu se debe hacer a partir de los datos de entrada

Datos de salida Cules son los datos de salida

Resultados Esperados

Cmo se espera haber estimulado el sistema con el requerimiento. Se puede decir cmo cambia el sistema.

Origen Fuente de donde surge el requerimiento

Dirigido a Usuarios involucrados

Prioridad 1 .. 5 (1 ms baja .. 5 muy alta)

Requerimientos Asociados

Lista de identificadores de requerimientos asociados

ESPECIFICACIN

Precondiciones Precondicin en trmino del estado del sistema

Poscondiciones Precondicin en trmino del estado del sistema

Criterios de Aceptacin

Criterio de aceptacin del requerimiento



d. Especificacin de Casos de Uso de Realizacin Nombre

Nombre del caso de uso

Identificador Identificador del caso de uso

Responsabilidades Responsabilidades del caso de uso

Tipo Tipo de caso de uso: Usuario / Sistema

Referencias Casos de Uso Casos de uso asociados

Referencias Requisitos Referencia a requisitos previos del caso de uso

PRECONDICIONES

De Instancia

Enumeracin de precondiciones de instancia

De Relacin

Enumeracin de precondiciones de instancia

POSCONDICIONES

De Instancia

Enumeracin de poscondiciones de instancia

De Relacin

Enumeracin de poscondiciones de instancia

SALIDAS PANTALLA

Informacin que muestra en el dispositivo de comunicacin, por ejemplo, la pantalla del PC



e. Especificacin casos de uso Caso de Uso

Nombre del caso de uso

Identificador Descripcin del caso de uso

CURSO TPICO DE EVENTOS

Usuario Sistema

Actividad que hace el usuario con identificador de orden

Actividad que ejecuta el sistema con identificador de orden

Actividad que hace el usuario con identificador de orden

Actividad que ejecuta el sistema con identificador de orden

CURSOS ALTERNATIVOS

Curso alternativo de eventos 1

Curso alternativo de eventos 2

.

Curso alternativo de eventos n

f. Especificacin pruebas de unidad

Identificador

de la Prueba:

Mtodo a Probar

Objetivo de la Prueba:

Datos De Entrada

Resultado Esperado

Comentarios



g. Especificacin pruebas de aceptacin

Identificador

de la Prueba:

Caso de uso Referencia al caso de uso

Tipo de usuario

Perfil, Cargo


Secuencia de eventos


Comentarios

Estado : Aceptado / No aceptado

h. Especificacin pruebas de carga

Identificador

de la Prueba:

Tipo de prueba Simulacin de desempeo con un nmero alto de registros en la base de datos / Simulacin de desempeo con un nmero alto de peticiones concurrentes


Descripcin

Estrategia para realizar la simulacin, herramientas a utilizar, valores a utilizar


Comentarios



B. Enlaces

Informacin acerca de UML:

http://www.uml.org/

C. Manuales

Manual de instalacin

Manual de instalacin del producto

Manual de usuario

Manual de usuario final del producto

Manual tcnico

Manual de usuario tcnico del producto, es decir, manual para alguien interesado en conocer los detalles de implementacin (diccionario de datos, cdigo fuente), diseo y arquitectura,

Herramientas

Descripcin de tecnologas y herramientas utilizadas durante el desarrollo

BILIOGRAFA EL DESARROLLO DE SOFTWARE ORIENTADO A ASPECTOS SEGN IVAR JACOBSON. (n.d.). Retrieved September 15, 2012, from http://www.usmp.edu.pe/publicaciones/boletin/fia/info69/desarrollo.pdf Rodrguez Lozano, D. (2001). Arquitectura de Sistemas Web Aplicados a la Empresa. Jotri Jornadas de Ingeniera Web, 1. Retrieved from http://www.informandote.com/jornadasIngWEB/articulos/jiw10.pdf IEEE-SA. (n.d.). IEEE SA - 830-1998 - IEEE Recommended Practice for Software

Requirements Specifications. Retrieved May 07, 2014, from

http://standards.ieee.org/findstds/standard/830-1998.html.

Ing. Cristian Prado. (2013). GUA DE PRESENTACIN DEL PROYECTO DE TITULACIN, 116.

documento de trabajo de titulación de la carrera de análisis de sistemas

Documents