Saltar a contenido

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 con realm-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 .env al importar: no quedan escritas en el archivo. No hace falta ningún lenguaje, ni Python ni Java.
  • Junto con eso: pasar generar_env_prod.py a 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) y docs/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)
Topes de descuento ✅ 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)
Costo de compra ✅ 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)
Dependencias del frontend ✅ 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

  1. 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.
  2. Stock inicial con un conteo físico: Inventario › Ajustes de inventario › "+ Conteo físico".
  3. Lisandro y Lucy cambian su contraseña (Configuración › "Cambiar mi contraseña").
  4. Activar el respaldo automático (cuando esté elegida la carpeta).
  5. Configurar el correo de la empresa (MAIL_USERNAME/MAIL_PASSWORD en .env.prod) y, al pasar a SUNAT real, SUNAT_AMBIENTE=PRODUCCION con la dirección oficial (FACTURACION_SUNAT.md).
  6. 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