SGE-JD · Sistema de Gestión Empresarial¶
Sistema web de JD Refrigeración S.A.C. (Breña, Lima): proformas, ventas, compras, cobranza, facturación y postventa en un solo lugar. Es el Proyecto Integrador de ADS, BD2 y LP2 de la Universidad Peruana Unión, construido sobre la base académica BomERP.
Última revisión contra el código: 08/11/2026 (entrega de comprobantes por correo, ambiente de SUNAT declarado y prueba de integración real). Equipo CherryTree. Repositorio:
https://github.com/YWAGNERCS/proyecto-SAC— backend en la ramamaster, frontend en la ramafrontend. Lo que no coincide entre el código, esta documentación o la guía del curso está listado en 5. Por verificar.
Qué hay en esta documentación¶
| Sección | Contenido |
|---|---|
| 1. Documentación funcional | Objetivo, alcance, módulos, requerimientos (RF y RNF) y casos de uso |
| 2. Documentación técnica | Stack, migración a Spring Boot 4.0.7, arquitectura, modelo de datos, API, instalación y uso diario |
| 3. Manual de usuario | Cómo se opera cada pantalla y preguntas frecuentes |
| 4. Estado y trazabilidad | Fases del proyecto, pendientes, equipo y avance por sesión de LP2 |
| 5. Por verificar | Lo que falta o no coincide, ordenado por importancia |
| Matriz de trazabilidad (RTM) | Cada requisito de punta a punta: arquitectura, base de datos, API, pantalla y prueba |
| ADS | Diseño técnico, sesiones S1 a S14: visión, C4, SOLID, dominio, UML, patrones, integración con SUNAT, auditoría de consistencia y ADR |
| BD2 | Base Oracle, sesiones S1 a S14: PL/SQL, triggers, índices, roles, auditoría, particiones, RMAN y monitoreo, con salidas reales |
| LP2 | Producto de la Unidad II, optimización y producción (S13), integración y estabilización (S14) y la integración con BD2 y ADS |
| Qué hace hoy y qué todavía no | Para Lisandro y Lucy: lo que funciona de verdad, lo simulado y las decisiones pendientes |
Equipo CherryTree¶
| Integrante | Módulos | Transaccional (muchos a muchos) |
|---|---|---|
| Yoel Wagner Chambi Sirena | Proveedores, Proformas y Ventas | Proforma ↔ Producto (ItemProforma) · Venta ↔ Producto (DetalleVenta) |
| Wilson Ronald Apaza Mamani | Catálogo, Inventario, Compras y Postventa | Compra ↔ Producto (DetalleCompra) |
| Aron Rodrigo Magaño Quispe | Clientes, Facturación, Notificaciones y Cobranza | Cobro ↔ Venta (DetalleCobro) |
Cómo funciona el muchos a muchos¶
Cada muchos a muchos se resuelve con una tabla del medio: cada fila une un registro del lado A con uno del lado B y guarda sus propios datos.
| Integrante | Lado A | Tabla del medio | Lado B | Dato propio |
|---|---|---|---|---|
| Yoel | Proforma | ItemProforma |
Producto | cantidad, precio, descuento |
| Yoel | Venta | DetalleVenta |
Producto | cantidad, precio, descuento |
| Wilson | Compra | DetalleCompra |
Producto | cantidad, precio de compra |
| Aron | Cobro | DetalleCobro |
Venta | monto abonado |
Por ejemplo, una venta lleva varios productos y un mismo producto aparece en varias ventas; cada línea de DetalleVenta es "esta venta + este producto, tantas unidades, a tal precio". La de Aron une cobros con ventas: un cobro puede pagar varias ventas y una venta puede recibir varios cobros. Diagrama y ejemplo completo en Relaciones muchos a muchos.
Tecnologías¶
Java 21 · Spring Boot 4.0.7 · Oracle 23 Free · Angular 22 · Keycloak 26.8 · Docker