4. Estado y trazabilidad del proyecto¶
Fases de ingeniería de software¶
| # | Fase | Estado |
|---|---|---|
| 1 | Inicio y planificación | ✅ Completo |
| 2 | Levantamiento de información | ✅ Completo (pendiente confirmar con Lucy el formato exacto de envío a SUNAT) |
| 3 | Análisis de requisitos | ✅ 16 RF originales + RF-17 a RF-35 (anulación, moneda, descuentos, cobranza, postventa, devoluciones, anulación de cobros, detracción y retención, órdenes de trabajo, equipos instalados, contratos, permisos delegables, historial de cambios, cuentas por pagar, ajustes de inventario, rentabilidad, agenda de técnicos, orden por columna y cliente nuevo desde la venta) |
| 4 | Modelado de procesos (BPMN AS-IS/TO-BE) | ✅ 2 procesos en BPMN 2.0 (docs/diagramas/); los AS-IS son borrador con supuestos S1–S9 por confirmar con el cliente |
| 5 | Análisis del sistema (casos de uso UML) | ✅ CU-01 a CU-11 y diagrama de casos de uso |
| 6 | Diseño del sistema (C1–C4, SOLID, BD) | ✅ Completo, con diagrama de clases del dominio (UML) |
| 7 | Desarrollo | 🔄 Backend y SPA operativos en todos los módulos, con Spring Boot 4.0.7 y Keycloak, más la entrega de comprobantes por correo con seguimiento (08/11/2026). Simulados: WhatsApp y, hasta tener las credenciales de JD, el envío real a SUNAT (probado en beta) y el correo (falta la cuenta de la empresa). Pendiente repartir reportes entre módulos |
| 8 | Pruebas y validación | ✅ 215 pruebas JUnit (171 en la integración continua de GitHub) y 33 del frontend, matriz de seguridad 14/14 y una prueba de integración real (migraciones sobre respaldos reales y correo de punta a punta, 08/11/2026: PRUEBA_INTEGRACION_CORREO.md) |
| 9 | Implementación/despliegue | 🔄 Instalación local en una PC, con arranque, apagado, respaldo y limpieza de un clic (scripts/, 25/10/2026). Configuración de producción verificada de punta a punta en contenedores (perfil prod, imagen Docker del backend, Oracle y Keycloak propios, SPA en nginx): PRODUCCION_LOCAL.md y S13 (05/11/2026). Pendiente el servidor de JD y HTTPS |
| 10 | Documentación técnica | ✅ Este documento, CONTEXTO.md, los README.md y lp2-demo.md, publicados en https://ywagnercs.github.io/proyecto-SAC/ |
| 11 | Manual de usuario | 🔄 Sección 3 y hoja para el cliente LIMITACIONES.md (actualizada el 08/11/2026); falta un manual con capturas por pantalla |
| 12 | Trazabilidad (RTM) | ✅ RTM.md: RF-01 a RF-35 y RNF-01 a RNF-09 con arquitectura, base de datos, API, pantalla y prueba; pruebas que faltan registradas (07/11/2026). Integración y estabilización (S14, LP2): S14_integracion_estabilizacion.md; ADR-006, atributos de calidad y trazado de punta a punta (S14, ADS): S14_ADS_decisiones_trazabilidad.md |
| 13 | Mantenimiento y evolución | ✅ Git/GitHub (YWAGNERCS/proyecto-SAC, con topics) y publicación automática de la documentación |
Avances del 07 y 08/11/2026¶
| Tema | Qué se hizo | Dónde |
|---|---|---|
| Facturación SUNAT | Plazo de 3 días, comprobante de reemplazo para rechazos con CDR, historial de envíos, receptor fijo al emitir, ventas "por emitir" sin cuenta de detracciones, envíos detenidos si SUNAT rechaza el usuario SOL | FACTURACION_SUNAT.md |
| Entrega de comprobantes por correo | PDF + XML firmado al cliente solo con validez tributaria; seguimiento en ENVIOS_CORREO e INTENTOS_CORREO; reintentos, reenvío con confirmación, estado INCIERTO ante una caída, conciliación de eventos perdidos y sin duplicados entre automático y manual; XML validado con un analizador seguro |
FACTURACION_SUNAT.md, sección 5 |
| Ambiente de SUNAT | Registrado e inmutable en cada comprobante; SUNAT_AMBIENTE obligatorio y solo direcciones oficiales (el backend no arranca con un intermediario o una dirección que no corresponde) |
(13b) |
| Auditoría (M1–M4, B5–B10, M9) | Precio editable con motivo y último costo de compra; IGV de compras; ventas con fecha pasada (permiso delegable); anulación con motivo y quién; topes de descuento editables por el administrador; dependencias fijadas; tabla USUARIOS retirada; validación de la venta directa |
AUDITORIA_SGE-JD_2026-11-07.md (fuera del repositorio) |
| Integración continua | GitHub Actions: backend (pruebas sin Oracle), frontend (auditoría de dependencias, compilación de producción y pruebas) y esta documentación | Integración continua en 2. Documentación técnica |
| Prueba de integración real | Migraciones sobre un respaldo con datos y sobre el de producción, y correo de punta a punta con el backend real, la beta de SUNAT y un servidor SMTP local | PRUEBA_INTEGRACION_CORREO.md |
Avances del 05/11/2026¶
| Tema | Qué se hizo | Dónde |
|---|---|---|
| Revisión externa: stock y operaciones simultáneas | Cantidades sumadas por producto y bloqueo de filas: dos ventas al mismo tiempo ya no dejan el stock en negativo, una proforma no se convierte dos veces (índice único UX_VENTAS_PROFORMA) y un cobro no se registra dos veces. Probado con peticiones en paralelo: 8 ventas con stock 4 → 4 aceptadas y 4 rechazadas (409), stock final 0 |
Stock y operaciones simultáneas en 2. Documentación técnica, (42) |
| Paginación | Ventas, Proformas y Compras se cargan de a 20, 50 o 100; los totales de Ventas se calculan en el servidor sobre todo el filtro. La respuesta de Ventas bajó de 194 KB a 16 KB | (41) |
| Credenciales | La contraseña de Gmail que quedó en el historial de git se revocó; hasta configurar la cuenta de la empresa no sale ningún correo | (2) |
| Pruebas automáticas | 72 pruebas JUnit, todas pasan (6 nuevas de stock) | Pruebas automáticas en 2. Documentación técnica |
| LP2 S13: preparación para producción | Perfiles dev/prod, logging por perfil, Actuator mínimo y protegido, Cache-Control en el tipo de cambio, Redis descartado con medición, imagen Docker del backend, Oracle y Keycloak propios de producción y el frontend compilado en nginx, verificado de punta a punta |
PRODUCCION_LOCAL.md, S13 |
| Logger | Las 7 clases con System.out pasaron a SLF4J; el WhatsApp simulado ya no escribe datos del cliente en el log de producción |
(33) |
Ideas (por decidir)¶
Instalar en la PC de JD sin Python: Keycloak que se configura solo. Hoy Keycloak arranca vacío y lo llena
keycloak/configurar_realm.py (realm, roles, permisos, clientes, cuenta de servicio y usuarios). Ese script
necesita Python, que la PC de JD probablemente no tenga.
- Propuesta: que Keycloak importe al arrancar un JSON con todo el realm (
--import-realm, como ya hace dev conrealm-bomerp.json). Las claves y el secreto de la cuenta de servicio irían como variables (${SGEJD_CLAVE_LISANDRO},${KC_BACKEND_SECRET}), que Keycloak lee del.enval importar: no quedan escritas en el archivo. No hace falta ningún lenguaje, ni Python ni Java. - Junto con eso: pasar
generar_env_prod.pya PowerShell (viene con Windows) y compilar el frontend dentro de Docker (Dockerfile de dos etapas, como el del backend). Así la PC de JD solo necesitaría Docker: instalarlo, copiar la carpeta y ejecutar un script. - Descartado: que el backend configure Keycloak al arrancar. Tendría que guardar la contraseña de administrador total de Keycloak, y si se compromete el backend se compromete el control de todos los usuarios.
- Sigue en Python solo lo de desarrollo:
sitio/armar.py(este sitio) ydocs/diagramas/generar_bpmn.py.
Pendientes (al 08/11/2026)¶
Resumen de lo que falta, según de quién depende. El detalle de cada punto está en 5. Por verificar (n.º entre paréntesis).
Depende del cliente (decisiones o contrataciones de Lisandro)
| Pendiente | Qué hace falta | Ref. |
|---|---|---|
| Facturación electrónica real | El envío directo a SUNAT ya funciona en beta. Falta que Lisandro cree un usuario SOL secundario (solo comprobantes electrónicos), saque el Certificado Digital Tributario y confirme series y la cuenta de detracciones. Al configurarlo: SUNAT_AMBIENTE=PRODUCCION con la dirección oficial |
(13b) |
| Acceso desde otra PC o desde el celular | Contratar un servidor o VPS con HTTPS; al instalarlo, eliminar el cliente sgejd-pruebas de Keycloak |
— |
| Respaldo automático diario | Elegir la carpeta fuera de la PC (USB, OneDrive o Google Drive de la empresa, red) y ejecutar programar_respaldo.bat -Destino |
(36) |
| AS-IS de los procesos | Confirmar los supuestos [S1]–[S9] de los diagramas BPMN | Modelado de procesos |
| Correo de la empresa | Cuenta para enviar facturas, boletas y proformas (MAIL_USERNAME/MAIL_PASSWORD). La entrega con seguimiento ya está lista; sin la cuenta no sale ningún correo |
(13c) |
| WhatsApp real | Cuenta de WhatsApp Business API (pagada); hoy el envío de proformas por WhatsApp es simulado | (13) |
| ✅ Ya no hace falta confirmarlos: Lisandro los fija en Configuración › Topes de descuento (08/11/2026) | (25b) | |
| Costos visibles para Lucy | Decidir si Lucy debe ver costo y margen en la lista de productos | — |
| Mantenimiento de ventilación forzada | Confirmar si también lleva mantenimiento preventivo | (14) |
| Datos de contacto | Teléfono, correo y web de la empresa para facturas, proformas y el pie del correo del comprobante (EMPRESA_TELEFONO, EMPRESA_CORREO, EMPRESA_WEB; vacíos no se muestran) |
— |
Depende del equipo (se puede hacer sin esperar al cliente)
| Pendiente | Qué hace falta | Ref. |
|---|---|---|
| Credenciales en el historial de git | Gmail ya revocada (05/11/2026). Falta regenerar el token de Decolecta si alguna vez se subió uno real | (2) |
| Costos y márgenes visibles para asistentes | Si deben ser privados, filtrarlos en el backend (hoy GET /productos los devuelve a todos; solo el reporte de Rentabilidad está protegido) |
(39) |
| ✅ Resuelto (08/11/2026): último costo de compra sin IGV, aviso en la venta y precio editable | (40) | |
| Pruebas de seguridad en JUnit | @WebMvcTest por rol y permiso (hoy solo pruebas-seguridad/05_matriz.ps1) |
(28) |
| DTO en todos los controladores | Categoría, Cliente y Proveedor todavía responden la entidad | (34) |
| Perfil de pruebas con H2 | Configurarlo o quitar la dependencia del pom.xml |
(29) |
| ✅ Resuelto (07/11/2026): versiones fijadas; la integración continua falla si aparece una vulnerabilidad alta | (34c) | |
| Esquemas Oracle por módulo | Decidir si se separa JDREFRIGERACION en esquemas como propone el curso |
(22) |
Antes de entregar el sistema al cliente
- Restaurar la base vacía
sgejd_entrega_vacia_20261107.dmp: hoy tiene datos simulados para la demostración (35). Luego Lisandro carga su catálogo, clientes y proveedores. - Stock inicial con un conteo físico: Inventario › Ajustes de inventario › "+ Conteo físico".
- Lisandro y Lucy cambian su contraseña (Configuración › "Cambiar mi contraseña").
- Activar el respaldo automático (cuando esté elegida la carpeta).
- Configurar el correo de la empresa (
MAIL_USERNAME/MAIL_PASSWORDen.env.prod) y, al pasar a SUNAT real,SUNAT_AMBIENTE=PRODUCCIONcon la dirección oficial (FACTURACION_SUNAT.md). - Primer día: una venta propia con el correo de Lisandro como cliente, para ver llegar la factura (también en spam).
Equipo y responsables¶
Equipo CherryTree.
| Integrante | Módulos a cargo | Transaccional (muchos a muchos, con su tabla intermedia) |
|---|---|---|
| Yoel Wagner Chambi Sirena | Proveedores, Proformas, Ventas | Proforma ↔ Producto (ItemProforma) · Venta ↔ Producto (DetalleVenta) |
| Wilson Ronald Apaza Mamani | Catálogo, Inventario, Compras, Postventa | Compra ↔ Producto (DetalleCompra) |
| Aron Rodrigo Magaño Quispe | Clientes, Facturación, Notificaciones, Cobranza | Cobro ↔ Venta (DetalleCobro) |
Cómo funcionan estas relaciones: ver Relaciones muchos a muchos.
Seguridad: Keycloak, integrado en S10b (backend como Resource Server y login de la SPA).
Avance según las sesiones de LP2¶
| Sesión | Tema | Estado en el proyecto |
|---|---|---|
| S1–S5 | Backend REST, CRUD, relaciones, cabecera-detalle, reportes, CORS | ✅ CRUD de producto y relación Categoría–Producto completos (13/10/2026) |
| S7 | SPA Angular: layout, rutas, servicios HTTP | ✅ |
| S8 | CRUD de tablas dependientes | ✅ Productos con categoría, categorías, clientes y proveedores (con búsqueda RUC/DNI) y compras |
| S9 | Formulario transaccional cabecera-detalle | ✅ Venta directa con FormArray, reporte filtrable y anulación; el mismo patrón en Proforma, Compra y "Registrar cobro" |
| S10 | Seguridad backend con roles | ✅ Ruta Keycloak (S10b, 18/10/2026): Resource Server, reglas por rol, GET /api/v1/auth/perfil, matriz de 14 casos (pruebas-seguridad/) |
| S11 | Seguridad frontend (guards, interceptores, 401/403) | ✅ 19/10/2026: login Authorization Code + PKCE, /auth/callback, authGuard (lleva a Keycloak) y rolGuard('ADMIN') (lleva a /sin-permiso), interceptor que refresca una vez ante 401 y no ante 403, menú por rol. Token en memoria con copia en sessionStorage |
| S12 | Evaluación de la Unidad II | ✅ 25/10/2026: lp2-demo.md publicado, presentación del PI (alcance, arquitectura y asignación), guion y demo preparados |
| S13 | Optimización y preparación para producción | ✅ 05/11/2026: lazy loading y presupuestos, caché del navegador, Redis descartado con medición, logs y Actuator por perfil, producción local en el 4300 (S13, producción local) |
| S14 | Integración y estabilización | ✅ 07/11/2026: totales del servidor, checklist de integración, auditoría, prueba end-to-end real y bitácora (S14) |
| — | Integración con BD2 y ADS | ✅ 10–11/11/2026: migracion_bd2/ aplicada en desarrollo y producción (backend de producción como JD_APP), consultas de BD2 S4, MODULE/ACTION por operación, ADR-007 (Cobro.abonar()), ADR-008 (evento de anulación completo) y Circuit Breaker hacia SUNAT; 228 pruebas en verde |
| — | Diseño responsivo | ✅ 19/10/2026: celular, tablet y escritorio |