Unidad 1 - Producto integrado¶
Corte U1¶
El corte de Unidad 1 demuestra que el equipo transformó el sistema MVC heredado de Ciclo 3 en una base técnica empresarial: arquitectura modular, motor transaccional Oracle y una aplicación Spring Boot REST preparada para la SPA. JWT se implementará en U2.
Dominio de ejemplo¶
Base de BomERP: gestión de productos y ventas.
El sistema MVC de Ciclo 3 ya gestiona Producto, Categoria, Venta, DetalleVenta y Usuario. En Ciclo 4 se conserva ese flujo, se organiza el backend mediante módulos de negocio, se expone mediante una API REST conectada a Oracle y se prepara su consumo desde una SPA empresarial. Catálogo y Ventas constituyen el alcance funcional obligatorio; Inventario, Compras y Seguridad quedan delimitados para evolucionar sin mezclar responsabilidades.
BomERP es el ejemplo del docente, no el dominio obligatorio. Cada sede (Lima, Juliaca, Tarapoto) y cada grupo dentro de una misma sede declara su propio dominio en su brief.md de S2, con su propio módulo transaccional (equivalente a ventas) y su módulo no transaccional (equivalente a catalogo). Las secciones siguientes (Evidencia mínima, Pruebas mínimas y Transición) usan los nombres de BomERP solo como referencia concreta; cada equipo los lee en clave de sus propios módulos.
Producto integrado U1¶
Arquitectura modular base + motor transaccional Oracle optimizado + una aplicación Spring Boot REST funcional y preparada para la SPA.
Productos por curso¶
| Curso | Producto U1 | Archivo |
|---|---|---|
| ADS | Arquitectura documentada mediante vistas arquitectonicas y principios de diseno aplicados. | Producto ADS U1 |
| BD2 | Motor transaccional Oracle optimizado. | Producto BD2 U1 |
| LP2 | Backend REST modular ensamblado como una sola aplicación Spring Boot, con Catálogo y Ventas funcionales, límites de Inventario y Compras, persistencia, consultas, CORS, logs y pruebas. | Producto LP2 U1 |
Alcance relativo de cada curso¶
Los tres cursos no tienen el mismo alcance de visión sobre BomERP:
- ADS ve todo el sistema: arquitectura completa de la empresa, incluyendo infraestructura y sistemas externos con los que BomERP se integra (notificaciones, servicios de IA, etc.), no solo lo que BD2 o LP2 construyen.
- BD2 también ve el sistema completo, pero acotado a la base de datos empresarial: motor transaccional, optimización, auditoría y resiliencia de Oracle.
- LP2 no alcanza a construir todo el ERP: su producto es una porción concreta — Catálogo y Ventas (2 módulos) —, con Inventario, Compras y Seguridad delimitados para sesiones futuras.
Integracion esperada¶
flowchart TB
A["`**ADS U1:** C4, atributos de calidad, decisiones y componentes`"]
B["`**BD2 U1:** PL/SQL, triggers, excepciones, optimizacion e indices`"]
C["`**LP2 U1:** Un Spring Boot modular, Catálogo y Ventas funcionales`"]
D["`**Producto integrado U1:** Backend empresarial funcional y sustentado`"]
A --> C
A --> D
B --> C
B --> D
C --> D
Evidencia minima para presentar¶
- Repositorio creado con topics academicos.
- Contexto, alcance tecnico y atributos de calidad.
- Vistas C4 iniciales: contexto, contenedores y componentes.
- Decisiones arquitectonicas iniciales.
- Paquetes PL/SQL, triggers, manejo de excepciones e indices.
- Esquemas funcionales y usuario técnico de aplicación con privilegios mínimos; FK verificables entre Catálogo y Ventas (Seguridad no existe hasta S10, ya en U2).
- Consultas optimizadas con evidencia de criterio de optimizacion.
- Proyecto backend ejecutable, configuración por ambientes, conexión a BD y endpoint de verificación.
- Un único
BomErpApplication; módulos de negocio con dependencias unidireccionales y repositorios propios. - Contrato REST, DTO y documentación OpenAPI.
- CRUD completo de
Producto, con validaciones, excepciones, logs y pruebas. - Asociación
Categoria–Productomediante ORM y DTO relacionados. - Operación
Venta–DetalleVentacon cálculos, estados, commit y rollback. - Consultas, filtros, ordenamiento, agregaciones y resúmenes; la paginación se reserva para S14.
- Reglas de negocio, trazabilidad, CORS, logs y pruebas.
- Demo o consola API ejecutable.
- Trazabilidad entre arquitectura, objetos Oracle, endpoints y pruebas.
Pruebas minimas del corte U1¶
| Caso | Entrada o accion | Resultado esperado | Curso que aporta evidencia |
|---|---|---|---|
| Verificación del backend | Ejecutar el proyecto con el ambiente local. | El backend conecta con Oracle y responde en el endpoint de verificación. | LP2 + BD2 |
| Verificación modular | Revisar dependencias y acceso a persistencia. | Existe un solo ejecutable y ningún módulo consume directamente repositorios ajenos. | ADS + LP2 |
| CRUD maestro | Crear, consultar, actualizar y eliminar un producto con categoría. | Las operaciones persisten y responden con estados HTTP consistentes. | LP2 + BD2 |
| Registro de venta válida | Cliente y dos detalles con cantidades válidas. | La venta se registra en estado ACTIVA, actualiza stock y calcula el total. |
LP2 + BD2 |
| Rechazo de cantidad invalida | Cantidad cero o negativa. | La API responde con error de validacion. | ADS + LP2 |
| Auditoría de cambios | Actualizar precio o stock de un producto. | El cambio queda registrado en PRODUCTO_AUDITORIA con los valores antes y después. |
BD2 + LP2 |
| Consulta filtrada | Filtrar ventas por fecha, estado, usuario o producto. | Se devuelven sólo ventas coincidentes. | BD2 + LP2 |
| Trazabilidad | Seleccionar un endpoint y explicar su componente, tabla, paquete y regla. | El equipo demuestra relacion ADS-BD2-LP2. | ADS + BD2 + LP2 |
Estado de aprobacion del corte U1¶
| Estado | Significado | Decision metodologica |
|---|---|---|
| Aprobado para continuar a U2 | Arquitectura, motor transaccional y API REST funcional son coherentes y verificables. | El equipo puede construir la SPA e incorporar seguridad backend y frontend. |
| Aprobado con observaciones | El backend funciona, pero existen ajustes en arquitectura, PL/SQL, transacciones o trazabilidad. | El equipo continúa a U2 corrigiendo observaciones antes del segundo corte. |
| No aprobado | No existe integracion verificable entre ADS, BD2 y LP2, o la API no ejecuta el flujo principal. | El equipo debe rehacer U1 antes de avanzar. |
Transicion hacia Unidad 2¶
| Curso | En U1 queda | En U2 se convierte en |
|---|---|---|
| ADS | Arquitectura base, C4, decisiones y componentes. | Modelo de dominio, UML, patrones, integracion y catalogo tecnico. |
| BD2 | Motor transaccional Oracle con PL/SQL, triggers, excepciones, optimizacion e indices. | Base Oracle administrada, optimizada, asegurada y particionada. |
| LP2 | Una aplicación Spring Boot modular con Catálogo y Ventas funcionales, CRUD, cabecera–detalle, consultas, CORS, logs y pruebas. | Una SPA modular segura con navegación, CRUD, formularios transaccionales, JWT, roles, guards e interceptores. |
flowchart TB
A[U1: Spring Boot modular funcional]
B[ADS U2: UML, patrones e integracion]
C[BD2 U2: administracion, seguridad, auditoria y particionamiento]
D[LP2 U2: una SPA modular segura integrada al backend]
E[Producto U2: aplicacion full-stack funcional con Oracle administrado]
A --> B
A --> C
A --> D
B --> E
C --> E
D --> E