04 metricas y graficos - lfnavarroj1/sport-app-platform GitHub Wiki

Métricas y gráficos de desarrollo

Esta página presenta el avance verificable de SportApp. El corte corresponde al 11 de octubre de 2026 y usa como fuente el proyecto SportApp Platform.

Convenciones de lectura

Para evitar que una proyección se interprete como resultado real, todos los datos se clasifican así:

Tipo de dato Significado
Real Resultado observado en el Project o en CI al corte indicado
Planificado Alcance asignado a un sprint, todavía no entregado
Proyectado Escenario hipotético; no representa avance conseguido
N/D Aún no existe una medición válida

Se administran dos perfiles complementarios. El desarrollo se observa semanalmente mediante PHU y valor equivalentes ponderados por evidencia verificable. La producción solo contabiliza HU aceptadas y liberadas. Los equivalentes de desarrollo son un indicador interno de avance; no son velocidad Scrum, no prueban aceptación y no sustituyen el valor entregado.

Cuadro de mando

Métrica Definición Momento de medición Resultado al corte
Avance técnico semanal Incremento semanal de PHU equivalentes, calculados como PHU × avance verificable Cada cierre semanal 5 PHU equivalentes en la semana 1
Burndown de desarrollo PHU comprometidos menos PHU equivalentes desarrollados Cada cierre semanal 22 de 27 PHU equivalentes restantes
Velocidad oficial del sprint PHU de HU que cumplen la definición de terminado Cierre del sprint 0 PHU; resultado provisional
Burndown de producción PHU del proyecto menos PHU aceptados y liberados Cada cierre semanal y cierre de sprint 100 de 100 PHU restantes
Predictibilidad de entrega PHU liberados / PHU comprometidos Cierre del sprint N/D hasta el 18 de octubre
Throughput Número de HU aceptadas Cierre del sprint 0 HU
Tiempo de ciclo Días desde En curso hasta Aceptada Por HU aceptada N/D
Sprint burndown PHU pendientes dentro del sprint Diario 27 PHU pendientes
Release burndown PHU del proyecto pendientes de liberar Cierre de cada sprint 100 reales al corte; saldos esperados 73, 53 y 19 después de los sprints 1, 2 y 3
Valor desarrollado acumulado Suma de valor HU × avance verificable Cada cierre semanal 6,5 puntos; 20,3 % de los 32 planificados en Sprint 1
Valor entregado a producción Valor de HU aceptadas y liberadas Cierre del sprint 0 de 100 puntos
Cobertura backend Sentencias y ramas ejecutadas por pruebas Cada ejecución de CI 96 % combinado, incluidas ramas; PR #8, 328 pruebas
Cobertura frontend Sentencias y ramas ejecutadas por pruebas Cada ejecución de CI 98,07 % sentencias y 92,67 % ramas; PR #7, 167 pruebas

Velocity chart

La velocidad se calcula con PHU de historias terminadas conforme a la definición de terminado. Durante un sprint abierto es un resultado provisional. Para mostrar actividad semanal sin inflar esa velocidad se publica aparte el avance técnico equivalente.

PHU equivalentes desarrollados = suma(PHU de la HU × avance verificable de la HU)
Velocidad oficial del sprint = suma(PHU de las HU terminadas)
Velocidad liberada a producción = suma(PHU de las HU aceptadas y liberadas)

Cálculo de desarrollo de la semana 1

HU PHU Avance verificable PHU equivalentes desarrollados
HU001 5 80 % 4,0
HU003 2 50 % 1,0
Total 7 — 5,0

Los otros 20 PHU comprometidos en el Sprint 1 permanecen en backlog y aportan cero al indicador interno.

Desarrollo — trayectoria esperada y avance real

La línea esperada distribuye linealmente los 27 PHU comprometidos entre las dos semanas. Es una referencia de seguimiento interno; no reemplaza la velocidad Scrum, que solo contabiliza historias terminadas.

Corte Desarrollo esperado acumulado Desarrollo real acumulado Desviación real - esperado Estado
Inicio 0 PHU-eq 0 PHU-eq 0 En fecha
Fin de la semana 1 13,5 PHU-eq 5 PHU-eq -8,5 PHU-eq Atrasado
Fin de la semana 2 27 PHU-eq N/D N/D Corte futuro

Velocity de desarrollo del Sprint 1 con avance esperado y real

Figura. La curva azul representa el avance técnico esperado completo (0 → 13,5 → 27 PHU-eq). La curva roja representa el avance real disponible (0 → 5 PHU-eq) y termina en la semana 1 porque todavía no existe el segundo corte.

Producción — escalera esperada y avance real

La velocidad productiva se acumula únicamente al liberar la versión de cada sprint. El plan conserva dos cortes para Sprint 1, dos para Sprint 2 y tres para Sprint 3.

Corte Liberación esperada acumulada Liberación real acumulada Estado del dato real
Inicio 0 PHU 0 PHU Disponible
Sprint 1 · semana 1 0 PHU 0 PHU Disponible
Sprint 1 · semana 2 / v0.1.0 27 PHU N/D Corte futuro
Sprint 2 · semana 3 27 PHU N/D Corte futuro
Sprint 2 · semana 4 / v0.2.0 47 PHU N/D Corte futuro
Sprint 3 · semana 5 47 PHU N/D Corte futuro
Sprint 3 · semana 6 47 PHU N/D Corte futuro
Sprint 3 · semana 7 / v0.3.0 81 PHU N/D Corte futuro

Velocity de producción del proyecto con avance esperado y real

Figura. La curva azul representa la escalera esperada de PHU liberados (0 → 27 → 47 → 81). La curva roja discontinua muestra el avance productivo real disponible y termina en la semana 1 con 0 PHU liberados.

Al terminar la semana 1 se observan 5 PHU equivalentes de desarrollo, pero la velocidad oficial y la liberada permanecen en 0 PHU porque ninguna HU cumple todavía la definición de terminado ni se ha publicado v0.1.0. Producción está en fecha porque la primera liberación se espera al finalizar el Sprint 1. Los 19 PHU que quedan después del Sprint 3 todavía no tienen sprint asignado y no se muestran como entregados.

Carga planificada, no velocidad

xychart-beta
    title "PHU planificados por sprint"
    x-axis ["Sprint 1", "Sprint 2", "Sprint 3"]
    y-axis "PHU planificados" 0 --> 40
    bar [27, 20, 34]

Cada semana se agrega un corte al indicador interno de desarrollo. La velocidad oficial se consolida al cierre con elementos terminados; la curva productiva cambia cuando esos elementos son liberados.

Sprint burndown chart

El burndown de desarrollo usa el alcance vigente del Sprint 1: diez HU que suman 27 PHU. El sprint comprende dos semanas y diez jornadas hábiles. La trayectoria esperada completa es 27 → 13,5 → 0; la trayectoria real solo se extiende hasta la semana 1 porque la semana 2 todavía no ha ocurrido.

Corte Esperado restante Real restante Desviación real - esperado Estado
Inicio 27 27 0 En fecha
Fin de la semana 1 13,5 22 +8,5 Atrasado
Fin de la semana 2 0 N/D N/D Corte futuro

Desarrollo — trayectoria esperada y avance real

Burndown de desarrollo del Sprint 1 con avance esperado y real

Figura. La curva azul representa el avance esperado completo de las dos semanas (27 → 13,5 → 0). La curva roja representa el avance real disponible (27 → 22) y termina en el corte de la semana 1; no se prolonga hacia la semana 2 porque ese dato aún no existe.

Como la curva real conserva 8,5 PHU-eq más que la esperada al cierre de la semana 1, el desarrollo está atrasado. El avance real usa evidencia verificable como aproximación interna mientras no exista trabajo restante diario por tarea; no equivale a HU aceptadas.

Release burndown chart

El burndown de producción cubre todo el proyecto: 100 PHU. Entre cierres de sprint el saldo esperado permanece constante y solo disminuye cuando se libera la versión correspondiente; por eso la planeación se representa como una escalera.

Hito de producción PHU previstos en la entrega Saldo esperado Saldo real disponible
Inicio 0 100 100
Corte semana 1 0 100 100
Fin Sprint 1 · v0.1.0 27 73 N/D
Corte semana 3 · Sprint 2 0 73 N/D
Fin Sprint 2 · v0.2.0 20 53 N/D
Corte semana 5 · Sprint 3 0 53 N/D
Corte semana 6 · Sprint 3 0 53 N/D
Fin Sprint 3 · v0.3.0 34 19 N/D

Producción — escalera esperada y avance real

Burndown de producción del proyecto con escalera esperada y avance real

Figura. La curva azul representa la escalera esperada de producción durante siete semanas: dos cortes para Sprint 1, dos para Sprint 2 y tres para Sprint 3. La curva roja discontinua muestra el avance real disponible y termina en el corte de la semana 1.

Las curvas esperada y real coinciden en 100 PHU al corte; producción está en fecha porque la primera reducción está prevista al liberar v0.1.0 al final del Sprint 1. La escalera baja a 73, 53 y 19 PHU después de las versiones v0.1.0, v0.2.0 y v0.3.0. Los 19 PHU finales corresponden a HU todavía sin sprint y no se eliminan artificialmente.

Value chart

Los PHU expresan esfuerzo relativo; los puntos de valor expresan aporte al negocio. También se separan el valor desarrollado durante la semana y el valor entregado a producción con la versión del sprint.

Valor desarrollado acumulado = suma(valor de la HU × avance verificable de la HU)
Valor desarrollado semanal = valor desarrollado del corte - valor desarrollado del corte anterior
Valor entregado a producción = suma(valor de las HU aceptadas y liberadas)

Cálculo de valor de la semana 1

HU Valor Avance verificable Valor desarrollado
HU001 5 80 % 4,0
HU003 5 50 % 2,5
Total 10 — 6,5

Desarrollo — valor esperado y valor real construido

La referencia distribuye linealmente los 32 puntos de valor planificados entre las dos semanas. El valor proporcional permite observar construcción, pero no se considera todavía valor entregado al usuario.

Corte Valor esperado acumulado Valor real desarrollado Desviación real - esperado Estado
Inicio 0 0 0 En fecha
Fin de la semana 1 16 6,5 -9,5 Atrasado
Fin de la semana 2 32 N/D N/D Corte futuro

Value chart de desarrollo del Sprint 1 con valor esperado y real

Figura. La curva azul representa el valor desarrollado esperado (0 → 16 → 32). La curva roja representa el valor real equivalente disponible (0 → 6,5) y termina en la semana 1 porque todavía no existe el segundo corte.

Producción — valor esperado y valor real entregado

El perfil productivo cubre todo el proyecto. El valor solo se reconoce cuando las HU son aceptadas y se libera la versión de su sprint; por ello, la curva esperada permanece plana durante cada sprint y aumenta en su cierre.

Corte Valor esperado entregado Valor real entregado Estado
Inicio 0 0 En fecha
Sprint 1 · semana 1 0 0 En fecha
Sprint 1 · semana 2 / v0.1.0 32 N/D Corte futuro
Sprint 2 · semana 3 32 N/D Corte futuro
Sprint 2 · semana 4 / v0.2.0 61 N/D Corte futuro
Sprint 3 · semana 5 61 N/D Corte futuro
Sprint 3 · semana 6 61 N/D Corte futuro
Sprint 3 · semana 7 / v0.3.0 87 N/D Corte futuro

Value chart de producción del proyecto con valor esperado y real

Figura. La curva azul representa la escalera esperada del proyecto (0 → 32 → 61 → 87 puntos) durante siete semanas: dos cortes para Sprint 1, dos para Sprint 2 y tres para Sprint 3. La curva roja discontinua representa el valor realmente entregado y termina en la semana 1 con 0 puntos.

Al corte se observan 6,5 puntos equivalentes desarrollados, equivalentes al 20,3 % de los 32 puntos planificados para Sprint 1. El desarrollo está atrasado en 9,5 puntos frente a la referencia semanal; producción está en fecha, con 0 puntos esperados y 0 reales antes del primer cierre. Los 13 puntos de valor sin sprint no se presentan como entregados.

Valor planificado por sprint

xychart-beta
    title "Distribución planificada de los 100 puntos de valor"
    x-axis ["Sprint 1", "Sprint 2", "Sprint 3", "Sin asignar"]
    y-axis "Puntos de valor" 0 --> 35
    bar [32, 29, 26, 13]

Distribución por dominio

pie showData
    title Valor de negocio por dominio
    "Usuarios" : 22
    "Afiliación" : 7
    "Servicios" : 16
    "Entrenamientos" : 31
    "Eventos" : 21
    "Terceros" : 3

Eficiencia de desarrollo = valor desarrollado / PHU equivalentes desarrollados
Avance de valor del sprint = valor desarrollado / valor planificado del sprint
Avance productivo de la release = valor liberado acumulado / valor total de la release

El valor proporcional se usa exclusivamente para observar el desarrollo semanal; no equivale a valor de negocio realizado ni autoriza facturación, aceptación o release. HU003 reúne el inicio de sesión web y móvil como una sola historia de 5 puntos de valor; no se duplica por canal.

Code coverage chart

La cobertura no mide velocidad ni valor, pero sí aporta evidencia de calidad técnica. La ejecución backend del PR #8 reporta 96 % combinado sobre 3.005 sentencias y 290 ramas; la ejecución frontend del PR #7 reporta 98,07 % de sentencias y 92,67 % de ramas. El umbral mínimo vigente del backend es 80 %; el umbral web continúa pendiente de ratificación.

xychart-beta
    title "Cobertura CI vigente frente al umbral backend"
    x-axis ["Backend PR #8", "Frontend PR #7", "Umbral backend"]
    y-axis "Porcentaje" 0 --> 100
    bar [96, 98.07, 80]

El backend reporta cobertura combinada de sentencias y ramas; el frontend reporta por separado 98,07 % de sentencias y 92,67 % de ramas. El detalle de pruebas, ejecución y limitaciones se mantiene en Calidad, pruebas y cobertura.

Avance verificable del flujo

El campo Avance verificable (%) alimenta los equivalentes de desarrollo sin alterar las métricas de entrega a producción:

Estado Avance verificable
Backlog 0 %
Preparada 10 %
En curso 50 %
En revisión 80 %
Aceptada 100 %

Al corte, HU001 está En revisión con 80 % y HU003 está En curso con 50 %. Estos porcentajes se ponderan con sus PHU y valor para construir las curvas semanales, pero los resultados se rotulan siempre como equivalentes desarrollados, no como entrega productiva.

Métricas que no se usarán como velocidad

  • cantidad de commits;
  • líneas de código agregadas;
  • horas conectadas;
  • número de archivos modificados;
  • puntos terminados por persona;
  • porcentaje de avance verificable aislado, sin ponderación por PHU y sin comparar cortes;
  • cobertura aislada como sustituto de valor.

Estas cifras pueden ayudar a investigar un problema, pero no representan por sí mismas productividad ni valor entregado.

Regla de actualización

En cada corte semanal se actualizan PHU equivalentes, burndown de desarrollo y valor desarrollado. Al cierre de cada sprint se registran por separado velocidad oficial, PHU y valor aceptados/liberados, predictibilidad y throughput. Las proyecciones permanecen separadas y rotuladas para que nunca se confundan con resultados obtenidos.

Referencias metodológicas