PEEPER PONTIFICIA UNIVERSIDAD JAVERIANA FACULTAD DE INGENIERIA CARRERA DE INGENIERIA DE SISTEMAS. Mayo Versión 2.1 OSCAR IVAN LÓPEZ PULIDO

Transcripción

1 PEEPER Implementación del cambio de técnica usada para la actualización de datos en los reportes de esfuerzo, usados como métrica de productividad, progreso y costo de los proyectos, de la compañía de desarrollo de software PSL. PONTIFICIA UNIVERSIDAD JAVERIANA FACULTAD DE INGENIERIA CARRERA DE INGENIERIA DE SISTEMAS Mayo 2014 Versión 2.1 OSCAR IVAN LÓPEZ PULIDO

2 Historia de Revisiones Fecha Versión Descripción Autor 2014/03/ /03/ /04/ /04/ /04/ /05/ Versión Inicial. Oscar López 1.2 Complementos sección 3 Oscar López 1.3 Ajustes Documento Oscar López 1.4 Complementos sección 3 y 4 Oscar López 1.5 Verificación y correcciones generales Oscar López 21 Actualización tabla de contenido y tabla de Ilustraciones. Revisión del documento Oscar López

3 Tabla de Contenido 1. INTRODUCCIÓN PROPÓSITO ALCANCE DEFINICIONES, SIGLAS Y ABREVIATURAS REFERENCIAS REPRESENTACIÓN METAS Y RESTRICCIONES METAS RESTRICCIONES Productos de Software Aplicaciones Legado PERSPECTIVA LÓGICA PAQUETES DE DISEÑO SIGNIFICATIVOS PARA LA ARQUITECTURA PERSPECTIVA DE IMPLEMENTACIÓN PERSPECTIVA DE DESPLIEGUE PERSPECTIVA DE DATOS ATRIBUTOS DE CALIDAD SEGURIDAD Autenticación Patrones de Ataque MANTENIBILIDAD DESEMPEÑO... 22

4 Lista de Ilustraciones Ilustración 1: Diagrama de Componentes propuesto Ilustración 2: Diagrama de Componentes Ilustración 3: Diagrama de Clases Ilustración 4: Diagrama de diseño Ilustración 5: Diagrama de despliegue... 19

5 1. Introducción Documento de Diseño de Software Este documento pretende alinear recursos tecnológicos de la forma más directa y clara con los objetivos de negocio del grupo GPIS- PSL. De esta forma se puede generar un mayor grado de integración dentro de las áreas internas de la empresa, para optimizar y agilizar los procesos de métricas de productividad, consolidación de la información, posterior análisis de los mismos y reporte de información dentro de la organización; adicionalmente se define la infraestructura e interfaces necesarias para el correcto funcionamiento de la solución. 1.1 Propósito Proveer un panorama comprensible del diseño del Sistema, utilizando un número de perspectivas que resaltan diferentes aspectos significativos, con el fin de capturar y convenir las principales decisiones que se han tomado sobre el sistema. El diseño aquí presentado se debe comprender y analizar como un conjunto de contextos de información que pretenden ofrecer una oportunidad de mejora a los procesos de análisis de información por parte de PSL. Para esto se definen diferentes puntos de vista que pueden ser vistos como un conjunto de elementos que constituyen la necesidad expuesta por el grupo GPIS. Finalmente, se realiza un análisis de los atributos de calidad que pueden llegar a generar un impacto sobre la solución definida. 6

6 1.2 Alcance El alcance de este documento es representar por medio de la utilización de las vistas, la solución propuesta para el proyecto PEEPER, con el fin de documentar cada uno de los módulos identificados y detallar cada una de las decisiones de diseño teniendo en cuenta los compromisos de requerimientos previamente acordados y documentados en el documento3-documento de requerimientos de Software. 1.3 Definiciones, siglas y abreviaturas ACRÓNIMO O DEFINICIÓN 7 SIGNIFICADO DESCRIPCIÓN G GUI Grafical User Interface Componente de un sistema que soporta el entorno grafico de este. J Jira Herramienta de gestión de proyectos de Software P PEEPER Trabajo de grado: Implementación del cambio de técnica usada para la actualización de datos en los reportes de esfuerzo, usados como métrica de productividad, progreso y costo de los proyectos, de la

7 compañía de desarrollo de software PSL. PSL Productora de Software S.A. Empresa que hace las veces de cliente del componente PEEPER. R REEE Reporte de Esfuerzo Formato en Excel que permite el reporte detallado del esfuerzo que cada empleado de PSL realiza en determinadas tareas. RM Administración de Requerimientos Administración de requerimientos (Requirement Management) S SCM Software Configuration Management Administra y gestiona la configuración del Software V VAF Value Adjustment Factor Factor de Complejidad Técnica 8

8 1.4 Referencias MICROSOFT. Arquitectura de personalizaciones a nivel de documento. Disponible en: MICROSOFT. Soluciones de Excel. Disponible en: MICROSOFT. Información general sobre el desarrollo de soluciones Office. Disponible en: MICROSOFT. Ensamblados de interoperabilidad primarios de Office. Disponible en: MICROSOFT. Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office. Disponible en: MICROSOFT. Entradas del registro de complementos a nivel de aplicación. Disponible en: 9

9 2. Representación En esta sección se describe el alcance de la solución requerida y el proceso de análisis utilizado para la definición del diseño de Software del sistema. Adicionalmente, se provee un diagrama conceptual que muestra claramente cada uno de los módulos a tener en cuenta dentro de la definición arquitectural. Actualmente en el área de GPIS de la empresa de desarrollo de software PSL existen diferentes procedimientos para el registro de todas las métricas de progreso, esfuerzo, defectos, entre otros, de todos sus proyectos de desarrollo. Dichos procedimientos cuentan con diferentes herramientas tecnológicas para el reporte, almacenamiento y posterior análisis de información, algunas de las cuales operan de forma independiente, registrando aisladamente la información exclusiva de cada procedimiento, a pesar que en algunos casos existen procedimientos que comparten información. De esta forma, se pueden presentar inconsistencias en la información registrada en los diferentes sistemas que soportan los procedimientos de registro de métricas, generando fallos que atentan con la integridad de la información. Bajo estas circunstancias, se requiere una solución que permita la interacción de la información registrada en los procesos de reporte de esfuerzo y el reporte de avance de proyectos. Cada uno de estos procesos está provisto por un formato con macros habilitados en Excel REEE, y la Herramienta JIRA, respectivamente para cada proceso. De esta forma, es necesario el desarrollo e una herramienta que permita el acceso de las dos soluciones existentes a un único origen de datos, permitiendo la estandarizar la información en común y por 10

10 ende los informes extraídos de estos procesos de negocio ejecutados por el grupo GPIS, logrando la oportunidad de reaccionar ágilmente a las necesidades de información transversal. El diseño está representado en una serie de vistas que proveen un panorama comprensible de la solución propuesta para la aplicación PEEPER. Es representada por medio de modelos UML a un alto nivel de abstracción, los cuales permiten dar una visión de los elementos de diseño de software que componen el sistema, identificando los componentes de mayor importancia e identificados como críticos que pueden representar algún grado de riesgo y requieran de mayor elaboración y detalle. En donde se consideran las siguientes vistas: Vista Vista Lógica Vista de Distribución ( Física ) Vista de Implementación (Desarrollo) Descripción Descomposición de la solución en paquetes y por cada paquete, su descomposición en clases. Documenta las clases del diseño del sistema más significativas y sus relaciones. Describe la distribución física del sistema a través del conjunto de nodos (servidores o equipos) de procesamiento. Algunas consideraciones de distribución pueden implicar restricciones sobre el diseño. Describe los componentes involucrados en el desarrollo del sistema en términos de paquetes, capas y manejo de configuración. El uso de Framework o directivas de desarrollo se pueden incluir en esta sección 11

11 Vista Lógica de Datos Modelo lógico que describe la estructura de datos que compone el sistema. Esta vista suele extender a la Vista Lógica al presentar con mayor detalle, la forma en que se compone la estructura de datos involucrada en el sistema. 3. Metas y restricciones 3.1 Metas El diseño de la solución debe brindar flexibilidad de acuerdo a la parametrización de la información registrada en los reportes de esfuerzo y la herramienta JIRA, permitiendo rápidas modificaciones en su estructura en caso de que una de las herramientas ya existentes cambie. 3.2 Restricciones Productos de Software La aplicación debe ser implementada utilizando los siguientes productos y versiones: 12

12 Herramienta de desarrollo: Visual Studio 2010, C# Framework 4.0. Motor de Base de datos: SQL Server Microsoft Office 2007 o superior Aplicaciones Legado La aplicación se debe integrar con los sistemas existentes: JIRA: Herramienta que permite la gestión operativa de proyectos de Software, administración de tareas y seguimiento de errores e incidentes. REEE: Formato en Excel en el cual los empleados de PSL registran de forma muy detallada el esfuerzo dedicado a sus diferentes tareas asociadas a su rol y responsabilidades diarias. 4. Perspectiva Lógica En la perspectiva lógica se identifican los componentes más significativos dentro del diseño de solución propuesta, se describe la responsabilidad de cada uno y se muestra la interacción entre los mismos. En la ilustración 1, se puede apreciar donde se encuentra ubicada la solución PEEPER dentro de las herramientas existentes, es decir, realizará una labor de intermediación entre el formato REEE y la Base de Datos del sistema JIRA. 13

13 Ilustración 1: Diagrama de Componentes propuesto. En una aproximación más específica, detallada en la ilustración 2, observamos que la solución PEEPER se encuentra como un componente adicional de Microsoft Excel para el Formato REEE. 14

14 Ilustración 2: Diagrama de Componentes 15

15 4.1 Paquetes de Diseño Significativos para la Arquitectura A continuación se muestra el diagrama de clases en donde se visualizan las interfaces necesarias para el funcionamiento de la aplicación: Ilustración 3: Diagrama de Clases

16 5. Perspectiva de Implementación La aplicación está basada en el conjunto de soluciones de desarrollo de Microsoft Office con Visual Studio para la implementación de aplicaciones de.net framework que extiendan Microsoft Office 2010 y 2007 Microsoft Office System. Este conjunto de soluciones aportan características que facilitan la creación de soluciones de Office para satisfacer un sin número de necesidades. El ensamblado de la aplicación establece comunicación con los componentes COM a través de los componentes de interoperabilidad primario de la aplicación. Se utilizó una plantilla que admite la personalización a nivel de documento, permitiendo que únicamente la plantilla generada para el formato REEE se asocie al ensamblado de código administrado y las diferentes clases utilizadas del.net framework. Si un usuario abre varias veces el formato de personalización a nivel de documento, cada ensamblado se cargará en un dominio de aplicación diferente, permitiendo aislar a una solución que presente errores de las otras soluciones ejecutadas. De esta forma, solo al utilizar el formato REEE se cargará el ensamblado asociado a la solución [1]. En el siguiente diagrama encontramos los diferentes componentes separados por capas: Presentación, Negocio y Datos. Además se ilustran elementos transversales y dependencias externas.

17 Ilustración 4: Diagrama de diseño 6. Perspectiva de Despliegue

18 Describe cómo van a ser desplegados los componentes definidos en el diseño teniendo en cuenta los lineamientos tecnológicos disponibles por PSL para tal. A continuación se encuentra el Diagrama de Despliegue de la solución propuesta. Ilustración 5: Diagrama de despliegue 7. Perspectiva de Datos Por razones de seguridad de la información, PSL restringe la información referente al modelo de datos que aplica en la implementación de PEEPER.

19 Teniendo en cuenta que el modelo de datos ya se encuentra definido por el sistema JIRA, y que las tablas de base de datos que interactúan con la solución propuesta no se verán afectadas en su estructura, propiedades ni objetos, no se hace necesario el análisis ni la reproducción de este tipo de información. 8. Atributos de Calidad Teniendo en cuenta las características de la solución escogida, el tipo de implementación y las herramientas tecnológicas a usar dentro de la implementación de PEEPER, los atributos de calidad que se tienen en cuenta dentro del proyecto se estipulan de la siguiente manera: 8.1 Seguridad Los atributos de calidad relacionados a la seguridad del sistema identificados son los siguientes: Autenticación La aplicación PEEPER se debe integrar a los procesos de seguridad de la información de PSL con el fin de no permitir el uso a personas no autorizadas, de igual manera se debe restringir el uso de las funcionalidades que provee el sistema de acuerdo a las políticas establecidas para cada uno de los usuarios. Para este fin se han creado dos plantillas: La primera con permisos de actualización de datos, que será utilizada por las personas autorizadas dentro del grupo GPIS

20 La segunda, será la utilizada por los empleados para la extracción de datos del REEE según lo reportado en la base de datos del sistema JIRA. Como se ha explicado anteriormente, los formatos creados de forma personalizada a nivel de documento en Microsoft Office Excel cargan los ensamblados de código administrado únicamente para este formato. Así, los formatos no podrán cargar funcionalidades que no estén asociadas a si mismo desde la publicación de la solución. La solución debe restringir en un 100% el uso de funcionalidades no permitidas para un usuario de acuerdo a la configuración de roles establecida en los requerimientos del proyecto Patrones de Ataque El desarrollo de la aplicación es realizado teniendo como base las recomendaciones de seguridad que se encuentran en OWASP ( y CAPEC ( lo que permite prevenir las vulnerabilidades identificadas por los patrones de ataque más comunes en este tipo de soluciones de desarrollo de Office en Visual Studio. La información contenida en estos sitios es implementada hasta donde es posible, según los requerimientos del proyecto identificados hasta el momento. De esta forma se garantiza que se realiza la implementación teniendo en cuenta los más reconocidos estándares de seguridad que se encuentran definidos en el momento. Cabe aclarar que no es posible implementar al 100% todos los estándares, pues de esta forma la funcionalidad se vería completamente limitada y reducida, no cumpliendo así con los requerimientos de la solución. Otro punto importante que se debe aclarar es que la solución es implementada minimizando en lo posible la existencia de vulnerabilidades, pero no es posible decir que PEEPER tiene cero vulnerabilidades, pues realmente esto no es posible de desarrollar. Una de las únicas maneras de tener un sistema con cero vulnerabilidades, es que nadie

21 tenga acceso a él, ni físicamente a las máquinas ni por aplicativo, por tanto ya no tendría sentido desarrollarlo. 8.2 Mantenibilidad Para cada uno de los componentes se define claramente su responsabilidad de tal forma que podemos garantizar el bajo acoplamiento y la alta cohesión en la implementación con el fin de favorecer la mantenibilidad de la solución. Adicionalmente se han tenido en cuenta los siguientes documentos técnicos de estándares para el desarrollo de proyectos de software que PSL ha desarrollado en su larga experiencia en la implementación de proyectos de software: Estándares de codificación Estándares de Bases de Datos SQL Server Estándares del Manejo de Excepciones Estándares del Manejo de Internacionalización, Localización y Propiedades del Sistema 8.3 Desempeño De acuerdo a los volúmenes de información y la concurrencia de usuarios esperados, durante el desarrollo del proyecto se deben definir los tiempos de respuesta esperados para cada una de las opciones del sistema, lo cual nos permite definir los escenarios de calidad para evaluar cada uno de los tiempos esperados y aplicar la puesta a punto o realizar el refactorización de código de los componentes de acuerdo a las necesidades del negocio.