2.EVS/2.3-Historias-de-usuario.md

-Una vez analizados los objetivos que se persiguen y cómo cada actor puede darles una solución, con la finalidad de poder evaluar si las distintas soluciones cumplen o no con lo que se espera de ellas y de esta forma poder compararlas para dar una propuesta de solución con los cimientos más sólidos posibles, se utilizarán las historias de usuario como herramienta principal. *Las historias de usuario son una herramienta que agiliza la administración de requisitos, reduciendo la cantidad de documentos formales y tiempo necesarios. Forman parte de la fórmula de captura de funcionalidades definida en 2001 por Ron Jeffries de las tres Cs[...]* <sup>6</sup>.
+Una vez analizados los objetivos que se persiguen y cómo cada actor puede darles una solución, con la finalidad de poder evaluar si las distintas soluciones cumplen o no con lo que se espera de ellas y de esta forma poder compararlas para dar una propuesta de solución con los cimientos más sólidos posibles, se utilizarán las historias de usuario como herramienta principal. *Las historias de usuario son una herramienta que agiliza la administración de requisitos, reduciendo la cantidad de documentos formales y tiempo necesarios. Forman parte de la fórmula de captura de funcionalidades definida en 2001 por Ron Jeffries de las tres Cs[...]* <sup>7</sup>.
 
 Además, estas historias de usuario permitirán una estimación más adecuada tanto en tiempo como en coste para poder comparar las distintas soluciones. El formato que tiene una historia de usuario es el siguiente:
 
 **Como**: *Actor* 
 **Quiero**: *Funcionalidad*
 **Para**: *Finalidad*
-**Criterios de aceptación**: *"[...]Criterios [...] para dar como finalizada la implementación de la historia de usuario"* <sup>6</sup>
+**Criterios de aceptación**: *"[...]Criterios [...] para dar como finalizada la implementación de la historia de usuario"* <sup>7</sup>
 
-Dentro de este marco, y tras hablar con el cliente (Reunión de fecha de 04/09/2024), se han concretado las siguientes historias de usuario para cada uno de los distintos actores, descritos en las especificaciones, que toman parte dentro del proceso de planificación, coordinación y dirección de las sesiones de entrenamiento en el ET.
+Dentro de este marco, desde los entregables del *Impact Map* y tras hablar con el cliente (Reunión de fecha de 04/09/2024), se han concretado las siguientes historias de usuario para cada uno de los distintos [actores](../1.Especificacion/1.4-Actores.md), que toman parte dentro del proceso de planificación, coordinación y dirección de las sesiones de entrenamiento en el ET.
 
 **ECEF**:
 	- Validación de fichas de entrenamiento
 	- Definición de ejercicios
 	- Definición de materiales para realizar ejercicios
-	- Gestión de perfiles de ECEF, Diplomados y Usuarios
+	- Gestión de perfiles de ECEF, Diplomados y Deportistas
 	- Control de niveles de ejecución de fichas
 	- Gestión de un aula de expertos 
 
@@ -27,9 +27,9 @@ Dentro de este marco, y tras hablar con el cliente (Reunión de fecha de 04/09/2
 	- Distribución de información de sesiones al grupo de entrenamiento
 	- Alertas de sobrecarga
 
-**Usuarios**:
+**Deportistas**:
 	- Registro en la aplicación
-	- Solicitud de cambio de nivel de usuario
+	- Solicitud de cambio de nivel de Deportista
 	- Creación de grupos de entrenamiento
 	- Solicitud de acceso a grupos de entrenamiento
 	- Asistente de ejecución de la sesión
@@ -38,7 +38,7 @@ Dentro de este marco, y tras hablar con el cliente (Reunión de fecha de 04/09/2
 	- Calculadora de VAM y 1RM
 	- Carga en SIGINS de los datos de entrenamiento
 
-En el formato definido anteriormente quedarían con la siguiente forma, estructuradas en actores:
+En el formato definido anteriormente quedarían con la siguiente forma, sin entrar en detalle de los criterios de aceptación más que para saber si las distintas soluciones propuestas cumplen o no con lo que el cliente necesita, estructuradas en actores:
 
 #### **ECEF**:
 
@@ -47,61 +47,41 @@ En el formato definido anteriormente quedarían con la siguiente forma, estructu
    - **Quiero:** validar las fichas de entrenamiento de manera rápida y sencilla.
    - **Para:** asegurar que las fichas cumplen con criterios de coherencia adecuados.
    - **Criterios de aceptación:** 
-	   - Poder ver, aceptar o rechazar las fichas que proponen los diplomados en EF del ET por la aplicación.
-	   - Que el resto de usuarios no tengan acceso a la ficha mientras que no se haya aprobado.
-	   - Las fichas deben proponerse con un RPE de su realización.
+	   - Que la ECEF pueda decidir qué fichas son válidas para difundir.
 
 2. **HU-02: Definición de ejercicios**
    - **Como:** ECEF
    - **Quiero:** definir ejercicios.
    - **Para:** proporcionar ejercicios realizables y bien definidos para poder diseñar y ejecutar las fichas.
-   - **Criterios de aceptación:** Los ejercicios deben contemplar los siguientes aspectos:
-	- Nombre (Obligatorio)
-	- Descripción (Obligatorio)
-	- Equipo
-	- Músculos primarios
-	- Músculos secundarios
-	- Cualidad (Obligatorio)
-	- Número de ejecutantes (Obligatorio)
-	- Tipo de movimiento
-	- Tipo de contracción
-	- Velocidad
-	- Enlace a imagen o Vídeo
+   - **Criterios de aceptación:** 
+	   - Que la ECEF pueda definir qué ejercicios son o no adecuados para incluir en las fichas. 
 
 3. **HU-03: Definición de materiales para realizar ejercicios**
    - **Como:** ECEF
    - **Quiero:** definir el material necesario para cada ejercicio.
-   - **Para:** asegurar que los entrenadores y usuarios tienen claridad sobre los recursos que necesitan.
-   - **Criterios de aceptación:** Los equipos deben contemplar los siguientes aspectos:
-	   - Nombre (Obligatorio)
-	   - Descripción (Obligatorio)
-	   - Enlace a imagen
+   - **Para:** asegurar que los entrenadores y Deportistas tienen claridad sobre los recursos que necesitan.
+   - **Criterios de aceptación:** 
+      - Que la ECEF pueda definir materiales para utilizar en los ejercicios que propone
 
-4. **HU-04: Gestión de perfiles de ECEF, Diplomados y Usuarios**
+4. **HU-04: Gestión de perfiles de ECEF, Diplomados y Deportistas**
    - **Como:** ECEF
-   - **Quiero:** gestionar los perfiles de diferentes actores (Diplomados, Usuarios).
+   - **Quiero:** gestionar los perfiles de diferentes actores (Diplomados, Deportistas).
    - **Para:** administrar permisos y niveles de acceso.
-   - **Criterios de aceptación:** Poder visualizar las peticiones que haya de cambio de nivel de usuario y aceptarlas o rechazarlas.
+   - **Criterios de aceptación:** Que la ECEF pueda definir quienes son diplomados o no.
 
 5. **HU-05: Control de niveles de ejecución de fichas**
    - **Como:** ECEF
    - **Quiero:** controlar los niveles de ejecución de fichas.
    - **Para:** comprobar qué fichas se ejecutan y qué fichas no, así como quién ejecuta qué fichas.
    - **Criterios de aceptación:** 
-	   - Ver el número de sesiones en que se ha usado cada ficha.
-	   - Ver la RPE media de la ficha.
-	   - Ver los distintos grupos creados de entrenamiento.
-	   - Ver los distintos planes de entrenamiento y las veces que se ha utilizado cada uno.
+	   - Que la ECEF pueda comprobar si hay fichas que no se utilicen o unidades que no utilicen fichas.
 
 6. **HU-06: Gestión de un aula de expertos**
    - **Como:** ECEF
    - **Quiero:** gestionar las actividades dentro del aula de expertos.
    - **Para:** continuar la formación de los diplomados en Educación Física.
-   - **Criterios de aceptación:** Tener un espacio donde poder:
-	   - Establecer temas sobre los que formar al personal diplomado.
-	   - Publicar artículos o documentación de interés.
-	   - Realizar formaciones complementarias.
-	   - Establecer debates sobre temas definidos.
+   - **Criterios de aceptación:** 
+      - Que la ECEF pueda gestionar un lugar donde perfeccionar los conocimientos de los diplomados.
 
 ---
 
@@ -111,31 +91,21 @@ En el formato definido anteriormente quedarían con la siguiente forma, estructu
    - **Como:** Diplomado
    - **Quiero:** diseñar planes de entrenamiento personalizados.
    - **Para:** proporcionar plantillas base para realizar macrociclos orientados a unos objetivos concretos.
-   - **Criterios de aceptación:** Poder crear, guardar y editar planes de entrenamiento para diferentes perfiles de usuarios, dentro de un calendario organizado por semanas, pero sin fechas.
+   - **Criterios de aceptación:** 
+      - Que el diplomado pueda diseñar plantillas de planes de entrenamiento, en base a objetivos genéricos, para que cualquiera pueda utilizarla.
 2. **HU-08: Propuesta de fichas**
    - **Como:** Diplomado
    - **Quiero:** proponer fichas de entrenamiento.
    - **Para:** aumentar y actualizar las fichas actuales de entrenamiento .
    - **Criterios de aceptación:** 
-	   - Poder proponer a la ECEF fichas de entrenamiento para su aprobación.
-	   - Comprobar si han sido o no rechazadas. 
-	   - Poder editarlas en caso de haber sido rechazadas.
-	   - Las fichas deben contemplar:
-		   - Nombre
-		   - Descripción
-		   - Cualidad
-		   - Tipo (Previstos en el Manual MI-003 Tomo I y Deportes militares)
-		   - Rondas
-			   - Series
-		   - RPE
-		   - Autor de la ficha
-		   - Unidad para la que se hace
+	   - Que los diplomados puedan proponer fichas nuevas a la ECEF.
 
 3. **HU-09: Acceso al aula de expertos**
    - **Como:** Diplomado
    - **Quiero:** acceder al aula de expertos.
    - **Para:** mejorar mi formación.
-   - **Criterios de aceptación:** Poder unirse y participar en las sesiones del aula de expertos de forma sencilla, así como participar en los debates y visualizar la documentación disponible en el aula de expertos on-line.
+   - **Criterios de aceptación:** 
+      - Que los diplomados puedan recibir formación de perfeccionamiento en su ámbito por parte de la ECEF.
 
 ---
 
@@ -145,86 +115,111 @@ En el formato definido anteriormente quedarían con la siguiente forma, estructu
    - **Como:** Encargado de grupo
    - **Quiero:** disponer de un asistente que me permita trabajar con los documentos de la ECEF y los diplomados para poder planificar las sesiones de EF.
    - **Para:** facilitar la planificación de la gimnasia.
-   - **Criterios de aceptación:** El asistente debe permitir:
-	   - Consultar y seleccionar fichas para una sesión.
-	   - Consultar los ejercicios de las fichas.
-	   - Consultar los equipos de los ejercicios.
-	   - Seleccionar una fecha para la sesión.
+   - **Criterios de aceptación:**
+	   - Que el encargado de grupo tenga una forma sencilla y ágil de incluir fichas en sus sesiones y revisar la programación.
 
 2. **HU-11: Tablón de grupo**
    - **Como:** Encargado de grupo
    - **Quiero:** poder gestionar un tablón en el que mostrar a los miembros del grupo las actividades previstas.
    - **Para:** distribuir la información de sesiones al grupo de entrenamiento.
    - **Criterios de aceptación:** 
-	   - Poder visualizar las sesiones planificadas.
-	   - Poder visualizar las sesiones realizadas.
-	   - Poder gestionar los miembros del grupo.
-      - Poder visualizar los miembros del grupo y sus entrenamientos en el grupo.
+	   - Que exista un lugar donde un grupo de entrenamiento pueda consultar su próximos entrenamientos y saber quién puede verlo o no.
 
 3. **HU-12: Alertas de sobrecarga**
    - **Como:** Encargado de grupo
    - **Quiero:** recibir alertas cuando los deportistas presenten una posible sobrecarga.
    - **Para:** prevenir lesiones y garantizar un entrenamiento equilibrado.
    - **Criterios de aceptación:** 
-	   - En el momento en que un deportista tenga dos sesiones seguidas con un RPE alto(7-10), recibir un aviso.
-	   - En el momento en que un deportista tenga dos sesiones seguidas con un RPE alto y las sesiones tengan de duración una media de *X*, recibir un aviso
+	   - Que dadas unas determinadas condiciones, al encargado de grupo se le avise de que hay deportistas del grupo que pueden presentar síntomas de sobrecarga.
 
 ---
 
-#### **Usuarios**:
+#### **Deportistas**:
 
 1. **HU-13: Calendario de entrenamientos**
-   - **Como:** Usuario
+   - **Como:** Deportista
    - **Quiero:** poder acceder a un calendario de los grupos en los que me encuentro.
    - **Para:** conocer el contenido de las siguientes sesiones a realizar.
    - **Criterios de aceptación:** 
-	   - Poder ver las próximas sesiones que se van a realizar.
-	   - Poder marcar una sesióin como realizada.
-	   - Poder ver las sesiones ya realizadas.
+	   - Que exista un lugar desde el que un deportista pueda ver los próximos entrenamientos que tiene que realizar.
 
 2. **HU-14: Creación de grupos de entrenamiento**
-   - **Como:** Usuario
+   - **Como:** Deportista
    - **Quiero:** crear grupos de entrenamiento.
-   - **Para:** organizar sesiones y actividades con otros usuarios si se me nombra encargado de un grupo.
-   - **Criterios de aceptación:** Poder crear un grupo. El grupo deberá tener un nombre con el que poder identificarlo.
+   - **Para:** organizar sesiones y actividades con otros Deportistas si se me nombra encargado de un grupo.
+   - **Criterios de aceptación:** 
+      - Que cualquier deportista pueda crear un grupo.
 
 3. **HU-15: Solicitud de acceso a grupos de entrenamiento**
-   - **Como:** Usuario
+   - **Como:** Deportista
    - **Quiero:** solicitar acceso a un grupo de entrenamiento.
    - **Para:** poder acceder a la planificación de un grupo de entrenamiento.
-   - **Criterios de aceptación:** Enviar solicitudes a grupos existentes y recibir una confirmación de ingreso.
+   - **Criterios de aceptación:** 
+      - Que una vez que quiero entrar en un grupo de entrenamiento pueda enviar una petición para que se acepte.
 
 4. **HU-16: Asistente de ejecución de la sesión**
-   - **Como:** Usuario
+   - **Como:** Deportista
    - **Quiero:** tener un asistente para guiarme en la ejecución de la sesión de entrenamiento.
    - **Para:** asegurarme de seguir los pasos correctos y optimizar mi rendimiento.
-   - **Criterios de aceptación:** Acceso a un asistente virtual o herramienta que muestre los ejercicios y tiempos de ejecución.
+   - **Criterios de aceptación:** 
+      - Disponer de una herramienta que me facilite la ejecución de la sesión de entrenamiento.
 
 5. **HU-17: Feedback de la sesión**
-   - **Como:** Usuario
+   - **Como:** Deportista
    - **Quiero:** dar feedback sobre la sesión de entrenamiento.
    - **Para:** mejorar la planificación futura de mis entrenamientos.
-   - **Criterios de aceptación:** Aportar información sobre el rendimiento en las sesiones realizadas:
-	   - RPE.
-	   - Tiempo de la parte fundamental de la sesión.
-	   - Resultados del entrenamiento (Distancia, tiempo, repeticiones de las rondas o series, %RM, número de ejecuciones...).
+   - **Criterios de aceptación:** 
+      - Que pueda hacer saber de forma sencilla a mi encargado de entrenamiento los pormenores de la sesión.
 
-7. **HU-18: Anotar datos de rendimiento**
-   - **Como:** Usuario
+6. **HU-18: Anotar datos de rendimiento**
+   - **Como:** Deportista
    - **Quiero:** anotar mis datos de rendimiento.
    - **Para:** evaluar mi progreso y ajustar mi entrenamiento.
-   - **Criterios de aceptación:** Ingresar datos sobre el VAM, la 1RM y las repeticiones máximas de los ejercicios.
+   - **Criterios de aceptación:** 
+      - Que pueda controlar mis datos de rendimiento como RM, VAM y máximo de repeticiones.
 
-9. **HU-19: Calculadora de VAM y 1RM**
-   - **Como:** Usuario
+7. **HU-19: Calculadora de VAM y 1RM**
+   - **Como:** Deportista
    - **Quiero:** poder calcular de forma sencilla mi VAM y mi 1RM de los ejercicios.
    - **Para:** que poder registrar los datos y ver mi progreso.
    - **Criterios de aceptación:** 
-	   - Calculadora para VAM en base al test de Cooper<sup>9</sup> y la distancia alcanzada en los 12 minutos. El resultado será la media entre los cálculos previstos por Cooper, Howald y Balke.
-	   - Calculadora para la 1RM
+	   - Que pueda calcular rápidamente mis datos de rendimiento si necesidad de fórmulas
 
-9. **HU-20: Carga en SIGINS de los datos de entrenamiento**
-   - **Como:** Usuario
+8. **HU-20: Carga en SIGINS de los datos de entrenamiento**
+   - **Como:** Deportista
    - **Quiero:** cargar mis datos de entrenamiento en SIGINS.
    - **Para:** que quede registrado en SIGINS la realización de las sesiones.
-   - **Criterios de aceptación:** Actualizar SIGINS con datos obtenidos de la aplicación.
+   - **Criterios de aceptación:** 
+      - Que pueda actualizar en SIGINS las fichas de la aplicación.
+
+
+Para realizar una valoración cuantitativa, a cada entregable o historia de usuario se le asignará una puntuación en *puntos historia*<sup>8</sup>. A partir de estos puntos historia, se calcula el total para cada impacto y el total de la solución, permitiendo así determinar el porcentaje de cobertura de los impactos. En los casos en que un impacto se vea cubierto de manera no prevista a través de los entregables, será necesario evaluar el porcentaje de cumplimiento de dicho impacto.
+
+Este enfoque permite agrupar los distintos entregables e impactos, facilitando la comparación del peso de cada uno en términos de tiempo y coste, lo que proporciona una visión clara del esfuerzo necesario para su implementación.
+
+El concepto de *punto historia*, en este contexto concreto, se utiliza para hacer referencia al esfuerzo de desarrollo e implementación que puede completarse durante una jornada laboral de 8 horas. Siguiendo esta metodología, 2 puntos historia equivaldrían a dos jornadas laborales, es decir, 16 horas de trabajo. Es importante destacar que cualquier estimación realizada se basa en la experiencia y el criterio profesional tanto del analista como de los desarrolladores que la efectúan. Estas estimaciones son aproximaciones y, aunque no ofrecen una precisión absoluta en cuanto al tiempo real de ejecución, permiten proporcionar al cliente una proyección estimada de tiempo y coste.
+
+La tabla con los *puntos historia* de cada *historia de usuario* es la siguiente:
+
+| HU    | PH  |
+|-------|-----|
+| HU-01 | 2   |
+| HU-02 | 2   |
+| HU-03 | 2   |
+| HU-04 | 2   |
+| HU-05 | 8   |
+| HU-06 | 16  |
+| HU-07 | 4   |
+| HU-08 | 4   |
+| HU-09 | 8   |
+| HU-10 | 2   |
+| HU-11 | 8   |
+| HU-12 | 4   |
+| HU-13 | 2   |
+| HU-14 | 1   |
+| HU-15 | 2   |
+| HU-16 | 8   |
+| HU-17 | 4   |
+| HU-18 | 2   |
+| HU-19 | 1   |
+| HU-20 | 16  |