Saltar a contenido

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

  1. 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.
  2. 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.
  3. 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).
  4. Usuarios de prueba. ✅ Resuelto en parte (18/10/2026): cuentas lisandro y lucy en 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.
  5. La SPA guarda el token Basic en localStorage ✅ 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 en sessionStorage (sobrevive un F5, se borra al cerrar la pestaña) y se renuevan solos. Direct access grants desactivado en bomerp-frontend; los scripts de prueba usan su propio cliente, sgejd-pruebas. Nota: Spring acepta 60 s de tolerancia de reloj sobre el exp.
  6. /docs quedará bloqueado al activar el login. ✅ Ya no aplica (25/10/2026): el backend dejó de servir la documentación en /docs; ahora vive en la carpeta docs/ del repositorio y se publica en https://ywagnercs.github.io/proyecto-SAC/. SecurityConfig solo 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 de bomerp-backend/.env (en .gitignore; plantilla .env.example): docker-compose.yml, configurar_realm.py y pruebas-seguridad/ las leen de ahí, y realm-bomerp.json ya no trae hashes. Se cambiaron las de lisandro, lucy y 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 en 127.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

  1. El reporte ventas-resumen cuenta ventas anuladas. ✅ Resuelto (13/10/2026): ventas-resumen, cobranza y /ventas/pagos-atrasados solo consideran ventas REGISTRADAS.
  2. 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.
  3. Producto sin categoría. ✅ Resuelto (13/10/2026): Producto tiene @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.
  4. 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.
  5. Autocompletado RUC/DNI simulado. ✅ Resuelto (13/10/2026): proveedor principal apis.net.pe v1 (sin token), respaldo Decolecta con DECOLECTA_TOKEN (RUC por SUNAT, DNI por RENIEC) y modo simulado solo con CONSULTA_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.
  6. 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 correr migracion_correlativos.sql una vez (renumera los comprobantes ya emitidos).
  7. WhatsApp simulado: NotificadorSimulado solo 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 en SUNAT_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): ProformaScheduledService vence 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. ProductoController usa el repositorio directamente. ✅ Resuelto (13/10/2026): ahora pasa por ProductoService y responde con ProductoResponseDTO.

Arquitectura y alineamiento con el curso

  1. 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.
  2. Spring Modulith no está implementado. ✅ Resuelto (31/10/2026): Spring Modulith 2.0.7 y ModularityTests verifican los límites entre módulos y la ausencia de ciclos en cada mvn test (ver Límites entre módulos en la sección 2).
  3. 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.
  4. Esquemas Oracle por módulo. El curso propone esquemas BOM_CATALOGO, BOM_VENTAS, etc.; aquí todo está en un solo esquema (JDREFRIGERACION), y CONTEXTO.md mencionaba un prefijo JD_<MODULO> que no se usa.
  5. Paquete raíz. Documentaciones anteriores decían com.jdrefrigeracion o pe.edu.upeu.sgejd; el real es com.bomerp.
  6. Seguridad con Keycloak sin responsable. ✅ Hecho (18/10/2026): Keycloak 26.8 + Postgres en docker-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).
  7. Cobranza por separar. ✅ Resuelto (15/10/2026): paquete cobranza con Cobro–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 publica VentaAnuladaEvent y 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/cobranza sigue en reportes.

    25b. Topes de descuento por confirmar. ✅ Resuelto (08/11/2026): el administrador los fija en Configuración › Topes de descuento (tabla TOPES_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 ejecutar migracion_proforma.sql en su Oracle local antes de arrancar el backend nuevo; si no, Hibernate crea tablas PROFORMAS vací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.

  8. 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 en application.properties (app.empresa.*, clase EmpresaProperties). Se quitó el teléfono de ejemplo. Pendiente: teléfono y correo de la empresa, en espera de que Lisandro los confirme.

  9. 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

  1. 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ás ProductoCrudTest; ver "Pruebas automáticas" en la documentación técnica. Pendiente: pruebas de controladores (@WebMvcTest) para la seguridad por rol, hoy cubierta por 05_matriz.ps1.
  2. 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).
  3. Paquete de arreglos 2 sin aplicar. Ya no existe la carpeta Claude/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).
  4. Contenedor Docker: la documentación anterior lo llamaba SGE-DJ; el real es SGE-JD. El volumen sge-jd-oracle-data está marcado como external en docker-compose.yml, así que debe existir antes de docker compose up.
  5. 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.
  6. System.out en vez de logger ✅ Resuelto (05/11/2026, S13): las 7 clases que lo usaban (las 5 anotadas más FacturacionService y ProformaService) 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.
  7. 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. (bomerp sigue 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 corre npm audit --audit-level=high en cada cambio del frontend.

Operación

  1. 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.bat con respaldos/sgejd_entrega_vacia_20261107.dmp (base vacía, series en 0). Es el respaldo vacío del 30/10 con migracion_proforma_unica.sql, migracion_envio_sunat.sql y migracion_compra_factura_unica.sql aplicadas (07/11/2026, auditoría A10 y revisión externa) y, desde la noche del 07/11/2026, también migracion_comprobante_reemplazo.sql (comprobante de reemplazo e historial de envíos; la versión anterior quedó como sgejd_entrega_vacia_20261107_sin_reemplazo.dmp), migracion_quitar_usuarios.sql (26 tablas, sin USUARIOS; la anterior quedó como sgejd_entrega_vacia_20261107_con_usuarios.dmp) y migracion_venta_anulacion.sql (quién anuló y por qué; la anterior quedó como sgejd_entrega_vacia_20261107_sin_anulacion.dmp). Desde el 08/11/2026 incluye también migracion_costos_precios.sql (IGV de compras, último costo, precio editado y TOPES_DESCUENTO: 27 tablas; la anterior quedó como sgejd_entrega_vacia_20261107_sin_costos_precios.dmp) y migracion_envio_correo.sql (ENVIOS_CORREO e INTENTOS_CORREO: 29 tablas; la anterior quedó como sgejd_entrega_vacia_20261107_sin_envio_correo.dmp) y migracion_ambiente_emision.sql (ambiente de emisión y su disparador; la anterior quedó como sgejd_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 en sgejd_antes_de_entrega_20261030_2224.dmp.
  2. 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 con respaldar_sgejd.bat al 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.
  3. 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".
  4. Tabla USUARIOS sin uso. ✅ Resuelto (07/11/2026, auditoría B7): estaba vacía y sin uso desde Keycloak (S10b). migracion_quitar_usuarios.sql la borra solo si está vacía y se puede ejecutar varias veces; aplicada en desarrollo. Producción nunca la tuvo (su esquema sale de esquema_jdrefrigeracion.sql) y el respaldo de entrega se regeneró sin ella.
  5. 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, pero GET /api/v1/admin/productos devuelve costoBase y margenPorcentaje a 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).
  6. 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 o PERM_EDITAR_PRECIO), con las dos cifras guardadas y el registro en el historial; la rentabilidad usa ese costo. Las compras separan subtotal e IGV.
  7. 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) con GET /ventas/pagina, /proformas/pagina y /compras/pagina (pagina desde 0, tamano máximo 100; respuesta Pagina: 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.
  8. 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 en ventas.proforma_id. Ver Stock y operaciones simultáneas.