Reporte de HUs implementadas S3 - JohannPaezU/MISW4501-MediSupply GitHub Wiki

Reporte de Historias de Usuario Implementadas — Sprints 1, 2 y 3

Este documento presenta el reporte de las Historias de Usuario (HUs) implementadas durante los Sprints 1, 2 y 3 del proyecto MediSupply, incluyendo el detalle de tareas completadas, responsables y tiempos de ejecución.

📑 Tabla de contenidos

📊 Resumen General

Sprint Duración HUs Planificadas HUs Completadas Puntos Estado
Sprint 1 2 semanas 4 4 (100%) 18 ✅ Completado
Sprint 2 2 semanas 5 5 (100%) 21 ✅ Completado
Sprint 3 3 semanas 5 5 (100%) 19 ✅ Completado
Total 7 semanas 14 14 (100%) 58 ✅ Completado

🚀 Sprint 1

📊 Resumen del Sprint 1

Aspecto Detalle
Sprint Sprint 1
Duración 2 semanas
Estado ✅ Completado
HUs Planificadas 4
HUs Completadas 4 (100%)
Puntos de Historia Totales 18 puntos

✅ Historias de Usuario Implementadas — Sprint 1

📌 HU02 – Registro de proveedores y carga de productos (individual y masivo)

Campo Detalle
ID Jira SCRUM-71
Descripción Como administrador, quiero poder registrar proveedores y cargar productos de forma individual o masiva (CSV/Excel), con fichas técnicas, certificados sanitarios y condiciones de almacenamiento, para garantizar que el catálogo esté actualizado y cumpla normativas regulatorias.
Estimación 5 puntos
Responsable Juan Cervantes
Estado ✅ Completada

Tareas completadas:

  • Diseño del modelo de datos para proveedores y productos
  • Implementación de API para registro de proveedores
  • Desarrollo de carga individual de productos
  • Implementación de carga masiva (CSV/Excel)
  • Validación de fichas técnicas y certificados sanitarios
  • Pruebas unitarias e integración

📌 HU03 – Registro de vendedores y creación de planes de venta

Campo Detalle
ID Jira SCRUM-72
Descripción Como gerente comercial, quiero poder registrar vendedores y asignarles planes de venta por producto, región y periodo, para monitorear el cumplimiento de metas y optimizar la estrategia comercial.
Estimación 5 puntos
Responsable Johann Páez
Estado ✅ Completada

Tareas completadas:

  • Diseño de modelo de datos para vendedores y planes de venta
  • Implementación de API para registro de vendedores
  • Desarrollo de módulo de asignación de planes de venta
  • Configuración de metas por producto, región y periodo
  • Interfaz web para gestión de vendedores
  • Pruebas unitarias e integración

📌 HU05 – Consulta y localización de productos en bodegas

Campo Detalle
ID Jira SCRUM-74
Descripción Como operador logístico, quiero poder consultar y localizar productos en bodegas en menos de 1 segundo, con detalle de lote, fecha de vencimiento, condiciones y ubicación física, para agilizar la preparación de pedidos y reducir errores.
Estimación 3 puntos
Responsable Julián Oliveros
Estado ✅ Completada

Tareas completadas:

  • Diseño de estructura de datos para inventario en bodegas
  • Implementación de búsqueda optimizada (< 1 segundo)
  • Desarrollo de consulta por lote y fecha de vencimiento
  • Integración de condiciones de almacenamiento
  • Visualización de ubicación física en bodega
  • Pruebas unitarias e integración

📌 HU11 – Registro de cliente

Campo Detalle
ID Jira SCRUM-45
Descripción Como cliente institucional, quiero registrarme en la aplicación móvil de MediSupply, para poder acceder al catálogo de productos, crear pedidos y dar seguimiento a mis entregas de forma autónoma.
Estimación 5 puntos
Responsable Miguel Padilla
Estado ✅ Completada

Tareas completadas:

  • Diseño de interfaz móvil para registro de clientes
  • Implementación de formulario de registro con validaciones
  • Desarrollo de API de autenticación
  • Integración con sistema de verificación de clientes institucionales
  • Configuración de notificaciones de bienvenida
  • Pruebas unitarias e integración

📦 Entregables Completados — Sprint 1

Entregable Descripción Responsable Estado
API Backend Base Servicios de autenticación, gestión de usuarios y productos Juan Cervantes ✅ Completado
Frontend Admin Módulos de registro de proveedores/vendedores Johann Páez ✅ Completado
App Móvil Base Registro de clientes y autenticación Miguel Padilla ✅ Completado
Base de Datos Esquema inicial con productos, usuarios y proveedores Julián Oliveros ✅ Completado
CI/CD Pipeline GitHub Actions configurado con pruebas automatizadas Juan Cervantes ✅ Completado

🚀 Sprint 2

📊 Resumen del Sprint 2

Aspecto Detalle
Sprint Sprint 2
Duración 2 semanas
Estado ✅ Completado
HUs Planificadas 5
HUs Completadas 5 (100%)
Puntos de Historia Totales 21 puntos

✅ Historias de Usuario Implementadas — Sprint 2

📌 HU04 – Consulta de reportes e informes de los vendedores

Campo Detalle
ID Jira SCRUM-73
Descripción Como director comercial, quiero poder consultar reportes e informes por vendedor y zona geográfica, para evaluar desempeño, comparar resultados y tomar decisiones basadas en datos.
Estimación 3 puntos
Responsable Julián Oliveros
Estado ✅ Completada

Tareas completadas:

  • Diseño de estructura de reportes
  • Implementación de endpoints de consulta de reportes
  • Desarrollo de filtros por vendedor y zona
  • Generación de informes en múltiples formatos
  • Pruebas unitarias e integración

📌 HU06 – Consulta de clientes por parte de los vendedores

Campo Detalle
ID Jira SCRUM-51
Descripción Como usuario comercial, quiero consultar mi lista de clientes asignados con su información de contacto y ubicación para preparar mis visitas y priorizarlas según la importancia del cliente.
Estimación 3 puntos
Responsable Johann Páez
Estado ✅ Completada

Tareas completadas:

  • Diseño de interfaz de lista de clientes
  • Implementación de API de consulta de clientes asignados
  • Desarrollo de vista de detalle de cliente
  • Integración con sistema de geolocalización
  • Implementación de priorización de clientes
  • Pruebas unitarias e integración

📌 HU07 – Consulta de ruta de visita por fecha

Campo Detalle
ID Jira SCRUM-52
Descripción Como usuario comercial, quiero consultar mi ruta de visitas de una fecha específica con tiempos estimados de desplazamiento, para organizar mi jornada y optimizar el itinerario.
Estimación 3 puntos
Responsable Juan Cervantes
Estado ✅ Completada

Tareas completadas:

  • Diseño de interfaz de calendario de rutas
  • Implementación de API de consulta de rutas por fecha
  • Cálculo de tiempos estimados de desplazamiento
  • Visualización de ruta en mapa
  • Optimización de itinerario
  • Pruebas unitarias e integración

📌 HU08 – Registro de la visita de un cliente

Campo Detalle
ID Jira SCRUM-53
Descripción Como usuario comercial, quiero registrar la visita realizada a un cliente incluyendo observaciones, fecha y evidencia, para llevar un historial confiable de mis interacciones.
Estimación 5 puntos
Responsable Miguel Padilla
Estado ✅ Completada

Tareas completadas:

  • Diseño de formulario de registro de visita
  • Implementación de captura de observaciones
  • Desarrollo de carga de evidencias (fotos/documentos)
  • Registro automático de fecha y geolocalización
  • Historial de visitas por cliente
  • Pruebas unitarias e integración

📌 HU09 – Creación de un pedido en línea con consulta de inventario en tiempo real

Campo Detalle
ID Jira SCRUM-54
Descripción Como usuario comercial, quiero crear pedidos desde la aplicación móvil validando la disponibilidad de inventario en tiempo real, para garantizar compromisos confiables de entrega al cliente.
Estimación 5 puntos
Responsable Miguel Padilla
Estado ✅ Completada

Tareas completadas:

  • Diseño de flujo de creación de pedidos
  • Implementación de consulta de inventario en tiempo real
  • Desarrollo de carrito de compras
  • Validación de disponibilidad antes de confirmar
  • Generación de compromiso de entrega
  • Pruebas unitarias e integración

📌 HU10 – Procesamiento de video y generación de recomendación

Campo Detalle
ID Jira SCRUM-55
Descripción Como usuario comercial, quiero adjuntar un video corto al registrar una visita, para que el sistema lo procese y me genere recomendaciones sobre productos o necesidades del cliente.
Estimación 5 puntos
Responsable Johann Páez
Estado ✅ Completada

Tareas completadas:

  • Diseño de módulo de captura de video
  • Implementación de carga y almacenamiento de videos
  • Desarrollo de procesamiento de video con IA
  • Generación de recomendaciones automáticas
  • Integración con registro de visitas
  • Pruebas unitarias e integración

📦 Entregables Completados — Sprint 2

Entregable Descripción Responsable Estado
Módulo Comercial Gestión de clientes, visitas y rutas Julián Oliveros ✅ Completado
Sistema de Pedidos Creación y validación de pedidos con inventario Miguel Padilla ✅ Completado
Motor de Rutas Algoritmo de optimización de rutas de entrega Juan Cervantes ✅ Completado
App Móvil Comercial Funcionalidades completas para vendedores Johann Páez ✅ Completado

🚀 Sprint 3

📊 Resumen del Sprint 3

Aspecto Detalle
Sprint Sprint 3
Duración 3 semanas
Estado ✅ Completado
HUs Planificadas 5
HUs Completadas 5 (100%)
Puntos de Historia Totales 19 puntos

✅ Historias de Usuario Implementadas — Sprint 3

📌 HU01 – Generación de rutas de entrega

Campo Detalle
ID Jira SCRUM-75
Descripción Como planificador logístico, quiero poder generar rutas de entrega óptimas en menos de 3 segundos y visualizar en tiempo real la ubicación de los camiones, para garantizar entregas en los tiempos comprometidos y reducir costos logísticos.
Estimación 5 puntos
Responsable Julián Oliveros
Estado ✅ Completada

Tareas completadas:

  • Diseño del algoritmo de optimización de rutas
  • Implementación del motor de cálculo de rutas (< 3 seg)
  • Integración con servicios de geolocalización
  • Desarrollo de visualización en tiempo real de camiones
  • Pruebas de rendimiento y optimización
  • Pruebas unitarias e integración

📌 HU04 – Consulta de reportes e informes de los vendedores

Campo Detalle
ID Jira SCRUM-73
Descripción Como director comercial, quiero poder consultar reportes e informes por vendedor y zona geográfica, para evaluar desempeño, comparar resultados y tomar decisiones basadas en datos.
Estimación 3 puntos
Responsable Juan Cervantes
Estado ✅ Completada

Tareas completadas:

  • Diseño de dashboard analítico
  • Implementación de endpoints de reportes
  • Desarrollo de filtros por vendedor y zona geográfica
  • Creación de gráficos y visualizaciones
  • Exportación de reportes
  • Pruebas unitarias e integración

📌 HU12 – Creación de pedido por cliente

Campo Detalle
ID Jira SCRUM-46
Descripción Como cliente institucional, quiero poder crear un pedido desde la aplicación móvil, para adquirir insumos médicos de manera ágil y segura sin depender de un asesor comercial.
Estimación 5 puntos
Responsable Miguel Padilla
Estado ✅ Completada

Tareas completadas:

  • Diseño de interfaz móvil para creación de pedidos
  • Implementación del flujo de carrito de compras
  • Validación de inventario en tiempo real
  • Integración con sistema de pagos
  • Confirmación y notificaciones de pedido
  • Pruebas unitarias e integración

📌 HU13 – Consulta estado de pedidos

Campo Detalle
ID Jira SCRUM-47
Descripción Como cliente institucional, quiero consultar en la aplicación móvil el estado actual de mis pedidos, para conocer su progreso y anticipar acciones logísticas en mi institución.
Estimación 3 puntos
Responsable Miguel Padilla
Estado ✅ Completada

Tareas completadas:

  • Diseño de pantalla de seguimiento de pedidos
  • Implementación de estados del pedido (timeline)
  • Notificaciones push de cambios de estado
  • Integración con backend de logística
  • Pruebas unitarias e integración

📌 HU14 – Consulta entregas programadas

Campo Detalle
ID Jira SCRUM-48
Descripción Como cliente institucional, quiero consultar las entregas programadas en la aplicación móvil, para organizar la recepción de insumos y coordinar recursos internos de mi institución.
Estimación 3 puntos
Responsable Miguel Padilla
Estado ✅ Completada

Tareas completadas:

  • Diseño de calendario de entregas
  • Implementación de vista de entregas programadas
  • Filtros por fecha y estado de entrega
  • Detalle de cada entrega con información del transportista
  • Pruebas unitarias e integración

📦 Entregables Completados

Entregable Descripción Responsable Estado
Módulo Cliente Final App móvil completa para clientes institucionales Miguel Padilla ✅ Completado
Sistema de Reportes Dashboard analítico y reportes comerciales Juan Cervantes ✅ Completado
Optimización Rutas Generación automática de rutas < 3 seg Julián Oliveros ✅ Completado
Monitoreo y Logs Sistema de observabilidad en producción Johann Páez ✅ Completado
Documentación Documentación técnica y de usuario Todo el equipo ✅ Completado

📈 Métricas del Sprint 3

Velocidad del equipo

Métrica Valor
Puntos planificados 19
Puntos completados 19
Velocidad 100%

Distribución de puntos por responsable — Sprint 3

Responsable Puntos HUs
Miguel Padilla 11 HU12, HU13, HU14
Julián Oliveros 5 HU01
Juan Cervantes 3 HU04

📈 Métricas Consolidadas

Resumen por Sprint

Sprint Puntos Planificados Puntos Completados Velocidad
Sprint 1 18 18 100%
Sprint 2 21 21 100%
Sprint 3 19 19 100%
Total 58 58 100%

Distribución de puntos por responsable — Total

Responsable Sprint 1 Sprint 2 Sprint 3 Total
Miguel Padilla 5 10 11 26
Johann Páez 5 8 0 13
Juan Cervantes 5 3 3 11
Julián Oliveros 3 3 5 11
Total 18 21 19 58

Historias de Usuario por Sprint

Sprint HUs Implementadas
Sprint 1 HU02, HU03, HU05, HU11
Sprint 2 HU04, HU06, HU07, HU08, HU09, HU10
Sprint 3 HU01, HU04, HU12, HU13, HU14

Cumplimiento de criterios de calidad

Criterio Meta Sprint 1 Sprint 2 Sprint 3
Cobertura de pruebas backend ≥ 70% ✅ ✅ ✅
Cobertura de pruebas frontend ≥ 70% ✅ ✅ ✅
Tiempo de respuesta consultas < 3 seg ✅ ✅ ✅
Vulnerabilidades críticas 0 ✅ ✅ ✅

🎯 Conclusiones

Los tres sprints se completaron exitosamente con el 100% de las Historias de Usuario implementadas dentro de los tiempos establecidos.

Resumen Final

Métrica Valor
Total HUs implementadas 14
Total puntos completados 58
Velocidad promedio 100%
Sprints completados a tiempo 3/3