[levi06516-ui]

📌 Resumen Ejecutivo

Este Pull Request incorpora la documentación necesaria para realizar la defensa del segundo parcial del Sistema de Gestión y Venta de Pasajes Interprovinciales — Cooperativa Ambato Express.

Se incluyen una presentación ejecutiva y un guion de exposición distribuido entre los seis integrantes del equipo, con una duración planificada de 28 minutos.

El material organiza la explicación de la arquitectura, las reglas de negocio, la gestión de configuración y la demostración funcional del sistema, incluyendo un plan de contingencia ante fallos técnicos.

---

🎯 Objetivo del cambio

• Preparar la presentación ejecutiva correspondiente a la Issue [18/18][Jeremy] D3 – Diapositivas y defensa #38.

• Establecer un guion minuto a minuto con responsables y tiempos de intervención.

• Documentar el recorrido de demostración desde la búsqueda de pasajes hasta la validación del boleto mediante QR.

• Incorporar alternativas de respaldo para la exposición.

• Facilitar la coordinación y evaluación de la defensa académica.

---

🧩 Contexto / Problema detectado

• Reporte de usuario

• Issue interno

• Mejora técnica

• Vulnerabilidad detectada

• Optimización

• Solicitud académica / cliente

• Otro

Detalle

La Issue #38 — [18/18][Jeremy] D3: Diapositivas y defensa establece la necesidad de preparar los materiales para la exposición final del segundo parcial.

El equipo requiere una presentación estructurada que permita explicar los componentes desarrollados y realizar una demostración coordinada sin exceder el tiempo establecido.

La actividad depende de la integración del escáner del chofer y del historial de boletos en PDF.

Dependencias técnicas integradas a develop:

• PR feat(escaneo): M2 – Módulo de escáner del chofer y verificación HMAC #54: escáner del chofer y verificación HMAC.

• PR feat: M3 – Historial de pasajeros y descarga PDF #58: historial de pasajeros y descarga PDF.

---

🔧 Tipo de cambio

• 🐞 bug

• ✨ feat — incorporación de un nuevo entregable documental

• ♻️ refactor

• 🔒 sec

Nota: El cambio es exclusivamente documental; no modifica funcionalidades del sistema.

---

🛠 Cambios realizados

• Cambio 1: Creación de docs/defensa/presentacion.md con la estructura de la presentación.

• Cambio 2: Creación de docs/defensa/guion.md con los tiempos y responsables de exposición.

• Cambio 3: Organización de las intervenciones de los seis integrantes.

• Cambio 4: Documentación del flujo previsto para la demostración funcional.

• Cambio 5: Incorporación de un plan de contingencia ante fallos de internet o de la aplicación.

Estructura de archivos

docs/
└── defensa/
    ├── presentacion.md
    └── guion.md

Distribución de tiempos

Responsable | Actividad | Duración -- | -- | -- Jeremy | Portada y agenda | 1 min Juan | Contexto, arquitectura, Gitflow y CCB | 9 min Celeste | Búsqueda, filtros y asientos | 3 min Andrés | Paradas y descuentos ANT | 3 min Anahí | Checkout, comprobante y panel oficinista | 4 min Mateo | QR, escáner e historial PDF | 4 min Jeremy | Evidencias de Gitflow y CCB | 2 min Todos | Conclusiones y preguntas | 2 min Total |   | 28 min

---

👀 Checklist del autor

Código

• Sigue la convención documental de la Issue [18/18][Jeremy] D3 – Diapositivas y defensa #38

• Documentación organizada y mantenible

• Sin código muerto — No aplica

• Sin console.log / debug — No aplica

• Sin conflictos de merge — pendiente de verificación del PR

Calidad

• Probado localmente

• Revisado manualmente

• Sin errores visibles

• Casos edge considerados

Seguridad

• Inputs validados — No aplica

• Sin exposición de secretos — pendiente de revisión

• Permisos revisados — No aplica al cambio documental

• Dependencias seguras — No se incorporan dependencias

Base de datos

• Queries optimizadas — No aplica

• Índices revisados — No aplica

• Migraciones verificadas — No aplica

• No se realizan cambios en datos ni esquemas

Documentación

• README actualizado — No requerido por esta Issue

• Comentarios agregados si aplica — No requerido

• Documentación de defensa incorporada

• Presentación y guion organizados en docs/defensa/

---

🧠 Notas para reviewers

Revisar especialmente

1. Que presentacion.md y guion.md cumplan la estructura de la Issue [18/18][Jeremy] D3 – Diapositivas y defensa #38.

2. Que los tiempos asignados sumen exactamente 28 minutos.

3. Que participen los seis integrantes.

4. Que la demostración incluya búsqueda, asiento, pago, aprobación, QR y escaneo.

5. Que las explicaciones técnicas coincidan con el código fusionado a develop.

6. Que el plan B sea ejecutable y esté respaldado por evidencias.

Preguntas abiertas

• ¿La demostración puede completarse dentro de los tiempos asignados?

• ¿Se ha verificado el funcionamiento del flujo completo en el entorno final?

• ¿El equipo dispone de un video de respaldo?

• ¿Se han registrado las observaciones del ensayo?

---

✅ Resultado esperado tras merge

Una vez aprobado y fusionado este Pull Request en develop, el repositorio contará con:

• Presentación ejecutiva versionada.

• Guion de exposición para los seis integrantes.

• Distribución de tiempos de 28 minutos.

• Recorrido documentado de la demostración.

• Plan de contingencia.

• Trazabilidad documental de la Issue [18/18][Jeremy] D3 – Diapositivas y defensa #38.

El cierre de la Issue debe realizarse después de verificar también los criterios pendientes de ensayo y evidencias.

---

🏁 Aprobación sugerida

• Ready for Review

• Draft PR

• Requires Changes

Aprobaciones requeridas: mínimo 2 revisores.

Rama origen: feature/docs-defensa-diapositivas

Rama destino: develop

Issue: Closes #38

[SebastianM-M]

🟢 Revisión aprobada – Defensa del Segundo Parcial (Issue #38)

¡Excelente trabajo con la estructuración de la documentación para la defensa, Jeremy! He revisado a detalle los archivos incorporados en este Pull Request y considero que cumple con creces todos los estándares requeridos.

---

📋 Puntos validados con éxito:

• Cronograma y Tiempos: La distribución de los bloques de tiempo está calculada de manera precisa para sumar exactamente los 28 minutos planificados, garantizando una exposición fluida y equitativa para los seis integrantes.
• Trazabilidad Técnica: Los apartados técnicos y de demostración guardan total coherencia con el código desarrollado, incorporando de forma integrada los flujos recientes (generación de QR con HMAC, módulo de escaneo del chofer y el historial con exportación a PDF en el módulo de pasajero).
• Plan de Contingencia: Se establecen de manera adecuada los escenarios de respaldo ante posibles fallas técnicas durante la sustentación en vivo.
• Estructura Documental: Los archivos presentacion.md y guion.md se ubican en la ruta correcta (docs/defensa/) junto con sus respectivas evidencias gráficas.

---

🏁 Conclusión:

El entregable cumple con la definición de terminado de la Issue #38. Queda listo para su fusión en la rama develop. ¡Gran trabajo en equipo!

[juanjose1234456787654]

Revisión técnica y formal aprobada. El guion de 28 minutos y la presentación cumplen rigurosamente con la estructura de defensa para el segundo parcial (Issue #38). Excelente trabajo en equipo, listo para merge en develop.