LP2 - Producto de Unidad 1¶
Esta es la plantilla-ejemplo del producto de Unidad 1 de LP2. La estructura (alcance arquitectónico, contrato REST, DTO principales, arquitectura backend, casos de prueba y trazabilidad con ADS/BD2) es exigible a todos: monolito modular verificado, un módulo transaccional con cabecera-detalle real, persistencia, consultas, CORS, logs y pruebas. El contenido de BomERP (catalogo/ventas, sus endpoints y DTO concretos) es el ejemplo real que muestra cómo se ve terminada — cada sede (Lima, Juliaca, Tarapoto) y cada grupo reemplaza ese contenido por sus propios módulos transaccional y no transaccional, definidos en su propio brief.md de S2, sin cambiar la estructura.
Producto¶
Backend REST modular ensamblado como una sola aplicación Spring Boot, conectado a Oracle, con persistencia ORM, CRUD, una operación cabecera–detalle, consultas, CORS, logs y pruebas.
La demo representa una consola académica de API REST y muestra el flujo obligatorio Categoria–Producto–Venta–DetalleVenta, heredado del sistema MVC de Ciclo 3. El backend real se organiza como monolito modular: catalogo y ventas quedan funcionales en U1; inventario, compras y seguridad conservan límites preparados para su evolución. Para publicarse en MkDocs sin servidor, la demo simula servicios, repositorios y persistencia en el navegador; no reemplaza la aplicación Spring Boot conectada a Oracle. La autenticación JWT no forma parte de U1 y se incorpora en S10.
1. Alcance arquitectónico del corte¶
backend/ # un solo proyecto Maven, sin reactor multi-módulo
└── src/main/java/pe/edu/upeu/bomerp/
├── BomErpApplication.java # único Spring Boot ejecutable
├── catalogo/ # funcional en U1
├── ventas/ # funcional en U1
├── inventario/ # aún no existe, se agrega cuando su sesión le dé contenido
├── compras/ # aún no existe, se agrega cuando su sesión le dé contenido
└── seguridad/ # se implementa en U2
Cada paquete directo bajo pe.edu.upeu.bomerp es un módulo de aplicación con sus límites verificados automáticamente por Spring Modulith, no un artefacto Maven separado.
Compras no es un segundo flujo obligatorio de U1. Su límite se documenta para evitar que el código de compras termine mezclado con ventas, pero la evaluación mantiene una sola operación cabecera–detalle implementada con profundidad.
2. Demo ejecutable¶
3. Contrato REST de referencia¶
Tabla 1. Contrato REST de referencia
| Método | Endpoint | Propósito | Sesión relacionada |
|---|---|---|---|
GET |
/api/v1/categorias |
Listar categorías. | S1-S3 |
GET |
/api/v1/productos |
Listar productos con categoría. | S1-S3 |
POST |
/api/v1/productos |
Registrar un producto. | S2 |
POST |
/api/v1/ventas |
Registrar cabecera y colección de detalles. | S4 |
GET |
/api/v1/ventas |
Consultar ventas mediante filtros y ordenamiento. | S5 |
GET |
/api/v1/ventas/resumen |
Devolver agregaciones y respuestas resumidas. | S5 |
4. DTO principales¶
{
"detalles": [
{ "productoId": 1, "cantidad": 2 },
{ "productoId": 2, "cantidad": 3 }
]
}
{
"id": 1001,
"fecha": "2026-09-01T10:15:00",
"estado": "REGISTRADA",
"total": 145.50,
"detalles": [
{ "productoId": 1, "nombreProducto": "Producto de prueba", "precioUnitario": 50.00, "cantidad": 2, "subtotal": 100.00 }
]
}
5. Arquitectura backend U1¶
Figura 1. Arquitectura backend U1
flowchart LR
APP[BomErpApplication<br/>único ejecutable]
CAT[catalogo<br/>Categoria–Producto]
VEN[ventas<br/>Venta–DetalleVenta]
FUT["inventario, compras, seguridad<br/>(aún no creados como paquetes)"]
SCAT[(BOM_CATALOGO)]
SVEN[(BOM_VENTAS)]
APP --> CAT
APP --> VEN
APP -. se agregan cuando su sesión les da contenido .-> FUT
VEN -->|servicio público| CAT
CAT --> SCAT
VEN --> SVEN
Todos los módulos se ejecutan en la misma JVM y utilizan un datasource. No existe Feign ni comunicación HTTP interna. Cada módulo conserva sus controllers, casos de uso, entidades y repositorios; los repositorios no se comparten.
6. Casos de prueba de la demo¶
Tabla 2. Casos de prueba de la demo
| Caso | Accion | Resultado esperado |
|---|---|---|
| Verificar backend | Ejecutar con el ambiente local. | Conecta con Oracle y responde en /health o equivalente. |
| Verificar límites | Revisar dependencias y paquetes de negocio. | Existe un solo ejecutable y ningún módulo accede a repositorios ajenos. |
| CRUD maestro | Crear, consultar, actualizar y eliminar un producto. | Las operaciones persisten con respuestas HTTP consistentes. |
| Crear venta válida | Dos detalles válidos. | Se registra venta REGISTRADA con total y stock consistentes. |
| Crear venta inválida | Cantidad cero o stock insuficiente. | Se devuelve error 400/409 sin persistencia parcial (rollback completo). |
| Filtrar ventas | Filtrar por estado y rango de fecha. | La lista muestra solo las ventas coincidentes. |
7. Trazabilidad con ADS y BD2¶
Tabla 3. Trazabilidad con ADS y BD2
| Elemento LP2 | ADS | BD2 |
|---|---|---|
| Configuración por ambientes | Un ejecutable desplegable y configuración externa | Conexión Oracle sin credenciales versionadas. |
| Monolito modular con capas internas | Vista C3, límites y dependencias | Esquemas y tablas con propiedad funcional definida. |
| Validación de total y stock | Regla de integridad | Restricciones y excepciones PL/SQL. |
| Filtros por fecha | Atributo rendimiento | Índice IX_VENTAS_FECHA. |
8. Rúbrica de Evaluación¶
Tabla 4. Rúbrica de evaluación de la Unidad 1
| Criterio | Peso | CE / Nivel | A (20 pts) | B (15 pts) | C (10 pts) | D (5 pts) | Calificación obtenida |
|---|---|---|---|---|---|---|---|
| 1. Crea y configura el proyecto backend con ORM, conexión a la base de datos, recurso REST inicial, DTO y documentación de API | 16% | CE023-N2 (parcial) | Proyecto ejecutable, conectado a Oracle, con contrato y versionado de API documentados y verificables en vivo. | Proyecto ejecutable y conectado, con documentación parcial. | Proyecto ejecutable con conexión o documentación incompleta. | No presenta un proyecto backend ejecutable. | |
| 2. Implementa un CRUD REST completo, con validaciones, excepciones, logs y pruebas transversales | 16% | CE023-N2 (parcial) | CRUD completo con validación, manejo de errores y trazabilidad probados con casos reales. | CRUD completo con validación parcial o trazabilidad incompleta. | CRUD incompleto o sin manejo de errores. | No presenta CRUD funcional. | |
| 3. Gestiona objetos relacionados mediante ORM, DTO y reglas de asociación | 16% | CE023-N2 (parcial) | Asociación entre entidades con DTO relacionado y navegación controlada, verificada en vivo. | Asociación funcional, con detalles menores en la navegación o el DTO. | Asociación incompleta o sin control de referencias. | No implementa objetos relacionados. | |
| 4. Implementa una operación cabecera-detalle con registro atómico, cálculos, estados, consistencia, commit y rollback | 16% | CE023-N2 (parcial) | Operación completa, con caso de éxito y caso de rollback probados y explicados. | Operación completa, con un caso probado. | Operación presente, sin evidencia clara de atomicidad. | No implementa la operación cabecera-detalle. | |
| 5. Implementa consultas, filtros, ordenamiento, agregaciones, reportes y configuración CORS | 16% | CE023-N2 (parcial) | Filtros combinados, reporte agregado y CORS configurado por propiedad, probados en vivo. | La mayoría de estos elementos funciona, con detalles menores. | Consultas o CORS incompletos. | No implementa consultas ni CORS. | |
| 6. Sustentación | 20% | CG | Sustenta con claridad y profesionalismo su aporte individual, respondiendo con precisión las preguntas del jurado. | Sustenta con solvencia, con detalles menores en claridad, orden o precisión. | Sustenta con dificultad; claridad, orden o precisión insuficientes. | No sustenta adecuadamente ni demuestra su aporte individual. |
Nota final = suma de (Peso / 100 × Puntos de la calificación obtenida) = ____ / 20.
CE023-N2 (parcial) = porción de backend REST del Nivel 2 de CE023 (Programación) — la otra porción (frontend SPA, JWT, integración full-stack) se completa en Unidad 2 de LP2. CG = Competencia General "Innovación y solución de problemas" del sílabo de LP2 — no es CE023: los criterios 1-5 ya son la evidencia técnica, incluida su verificación en vivo; el criterio 6 verifica aporte individual y comunicación.
Tabla 5. Subaspectos de la sustentación (Unidad 1)
El criterio 6 se evalúa con los mismos 6 subaspectos de la sustentación integral del Proyecto Integrador (Guía de Sustentación Final) — exigibles desde esta primera sustentación de unidad, no solo en la sustentación final del ciclo (Unidad 3).
| Subaspecto | Qué observa en Unidad 1 |
|---|---|
| 1. Aporte individual | Cada integrante demuestra lo que construyó de su propio backend. |
| 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 | Topics académicos configurados desde S2, organización, commits y reproducibilidad del backend. |
| 5. MkDocs o equivalente | Documentación de Unidad 1 publicada, navegable y alineada con lp2-demo.md. |
| 6. Pitch/demo ejecutiva | Introducción breve del backend y su avance, con apoyo visual (.pptx, Canva o equivalente) — no reemplaza la demo técnica de S06, la precede. |
Para usar la rúbrica con IA, solicita:
Evalúa la sustentación y el producto (lp2-demo.md o la sección 2 de la guía S06) 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 (endpoints, código, pruebas en vivo).
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 para lo que sigue en Unidad II.
9. Trazabilidad y procedencia de la rúbrica¶
Los primeros cinco criterios son cita literal del resultado de aprendizaje de la Unidad I en el sílabo de LP2; el sexto (Sustentación) corresponde a la sustentación exigida por el mismo sílabo (sesión 6, actividad 2).
Con la malla curricular: los criterios 1-5 corresponden a la porción de backend REST del Nivel 2 de CE023 (Programación) — la otra porción de ese nivel, el frontend SPA, la seguridad JWT y la integración full-stack completa, se completa en la Unidad 2 de LP2, no aquí. El criterio 6 (Sustentación) es transversal y no forma parte de la definición de la competencia.