5. Por verificar¶
Diferencias encontradas al comparar esta documentación, CONTEXTO.md, el código y la guía del curso. Ordenadas por importancia.
Seguridad¶
La API está abierta sin login.✅ Resuelto (18/10/2026, S10b): toda/api/v1/admin/**exige un JWT válido de Keycloak; se retiróapp.security.admin-requiere-login. Solo quedan abiertos el catálogo público y Swagger.- Credenciales en el historial de git (parcialmente resuelto, 05/11/2026). La contraseña de aplicación de Gmail (cuenta de Aron) se eliminó en Google: aunque aparezca en commits antiguos ya no sirve. Pendiente: regenerar el token de Decolecta si alguna vez se subió uno real. Como consecuencia, hoy no sale ningún correo (proformas, facturas, resumen diario) hasta configurar la cuenta de correo de la empresa en
application-local.properties. Roles sin efecto (RF-02).✅ Resuelto (18/10/2026): ver RF-02. Por confirmar con Lisandro: si Lucy debe ver costo y margen de los productos (hoy los ve).Usuarios de prueba.✅ Resuelto en parte (18/10/2026): cuentaslisandroylucyen Keycloak (correos.test; contraseñas en.env, ver 6b). Cada venta guarda quién la registró (vendedor_id=sub,vendedor_nombre). Falta registrar el autor en compras, cobros y anulaciones.La SPA guarda el token Basic en✅ Resuelto (18-19/10/2026): login Authorization Code + PKCE (S256); el access token (5 min) y el refresh token viven en memoria con una copia enlocalStoragesessionStorage(sobrevive un F5, se borra al cerrar la pestaña) y se renuevan solos. Direct access grants desactivado enbomerp-frontend; los scripts de prueba usan su propio cliente,sgejd-pruebas. Nota: Spring acepta 60 s de tolerancia de reloj sobre elexp.-
✅ Ya no aplica (25/10/2026): el backend dejó de servir la documentación en/docsquedará bloqueado al activar el login./docs; ahora vive en la carpetadocs/del repositorio y se publica en https://ywagnercs.github.io/proyecto-SAC/.SecurityConfigsolo deja abierto/images/**(el logo de la factura y del correo).6b.
Contraseñas de desarrollo en el repositorio.✅ Resuelto (25/10/2026, auditoría A9): todas las contraseñas salen debomerp-backend/.env(en.gitignore; plantilla.env.example):docker-compose.yml,configurar_realm.pyypruebas-seguridad/las leen de ahí, yrealm-bomerp.jsonya no trae hashes. Se cambiaron las delisandro,lucyy la consola de Keycloak; el realm tiene protección contra fuerza bruta (5 intentos, espera de 1 a 15 min) y política de contraseñas (10 caracteres, distinta del usuario y del correo), y los puertos de Docker (Oracle 1522, Postgres 35432, Keycloak 38080) solo escuchan en127.0.0.1. También se cambiaron las contraseñas de Oracle (SYS, SYSTEM, PDBADMIN y JDREFRIGERACION) y del Postgres de Keycloak; las viejas quedan en el historial de git, pero ya no sirven. Al instalar en el cliente, poner contraseñas propias en su.env.
Funcionalidad¶
El reporte✅ Resuelto (13/10/2026):ventas-resumencuenta ventas anuladas.ventas-resumen,cobranzay/ventas/pagos-atrasadossolo consideran ventas REGISTRADAS.Al anular una venta no se cancelan sus mantenimientos ni se genera nota de crédito.✅ Resuelto (13/10/2026): Postventa cancela los mantenimientos PENDIENTES y Facturación emite la nota de crédito (serie FC01/BC01, correlativo por serie) si el comprobante fue aceptado.Producto sin categoría.✅ Resuelto (13/10/2026):Productotiene@ManyToOne Categoria; la API exige la categoría al crear/editar (404 si no existe) y no deja borrar una categoría con productos (409). Verificado el 25/10/2026: ningún producto queda sin categoría.Pantalla de productos en la SPA.✅ Resuelto (13/10/2026): productos con filtro por categoría, y clientes y proveedores con formulario y búsqueda RUC/DNI en la SPA.Autocompletado RUC/DNI simulado.✅ Resuelto (13/10/2026): proveedor principal apis.net.pe v1 (sin token), respaldo Decolecta conDECOLECTA_TOKEN(RUC por SUNAT, DNI por RENIEC) y modo simulado solo conCONSULTA_DOCUMENTOS_SIMULADO=true. ⚠️ La v1 limita las consultas seguidas (429): se responde 503 "intente en unos segundos" y se recomienda registrar un token gratuito de Decolecta como respaldo. La API oficial de RENIEC (PIDE) requiere convenio institucional y no está disponible para el proyecto.Correlativo de comprobantes aleatorio.✅ Resuelto (15/10/2026): cada serie (F001, B001, FC01, BC01) numera 00000001, 00000002… sin saltos ni repetidos, con un contador por serie (SERIES_COMPROBANTE) bloqueado durante la venta y la restricción única (serie, número). Probado con 5 ventas simultáneas: números consecutivos, 0 repetidos. Las bases existentes deben corrermigracion_correlativos.sqluna vez (renumera los comprobantes ya emitidos).-
WhatsApp simulado:
NotificadorSimuladosolo escribe en el log.13b. Facturación electrónica (06/11/2026): envío directo a SUNAT probado en beta. Con
app.facturacion.modo=sunat, SGE-JD arma el XML UBL 2.1 (xbuilder de OpenUBL), lo firma con el certificado de JD y lo envía a SUNAT (sendBill); en beta fueron aceptadas facturas, boletas y notas de crédito, y un rechazo real (3034, falta la cuenta de detracciones) quedó registrado con su motivo. Ver Facturación electrónica: envío directo a SUNAT en la documentación técnica. Pendiente para producción: usuario SOL secundario, Certificado Digital Tributario, series y cuenta de detracciones (decisiones de Lisandro y su contador). Ambiente (08/11/2026): se declara enSUNAT_AMBIENTE(PRODUCCION o BETA, obligatorio) y solo se aceptan las direcciones oficiales de SUNAT; queda registrado e inmutable en cada comprobante aceptado y solo PRODUCCION se envía por correo al cliente.13c.
Correo sin configurar.✅ Listo para usar (08/11/2026): la entrega de facturas y boletas al cliente (PDF + XML firmado) tiene seguimiento, reintentos y reenvío en Ventas. Solo falta la cuenta de correo de la empresa (MAIL_USERNAME/MAIL_PASSWORD); la Gmail de prueba de Aron se revocó el 05/11/2026. 14. Mantenimientos solo para CLIMATIZACIÓN y REFRIGERACIÓN. Confirmar con el cliente si VENTILACIÓN FORZADA también los requiere. 15.Alerta de stock mínimo sobre todos los productos.✅ Resuelto (15/10/2026): las alertas (pantalla y correo diario) consideran solo materiales (MATERIAL_SERVICIO); los equipos no controlan stock y ya no generan alertas falsas. 16.Proformas vencidas sin programar.✅ Resuelto (15/10/2026):ProformaScheduledServicevence las proformas PENDIENTES todos los días a las 00:05 y también al iniciar el backend (por si estuvo apagado). Ejecución manual:POST /proformas/marcar-vencidas. 17.Moneda mixta.✅ Resuelto y ampliado (15/10/2026): cada venta y proforma elige su moneda (soles o dólares) y los productos en la otra moneda se convierten con el tipo de cambio, que queda guardado en la venta/proforma. Ver RF-18. 18.✅ Resuelto (13/10/2026): ahora pasa porProductoControllerusa el repositorio directamente.ProductoServicey responde conProductoResponseDTO.
Arquitectura y alineamiento con el curso¶
- Versión de Spring Boot. ✅ Migrado de 3.3.4 a 4.0.7 (22/10/2026), la versión que fija la guía del curso (ADR-003). Ver Migración a Spring Boot 4.0.7 en la sección 2.
Spring Modulith no está implementado.✅ Resuelto (31/10/2026): Spring Modulith 2.0.7 yModularityTestsverifican los límites entre módulos y la ausencia de ciclos en cadamvn test(ver Límites entre módulos en la sección 2).Límites entre módulos incumplidos.✅ Resuelto (31/10/2026): Facturación, Reportes y Rentabilidad usan fachadas de servicio en vez de repositorios ajenos; Ventas avisa a Facturación y Postventa con eventos. Queda como opción repartir los reportes por módulo.- Esquemas Oracle por módulo. El curso propone esquemas
BOM_CATALOGO,BOM_VENTAS, etc.; aquí todo está en un solo esquema (JDREFRIGERACION), yCONTEXTO.mdmencionaba un prefijoJD_<MODULO>que no se usa. - Paquete raíz. Documentaciones anteriores decían
com.jdrefrigeracionope.edu.upeu.sgejd; el real escom.bomerp. Seguridad con Keycloak sin responsable.✅ Hecho (18/10/2026): Keycloak 26.8 + Postgres endocker-compose.yml, backend como Resource Server y SPA adaptada. Confirmar con el docente que la ruta S10b es válida para la evaluación de S10 (la guía S10b dice que no se evalúa). S11 hecho (19/10/2026): login con redirección y PKCE, y Direct access grants desactivado (ver punto 5).-
Cobranza por separar.✅ Resuelto (15/10/2026): paquetecobranzaconCobro–DetalleCobro, abonos parciales y saldos; usa Ventas solo por su fachada (listarPendientesDeCobro,obtenerPorIdPublico,marcarComoPagada). (a) ✅ Resuelto (25/10/2026, A8): anular una venta que el cliente ya pagó (al contado o con abonos) avisa el monto antes de confirmar y deja una devolución PENDIENTE en Cobranza › Devoluciones; el ADMIN registra cuándo y cómo se devolvió. Ventas publicaVentaAnuladaEventy Cobranza lo escucha en la misma transacción, así Ventas no depende de Cobranza. (b) ✅ Resuelto (25/10/2026, A7): se retiróPOST /ventas/{id}/marcar-pagada, que también podía llamar ASISTENTE y marcaba PAGADA sin cobro; una venta solo pasa a PAGADO por sus abonos. Pendiente: (c)/reportes/cobranzasigue enreportes.25b.
Topes de descuento por confirmar.✅ Resuelto (08/11/2026): el administrador los fija en Configuración › Topes de descuento (tablaTOPES_DESCUENTO; no se delega y queda en el historial). Mientras no los cambie valen 30 % (administrador y "Descuento ampliado") y 10 % (asistente). 26. Migración de base de datos para Proformas. Cada integrante debe ejecutarmigracion_proforma.sqlen su Oracle local antes de arrancar el backend nuevo; si no, Hibernate crea tablasPROFORMASvacías. 27. Herramienta de modernización:C:\SGE-JD\.github\modernize\(fuera de los repositorios) registra un intento de migrar a Java 25 / Boot 3.5.16 que no se aplicó. Se puede borrar. -
Datos de JD en el PDF del comprobante.✅ Resuelto (15/10/2026): la factura/boleta y la proforma imprimen la razón social, el RUC (20521632268) y la dirección reales de JD, configurados enapplication.properties(app.empresa.*, claseEmpresaProperties). Se quitó el teléfono de ejemplo. Pendiente: teléfono y correo de la empresa, en espera de que Lisandro los confirme. - Compras y stock de equipos (corregido 13/10/2026). Las compras subían el stock de todos los productos, incluidos los equipos, mientras las ventas solo descontaban materiales. Ahora las compras también suben solo el stock de materiales.
Pruebas y configuración¶
Pruebas automatizadas casi inexistentes.✅ Resuelto (31/10/2026): 61 pruebas unitarias de reglas de negocio (cobranza, cuentas por pagar, ajustes, detracción, agenda, permisos, historial, rentabilidad, compras) másProductoCrudTest; ver "Pruebas automáticas" en la documentación técnica. Pendiente: pruebas de controladores (@WebMvcTest) para la seguridad por rol, hoy cubierta por05_matriz.ps1.- H2 incluido pero sin perfil. La dependencia está en el
pom.xml, pero no hay configuración H2 activa (se eliminóapplication-test.properties, que solo cambiaba el puerto). Paquete de arreglos 2 sin aplicar.Ya no existe la carpetaClaude/arreglos2. De lo que traía, el correlativo secuencial se hizo aparte (punto 12); siguen pendientes las pruebas de ventas (punto 28) y los límites entre módulos (punto 21).- Contenedor Docker: la documentación anterior lo llamaba
SGE-DJ; el real esSGE-JD. El volumensge-jd-oracle-dataestá marcado comoexternalendocker-compose.yml, así que debe existir antes dedocker compose up. - Requisitos "16 RF consolidados en 8": la documentación anterior lo decía, pero no existe esa versión consolidada. Confirmar si hay otro documento con los 8 RF.
✅ Resuelto (05/11/2026, S13): las 7 clases que lo usaban (las 5 anotadas másSystem.outen vez de loggerFacturacionServiceyProformaService) usan SLF4J, así que el nivel de cada perfil (logback-spring.xml) también las controla. El WhatsApp simulado, que escribía el teléfono y el mensaje del cliente, quedó en DEBUG: no sale en el log de producción.-
Algunos controllers todavía responden entidades: Categoría, Cliente y Proveedor (el resto ya usa DTO).
34b.
La SPA todavía dice "BomERP".✅ Resuelto (25/10/2026): pestaña, títulos de las 25 rutas, menú (ícono "JD") e Inicio dicen SGE-JD, y el Inicio tiene accesos a Ventas, Proformas, Cobranza y Postventa. (bomerpsigue siendo el nombre técnico del realm y del cliente de Keycloak.) Pendiente: indicadores en el Inicio (ventas del mes, por cobrar, stock en alerta).34c.
Dependencias.✅ Resuelto (07/11/2026, auditoría B5): Angular y zod en versiones exactas sin avisos altos; la integración continua correnpm audit --audit-level=highen cada cambio del frontend.
Operación¶
- Base con datos simulados para la demostración (31/10/2026). Tiene un año ficticio (11/2025 → 10/2026) cargado por la API como lo harían Lucy y Lisandro: 34 clientes, 8 proveedores, 39 productos, 219 proformas, 224 ventas (3 anuladas con su devolución), cobros con detracción y retención, 48 compras con pagos, 58 órdenes de trabajo, mantenimientos, 5 contratos y ajustes de inventario. Las fechas se corrieron por SQL y las facturas se renumeraron por fecha. Antes de entregar:
restaurar_sgejd.batconrespaldos/sgejd_entrega_vacia_20261107.dmp(base vacía, series en 0). Es el respaldo vacío del 30/10 conmigracion_proforma_unica.sql,migracion_envio_sunat.sqlymigracion_compra_factura_unica.sqlaplicadas (07/11/2026, auditoría A10 y revisión externa) y, desde la noche del 07/11/2026, tambiénmigracion_comprobante_reemplazo.sql(comprobante de reemplazo e historial de envíos; la versión anterior quedó comosgejd_entrega_vacia_20261107_sin_reemplazo.dmp),migracion_quitar_usuarios.sql(26 tablas, sinUSUARIOS; la anterior quedó comosgejd_entrega_vacia_20261107_con_usuarios.dmp) ymigracion_venta_anulacion.sql(quién anuló y por qué; la anterior quedó comosgejd_entrega_vacia_20261107_sin_anulacion.dmp). Desde el 08/11/2026 incluye tambiénmigracion_costos_precios.sql(IGV de compras, último costo, precio editado yTOPES_DESCUENTO: 27 tablas; la anterior quedó comosgejd_entrega_vacia_20261107_sin_costos_precios.dmp) ymigracion_envio_correo.sql(ENVIOS_CORREOeINTENTOS_CORREO: 29 tablas; la anterior quedó comosgejd_entrega_vacia_20261107_sin_envio_correo.dmp) ymigracion_ambiente_emision.sql(ambiente de emisión y su disparador; la anterior quedó comosgejd_entrega_vacia_20261107_sin_ambiente.dmp). Restaurado en un esquema aparte: 0 diferencias con la base de desarrollo: el del 30/10 restauraba el esquema de ese día, sin las columnas de la respuesta de SUNAT ni el índice de proforma única. Se comprobó restaurándolo en un esquema aparte: 0 diferencias de columnas, índices y restricciones con la base actual. Si después se cambia el esquema, hay que volver a generarlo. Los datos de prueba anteriores siguen ensgejd_antes_de_entrega_20261030_2224.dmp. - Respaldo automático sin activar (⏳ pendiente). Los scripts están listos desde el 31/10/2026 (
programar_respaldo.bat, RNF-08), pero la tarea diaria no está programada: falta que Lisandro elija la carpeta fuera de la PC para la copia (USB, OneDrive o Google Drive de la empresa, o una carpeta de red). Mientras tanto, respaldo manual conrespaldar_sgejd.batal menos una vez por semana. Al decidir:programar_respaldo.bat -Destino "<carpeta>". Corregido el 11/11/2026 (revisión externa): antes respaldaba solo la base de desarrollo, su rotación podía borrar los respaldos manuales y, al ejecutarse solo, fallaba siempre (el primer aviso de docker en stderr lo cortaba); ahora toma la de producción si está encendida y rota solo los diarios de cada entorno. - Un error 500 sin explicar (25/10/2026). Crear una venta falló una vez, sin guardar nada, en un backend que se había encendido justo después de cambiar las contraseñas de la base; no se pudo reproducir. Si vuelve a pasar, revisar la ventana "SGE-JD · Backend".
Tabla✅ Resuelto (07/11/2026, auditoría B7): estaba vacía y sin uso desde Keycloak (S10b).USUARIOSsin uso.migracion_quitar_usuarios.sqlla borra solo si está vacía y se puede ejecutar varias veces; aplicada en desarrollo. Producción nunca la tuvo (su esquema sale deesquema_jdrefrigeracion.sql) y el respaldo de entrega se regeneró sin ella.- Costos y márgenes visibles para asistentes (revisión externa, 05/11/2026). El reporte de Rentabilidad es solo de ADMIN o
PERM_VER_RENTABILIDAD, peroGET /api/v1/admin/productosdevuelvecostoBaseymargenPorcentajea cualquier usuario. Si Lisandro decide que sean privados, hay que quitarlos de la respuesta en el backend según el permiso (ocultarlos solo en la pantalla no basta). Costo de compra sin actualizar (revisión externa, 05/11/2026).✅ Resuelto (08/11/2026, auditoría M1 y M2): decidido con el cliente: el precio de venta no cambia solo. La compra guarda el último costo sin IGV en el producto; Ventas y Proformas avisan si supera el costo del catálogo y permiten editar el precio de la línea (solo subir, con motivo, ADMIN oPERM_EDITAR_PRECIO), con las dos cifras guardadas y el registro en el historial; la rentabilidad usa ese costo. Las compras separan subtotal e IGV.Listados sin paginación (revisión externa, 05/11/2026).✅ Resuelto (05/11/2026): las pantallas de Ventas, Proformas y Compras piden de a 20 (o 50 / 100) conGET /ventas/pagina,/proformas/paginay/compras/pagina(paginadesde 0,tamanomáximo 100; respuestaPagina: contenido, pagina, tamano, total, totalPaginas). En Proformas y Compras pagina la base de datos; en Ventas el servidor además calcula los totales por moneda y las anuladas de todo el filtro, así los indicadores no cambian al paginar. La respuesta de Ventas bajó de 194 KB a 16 KB. Los listados completos (GET /ventas,/proformas,/compras) se mantienen para el tablero, los avisos y los formularios que los usan.Stock y conversiones sin bloqueo (revisión externa, 05/11/2026).✅ Resuelto: cantidades sumadas por producto, bloqueo de filas en productos, proformas, ventas (cobros) y compras (pagos), e índice único enventas.proforma_id. Ver Stock y operaciones simultáneas.