Revisión del 19:39 1 feb 2017

Aspectos organizativos

Introducción

• En el presente documento describimos como se ha desarrollado el proyecto de la asignatura de Evolución y Gestión de la Configuración (EGC), que consiste principalmente en integrar nuestro proyecto que corresponde a un subsistema, con otros subsistemas para ofrecer una herramienta de voto online.

• En las primeras semanas de curso se propusieron una serie de proyectos o subsistemas que engloban una aplicación o sistema completo, cuya funcionalidad es la de hacer votaciones online.

• Estos proyectos, son proyectos creados de años anteriores, basado en el proyecto Agora-Us. De estos proyectos, se nos proporcionan su desarrollo para poder realizar lo que será este año nuestro trabajo, que consiste en modificar y corregir posibles conflictos, incidencias o simplemente proporcionar mejoras para cumplir el objetivo principal, integrarnos con los demás subsistemas y hacer funcionar el sistema en toda su totalidad.

+ Los distintos subsistemas proporcionados se reparten en subgrupos hechos en el aula, donde cada uno de estos subgrupos tendrá que coordinarse unos con otros para llevar a cabo el objetivo principal antes mencionado.

• Nuestro grupo de trabajo ha tenido que valorar y tomar decisiones tanto internamente cómo con los demás grupos de los demás subsistemas teniendo que establecer procesos y herramientas ya constituidas para crear políticas de trabajo y seguir unas pautas para el desarrollo de nuestro subsistema y para la integración con los demás subsistemas.

• Además de la temática que se imparte en la asignatura, se aportaron una serie de herramientas de gestión de código, gestión de incidencias y depuración para poder desarrollar nuestro subsistema y poder realizar los procesos de integración continua con los demás subsistemas así como el uso de un servidor donde se irá actualizando el desarrollo de cada subsistema y hacer más fácil la integración completa de todos los subsistemas.

Miembros

• Del Rio Franco, Rafael: Project Manager
• Navas Inocencio, Jesús: Software Developer
• Rodriguez Nuñez, Ernesto: Software Developer
• Rufo Palomo, Macarena: Software Developer
• Ruiz Navarro, Jose Carlos: Software Developer

Actas

• Acta Reunión I (12/10/2016)
• Acta Reunión II (09/11/2016
• Acta Reunión III (07/12/2016)
• Acta Reunión IV (27/12/2016)
• Acta Reunión V (27/12/2016)
• Acta Reunión VI (28/12/2016)
• Acta Reunión VII (09/01/2017)
• Acta Reunión VIII (26/01/2017)
• Acta Reunión IX (30/01/2017)
• Acta Reunión X (01/02/2017)

Ecosistema de desarrollo

El entorno de desarrollo que usaremos será Eclipse, debido a la familiarización de todos los miembros del equipo con este entorno de desarrollo. De este modo, podremos reutilizar la máquina virtual que proveían el grupo Verificacion 15/16 (Tarde)

Descarga del entorno de desarrollo

Gestión de código fuente

• Usaremos un repositorio Git llamado AgoraUS-G1-1617 para administrar el código fuente del sistema. En este repositorio, que se ubica en el servicio de alojamiento de repositorios Git Github, cada subsistema se desarrollará en un repositorio diferente dentro del repositorio global. En el repositorio AgoraUS se recogerá el trabajo realizado y funcional de todos los grupos y su correspondiente integración.

• Usar un repositorio global facilita el acceso al código por parte de cada grupo. Podemos obtener el código de otros grupos clonando sus repositorios y haciendo pull, obteniendo así el código más reciente del subsistema en cuestión.

• Usar un único repositorio nos facilita aún más el acceso al código ya que solo tendríamos que hacer pull de la rama master para obtener el código de los demás subsistemas pero nos encontraríamos con el inconveniente de que cualquier persona podría modificar lo que quisiera, independientemente del grupo en el que se halle. Este inconveniente no se nos presenta porque sólo tenemos acceso de lectura a los repositorios a los que no pertenecemos.

• Tampoco se nos presentará problemas de conflictos con los demás grupos al alojarnos en repositorios diferentes. Si usáramos un único repositorio tendríamos que crear una carpeta o una rama para cada subsistema con el fin de evitar numerosos conflictos que se presentarían al compartir muchos subsistemas la misma estructura de archivos.

Gestión de conflictos

*Introducción: En el caso de que se genere un conflicto, será el miembro del grupo que lo divise primero el encargado de resolverlo. Para esto tendrá que ponerse en contacto con los demás miembros o con alguno en concreto si fuere necesario para acordar la versión escogida, etc.

*Implementación: Utilizamos la consola y el sistema de resolución de conflictos de Git. Este sistema impide un commit o un push en el caso de que haya conflicto además de mostrar un aviso. Para resolver el conflicto, la persona que intentó la operación debe editar manualmente los archivos para quedarnos con el contenido adecuado. Una vez hecho esto, se realiza la operación de nuevo pero sin conflicto.

*Lecciones aprendidas: La resolución de conflictos ha sido intuitiva y rápida, limitándose a conocimiento del proyecto y comunicación con los demás miembros del grupo.

Gestión de la construcción

• Para la construcción automática del sistema se utilizara la herramientas Travis CI. Esta herramienta te permite realizar la construcción cada vez que se realiza un commit al repositorio de código de GitHub. Travis aparte de realización la construcción ( crear el .jar del proyecto) previo a esto realiza cada uno de los test de la aplicación, comprobando que funcionan correctamente

Gestión de las liberaciones, despliegue y entregas

• Esta sección, abarca toda la información referente a los distintos elementos y/o entregables necesarios para la entrega, así como toda aquella documentación que lo compone, proyecto desarrollado por todo el equipo de trabajo y la correspondiente máquina virtual para el despliegue.

Gestión de la integración continua

• El proceso de integración continua tiene como objetivo principal comprobar que cada actualización del código fuente desarrollado por el equipo de trabajo no genere problemas en una aplicación que se está desarrollando.

Por lo tanto, la integración continua se usa como práctica de desarrollo software donde todos los componentes del equipo integran a lo largo del tiempo de vida del proyecto su trabajo, con el fin de conseguir un software de mayor calidad.

• Las ventajas que ofrece la integración continua son las siguientes:

    -Ejecución automática de pruebas unitarias, conociendo a su vez los resultados de éstos.

    -Ofrece información de cualquier incidencia tras un período de codificación, dándonos la posibilidad de saber 
     quién y cuándo ha realizado un cambio de impacto negativo en el proyecto.

    -Permite detectar los errores lo más pronto posible, en fases tempranas de 	desarrollo, dando la posibilidad 
     de encontrar solución cuanto antes.

    -Monitorización continua de las métricas de calidad del proyecto.

Gestión de incidencias

Para la gestión de incidencias usaremos las Issue de GitHub.

Una vez encontremos una incidencia tendremos que:

- Analizar: Las incidencias serán analizadas por al menos dos miembros del equipo, los cuales reproducirán la incidencia (para ello se espera que el autor de la incidencia de todos los detalles para poder reproducir lo ocurrido), analizaran y clasifican según su prioridad:

• ALTA: Un servicio se ve afectado de manera severa impidiendo su uso y afectando a actividades críticas de negocio.

• MEDIA: Un servicio se ve afectado impidiendo su uso pero no afectando a actividades críticas de negocio.

• BAJA: Un servicio se ve afectado pero no impide su uso.

- Resolución: La resolución de la incidencia será asignada a un miembro del equipo, el cual debe resolverla. En el caso de tener más de una incidencia asignada, se resolverán por orden de prioridad, siendo el orden de prioridad en resolverla ALTA, MEDIA, y BAJA. Una vez solucionado, será subido a gitHub.

- Revisión: Se asignará un miembro del equipo (puede ser el que realizó la incidencia), el cual deberá revisar que la resolución es correcta.

- Cierre: Se cerrará la incidencia y se documentará la solución tomada.

Integración continua

La integración continua del sistema se gestiona haciendo uso de las herramientas Jenkins, Maven y Docker.

Jenkins

• Consiste en hacer integraciones automáticas de un proyecto con el objetivo de detectar fallos cuanto antes. Consta de tres fases: Make, Beta y Stable.

    *Fase Make (URL)
     Se encarga de descargar el proyecto tras una modificación, ejecutar test para comprobar la integridad  y desplegarlo, es decir, ejecutar los test y       
     todas las acciones oportunas antes de desplegar el proyecto.

   *Fase Beta (URL)
     Se encarga de eliminar restos de despliegue anterior, preparar el despliegue y desplegar.

   *Fase Stable (URL)
     Se ejecuta manualmente y las fases principales son las mismas que en la fase Beta y usa los archivos provenientes de la misma con el fin de conseguir    
     la estabilidad del proyecto.

Travis

• Travis será la encargada de comprobar de lanzar comandos de Maven con el objetivo de comprobar los test de la aplicación, y esto lo hará cuando detecte un commit. Además, Travis añadirá automáticamente añade el verificacion1.jar.

• El objetivo de esto, es automatizar la construcción, la entrega y despliegue del sistema y la ejecución de pruebas

Subsistemas relacionados

Creación de votaciones

• Este proyecto trata del desarrollo del subsistema de Agora@US "Administración y Creación de Votaciones". Nuestro grupo es el encargado de desarrollar el sistema de visualización, cuyo propósito es crear formularios para que los usuarios puedan crear sus votaciones.

Cabina de votación

• Un subsistema de AGORA@US donde el votante podrá ver las distintas opciones y votar una de ellas. El voto tiene que cifrarse en cliente, nunca debe llegar al servidor sin cifrar.

Recuento y modificación

• Es un conjunto de subsistemas de AGORA@US para:

Recuento

Realizará el recuento de una votación determinada. Para realizar el recuento tendrá que pedir los votos al almacenamiento de votos y deberá lanzar la tarea de recuento sincronizando las diferentes autoridades.

Modificación de resultados
    Sistema para interpretar los resultados de una votación y ofrecer un ordenamiento de opciones concreto según   
    diferentes reglas variables. La mayoría de las votaciones no son directas, sino que hay una serie de reglas que 
    ordenan los resultados. Esto puede servir por ejemplo para formar listas con criterios de paridad, criterios de 
    localidad, quitar de los resultados candidatos retirados, etc. Este sistema además de alterar el resultado final 
    debe ofrecer una serie de estadísticas y desviaciones

Tiempos individuales

Repositorio de código

Se utilizará Git como herramienta de gestión de código ya que permite la posibilidad de realizar commits locales. Además esto supone el uso de una característica que el equipo no ha utilizado anteriormente, por lo que supone una oportunidad para aprender un nuevo software de control de versiones.

Verificación en GitHub

Sitio de despliegue del subsistema

Este subsistema no está diseñado para despliegue web, sino para despliegue en forma de librería .jar consumida por otros subsistemas.

Proyecto en Opera

La forma en la que haremos entregar los distintos entregables del proyecto para su posterior corrección sera haciendo uso del portal Opera. El espacio usado por este proyecto de opera es el siguiente:

Verificación en Opera

Enlaces interesantes

• Repositorio del codigo: https://github.com/EGC-1617/Verificacion-G1
• Proyecto en opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/56
• Mapa de herramientas: https://www.text2mindmap.com/
• Travis: https://travis-ci.org/EGC-1617/Verificacion-G13
• Wiki: https://1984.lsi.us.es/wiki-egc/index.php/Verificaci%C3%B3n_1617
• Repositorio compartido: https://github.com/AgoraUS-G1-1617/Verificacion-G13
• Máquina Virtual (Mega) :