ADS · S4 · Arquitecturas modernas: el estilo de SGE-JD con evidencia¶
SGE-JD · JD Refrigeración S.A.C. · Equipo CherryTree · Yoel Wagner Chambi Sirena · 10/11/2026
Trabajo autónomo de la sesión 4 (Arquitecturas modernas). En S1 se eligió monolito modular. Aquí esa elección se pone a prueba con evidencia real: dos instancias del backend corriendo a la vez, la prueba de módulos y el alcance real de una transacción.
1. Trade-offs de los siete estilos, aplicados a SGE-JD¶
| Estilo | ¿Aplica hoy? | Qué se ganaría | Qué se pagaría |
|---|---|---|---|
| Monolito modular | Sí | ACID por defecto: registrar una venta escribe VENTAS, DETALLE_VENTA, el stock de PRODUCTOS, el correlativo de SERIES_COMPROBANTE, el COMPROBANTE y los MANTENIMIENTOS en una sola transacción de Oracle, aunque toque 4 módulos (sección 2). ADP verificado: ModularityTests falla si aparece un ciclo entre módulos |
No se puede escalar o desplegar un módulo por separado: si Facturación necesita más recursos, se escala todo |
| Arquitectura en capas | Sí, dentro de cada módulo | Controller → Service → Repository → Entity, con DTO en el borde | No pone límites entre módulos; eso lo da Spring Modulith |
| Hexagonal | Solo en las integraciones | Ya se usa donde la infraestructura cambia: OseClient tiene dos adaptadores (NubefactClientSimulado y SunatDirectoClient), y NotificadorCorreo también |
Llevarla a todo el dominio agregaría puertos y mapeos que hoy no protegen ninguna regla (sección 4) |
| Clean Architecture | Parcial: los principios | El dominio no depende de Spring MVC; las entidades calculan su propio total | La estructura formal (casos de uso, presentadores) duplicaría lo que ya separan las capas |
| Microservicios | No | Escalar y desplegar por separado | Teorema CAP: la venta y su comprobante quedarían en dos servicios con dos bases. Si la red entre ellos falla (partición), habría que elegir entre rechazar la venta (consistencia) o guardarla sin comprobante y completarla después (disponibilidad, consistencia eventual con una Saga). Hoy esa elección no existe: o se guarda todo o no se guarda nada |
| Serverless | No | Pagar por invocación | Arranque en frío para 2 usuarios; tareas programadas (reintentos a SUNAT, alertas de las 8:00) que necesitan un proceso vivo; el certificado digital tendría que vivir en la nube |
| Microfrontend | No | Desplegar cada pantalla por separado | Un solo equipo de 3 con una sola SPA; coordinaría versiones sin ninguna necesidad |
CAP ya aparece hoy, en un solo lugar: SUNAT. El envío a SUNAT es el único paso que cruza una red ajena, y
por eso no está dentro de la transacción. Va en una cola aparte (EnvioSunatService) con reintentos, estado
PENDIENTE y estado INCIERTO. Es exactamente la consistencia eventual que habría que construir entre
microservicios propios. Esa experiencia es el mejor argumento para no multiplicarla sin necesidad.
2. ACID y ADP con evidencia¶
ACID. VentaService está anotada con @Transactional a nivel de clase (línea 43). Los oyentes de los otros
módulos son síncronos (@EventListener, no @TransactionalEventListener ni @Async):
Paso de registrarVentaDirecta |
Módulo | Tabla | ¿Misma transacción? |
|---|---|---|---|
| Cabecera y líneas | ventas | VENTAS, DETALLE_VENTA |
Sí |
Descuento de stock (ProductoService.descontarStock) |
catalogo | PRODUCTOS |
Sí |
Comprobante y correlativo (VentasFacturacionListener.alRegistrarVenta) |
facturacion | COMPROBANTES, SERIES_COMPROBANTE |
Sí |
Rutina de mantenimiento (VentasPostventaListener.alRegistrarVenta) |
postventa | MANTENIMIENTOS |
Sí |
| Envío a SUNAT | facturacion | (red externa) | No: se encola después, en segundo plano |
Si falla cualquiera de los cuatro primeros pasos, por ejemplo un stock insuficiente, no queda ni la venta ni el número de comprobante consumido. Lo comprobó la prueba de la sección 3: con 2 621 fallos de inserción, las series quedaron sin un solo hueco.
ADP (Acyclic Dependencies Principle).
> mvn -q test -Dtest=ModularityTests
Test set: com.bomerp.ModularityTests
Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 7.119 s
ApplicationModules.of(BomerpApplication.class).verify() falla la compilación si un módulo usa clases internas
de otro, por ejemplo un repositorio, o si se forma un ciclo. Ventas llama a Catálogo, y Catálogo no llama a
Ventas. Ventas avisa a Facturación y Postventa por eventos, sin conocerlos.
3. Escalabilidad horizontal: dos instancias de verdad¶
Prueba (evidencia/S04_dos_instancias.ps1). Se levantaron dos instancias
del mismo jar en los puertos 8081 y 8082, contra la misma Oracle: la base de práctica de BD2, con 30 241
ventas. Para que nada saliera de la PC se usaron SUNAT en modo simulado, el correo hacia un puerto donde nadie
escucha y ddl-auto=validate.
Started BomerpApplication in 19.797 seconds (8081)
Started BomerpApplication in 19.794 seconds (8082)
GET :8081/actuator/health -> 200 (status UP; componente db: Oracle, UP)
GET :8082/actuator/health -> 200 (status UP; componente db: Oracle, UP)
GET :8081/api/v1/admin/ventas sin token -> 401
GET :8082/api/v1/admin/ventas sin token -> 401
La capa web escala. Las dos responden de forma independiente, sin configuración compartida, y cada una valida el token por su cuenta.
Las tareas programadas, no. A los 20 s, las dos ejecutaron la misma tarea,
FacturacionService.emitirVentasPorEmitir() (@Scheduled), con 44 ms de diferencia, sobre la misma lista:
19:15:11.621 8082 Emitiendo el comprobante de 29092 venta(s) que estaban por emitir
19:15:11.665 8081 Emitiendo el comprobante de 29092 venta(s) que estaban por emitir
Instancia 8081: emitidos 141 | rechazados por UX_COMPROBANTE_VIGENTE_VENTA: 2480
Instancia 8082: emitidos 2481 | rechazados por UX_COMPROBANTE_VIGENTE_VENTA: 141
Compitieron venta por venta. De 5 243 intentos, 2 621 (50 %) fueron trabajo duplicado que Oracle rechazó con ORA-00001. Después se verificó la base:
SERIE COMPROBANTES DESDE HASTA HUECOS NUMEROS_REPETIDOS
B001 1420 1 1420 0 0
F001 1439 1 1439 0 0
VENTAS_CON_DOS_VIGENTES: 0
La integridad se sostuvo, pero no gracias al diseño del backend. La salvaron dos piezas de la base de datos:
el índice único UX_COMPROBANTE_VIGENTE_VENTA y el correlativo dentro de la misma transacción, que se deshace
si la inserción falla.
| Tarea o estado en memoria | Qué pasa con 2 instancias | Protección actual |
|---|---|---|
emitirVentasPorEmitir (cada 3 min) |
Medido: las dos emiten las mismas ventas, y 50 % del trabajo se desperdicia | Índice único en Oracle: sin duplicados ni huecos |
EnvioSunatService.reintentarPendientes (cada 3 min) |
Las dos pueden enviar a SUNAT el mismo comprobante PENDIENTE: enviarComprobante lo lee con findById, sin bloqueo |
Ninguna en el backend; SUNAT respondería 1033 "ya registrado" al segundo envío |
envioDetenido (credenciales SOL rechazadas) |
Estado en memoria: si la instancia A lo detecta, la B sigue enviando con la clave mala y puede bloquear la cuenta SOL de JD | Ninguna |
Cola envio-sunat (un hilo, 1,5 s entre envíos) |
Dos colas: el doble de ritmo hacia SUNAT | Ninguna |
| Alertas de mantenimiento y de stock (cron 08:00) | Dos correos a la oficina cada mañana | Ninguna (la de mantenimiento marca alertaEnviada, pero las dos leen antes de marcar) |
| Correo de comprobantes | Seguro | Toma del envío con UPDATE condicional (tomar) y bloqueo de la fila |
| Cache del tipo de cambio | Inofensivo: cada instancia guarda el mismo dato público | — |
Archivo de log spring.log |
Medido: las dos escriben el mismo archivo en %TEMP%, y logback falló al rotarlo (Failed to rename file … spring.log) |
Ninguna |
4. ¿Es stateless?¶
Las peticiones HTTP sí, por diseño:
// seguridad/SecurityConfig.java:99
.sessionManagement(s -> s.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
No hay HttpSession. Cada petición trae su JWT, firmado por Keycloak, y cada instancia lo valida con la clave
pública, sin preguntarle a nadie. Quién vende o anula sale del token (jwt.getSubject(),
preferred_username), nunca de memoria. En la prueba, las dos instancias respondieron 401 por su cuenta. Ningún
servicio guarda datos de un usuario en un campo entre peticiones. Los campos son dependencias final.
El proceso no es stateless del todo. EnvioSunatService guarda estado de negocio en memoria
(private volatile String envioDetenido) y tiene su propia cola. Para un solo servidor es correcto y simple.
Para dos, ese estado tendría que estar en Oracle.
5. ¿El dominio justifica hexagonal o Clean Architecture?¶
| Módulo | Complejidad real | ¿Aislar el dominio? |
|---|---|---|
catalogo |
CRUD con precio por margen y stock con bloqueo | No: la indirección no protegería ninguna regla |
ventas |
Agregado real: Venta–DetalleVenta con total, IGV, topes, stock, anulación definitiva y fecha pasada con permiso |
Todavía no. Sus reglas dependen de fachadas de 5 módulos; primero hay que separar sus interfaces (hallazgo de S3) |
facturacion |
El más complejo: UBL 2.1, firma, plazo de 3 días, reemplazos, notas de crédito, ambiente inmutable, y una infraestructura que cambia (simulado, beta, producción) | Sí, y ya está hecho donde importa. OseClient es un puerto con dos adaptadores; la regla "solo direcciones oficiales" está en su propia clase (AmbienteSunat), con su propia prueba (AmbienteSunatTest). Llevarlo más lejos (UBL independiente de JAXB) no tiene hoy un segundo uso que lo justifique |
Valdría la pena aislar más el dominio de ventas si JD vendiera por un segundo canal, como una tienda web o WhatsApp con pedidos. Las mismas reglas tendrían que servir a dos entradas distintas.
6. Conclusión: confirmación con un hallazgo¶
Se confirma el monolito modular para JD: dos usuarios, una PC o un servidor, ACID entre 4 módulos sin esfuerzo, y ADP verificado en cada compilación. Microservicios cambiarían una transacción por una Saga sin ningún beneficio para este volumen.
Hallazgo: la escalabilidad horizontal estaba "confirmada" en papel (sin sesión, JWT), pero la prueba real
mostró que solo la capa web escala. Las tareas programadas y el estado de EnvioSunatService suponen una
sola instancia, y con dos se duplica el trabajo (50 % medido). También se podría enviar dos veces a SUNAT y
seguir enviando con credenciales rechazadas.
Decisión (ADR-S4-01): SGE-JD se despliega con una sola instancia del backend, que ya es lo que hacen
compose-prod.yml y la PC de JD. Esa restricción queda documentada. Si algún día hace falta una segunda, las
tareas tienen que coordinarse antes:
SELECT … FOR UPDATE SKIP LOCKEDal tomar comprobantes pendientes, para que cada instancia tome los suyos.envioDetenidoguardado en una tabla.- Un candado distribuido (ShedLock, sobre Oracle) para las tareas de las 8:00.
- Un archivo de log por instancia.
7. Integración con LP2 y BD2¶
| Criterio | Evidencia en LP2 | Relación con BD2 |
|---|---|---|
| Monolito modular, ADP | ModularityTests 2/2 |
Un esquema propietario, JDREFRIGERACION |
| ACID entre módulos | @Transactional en VentaService y @EventListener síncronos |
El correlativo se deshace con la transacción: 0 huecos |
| Escalabilidad horizontal | Dos instancias en 8081 y 8082 | El índice único UX_COMPROBANTE_VIGENTE_VENTA evitó 2 621 duplicados. La base es la última línea de defensa (igual que las CHECK de BD2 S1) |
| Stateless | SessionCreationPolicy.STATELESS, JWT |
— |
| Tareas en segundo plano | @Scheduled de facturación, postventa e inventario |
BD2 S4: el backend factura solo las ventas insertadas por PL/SQL |
8. Reflexión¶
¿Por qué una decisión arquitectónica tomada al inicio necesita revisarse con evidencia?
Porque al inicio se decide con lo que se sabe, y el sistema sigue creciendo. En S1, "stateless con JWT" parecía suficiente para decir que el backend escalaba. Pero después llegaron las tareas programadas de SUNAT y del correo, la cola de envíos y el aviso de credenciales rechazadas, y ninguna de esas piezas existía cuando se tomó la decisión. Solo al levantar dos instancias de verdad se vio que el 50 % del trabajo se duplicaba y que la integridad la estaba sosteniendo un índice de Oracle, no el diseño. La decisión de usar monolito modular sigue siendo correcta, pero ahora se sabe con precisión qué la sostiene y bajo qué condición dejaría de valer.