Saltar a contenido

LP2 - Producto de Unidad 3

Este documento es el ejemplo BomERP del docente, no una plantilla obligatoria. Cada sede (Lima, Juliaca, Tarapoto) y cada grupo dentro de una misma sede estabiliza y sustenta su propia base full-stack sobre su propio dominio. Los módulos y casos de prueba concretos de este documento (catalogo/ventas) son los del ejemplo BomERP; cada equipo los reemplaza por los suyos. Lo exigible a todos es la estructura: backend y frontend modular funcionando integrado, seguridad, optimización, caché, observabilidad, paginación, auditoría, pruebas y estabilización.

Producto

Base Full-Stack modular de BomERP —una SPA, una aplicación Spring Boot única (módulos verificados con Spring Modulith) y una base Oracle organizada por esquemas funcionales— integrada, optimizada, monitoreada y estabilizada.

Componentes finales

Componente Evidencia esperada
Backend REST modular Un bomerp-backend ejecutable; Catálogo y Ventas funcionales; Inventario, Compras y Seguridad como paquetes agregados solo cuando su sesión les dio contenido; conexión a Oracle, DTO, validaciones y consultas.
Frontend SPA modular Una SPA con core, shared y funcionalidades; navegación, CRUD, ventas, consultas, reportes, guards e interceptores.
Integración Flujo SPA → aplicación Spring Boot → módulos → esquemas Oracle completo y verificable.
Seguridad Keycloak (no JWT propio, reemplazado desde S10b): Authorization Code + PKCE, roles reales (realm_access.roles), rutas protegidas, manejo de 401/403 con refresco automático.
Límites modulares Dependencias unidireccionales, repositorios privados y comunicación interna mediante servicios Java, sin Feign.
Optimización frontend Lazy Loading, Code Splitting y evidencia del build optimizado.
Caché Política de navegador y uso justificado de Redis o justificación de no uso.
Observabilidad Logs estructurados, endpoint de salud y monitoreo básico.
Paginación Listado de alto volumen con metadatos, filtros y ordenamiento conservados.
Auditoría Usuario, fecha, acción, entidad afectada y cambio relevante.
Pruebas Casos funcionales, seguridad, integración, end-to-end y regresión.
Estabilización Bitácora de incidencias, prioridad, corrección y prueba de no regresión.
Despliegue o ejecución Configuración por ambientes y guía reproducible para levantar o revisar el sistema.

Plan de pruebas final

Tipo Caso Resultado esperado
Funcional Registrar operación principal. Se persiste y se visualiza correctamente.
Seguridad Acceder sin token a ruta protegida. Acceso bloqueado.
Integración Ejecutar flujo SPA -> API -> Oracle. Respuesta coherente y datos actualizados.
Validación Enviar datos inválidos. Error controlado y mensaje claro.
Paginación Consultar un listado de alto volumen y cambiar de página. Mantiene filtros, ordenamiento y metadatos consistentes.
Auditoría Ejecutar una operación crítica. Registra actor, fecha, acción y cambio.
Observabilidad Provocar una operación correcta y un error controlado. Logs correlacionables y estado de salud visible.
End-to-end Ejecutar autenticación, transacción y consulta desde la SPA. El flujo completo finaliza sin rupturas.
Recuperación Revisar sistema después de restore de BD. Datos y flujo principal disponibles.
Arquitectura modular Revisar dependencias entre módulos. Existe un ejecutable, no hay acceso a repositorios ajenos y los módulos se relacionan mediante servicios públicos.

Bitácora de estabilización

Hallazgo real de S14, verificado contra el código: VentaReporteComponent (frontend) nunca llamaba a GET /api/v1/ventas/resumen (el agregado real, con SUM/COUNT en Oracle, existente desde S9) — recalculaba totalVentas/montoTotal/ticketPromedio en el navegador, con .reduce(), sobre la lista completa sin paginar. Corregido en S14: el listado se paginó (Page<VentaResponse>) y la SPA se reconectó al agregado real del servidor.

Hallazgo Corrección Evidencia
VentaReporteComponent recalculaba sus totales en el navegador en vez de usar el agregado real de /resumen (S9, nunca conectado) Listado paginado (Page<VentaResponse>) + SPA reconectada al agregado real del servidor (S14) VentaEndToEndTest en verde; verificación manual de montoTotal contra una suma real de las filas.
Error de validación incompleta Se agregó validación frontend/backend. Caso de prueba actualizado.
Consulta lenta Se revisó plan e índice con BD2. Evidencia de optimización.
Ruta sin protección Se agregó guard/interceptor. Prueba de acceso 401/403.
Falta de trazabilidad Se vinculó endpoint con diseño y tabla. Matriz final actualizada.
Listado inestable con volumen Se incorporó paginación conservando filtros. Prueba de alto volumen.
Error recurrente del flujo Se corrigió y añadió prueba de regresión. E2E ejecutada satisfactoriamente.

Rúbrica de Evaluación

Tabla 1. Rúbrica de evaluación de la Unidad 3

A diferencia de las demás unidades (5 criterios técnicos + Sustentación como criterio transversal), el sílabo de LP2 lista exactamente 4 criterios para esta unidad, y la sustentación es, literalmente, uno de ellos (criterio 4) — no un criterio "Agregado manual" aparte. Los 4 son cita literal.

Criterio Peso CE / Nivel A (20 pts) B (15 pts) C (10 pts) D (5 pts) Calificación obtenida
1. Aplica Lazy Loading, Code Splitting, caché del navegador y Redis cuando corresponda, logging, monitoreo básico y buenas prácticas de despliegue 25% CE023-N2 (cierre) Build optimizado medido (antes/después), decisión de caché/Redis justificada con criterio medido, logging y monitoreo básico verificados en vivo. Optimización presente, con la decisión de Redis o el monitoreo incompleto. Solo una de las piezas (optimización, caché o monitoreo) presente. No presenta evidencia de optimización ni monitoreo.
2. Implementa paginación en listados de alto volumen e integra funcionalmente los módulos de la aplicación 25% CE023-N2 (cierre) Listado paginado con agregado correcto verificado, e integración funcional completa (checklist end-to-end) entre todos los módulos. Uno de los dos presente y verificado; el otro parcial. Paginación o integración mencionada sin verificación real. No presenta paginación ni integración funcional verificable.
3. Incorpora auditoría y ejecuta pruebas end-to-end, corrige errores y estabiliza el sistema 25% CE023-N2 (cierre) Auditoría real sobre al menos 2 acciones, prueba end-to-end en verde contra la base real, y al menos un hallazgo real en la bitácora con su corrección. Dos de los tres elementos presentes y verificados. Solo uno de los tres elementos presente. No presenta auditoría, pruebas end-to-end ni bitácora.
4. Sustenta exclusivamente el Proyecto Integrador mediante una demostración funcional y defensa técnica 25% CG Sustenta con claridad y profesionalismo su aporte individual, con demostración funcional en vivo y defensa técnica precisa. Sustenta con solvencia, con detalles menores en la demostración o la defensa. Sustenta con dificultad; demostración o defensa insuficientes. No sustenta adecuadamente ni demuestra su aporte individual.

Nota final = suma de (Peso / 100 × Puntos de la calificación obtenida) = ____ / 20.

CE023-N2 (cierre) = cierre del Nivel 2 de CE023 (Programación): la Unidad 2 ya dejó ese nivel "parcial" (SPA, CRUD, seguridad); esta unidad lo completa con optimización, integración funcional, auditoría y pruebas end-to-end sobre el mismo backend y la misma SPA. CG = Competencia General del sílabo de LP2 — el criterio 4 es, en este sílabo, la propia sustentación, a diferencia de otras unidades donde es un criterio transversal aparte.

Tabla 2. Subaspectos de la sustentación (Unidad 3)

El criterio 4 se evalúa con los mismos 6 subaspectos de la sustentación integral del Proyecto Integrador (Guía de Sustentación Final) — la misma exigencia de Unidad 1 y Unidad 2, ahora en la sustentación final del curso.

Subaspecto Qué observa en Unidad 3
1. Aporte individual Cada integrante demuestra el hallazgo real que diagnosticó y corrigió (paginación, auditoría o prueba end-to-end).
2. Comunicación y orden Claridad, estructura, tiempo y lenguaje técnico durante la presentación.
3. Presentación personal y actitud Puntualidad, vestimenta limpia y adecuada, higiene, cabello ordenado, actitud profesional, respeto, honestidad y coherencia con los valores y principios cristianos de la institución.
4. Repositorio y estándares Organización, commits y reproducibilidad del código desde S13.
5. MkDocs o equivalente Documentación de Unidad 3 publicada, navegable y alineada con lp2-producto.md.
6. Pitch/demo ejecutiva La aplicación Full-Stack completa, optimizada y estabilizada, con apoyo visual (.pptx, Canva o equivalente) — no reemplaza la demo técnica de S15, la precede.

Para usar la rúbrica con IA, solicita:

Evalúa la sustentación y el producto (lp2-producto.md o la sección 2 de la guía S15) usando la rúbrica de esta sección.
Para cada criterio selecciona la calificación obtenida: A=20, B=15, C=10, D=5.
Justifica brevemente cada nivel con evidencia concreta (optimización medida, paginación con agregado correcto, auditoría, pruebas end-to-end, demostración y defensa técnica).
Calcula la nota final con la fórmula: suma de (Peso / 100 × Puntos de la calificación obtenida), directamente sobre 20.
Indica 2 fortalezas y 2 recomendaciones.

Trazabilidad y procedencia de la rúbrica

Los cuatro criterios son cita literal de los "Criterios de evaluación del producto" de la Unidad 3 en el sílabo de LP2 — incluida la sustentación (criterio 4), que este sílabo integra como criterio propio en vez de agregarla aparte como las demás unidades.

Cierre LP2

LP2 está completo cuando la base de BomERP continúa el dominio de Ciclo 3, mantiene una sola aplicación Spring Boot y una SPA con módulos cohesionados, ejecuta Venta–DetalleVenta de extremo a extremo, aplica seguridad, optimización, caché y observabilidad básica, pagina listados de alto volumen, audita operaciones, supera pruebas end-to-end, queda estabilizada y puede ser sustentada por cada integrante. Compras queda como módulo delimitado o ampliación del equipo, no como segundo flujo obligatorio. La preparación para producción tiene alcance académico y debe demostrarse con evidencias reproducibles.