Automatizacón de la Gestión de Requisitos de MEDEA

• Alumno
  • Jorge Menchón Albaladejo jorge.menchon@um.es. 615972383
• Facultad de Informática
  • Joaquín Nicolás Ros. jnr@um.es. Ext 8525
  • Juan Manuel Carrillo de Gea. jmcdg1@um.es. Ext 4642
• MNCS (ATICA) mncs@um.es. Ext 7604
  • Francisco García Mateo. pacom@um.es. Ext 7604
  • Juan Luis Serradilla. juanlu@um.es. Ext 7604
  • Pedro Delgado Yarza (FundeWEB). pedrody@um.es. Ext 8753

• Trabajo Fin de Grado
• Plan de Trabajo Actualizado

• Ficha Resumen del Trabajo Fin de Grado

• Proyecto TFG en Jira de ATICA
• SCRUM
  • Libro de "Scrum y XP desde las trincheras"
  • Presentación Scrum ATICA
  • Presentación Sprint ATICA
• MEDEA 1.1.0
  • Plantillas de MEDEA
  • Presentaciones Curso MEDEA
• FundeWEB 2.0
• BD ISIS
  • Conexión
    • Host: isis.atica.um.es
    • Puerto: 1522
    • Servicio: isis.world
  • Usuarios
    • MEDEA: propietario de las tablas a crear.
    • JV_MEDEA: usuario para la fuente de datos del servidor de aplicaciones (datasource)
• Repositorio SVN
• JIRA
  • JIRA (Gestor de Incidencias)
  • JIRA Pruebas (Gestor de Incidencias para hacer pruebas de integración con la aplicación, como dar de alta una incidencia)
  • Documentación de la API de Jira para crear tareas
• Servidor Weblogic de Desarrollo
  • URL principal: http://medeapruebas.um.es/medea/
  • Logs: http://medeapruebas.um.es/logs/
    • http://medeapruebas.um.es/logs/desarrollo/weblogic/mncs1-1_yyyy_MM_dd_hh_mm.log
    • http://medeapruebas.um.es/logs/desarrollo/aplicacion/medea-application.log
  • Testear Fuente de datos: http://medeapruebas.um.es/medea/TestDataSource?dsname=jdbc/Medea DataSource
  • SoopServlet: http://medeapruebas.um.es/medea/SnoopServlet

Asistentes: todos los contactos

Resumen: Duración 1h.

• MNCS:
  • Preparar Wiki para el proyecto, con acceso a los recursos necesarios (MEDEA y FundeWEB).
  • Crear lista de correo para el proyecto donde estemos todos los contactos.
  • Acceso a JiraPruebas (servidor Jira de pruebas).
  • Acceso a BD de Desarrollo (ISIS).
  • Preparar sesión formativa sobre FundeWEB y MEDEA para la semana del 10 al 14 de Marzo, en principio Lunes 10.
• Facultad: enviar documentación técnica del TFG sobre Gestión de Requisitos con Drupal.
• Alumno:
  • Hablar con su empresa para la sesión formativa inicial, en principio el 10-3-2014.
  • Empezar a mirar la documentación del TFG anterior, así como la que hay en la Wiki de MEDEA y FundeWEB.

Sesión formativa sobre FundeWEB. Toda la mañana (9 a 15h).

Asistentes: Jorge, Joaquín, Paco y Juan Luis.

Resumen: Duración 1h45m.

• Se confirma que la dedicación del Jorge al TFG son 320h (20h/semana, 80h/mes, durante 4 meses, desde el 1-10-2014).
• Jorge se compromete a dedicarle el tiempo necesario y terminar el TFG para Febrero del 2015.
• ATICA ofrece una mesa en el despacho de MNCS (1.07) para que Jorge pueda trabajar en el TFG. Jorge cree q le puede venir bien cuando empiece con el desarrollo de la aplicación con FundeWEB.
• Jorge se compromete a aplicar MEDEA a la gestión del proyecto, empezando por “traducir” el plan de trabajo a artefactos MEDEA (actas de reuniones, cronograma, documento visión, etc).
• Jorge incluirá en el análisis (dependencias, flujos, etc) la interacción con Jira, y se compromete a q la aplicación sea capaz de generar los jiras de la gestión de requisitos.
• Acta del día: TFG-20141010-ACT-DeterminarAlcance

Asistentes: Jorge, Joaquín, Paco, Pedro y Juan Luis.

Resumen: Duración 2h20m.

• Estado del Proyecto: Jorge dice q ha terminado el análisis y tiene casi terminadas las pantallas de mantenimiento de la aplicación, con persistencia en BD.
• Revisión de la aplicación en “http://medeapruebas.um.es”: le hacemos sugerencias de mejora, incluyendo remodelación del acceso a las opciones, para q sea más intuitivo, y siga el “workflow” de MEDEA.
• Lo que falta: además de implementar la sugerencias de mejora q le hemos hecho, hay q terminar los mantenimientos, pues no están todos terminados, y tb tiene q desarrollar la generación de documentos con BIRT, así como permitir la grabación de documentos en Alfresco, y crear los Jiras correspondientes a las tareas de Gestión de Requisitos.
• Hemos quedado para la semana del 9-2-2015 deberían estar terminados todos los mantenimientos, y aplicadas las mejoras q le hemos hecho de cara a q la aplicación sea más intuitiva y usable.
• Tanto ATICA como la Facultad (Joaquín) deberíamos revisar a fondo la aplicación (http://medeapruebas.um.es) para comprobar su correcto funcionamiento.

Asistentes: Jorge, Joaquín, Paco, Pedro y Juan Luis.

Resumen: Duración 2h20m.

• Revisamos la aplicación y proponemos mejoras en organización de campos, longitudes, usabilidad, informes, etc.

Asistentes: Pacom, Juan Luis.

A partir de varias dudas q le surgen a Joaquín y Jorge sobre el versionado de requisitos y documentos, me reúno con Pacom para elaborar una lista de requisitos q debe cumplir la aplicación en este sentido (versionado de requisitos y documentos).

1.- VERSIONADO general, da igual q sea de requisitos o de documentos:

• Cuando manejamos un requisito/documento realmente siempre trabajamos con una versión concreta del requisito/documento, por lo tanto a partir de ahora si hablamos de requisito/documento realmente estamos hablando de una versión concreta de un requisito/documento.
• Una versión puede estar “abierta” o “cerrada”, y solo se pueden modificar los datos si está abierta.
• Si tengo varias versiones solo podré tener “abierta” la última versión.
• Al cerrar una versión la app me avisará de q “una vez cerrada no podré modificarla”, y solo podré “crear nueva versión”.
• Excepcionalmente, el Jefe de Proyecto podrá abrir una versión cerrada si ésta es la última.
• Para “crear una nueva versión” todas las anteriores deben estar cerradas.

2.- REQUISITOS, da igual q sea de alto nivel (visión) o de bajo nivel (historias, casos de uso, requisitos no funcionales),:

• Un requisito se crea dentro de un Catálogo reutilizable, o bien en un Proyecto, nunca de forma aislada.
• En un proyecto puedo copiar los requisitos de un Catálogo.
• En un catálogo puedo copiar uno, varios o todos los requisitos de un Proyecto.

3.- APROBACIÓN DE REQUISITOS:

• A nivel requisito, vamos a separar la acción de “Aprobar” (visto bueno del usuario) de la de “Cerrar Versión”, aunque al pulsar el botón “Aprobar” por defecto se lanzará tb la acción “Cerrar Versión”. De este modo una versión aprobada de un requisito NO se podrá modificar.
• Al “Aprobar” un requisito la app debe preguntar si “estoy seguro de hacerlo” avisando de q implica q “dicho requisito no se podrá modificar, a no ser q crees una nueva versión”.
• Para adaptarnos a la realidad del trabajo diario, mientras no exista una versión posterior del requisito, vamos a habilitar un botón “Abrir Versión” q nos permitirá hacer un cambio en un requisito ya aprobado. Esta opción de “Abrir Versión” debería requerir permisos especiales (rol “Jefe Proyecto”), ya q podré modificar un requisito aprobado por el cliente.

4.- VERSIONADO DE REQUISITOS (se aplica el punto 1 de VERSIONADO general de más arriba):

• Crearé una nueva versión de un requisito cuando haya q modificar un requisito ya aprobado.

5.- DOCUMENTOS, da igual q sea de Visión o de Requisitos.

• Un documento sirve para definir qué requisitos voy a abordar, ya sean de alto nivel (visión) o de bajo nivel (historias, casos de uso, requisitos no funcionales), y tb es una herramienta para comunicárselo al cliente.
• Un requisito de un proyecto solo puede aparecer en un Documento de dicho proyecto (ya sea de Visión o de Requisitos). Obviamente, los requisitos de visión solo pueden estar en un documento de visión.
• Una versión de un requisito puede aparecer en varios versiones del mismo documento.
• Un Documento debe un atributo para recoger la “Versión de la Aplicación” a la q se corresponde.
• Puedo añadir requisitos del proyecto a un Documento (solo la última versión de cada requisito q quiera añadir), de modo q NO SE COPIA el requisito en el documento, pues el versionado (abierto/cerrado) de cada requisito es el q define si dicho requisito está “vivo” o no. Por lo tanto, en el documento solo tengo la relación de requisitos del proyecto q he seleccionado con su versión correspondiente.

6.- VERSIONADO DE DOCUMENTOS (se aplica el punto 1 de VERSIONADO general):

• Crearé una nueva versión de un documento cuando necesite modificar/borrar requisitos ya aprobados del citado documento, y tb si quiero añadir nuevos requisitos una vez q ya he cerrado la versión del citado documento.

Asistentes: Jorge, Joaquín, Juanma, Pedro, Pacom, Juan Luis.

Resumen: hablamos de la revsión técnica q ha hecho Pedrody al código de la aplicación (ver más abajo), y hacemos una revisión de la aplicación de la que surgen los siguientes bugs (B) y peticiones de cambio (N):

1. (B) (Hecho) Rich Editor a veces no se carga: Pedrody sugiere actualizar a última versión de Primefaces para ver si se soluciona, pues recuerda haber visto bug similar al usar el editor en pestañas, como es el caso.
2. (B) (Hecho) Componente tabla editable: en los convocados a una reunión permite crear una línea en blanco y guardarla, lo q provoca q luego la app falle.
3. (B) (Hecho) Gestión de Reuniones: el botón “Abrir Versión” debe tener el texto “Abrir Reunión”.
4. (B) (Hecho) Historias: donde dice “Como probarlo” debe ser “Cómo probarlo” (con tilde).
5. (B) (Hecho) Botón “Volver”: debe estar siempre a la derecha.
6. (B) (Hecho) Gestión de Reuniones: en la lista de Asistentes, el check “Asistido” debe ser clicacle sin editar la línea.
7. (N) (Hecho) Listado de documentos del proyecto (y cualquier lista): los botones de paginación deben estar debajo, incluyendo la selección del nº de elementos por página, y la selección del nº de página a la q quiero ir directamente.
8. (N) (Hecho) Edición de requisitos: los campos Nombre, Texto y Breve Descripción deben ser Código, Resumen y Descripción.
9. (N) (Hecho) Lista de documentos: incluir un botón para descargar el documento (Pedrody le tiene q pasar captura de pantalla con el icono en cuestión).
10. (N) (Hecho) Requisitos Proyecto: importar Catálogo, debe traerse los requisitos del catálogo y aprobarlos, cerrando la v1.0.0. De modo q si se quieren modificar requerirá crear nueva versión de cada uno.
11. (N) (Hecho) Listado Requisitos: los campos a mostrar por defecto son Proyecto, Tipo, Código, Resumen, Versión y Aprobado (Quién y Fecha).
12. (N) (Hecho) Generar Documento con Requisitos de un Catálogo: hacerlo de forma similar al Documento de Requisitos, en lugar de en un listado tipo tabla. Para ello, Jorge tendrá q copiar y pegar la plantilla del doc. de requisitos y modificarla.
13. (N) (Hecho) Filtros: incluir icono “embudo” cuando se aplique un filtro, y q se cierre el filtro al aplicarlo. Pedrody tiene q paasrle captura de pantalla con el “icono del embudo”.
14. (N) (Hecho) Generar Documento: al generar cualquier documento hay q tener en cuenta q si una sección del mismo está vacía, se debe incluir el texto “No hay datos.”, de forma q quede claro q NO se ha rellenado la sección en cuestión.
15. (N) (Hecho) Añadir un tooltip a iconos para descargar los pdfs de Acta y Orden del Día (y saber cual es cada uno).

Además, Pedrody ha hecho una revisión técnica del código de la aplicación, de modo que habría que revisar lo siguiente:

1. (Hecho) Los métodos “getLog()” no deben devolver nulos, sino el log
2. (Hecho) Quitar todos los “TODO” y todo el código comentado innecesario
3. (Hecho) Quitar las variables que no se utilicen
4. (Hecho) Mover los métodos getter y setter al final del código
5. (Hecho) Quitar accesos a rutas absolutas. Ejemplo: C:\out.pdf en el Manejador de reuniones.
6. (Hecho) A la hora de recuperar el usuario cambia identiy.getUsername() por identiy.getCredentials().getUsername()
7. (Hecho) He adjuntado dos imágenes una del botón de filtrado y otra de un pequeño mantenimiento que tiene los iconos de buscar y limpiar. Sobre el botón de filtrado, aunque en apium no está hecho, resalta en rojo el icono para que llame la atención mejor.
8. (Hecho) Eliminar import que no hacen falta.
9. (Hecho) No poner llaves en los condicionales.
10. (Hecho) Poner Javadoc a principales métodos.
11. (Hecho) Poner una salida de log en todas las excepciones que se capturen.
12. (Hecho) Quitar los printStackTrace.
13. (Hecho) Para actualizar a primefaces 5.2 cambia en el pom.xml del módulo web el bloque de primefaces por:

    <!-- Primefaces -->
            <dependency>
                <groupId>org.primefaces</groupId>
                <artifactId>primefaces</artifactId>
                <version>5.2</version>
            </dependency>
     
            <dependency>
                <groupId>org.primefaces.themes</groupId>
                <artifactId>all-themes</artifactId>
            </dependency>
     
            <dependency>
                <groupId>rome</groupId>
                <artifactId>rome</artifactId>
            </dependency>
     
            <dependency>
                <groupId>org.jdom</groupId>
                <artifactId>jdom</artifactId>
            </dependency>
     
            <dependency>
                <groupId>org.primefaces.extensions</groupId>
    <artifactId>primefaces-extensions</artifactId>
                <version>3.1.0</version>
            </dependency>
     
            <dependency>
                <groupId>org.primefaces.extensions</groupId>
                <artifactId>resources-ckeditor</artifactId>
                <version>3.1.0</version>
            </dependency>
     
            <dependency>
                <groupId>com.google.code.gson</groupId>
                <artifactId>gson</artifactId>
            </dependency>
     
            <dependency>
                <groupId>org.apache.poi</groupId>
                <artifactId>poi</artifactId>
            </dependency>
            <!-- FIN - Primefaces -->

El compromiso de Jorge es tener solucionado todo ésto para el 15-6-2015 (Bugs y Cambios resultantes de la revisión, más las mejoras propuetas por Pedrody al código)

MNCS tiene que preparar la infraestructura de recursos necesaria que debe proporcionar Atica (Wiki, lista-correo, SVN, BD, Web, etc):

El 10-3-2014 Jorge recibe formación sobre nuestro entorno de desarrollo FundeWEB 2.0, por parte de Pedrody.

Instalado FundeWEB-2.0 en su portátil, y solucionados los problemas del IDE y tb de accesos.

Comenta q va a cambiar de portátil a un Mac, por lo q se le recomienda trabajar con una máquina virtual, en la q tendrá q instalarlo todo de nuevo (ya sabe cómo).

El 11-3-2014 Jorge continua con la formación sobre el entorno de desarrollo FundeWEB 2.0. En primer lugar, repasa todo lo explicado por Pedro la mañana anterior y una vez repasado ahonda más en la configuración del proyecto semilla que se le instaló en el portátil para poder comprender a la perfección el funcionamiento y poder seguir con el estándar de aplicación que se propone desde ATICA.

En cuanto al cambio de portátil, este es debido a dos motivos. Por una parte la velocidad de su actual ordenador y por otro que el hecho de trabajar con un entorno FundeWEB implica cambios en la configuración actual de su portátil.

El 9-12-2014, Pedrody estuvo con Jorge por la tarde, y le solucionó el problema q tenía con FDW2 (estaba usando el mismo proyecto FDW1), creando de nuevo el proyecto con FDW2; y le explicó cómo hacer las pantallas, con qué componentes, y tb cómo implementar la persistencia, generando las clases a partir de la BD.

El 5-2-2015, Pedrody estubo con Jorge por la mañana, solucionando dudas técnicas sobre FDW, y enseñándole como hacer un informe BIRT.

• Soporte MNCS al TFG de Jorge Menchón
  • Soporte de Pedrody (FUNDEWEB)
  • Soporte de Juanlu (MEDEA)

• Semana 1 (10-3-2014)
• Semana 2 (17-3-2014)
• Semana 3 (24-3-2014)
• Semana 4 (31-3-2014)

• Semana 1 (07-4-2014)
• Semana 2 (14-4-2014)
• Semana 3 (21-4-2014)
• Semana 4 (28-4-2014)

• Semana 1 (06-10-2014)
• Semana 2 (13-10-2014)
• Semana 3 (20-10-2014)
• Semana 4 (27-10-2014)

• Semana 1 (03-11-2014)
• Semana 2 (10-11-2014)
• Semana 3 (17-11-2014)
• Semana 4 (24-11-2014)

• Semana 1 (01-12-2014)
• Semana 2 (08-12-2014)
• Semana 3 (15-12-2014)
• Semana 4 (22-12-2014)

• Semana 1 (29-12-2014)
• Semana 2 (05-01-2015)
• Semana 3 (12-01-2015)
• Semana 4 (19-01-2015)

• Semana 1 (26-02-2015)
• Semana 2 (02-02-2015)
• Semana 3 (09-02-2015)
• Semana 4 (16-02-2015)

• Gestionar Ordenes del Día
• Gestionar Actas del Día
• Gestionar Visión
• Gestionar Maestros(Catálogos) de Requisitos
• Gestionar Requisitos
• Gestionar Patrones
• Gestionar Parámetros
• Gestionar Proyectos

Funcionalidades generales a implementar:

• Gestión de proyectos.
• Gestión de catálogos.
• Gestión de requisitos.
• Gestión de reuniones.
• Generación de documentos con BIRT.

Detalle de las funcionalidades a implementar:

• Mantenimiento de Proyectos: requisitos del proyecto (mantenimiento, importación desde catálogo, versionado), reuniones (generación de órden del día y acta) y documentos visión/requisitos (mantenimiento, generación de pdf y versionado).
• Mantenimiento de Catálogos: requisitos del catálogo (mantenimiento y generación de listado pdf).
• Consulta de Requisitos: para listar requisitos por proyecto, catálogo, tipo, nombre, descripción, etc, de modo q pueda seleccionar un requisito de la lista y editarlo, lo q me llevará a la pantalla de edición del requisito en el proyecto/catálogo según donde esté.
• Gestión de Identificación de Personas: copiarlo de APIUM, de modo q se obtengan/busquen los datos de cualquier persona involucrada en la Gestión de Requisitos, como responsables funcionales, expertos, etc. No incluya gestión de cargos, q será abordada en versiones siguientes.
• Gestión de Usuarios y Roles: hay operaciones q solo las puede hacer determinado rol, como por ejemplo, Abrir una versión cerrada de un requisito aprobado. Replanificado para versión 1.1.

Ajustes necesarios:

• Ajuste del Modelo de Datos en BD: ajustarlo a todos los cambios q se hayan hecho, de modo q las tablas tengan los nombres correctos y las columnas necesarias. Finalmente el modelo debe estar impoluto, con las entidades necesarias bien nombradas, y los atributos requeridos bien dimensionados.
• Ajuste de todas las pantallas (estilo y usabilidad, como puede ser ajuste de campos o q el botón Volver te lleve a la pantalla de la q vienes).
• Validación de TODOS los campos, tanto en la vista como en la capa de persistencia.

Fecha de entrega: 30 de /Junio

Cierre de la version: puesta en producción de la versión 1.0 (en los servidores de producción de BD y Web, pasando antes todas las pruebas en los servidores de tests). Deben incluirse los cambios propuestos en la reunión del 4-6-2015.

Versión cerrada a 29-6-2015, en servidor de Desarrollo (no está en Test ni Producción).

• Gestión de cargos, similar a como se hace en ApiUM.
• Gestión de Usuarios y Roles: hay operaciones q solo las puede hacer determinado rol, como por ejemplo, Abrir una versión cerrada de un requisito aprobado.

• Conexión JIRA para la gestión de tareas.
• Conexión ALFRESCO para guardar documentos generados.
• Conexión APIUM para la trazabilidad con aplicaciones.
• Conexión Agenda UMU para la gestión de reuniones.
• Requisitos parametrizados (propuesta Joaquín Fac.Inf.).
• Gestión completa de trazas para reutilización (propuesta Joaquín Fac.Inf.).
• Etiquetas (propuesta Joaquín Fac.Inf.).
• Patrones de requisitos predefinidos (propuesta Joaquín Fac.Inf.).