Saltar a contenido

BD2 - Producto de Unidad 1

Esta es la plantilla-ejemplo del producto de Unidad 1 de BD2. La estructura (objetos Oracle, reglas de negocio y transaccionales, manejo de excepciones, selectividad e índices, evidencia de integración) es exigible a todos: motor transaccional con reglas de negocio en PL/SQL, manejo de excepciones, auditoría y optimización con índices según selectividad medida. El contenido de BomERP (esquemas, tablas, paquetes PL/SQL y triggers concretos) es el ejemplo real que muestra cómo se ve terminada — cada sede (Lima, Juliaca, Tarapoto) y cada grupo reemplaza ese contenido por el de su propio proyecto, definido en su propio brief.md de S2, sin cambiar la estructura.

Producto

Motor transaccional Oracle optimizado.

Este producto implementa lógica de negocio en Oracle mediante PL/SQL, triggers, excepciones, auditoría básica, consultas optimizadas e índices. La base no se trabaja como ejercicio aislado: soporta los endpoints y reglas del backend LP2.

1. Scripts del producto

Los scripts se agregan por sesión de BD2, a medida que cada una les da contenido real — no se pre-crean tablas/objetos de sesiones que todavía no se dictaron (mismo criterio que la arquitectura de módulos de LP2, ver ADR-002).

Tabla 1. Scripts del producto

Script Sesión BD2 Uso
S01_01_esquemas.sql S1 Usuarios BOM_CATALOGO (propietario) y BOMERP_APP (técnico de LP2).
S01_02_tablas.sql S1 Tablas CATEGORIAS/PRODUCTOS y permisos de BOMERP_APP sobre ellas.
S01_03_plsql.sql S1 Función y procedimientos PL/SQL del catálogo.
S02_triggers_dml_auditoria.sql S2 Trigger de regla de negocio (TRG_PRODUCTO_PRECIO_BU) y trigger + tabla de auditoría de precio/stock (TRG_PRODUCTO_AUDITORIA, PRODUCTO_AUDITORIA).
S03_excepciones_robustez.sql S3 Tabla LOG_ERRORES, excepciones en los procedimientos de S1 y FN_OBTENER_PRECIO_PRODUCTO.
S04_01_esquemas.sql S4 Usuario BOM_VENTAS.
S04_02_tablas.sql S4 Tablas VENTAS/DETALLE_VENTAS.
S04_optimizacion_consultas.sql S4 Volumen de prueba, EXPLAIN PLAN, DBMS_STATS y reescritura de la consulta representativa.
S05_indices_optimizacion.sql S5 Selectividad medida e índices B-Tree, Bitmap y Function-Based.

Pendiente (se agrega cuando esa sesión de BD2 se documente): esquema BOM_SEGURIDAD (S10 de LP2).

2. Objetos Oracle U1

Estado al cierre de la Unidad 1 (S6):

Tabla 2. Objetos Oracle U1

Objeto Propósito Relación con LP2
BOM_CATALOGO.CATEGORIAS/PRODUCTOS Catálogo heredado de Ciclo 3. Recursos /api/v1/categorias y /api/v1/productos.
BOM_CATALOGO.LOG_ERRORES Registro de errores capturados por los procedimientos/función del catálogo (S3). Ninguno directo — el backend no consulta esta tabla.
BOM_CATALOGO.PRODUCTO_AUDITORIA + TRG_PRODUCTO_AUDITORIA Auditoría de cambios de precio/stock. POST/PUT sobre /api/v1/productos (cualquier alta o cambio la dispara).
BOM_VENTAS.VENTAS/DETALLE_VENTAS Operación transaccional principal. Recurso /api/v1/ventas.
IX_VENTAS_FECHA (B-Tree) Consultas filtradas por rango de fecha. GET /api/v1/ventas?desde=&hasta=.
IX_LOG_ERRORES_OBJETO (Bitmap) Diagnóstico de errores agrupados por objeto que falló. Ninguno directo.
IX_VENTAS_FECHA_DIA (Function-Based, sobre TRUNC(FECHA)) Reporte de ventas por día calendario. GET /api/v1/ventas/resumen.

3. Reglas de negocio y transaccionales

Tabla 3. Reglas de negocio y transaccionales

Regla Implementación Oracle
Un producto se registra con una categoría que debe existir. SP_REGISTRAR_PRODUCTO, captura ORA-02291 y la registra en LOG_ERRORES.
Un descuento no puede dejar el precio fuera de rango razonable. TRG_PRODUCTO_PRECIO_BU (BEFORE UPDATE), rechaza con RAISE_APPLICATION_ERROR antes de escribir.
Todo cambio de precio o stock queda auditado, sin que el backend lo sepa. TRG_PRODUCTO_AUDITORIA (AFTER INSERT/UPDATE/DELETE), disparado por Oracle mismo.
Una venta no puede registrarse con stock insuficiente. Validado desde el servicio de ventas en LP2 (S4), consultando catalogo vía su servicio público — regla de estado, no de forma, por eso vive en el service y no en un CHECK.
Un producto inexistente al consultar su precio responde con causa clara. FN_OBTENER_PRECIO_PRODUCTO, captura NO_DATA_FOUND y la registra en LOG_ERRORES.

4. Manejo de excepciones

Tabla 4. Manejo de excepciones

Situación Excepción esperada
Categoría inexistente al registrar un producto. ORA-02291 capturado, RAISE_APPLICATION_ERROR(-20010, ...).
Porcentaje de descuento fuera de rango (0-100). RAISE_APPLICATION_ERROR(-20011, ...), sin código Oracle previo — la regla la crea el propio procedimiento.
Producto inexistente al consultar su precio. NO_DATA_FOUND (código 100), RAISE_APPLICATION_ERROR(-20012, ...).

5. Selectividad e índices (S5)

Ningún índice se crea sin medir selectividad primero (COUNT(DISTINCT columna) / COUNT(*)):

Tabla 5. Selectividad e índices

Columna candidata Selectividad Índice creado
VENTAS.FECHA Alta (cercana a 1) B-Tree (IX_VENTAS_FECHA)
LOG_ERRORES.OBJETO Baja (pocos valores distintos) Bitmap (IX_LOG_ERRORES_OBJETO)
TRUNC(VENTAS.FECHA) La de la expresión, no la de la columna Function-Based (IX_VENTAS_FECHA_DIA)
VENTAS.ESTADO Muy baja (un único valor, EstadoVenta.REGISTRADA en LP2 S4) Ninguno — se creó, se confirmó que el optimizador no lo usaba, y se eliminó.

6. Evidencia de integración

Tabla 6. Evidencia de integración con ADS y LP2

BD2 ADS LP2
TRG_PRODUCTO_AUDITORIA Atributo de auditabilidad POST/PUT sobre /api/v1/productos.
IX_VENTAS_FECHA Atributo de rendimiento GET /api/v1/ventas?desde=&hasta=.
LOG_ERRORES + excepciones personalizadas Robustez del motor GlobalExceptionHandler (manejo global de errores).
EXPLAIN PLAN/DBMS_STATS sobre la consulta representativa (S4) — Consulta de reporte agregado (GET /api/v1/ventas/resumen, LP2 S5).

Las FK entre esquemas conservan la integridad porque todos los objetos pertenecen a una sola base Oracle. BOMERP_APP ejecuta la aplicación, pero no es propietario de tablas ni paquetes.

7. Rúbrica de Evaluación

Tabla 7. 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. Implementa procedimientos y funciones PL/SQL alineados al negocio 16% CE023-N1 Procedimientos y funciones correctos, probados con casos válidos e inválidos, alineados a una regla real del proyecto. Procedimientos y funciones correctos, con pruebas parciales. Procedimientos incompletos o sin alineación clara al negocio. No presenta procedimientos ni funciones PL/SQL.
2. Automatiza reglas mediante triggers DML 16% CE023-N1 Al menos un trigger de regla de negocio y uno de auditoría, disparados y verificados en vivo. Triggers presentes, con verificación parcial. Un solo trigger funcional, o sin verificación clara. No presenta triggers.
3. Controla errores mediante manejo de excepciones 16% CE023-N1 Excepciones predefinidas y personalizadas, con registro de errores probado con casos reales. Manejo de excepciones presente, con registro parcial. Manejo de excepciones incompleto o sin registro. No maneja excepciones.
4. Analiza y mejora consultas mediante Explain Plan, CBO y DBMS_STATS 16% CE023-N1 Comparación completa (antes/después de estadísticas y de una reescritura), con COST/ROWS interpretados correctamente. Comparación presente, con interpretación parcial. Un solo EXPLAIN PLAN capturado, sin comparación real. No presenta EXPLAIN PLAN.
5. Aplica estrategias de indexación según selectividad y necesidades de consulta 16% CE023-N1 Selectividad medida antes de crear cada índice, con al menos un caso de índice correctamente descartado. Índices creados con selectividad medida, sin caso de descarte. Índices creados sin medir selectividad. No presenta índices ni selectividad medida.
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-N1 = Nivel 1 de CE023 (Programación) — la rama que se satisface programando el motor transaccional del lado del servidor. CG = Competencia General del sílabo de BD2 — con una inconsistencia del propio documento fuente que hay que resolver antes de usar esta etiqueta en un informe formal: la sección III del sílabo la nombra "PENSAMIENTO SUPERIOR" (Firmeza de propósito, ejecución, dominio propio, mantener esfuerzo), pero la tabla de evaluación de la sección VIII la nombra "Servicio y misión" — no son el mismo texto y no está claro cuál es la vigente. 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 8. 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 motor transaccional.
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 de los scripts Oracle.
5. MkDocs o equivalente Documentación de Unidad 1 publicada, navegable y alineada con bd2-producto.md.
6. Pitch/demo ejecutiva Introducción breve del motor transaccional 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 (bd2-producto.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 (objetos Oracle, planes de ejecución, selectividad).
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.

8. 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 BD2; 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 al Nivel 1 de CE023 (Programación) — la rama de esa competencia que se satisface programando el motor transaccional del lado del servidor (Unidad 1 de BD2), distinta de la rama que otros cursos (FP, POO, LP1) satisfacen construyendo una plataforma completa de otro tipo. La administración de la instancia Oracle a escala empresarial (Nivel 2 de CE022, Ingeniería de la Información) no se evalúa aquí: se completa en las Unidades 2 y 3 de BD2. El criterio 6 (Sustentación) es transversal y no forma parte de la definición de la competencia.