LP2 - Producto final (Unidad 3)¶
Proyecto: Semestre Saludable UPeU Equipo 01: Montalvo Machaca, Maykol Gabriel · Cruz Mendoza, Deysi Curso: Lenguaje de Programación II — UPeU sede Juliaca — Semestre 2026-2 Repositorios: bomerp-backend · bomerp-frontend
Producto¶
Sistema web para la campaña Semestre Saludable: el estudiante registra evidencias diarias de hábitos saludables con foto, la coordinación de su sede las valida o rechaza, el puntaje validado arma el ranking y, al cierre, se emite un acta de premiación que descuenta el stock de los premios entregados.
Backend Spring Boot 4 como monolito modular (Spring Modulith) sobre Oracle 23ai, con seguridad JWT de Keycloak. Frontend Angular 22 con componentes standalone, signals y carga diferida por ruta. Cada sede (Juliaca, Lima, Tarapoto) trabaja con sus propios datos.
1. Componentes finales¶
| Módulo | Esquema Oracle | Responsabilidad |
|---|---|---|
campanias |
BOM_CAMPANIAS |
Categorías de hábito, hábitos, campañas, sedes y hábitos de cada campaña, cupo diario |
participacion |
BOM_PARTICIPACION |
Estudiantes, registro de participación con sus evidencias, validación, reporte y ranking |
premios |
BOM_PREMIOS |
Categorías de premio, premios con stock y actas de premiación |
cuentas |
Keycloak + BOM_PARTICIPACION.SOLICITUDES_CUENTA |
Cuentas y roles en Keycloak, solicitudes de cuenta |
sedes |
BOM_PARTICIPACION.SEDES_USUARIO |
Sede de cada usuario y alcance de las consultas |
auditoria |
BOM_AUDITORIA |
Registro inmutable de las acciones importantes |
catalogo y ventas son el ejemplo guiado del docente y no forman parte del dominio del proyecto.
1.1 Operaciones transaccionales¶
Registro de participación (cabecera + detalle + cupo). Una sola transacción crea REGISTROS, sus DETALLE_EVIDENCIAS y suma las evidencias en CUPOS_DIARIOS. Si una línea supera el cupo diario de la campaña, se lanza CupoDiarioExcedidoException y Oracle deshace todo: no queda cabecera sin detalle ni cupo consumido a medias.
Acta de premiación (cabecera + detalle + stock). Emitir el acta crea ACTAS_PREMIACION, sus detalles y descuenta el stock de cada premio en la misma transacción. Si un premio no alcanza, se rechaza el acta completa. Anular el acta devuelve el stock.
1.2 Relaciones muchos a muchos¶
CAMPANIA_HABITOS (qué hábitos cuentan en una campaña) y CAMPANIA_SEDES (en qué sedes corre) se modelan como entidades de unión explícitas, no con @ManyToMany. Así cada módulo guarda solo identificadores del otro y Spring Modulith no detecta dependencias cruzadas entre entidades de módulos distintos.
2. Rendimiento y preparación para producción¶
2.1 Carga diferida y presupuestos¶
Las 23 rutas de app.routes.ts usan loadComponent, así que cada pantalla se descarga solo cuando se visita. angular.json define presupuestos en la configuración production:
| Tipo | Advertencia | Error |
|---|---|---|
initial |
500 kB | 1 MB |
anyComponentStyle |
4 kB | 8 kB |
2.2 Paginación con agregado correcto¶
El reporte de participación pide cada página a GET /api/v1/participacion/registros/pagina (Spring Data Page con countQuery) y los totales a GET /api/v1/participacion/registros/totales. Los totales (registros, evidencias, puntaje validado, promedio y hábito más registrado) se calculan en Oracle con COUNT, SUM y GROUP BY sobre todos los registros que cumplen los filtros, no sobre la página visible.
2.3 Caché del navegador¶
GET /api/v1/categorias-habito y GET /api/v1/habitos responden con Cache-Control: no-cache, private y un ETag calculado por EtagCatalogosFilter (subclase de ShallowEtagHeaderFilter). El navegador guarda la respuesta y, en cada visita, pregunta con If-None-Match. Si el catálogo no cambió, el backend responde 304 sin volver a enviar el cuerpo. private evita que un proxy compartido guarde datos de un usuario autenticado. Nunca se aplica a endpoints que escriben.
2.4 Decisión sobre Redis: descartado¶
Medición del 8 de noviembre de 2026, de 15:09 a 15:14 (5 minutos de uso normal como administrador: crear categorías, hábitos, campaña, premios y revisar pantallas), en Network del navegador:
| Endpoint | Lecturas (GET) | Respuestas 200 | Respuestas 304 | Tiempo por petición |
|---|---|---|---|---|
GET /habitos |
7 | 1 | 6 | 13–19 ms |
GET /categorias-habito |
8 | 1 | 7 | 12–24 ms |
En 5 minutos hubo 15 lecturas de los catálogos candidatos, unos 0.2 segundos de trabajo total del backend, y 13 de ellas se resolvieron con 304. Redis agregaría un servicio más que levantar, asegurar y mantener sincronizado (invalidar al crear o editar) para ahorrar milisegundos que hoy no se notan. Se descarta. Se reconsideraría si la medición con usuarios reales mostrara cientos de lecturas por minuto de un mismo dato o una consulta que tarde cientos de milisegundos.
2.5 Logging, Actuator y configuración de producción¶
logback-spring.xml:pe.edu.upeu.bomerpenDEBUGcon el perfildevy enINFOconprod; Hibernate enWARNenprod.- Logs estructurados: además del log de texto (
logs/bomerp.log), cada evento se escribe en JSON con el formato ECS de Elastic enlogs/bomerp.json, con fecha, nivel, clase, mensaje y eltraceIdde la petición. Así un recolector como ELK o Grafana Loki los puede leer sin interpretar texto. - Actuator:
devexpone todo;prodsolohealth,info. Esos dos son públicos para que Docker o un balanceador revisen la salud sin token; cualquier otro endpoint pide JWT. application-prod.ymlycompose.ymlleen conexiones, usuarios, contraseñas y el secreto del cliente de Keycloak desde variables de entorno..env.exampledocumenta los nombres sin valores; el.envreal está en.gitignore.environment.prod.tsreemplaza aenvironment.tsen el build de producción porfileReplacements.
2.6 Auditoría¶
Cada acción importante queda en BOM_AUDITORIA.EVENTOS con fecha, usuario, nombre, acción, entidad, detalle, sede y el traceId de la petición:
| Grupo | Acciones |
|---|---|
| Seguridad | crear cuenta, cambiar rol, activar o desactivar, restablecer contraseña |
| Puntos | registrar participación, validar o rechazar evidencia, validar, rechazar o anular registro |
| Premios | emitir o anular acta; crear, editar o eliminar premios y categorías de premio (con stock anterior y nuevo) |
| Reglas | crear, editar o eliminar campañas, hábitos (con puntaje anterior y nuevo) y categorías de hábito |
- Inmutable: el usuario de la aplicación
BOMERP_APPsolo tieneSELECTeINSERTsobre la tabla. Ni con un error en el código se puede editar o borrar un evento. - No rompe la operación: se guarda en una transacción propia (
REQUIRES_NEW) y, si falla, solo se escribe una advertencia en el log. - Sin secretos: nunca guarda contraseñas ni tokens; al restablecer una contraseña solo se registra que ocurrió.
- Solo el rol
ADMINpuede consultarla (/api/v1/auditoria).
3. Plan de pruebas¶
3.1 Pruebas automáticas¶
| Prueba | Tipo | Qué verifica |
|---|---|---|
ModularityTests |
Arquitectura | Que ningún módulo use el interior de otro (Spring Modulith) |
BomerpBackendApplicationTests |
Arranque | Que el contexto completo levante contra Oracle |
ParticipacionEndToEndTest |
De punta a punta, Oracle real | El flujo completo de participación |
ParticipacionEndToEndTest crea su propia categoría, hábito de 2.00 puntos, campaña activa con cupo de 3 por día y estudiante, y comprueba en orden:
- Dos registros válidos suman 4.00 puntos y consumen 2 evidencias del cupo.
- Un registro con 2 evidencias más supera el cupo: se lanza
CupoDiarioExcedidoExceptiony el cupo sigue en 2 (rollback completo). - Un tercer registro de 1 evidencia sí entra.
- Validar una evidencia deja el puntaje validado en 4.00.
- La página de tamaño 1 informa 2 registros y 2 páginas.
- Los totales dan 2 registros, 3 evidencias, 4.00 puntos y el hábito más registrado.
- El ranking pone al estudiante en el puesto 1 con 4.00 puntos.
Al terminar borra todo lo que creó. Resultado: Tests run: 1, Failures: 0, Errors: 0, Skipped: 0.
3.2 Pruebas manuales con errores forzados¶
| Caso | Acción | Resultado esperado |
|---|---|---|
| Cupo diario | Registrar más evidencias que el cupo en un día | Mensaje de cupo excedido; no se guarda nada |
| Stock | Emitir un acta con más unidades que el stock | Acta rechazada; stock intacto |
| Anular acta | Anular un acta emitida | El stock vuelve a su valor anterior |
| Fechas | Campaña con fecha fin igual o anterior a la de inicio | El backend responde 400 con el mensaje de fechas |
| Rol | Estudiante entra a /auditoria o /cuentas |
Pantalla de sin permiso; el backend responde 403 |
| Sede | Coordinador de Juliaca pide datos de Lima | Solo recibe datos de su sede |
| Caché | Visitar Hábitos dos veces | La segunda petición responde 304 |
4. Bitácora de hallazgos¶
| Fecha | Hallazgo | Corrección |
|---|---|---|
| 08/11/2026 | El reporte sumaba evidencias y puntaje con .reduce() en el navegador sobre los registros cargados. Al paginar, los totales habrían mostrado solo la página visible. |
Totales calculados en Oracle con /totales, independientes de la página |
| 08/11/2026 | Crear o editar hábitos y premios no quedaba en la auditoría, aunque cambiar el puntaje de un hábito o el stock de un premio afecta puntos y premios. | Auditoría en los cuatro catálogos con valor anterior y nuevo |
| 08/11/2026 | categoria-habito-form.ts imprimía el formulario en la consola en cada tecla, resto de una práctica de clase. |
Se eliminaron los console.log |
| 08/11/2026 | .env.example (que sí sube a GitHub) tenía la contraseña de la base y el secreto del cliente de Keycloak; compose.yml de producción tenía cuatro contraseñas escritas y application.yml usaba el secreto como valor por defecto, así que prod arrancaba con el secreto de desarrollo si nadie lo configuraba. |
.env.example solo con nombres, compose.yml con ${...} y el secreto de desarrollo movido a application-dev.yml |
| 08/11/2026 | El panel de coordinación muestra un 404 en consola cuando la sede no tiene campaña activa. | Es la respuesta esperada; el frontend la maneja mostrando "sin campaña activa" |
| 16/11/2026 | PremioController declaraba dentro de sí una interfaz PremioRepository que nadie usaba. |
Se eliminó; el repositorio real sigue en premio/repository |
| 16/11/2026 | Pedir un premio inexistente respondía 500 porque el servicio lanzaba RuntimeException. |
Ahora responde 404 |
| 16/11/2026 | Eliminar un premio que ya estaba en un acta dejaba el acta apuntando a un premio que ya no existe. | El servicio lo impide con 409 y S20 agrega FK_DETALLE_PREMIO en la base |
| 16/11/2026 | REGISTROS.ID_ESTUDIANTE y DETALLES_PREMIACION.PREMIO_ID estaban en el mismo esquema que su tabla de destino pero sin llave foránea. |
S20_integridad_referencial.sql agrega las dos llaves y los índices de las columnas usadas en búsquedas |
| 16/11/2026 | ProductoControllerTest (ejemplo del docente, con @WebMvcTest) no levantaba desde que se agregó Keycloak: la configuración automática del servidor de recursos OAuth2 pedía HttpSecurity dentro de la prueba de solo controlador. |
La prueba excluye esa configuración; los 4 casos vuelven a pasar |