1. Documentación funcional¶
Objetivo general¶
Desarrollar e implementar un sistema integral web (ERP/CRM) para JD Refrigeración S.A.C., que centralice y automatice el catálogo de productos, el registro de clientes/proveedores, el flujo completo de proformas y ventas, y la postventa (mantenimientos preventivos), mejorando la eficiencia operativa y la atención al cliente.
Alcance del proyecto¶
Incluye:
- Catálogo de productos con soporte multimoneda (soles/dólares) y precio de venta calculado por margen porcentual sobre el costo.
- Clientes y Proveedores con autocompletado por RUC (SUNAT) y DNI (RENIEC) vía apis.net.pe v1; Decolecta como respaldo opcional.
- Proformas con exportación a PDF y envío por correo (SMTP).
- Ventas al contado o a crédito: venta directa (cabecera-detalle) y conversión desde una proforma aceptada; anulación con restauración de stock, nota de crédito y, si el cliente ya pagó, devolución pendiente del dinero.
- Facturación electrónica con correlativo real por serie y envío directo a SUNAT (SEE - Del Contribuyente) probado en el ambiente beta; en producción falta el usuario SOL y el certificado digital de JD. El ambiente (PRODUCCION o BETA) se declara en SUNAT_AMBIENTE y solo se aceptan las direcciones oficiales de SUNAT.
- Entrega de la factura o boleta por correo al cliente, con el PDF y el XML firmado, solo si tiene validez tributaria: seguimiento de cada envío e intento en Oracle, reintentos, reenvío manual y conciliación (ver FACTURACION_SUNAT.md, sección 5).
- Compras con el IGV separado y el último costo de compra en cada producto; precio de una línea editable al vender o cotizar (solo sube, con motivo y permiso); topes de descuento que fija el administrador.
- Postventa: mantenimientos preventivos con alertas automáticas (tarea programada diaria) y pantalla de agenda (vencidos, próximos, realizado, reprogramar).
- Inventario: descuento al vender, incremento al comprar y alertas de stock mínimo.
- Cobranza: ventas a crédito con su saldo, abonos parciales o totales (un pago puede repartirse entre varias ventas), historial de cobros y devoluciones de ventas anuladas.
- Consultas y reportes dentro de cada módulo: ventas (reporte filtrable, resumen por periodo), cobranza (pendientes y atrasadas) y proformas (pendientes).
- Panel administrativo web (SPA Angular, en bomerp-frontend) con inicio de sesión en Keycloak y permisos por rol.
Queda explícitamente fuera del alcance: - Módulo de planillas y recursos humanos. - Pasarelas de pago online (las ventas se registran como pagadas o a crédito, sin procesar pagos reales). - Control de GPS de los técnicos de mantenimiento.
Módulos (backend)¶
| # | Módulo | Tipo | Responsable | Estado |
|---|---|---|---|---|
| 1 | Catálogo (productos con categoría, categorías, catálogo público) | Maestro | Wilson | ✅ CRUD de productos con categoría (API y SPA) |
| 2 | Clientes (autocompletado RUC/DNI) | Maestro | Aron | ✅ CRUD con validación de RUC/DNI y duplicados; autocompletado real (apis.net.pe v1) en la SPA |
| 3 | Proveedores | Maestro | Yoel | ✅ CRUD con validación de RUC/DNI, duplicados (409) y correo; pantalla con búsqueda en SUNAT/RENIEC |
| 4 | Proformas (+ PDF, + envío por correo, descuento por línea) | Transaccional | Yoel | ✅ Estado CONVERTIDA con el N° de venta; el envío informa qué salió y qué no |
| 5 | Ventas (directa, desde proforma, crédito, anulación, descuento por línea) | Transaccional | Yoel | ✅ Al anular una venta pagada avisa el monto y deja la devolución en Cobranza |
| 6 | Compras (incrementa stock) | Transaccional | Wilson | ✅ Valida cantidades, precios y N° de factura; total calculado en el servidor; no acepta la misma factura dos veces |
| 7 | Inventario (alertas de stock mínimo) | Soporte | Wilson | ✅ |
| 8 | Postventa (cronograma preventivo automático) | Operativo | Wilson | ✅ Pantalla de agenda en la SPA |
| 9 | Facturación (Comprobante, XML UBL 2.1) | Integración | Aron | ⚠️ Correlativo real por serie; envío directo a SUNAT probado en beta (facturas, boletas y notas de crédito aceptadas) — faltan las credenciales reales de JD |
| 10 | Notificaciones (SMTP real + WhatsApp) | Integración | Aron | ⚠️ WhatsApp simulado |
| 11 | Cobranza (abonos a ventas a crédito, saldos, historial, devoluciones) | Transaccional | Aron | ✅ Cobro–DetalleCobro (15/10/2026); "Registrar cobro" con FormArray y devoluciones de ventas anuladas (25/10/2026); anulación de cobros por el ADMIN, voucher duplicado y quién registró (28/10/2026) |
| 12 | Seguridad (usuarios, roles, login) | Transversal | — (Keycloak) | ✅ Keycloak (S10b, 18/10/2026): realm bomerp, roles ADMIN/ASISTENTE; el backend es Resource Server y valida el JWT (RS256, issuer-uri) |
| 13 | Servicios técnicos (órdenes de trabajo, sedes, equipos instalados, contratos) | Transaccional | Por asignar | ✅ (28/10/2026) OrdenTrabajo–MaterialOrden, SedeCliente, EquipoInstalado y ContratoMantenimiento; detracción y retención en Ventas y Cobranza |
| — | Frontend (SPA Angular 22) | — | Cada responsable en su módulo | ✅ Operativa en todos los módulos, con login, roles y diseño responsivo (bomerp-frontend, rama frontend) |
Reportes: no son un módulo. Cada módulo expone sus consultas (decisión del equipo, alineada con el curso). Hoy
ventas-resumen,cobranzayproformas-pendientessiguen en el paquete transitorioreportes(ver 5).
Requerimientos Funcionales (RF)¶
| RF | Descripción | Estado real en el código |
|---|---|---|
| RF-01 | Autenticación: inicio de sesión con credenciales seguras. | ✅ La SPA redirige a la pantalla de login de Keycloak (Authorization Code + PKCE S256; sin formulario propio ni Direct access grants). Keycloak emite el JWT (RS256) y el backend lo valida; las contraseñas viven solo en Keycloak. |
| RF-02 | Roles y permisos: restringir módulos según el rol (Administrador, Asistente). | ✅ ADMIN (Lisandro) y ASISTENTE (Lucy). Catálogo: consultar cualquiera, modificar solo ADMIN; anular ventas, anular cobros, eliminar clientes/proveedores/sedes, cancelar órdenes de trabajo, crear o cancelar contratos y retirar equipos instalados: solo ADMIN; tope de descuento por rol. 401/403 en JSON. La SPA oculta lo que el rol no puede hacer. |
| RF-03 | Catálogo de productos: moneda dual y precio por margen porcentual. | ✅ Precio = costo base × (1 + margen %). CRUD completo de productos, cada uno con su categoría. |
| RF-04 | Autocompletado de clientes/proveedores por RUC/DNI vía API externa. | ✅ apis.net.pe v1 sin token (RUC → SUNAT, DNI → RENIEC), con respaldo en Decolecta si se configura DECOLECTA_TOKEN. Valida el formato (400), distingue "no existe" (404) de "servicio ocupado" (503) y guarda las consultas exitosas en memoria. |
| RF-05 | Proformas con cálculo automático de IGV y subtotales. | ✅ |
| RF-06 | PDF formal y corporativo de la proforma. | ✅ Se genera al enviar la proforma (no al guardar). |
| RF-07 | Envío de proformas por correo (SMTP). | ✅ POST /proformas/{id}/enviar; requiere credenciales SMTP configuradas. Las facturas y boletas aceptadas por SUNAT se envían solas al cliente con el PDF y el XML firmado, con seguimiento, reintentos y reenvío (08/11/2026; ver FACTURACION_SUNAT.md, sección 5). |
| RF-08 | Conversión de proforma aceptada en venta sin redigitar. | ✅ Valida que esté ACEPTADA (409); al convertirla pasa a CONVERTIDA y guarda el N° de venta, por lo que ya no se puede aceptar, rechazar, enviar ni convertir de nuevo. Respeta precios, tipo de cambio y descuentos de la proforma. |
| RF-09 | Control de créditos (contado/crédito, deudas pendientes y atrasadas). | ✅ Con saldo por venta (RF-20). |
| RF-10 | Facturación electrónica (estructura UBL 2.1). | ⚠️ Numeración real: correlativo por serie (F001, B001, FC01, BC01) sin saltos ni repetidos. Envío directo a SUNAT con XML UBL 2.1 firmado, probado en el ambiente beta; hasta tener el usuario SOL y el certificado de JD, los comprobantes no tienen validez tributaria. |
| RF-11 | Descuento de stock atómico al vender. | ✅ Solo materiales (MATERIAL_SERVICIO); si no alcanza → 409 y no se guarda nada. Los equipos no controlan stock. |
| RF-12 | Incremento de stock al registrar compras. | ✅ |
| RF-13 | Alertas de stock mínimo diarias. | ✅ 8:00 a. m., solo materiales, por correo a app.notificaciones.correo-oficina (si está vacío, no se envía). |
| RF-14 | Postventa: rutina de mantenimiento al vender equipos. | ✅ Botón "Implementar rutinas de mantenimiento" en Nueva venta y al convertir una proforma (07/11/2026): el vendedor elige cada cuántos meses (1 a 12), cuántas visitas (1 a 24) y la primera fecha. Solo para equipos de CLIMATIZACIÓN y REFRIGERACIÓN; sin rutina no se programa nada (antes eran siempre 4 visitas a los 3, 6, 9 y 12 meses). |
| RF-15 | Postventa: alertas de mantenimiento (8:00 a. m., próximos 7 días, correo a la oficina). | ✅ Si el correo falla, la alerta no se marca como enviada y se reintenta al día siguiente. |
| RF-16 | Reportes de ingresos y cuentas por cobrar, segmentados por moneda. | ✅ Segmenta soles/dólares y excluye las ventas anuladas. |
| RF-17 | Anulación de venta (nuevo, S09): REGISTRADA → ANULADA. | ✅ PATCH /ventas/{id}/anular: restaura stock, cancela los mantenimientos pendientes y emite nota de crédito; 409 si ya estaba anulada. |
| RF-18 | Venta en soles o dólares con tipo de cambio (nuevo, 15/10/2026). | ✅ El vendedor elige la moneda; el tipo de cambio de venta SUNAT del día se propone automáticamente y es editable (1–10). Los precios se convierten, el tipo de cambio queda guardado en la venta (no cambia aunque varíe después), aparece en la factura PDF y en el Excel. Una proforma conserva su tipo de cambio al convertirse en venta (se respeta el monto cotizado). |
| RF-19 | Descuento por línea (nuevo, 15/10/2026) en proformas y ventas. | ✅ % por línea con tope según el rol. Los topes los cambia solo el administrador en Configuración › Topes de descuento (tabla TOPES_DESCUENTO, 08/11/2026; no se delega y queda en el historial); mientras no los cambie valen app.descuentos.tope-admin = 30 y tope-asistente = 10. Queda guardado en la línea y sale en la factura y la proforma (columna "Dscto.") y en el Excel. El tope sale del rol del JWT; sin sesión la API responde 401. |
| RF-20 | Cobranza con abonos (nuevo, 15/10/2026). | ✅ Cobro–DetalleCobro: un pago (fecha, método, N° de operación) se reparte entre una o varias ventas del mismo cliente y moneda. Cada abono ≤ saldo (409); al llegar a 0 la venta pasa a PAGADO. El reporte de cobranza suma saldos, no totales. |
| RF-21 | Agenda de Postventa (nuevo, 15/10/2026). | ✅ Vencidos, próximos N días, realizados y todos, con contacto del cliente y equipos; marcar realizado (fecha y trabajo hecho) o reprogramar (fecha ≥ hoy, con motivo). |
| RF-22 | Devolución al anular una venta pagada (nuevo, 25/10/2026). | ✅ Antes de confirmar la anulación se muestra lo que el cliente ya pagó (al contado o con abonos). Al anular queda una devolución PENDIENTE en Cobranza › Devoluciones; el ADMIN registra fecha, método y N° de operación (DEVUELTA). Una venta solo pasa a PAGADO por sus abonos: ya no existe "marcar como pagada". |
| RF-23 | Anulación de cobros y control de pagos duplicados (nuevo, 28/10/2026). | ✅ Un cobro mal registrado (monto o venta equivocados, pago duplicado, cheque rechazado) lo anula el ADMIN con un motivo: no se borra, queda ANULADO con fecha, motivo y usuario, deja de contar en el saldo y sus ventas PAGADAS vuelven a PENDIENTE. No se anula el cobro de una venta ya anulada (ese dinero va por Devoluciones, 409). Al registrar: el mismo N° de operación con el mismo método no entra dos veces (409, sin distinguir mayúsculas ni espacios), la fecha no puede ser anterior a la venta (400) y cada cobro guarda quién lo registró (del token). |
| RF-24 | Detracción (SPOT) y retención del IGV (nuevo, 28/10/2026). | ✅ Sector SERVICIO (mano de obra) en productos y marca "agente de retención" en clientes. Al registrar la venta: si incluye servicios y supera S/ 700 → detracción del 12 % (en soles, redondeada a soles enteros); si no, y el cliente es agente de retención y supera S/ 700 → retención del 3 %. Porcentajes y umbral en app.tributos.*. La factura muestra la deducción, el neto y la leyenda del SPOT con la cuenta del Banco de la Nación (app.empresa.cuenta-detracciones, por confirmar). En Cobranza la constancia de detracción y el comprobante de retención se registran como abonos (métodos DETRACCION y RETENCION, con N° obligatorio, solo en ventas con esa deducción y hasta lo pendiente). Regla simplificada: confirmar con el contador. |
| RF-25 | Órdenes de trabajo (nuevo, 28/10/2026). | ✅ Instalación, mantenimiento, reparación o visita técnica con técnico, fecha, sede y dirección. PROGRAMADA → REALIZADA (lo hecho, quién lo recibió y materiales usados, que descuentan stock y salen en el kardex) o CANCELADA (solo ADMIN). Una instalación registra los equipos instalados; una de mantenimiento deja la visita REALIZADA. Se factura una vez, solo con servicios. |
| RF-26 | Sedes y equipos instalados (nuevo, 28/10/2026). | ✅ Sedes por cliente (nombre único por cliente). Cada equipo instalado con sede, serie (única por modelo), ubicación, fecha, garantía (0 a 120 meses) y frecuencia de mantenimiento; filtro por garantía vigente; retirarlo (solo ADMIN) cancela sus visitas pendientes. |
| RF-27 | Mantenimiento configurable y contratos (nuevo, 28/10/2026). | ✅ Plan por equipo cada 1, 2, 3, 4, 6 o 12 meses (se programa un año adelante y se extiende al hacer cada visita; reemplaza las visitas de la rutina de su venta). Contratos (solo ADMIN) con fechas (hasta 5 años), frecuencia y monto por visita: sus visitas se programan al crearlos y se cancelan al cancelarlos. |
| RF-28 | Permisos delegables (nuevo, 30/10/2026). | ✅ El ADMIN, desde Configuración › Usuarios y permisos, le da a un asistente operaciones que normalmente son solo suyas, sin hacerlo administrador: anular ventas, anular cobros, registrar devoluciones, editar el catálogo, eliminar clientes/proveedores/sedes, administrar servicios (contratos, cancelar órdenes, dar de baja equipos), registrar ventas con fecha pasada (07/11/2026) y el tope de descuento del administrador. Se guardan en Keycloak como roles PERM_* (el backend usa una cuenta de servicio propia, sgejd-backend); SecurityConfig acepta ADMIN o el permiso. Nadie cambia sus propios permisos ni los de un ADMIN (409). El cambio llega a la sesión del asistente en 5 minutos como máximo o al volver a entrar. |
| RF-29 | Historial de cambios y de sesiones (nuevo, 30/10/2026). | ✅ Todo POST/PUT/PATCH/DELETE al panel queda registrado (tabla HISTORIAL_CAMBIOS, por un filtro dentro de la cadena de seguridad): usuario, rol y permisos, fecha y hora, IP, módulo, acción en palabras ("Anuló la venta #113", "Intentó eliminar el cliente #5") y resultado (Hecho, Sin permiso, Rechazado con el motivo, Error). Incluye los intentos sin permiso (403). Solo se agrega: la aplicación no lo edita ni lo borra. Pantalla solo ADMIN con filtros por usuario, módulo, resultado y fechas, y una pestaña de inicios de sesión, intentos fallidos y cierres que guarda Keycloak (7 días). |
| RF-30 | Cuentas por pagar a proveedores (nuevo, 31/10/2026). | ✅ La compra se registra al contado (queda PAGADA) o a crédito con 1 a 365 días (PENDIENTE, vence fecha + días). Inventario › Cuentas por pagar lista lo que se debe, la que vence primero arriba, con totales por moneda (por pagar, vencido, vence en 7 días). Pagos parciales con fecha, método y N° de operación (obligatorio salvo efectivo): no superan el saldo, no son anteriores a la compra ni futuros, y el mismo N° con el mismo método a un proveedor no entra dos veces (409). Al cubrir el total la compra pasa a PAGADA; un pago mal registrado se anula con motivo (ADMIN o permiso ANULAR_COBROS) y la compra vuelve a PENDIENTE. Las compras anteriores quedaron como pagadas al contado. |
| RF-31 | Ajustes de inventario (nuevo, 31/10/2026). | ✅ Solo materiales (los equipos no controlan stock). Conteo físico: se escribe cuántas unidades hay y el sistema registra la diferencia. Movimiento: entrada o salida con motivo (stock inicial, merma, dañado, robo o pérdida, devolución al proveedor, otro) y observación obligatoria. Una salida no deja el stock negativo. Cada ajuste guarda el stock antes y después, quién y cuándo; sale en el kardex (Ajuste +/−) y en el historial de cambios. Registrar: ADMIN o permiso AJUSTAR_INVENTARIO. No se editan ni borran: un error se corrige con otro ajuste. |
| RF-32 | Rentabilidad (nuevo, 31/10/2026). | ✅ Cada línea vendida guarda el costo del producto al vender, en la moneda de la venta. Comercial › Rentabilidad (ADMIN o permiso VER_RENTABILIDAD) muestra, para un periodo y en soles (lo vendido en dólares, al tipo de cambio de cada venta): vendido sin IGV, costo, ganancia y % por venta, cliente, producto, categoría y técnico (órdenes realizadas: su facturación de mano de obra menos el costo de mano de obra y los materiales usados). Marca en ámbar lo que deja menos de 10 %. Las ventas anteriores al 31/10/2026 usan el costo del producto de esa fecha (no se guardaba). |
| RF-33 | Agenda de técnicos (nuevo, 31/10/2026). | ✅ La orden de trabajo lleva hora de inicio (opcional) y duración estimada (15 min a 12 h, 2 h por defecto). Un técnico no puede tener dos visitas PROGRAMADAS que se crucen el mismo día (409 con la orden que choca). Servicios › Agenda: semana de lunes a domingo con una fila por técnico; cada visita con horario, cliente y tipo; las que se cruzan, en rojo; "+" en un día libre programa una orden para ese técnico y ese día. |
| RF-34 | Ordenar listados por columna (nuevo, 07/11/2026). | ✅ Clic en el encabezado: A→Z o de menor a mayor, otro clic invierte y el tercero vuelve al orden normal, en las 13 listas. Ventas, Proformas y Compras ordenan en el servidor antes de paginar (orden=campo,asc|desc, columnas permitidas por listado); los montos en dólares se comparan en soles. |
| RF-35 | Registrar un cliente sin salir de la venta o proforma (nuevo, 06/11/2026). | ✅ Botón "Nuevo cliente" junto al selector: abre el formulario de cliente (con búsqueda SUNAT/RENIEC) en un diálogo y lo deja seleccionado; si el RUC/DNI ya existe ofrece "Usar este cliente". |
Requerimientos No Funcionales (RNF)¶
- RNF-01 (Arquitectura): monolito modular en capas (controladores, servicios, repositorios), un módulo por paquete. Los módulos se comunican solo por fachadas de servicio y eventos;
ModularityTests(Spring Modulith) lo verifica en cadamvn test(resuelto el 31/10/2026, ver 5, punto 21). - RNF-02 (Rendimiento): endpoints por debajo de 1000 ms con carga estándar. Medido el 07/11/2026 con los datos simulados (232 ventas, 219 proformas): las listas completas de ventas y proformas tardaban 570 y 360 ms con 380 y 256 consultas cada una (auditoría M9: una por cada venta para su detalle, cliente y productos). Con
hibernate.default_batch_fetch_size=100, que carga esas relaciones de a 100 con unIN (...), bajaron a 185 y 155 ms con 7 y 5 consultas, con la misma respuesta. Las usan Inicio, la campana y la orden de trabajo. - RNF-03 (Interoperabilidad): backend desacoplado del frontend, solo API REST en JSON, versionada en
/api/v1/.... - RNF-04 (Mantenibilidad e IoC): inyección de dependencias de Spring; credenciales externalizadas: el backend las lee de variables de entorno o de
application-local.properties, y Docker y Keycloak de.env(ambos ignorados por git, con plantilla.example). ✅ Cumplido; ver 5 sobre el historial de git. - RNF-05 (Seguridad):
/api/v1/admin/**exige un JWT emitido por Keycloak (RS256, validado porissuer-uri); autorización por rol (ADMIN, ASISTENTE) y por permiso delegado (PERM_*, RF-28); cada cambio queda en el historial (RF-29). Las contraseñas viven solo en Keycloak, con protección contra fuerza bruta (5 intentos) y política de contraseñas. - RNF-06 (Usabilidad): la SPA es responsiva: barra superior con grupos, buscador global y avisos, y riel de íconos con el nombre de cada módulo al pasar el mouse; bajo 900 px el riel pasa a un menú desplegable (☰) con texto; formularios a una columna y tablas con desplazamiento horizontal en celular (≤ 640 px); el detalle de la venta se muestra como tarjetas.
- RNF-07 (Usabilidad): tema claro, oscuro o "como el sistema" (sigue al modo de Windows sin recargar), elegido en Configuración o con el botón sol/luna de la barra; se guarda en el navegador y se aplica antes de cargar la app (sin destello claro). El tema oscuro usa una escala de grises neutros: fondo
#111827, texto#F3F4F6, texto secundario#9AA3AF, bordes y gráficos#D1D5DB/#9AA3AF, y#F3F4F6como acento (botones claros con texto oscuro); rojo, verde y ámbar quedan solo para estados y alertas. - RNF-08 (Recuperabilidad): respaldo automático diario de la base (tarea de Windows "SGE-JD respaldo diario",
programar_respaldo.bat): Data Pump aC:\SGE-JD\respaldos, copia a una carpeta fuera de la PC (USB, OneDrive o red) y se conservan los últimos 14; si la PC estaba apagada a la hora, corre al encenderla. Registro enrespaldos\respaldo_automatico.log. - RNF-09 (Observabilidad): perfiles dev/prod, logs con
logback-spring.xmly Actuatorhealth/infopara diagnosticar en producción (S13).
Casos de uso / Historias de usuario¶
- CU-01 (Elaborar proforma): el vendedor selecciona cliente y productos; el sistema calcula IGV y totales; luego envía el PDF de la proforma al cliente por correo.
- CU-02 (Postventa: alertas de mantenimiento): el sistema revisa a diario, a las 8:00 a. m., los mantenimientos de los próximos 7 días y envía un correo a la oficina con los clientes a contactar.
- CU-03 (Vender): el vendedor registra una venta directa con varias líneas de producto, revisa el total y confirma; el sistema descuenta stock, programa mantenimientos y emite el comprobante.
- CU-04 (Anular venta): el administrador anula una venta registrada indicando el motivo (obligatorio; la venta guarda quién la anuló y por qué, auditoría M4); el sistema devuelve al inventario lo vendido, cancela los mantenimientos pendientes, emite la nota de crédito del comprobante y la venta deja de contar en los reportes. Si el cliente ya había pagado, queda una devolución pendiente que se registra cuando se le devuelve el dinero.
- CU-05 (Cobrar): la asistente registra un pago del cliente y lo reparte entre sus ventas a crédito en esa moneda; ningún abono supera el saldo y la venta pasa a PAGADO al completarse.
- CU-06 (Anular cobro): el administrador anula un cobro mal registrado indicando el motivo; el monto vuelve al saldo de sus ventas y el cobro queda en el historial como anulado.
- CU-07 (Programar y cerrar una orden de trabajo): la asistente programa la visita con técnico, fecha y hora (el sistema rechaza un cruce en la agenda del técnico); al cerrarla registra lo hecho y los materiales usados, que descuentan stock.
- CU-08 (Comprar y pagar al proveedor): la asistente registra la compra al contado o a crédito; las compras a crédito quedan en Cuentas por pagar hasta registrar sus pagos.
- CU-09 (Ajustar inventario): el administrador (o quien tenga el permiso) registra un conteo físico o una merma; el sistema ajusta el stock y lo muestra en el kardex.
- CU-10 (Delegar permisos): el administrador enciende o apaga, para un asistente, operaciones que normalmente son solo suyas.
- CU-11 (Revisar el historial y la rentabilidad): el administrador consulta quién hizo cada cambio y cuánto se ganó por venta, cliente, producto y técnico.
Diagrama de casos de uso (UML)¶
El administrador hereda todo lo que hace la asistente (generalización de actores). Los casos marcados con 🔑 son del administrador y los puede delegar a una asistente con un permiso (RF-28).
flowchart LR
Asis(["👤 Asistente<br/>(Lucy)"])
Admin(["👤 Administrador<br/>(Lisandro)"])
Reloj(["⏰ Tiempo<br/>(tareas programadas)"])
Ext(["🌐 Sistemas externos<br/>SUNAT · RENIEC · correo · Keycloak"])
Admin -- "hereda de" --> Asis
subgraph SGE["SGE-JD"]
direction TB
cu1([Iniciar sesión])
cu2([Registrar cliente o proveedor])
cu3([Elaborar y enviar proforma])
cu4([Registrar venta])
cu5([Registrar cobro])
cu6([Programar y cerrar orden de trabajo])
cu7([Registrar compra y pago a proveedor])
cu8([Consultar kardex, reportes y agenda])
cu9([🔑 Anular venta o cobro])
cu10([🔑 Editar catálogo y eliminar registros])
cu11([🔑 Ajustar inventario])
cu12([🔑 Ver rentabilidad])
cu13([Delegar permisos])
cu14([Revisar historial de cambios])
cu15([Enviar alertas de mantenimiento y stock])
cu16([Calcular detracción o retención])
end
Asis --- cu1 & cu2 & cu3 & cu4 & cu5 & cu6 & cu7 & cu8
Admin --- cu9 & cu10 & cu11 & cu12 & cu13 & cu14
Reloj --- cu15
cu4 -. "«include»" .-> cu16
cu2 -. "consulta" .-> Ext
cu1 -. "autentica" .-> Ext
Modelado de procesos (BPMN AS-IS y TO-BE)¶
Dos procesos clave del negocio, como se hacen hoy (AS-IS) y con SGE-JD (TO-BE). Cada diagrama está en BPMN 2.0
estándar en docs/diagramas/ (.bpmn, se abre y edita en Camunda Modeler o
demo.bpmn.io) y como imagen (.svg). Se generan con python docs/diagramas/generar_bpmn.py.
⚠️ Los AS-IS son un borrador. No hay un registro de cómo trabaja hoy la oficina: se armaron a partir de lo que resuelven los requerimientos, y cada paso dudoso está marcado [S1]–[S9] (supuesto). Hay que confirmarlos con Lisandro antes de presentarlos como el proceso real.
Proceso 1 · Venta, instalación y cobro¶
AS-IS (borrador)
TO-BE (con SGE-JD)
Proceso 2 · Compra, pago al proveedor e inventario¶
AS-IS (borrador)
TO-BE (con SGE-JD)
Supuestos del AS-IS por confirmar con Lisandro¶
| # | Supuesto | Pregunta para confirmar |
|---|---|---|
| S1 | La proforma se arma a mano en Word o Excel | ¿Con qué arman hoy la cotización? ¿Hay una plantilla? |
| S2 | Lisandro revisa precio y descuento de cada proforma | ¿Lucy puede cotizar sola o todo pasa por Lisandro? |
| S3 | El stock se confirma mirando el almacén | ¿Llevan algún control de stock (Excel, cuaderno)? |
| S4 | La factura se emite en el portal de SUNAT (SOL) | ¿Facturan en SUNAT SOL, con un sistema o con un contador? |
| S5 | Las visitas de los técnicos se recuerdan de memoria o en una agenda | ¿Cómo asignan hoy al técnico y la hora? ¿Han tenido cruces? |
| S6 | Las deudas de clientes se anotan en un cuaderno o Excel | ¿Cómo saben hoy quién debe y desde cuándo? |
| S7 | Se nota que falta material cuando se va a usar | ¿Hay un mínimo de stock o un pedido periódico? |
| S8 | La factura del proveedor se archiva y lo recibido se anota | ¿Dónde registran lo que entra al almacén? |
| S9 | Las fechas de pago a proveedores se recuerdan | ¿Cómo controlan lo que deben a los proveedores? |
Qué cambia del AS-IS al TO-BE¶
| Problema (AS-IS) | Con SGE-JD (TO-BE) | RF |
|---|---|---|
| Precios y descuentos calculados a mano | Precio desde costo y margen, IGV y tope de descuento por usuario | RF-01, RF-19 |
| Proforma sin seguimiento | Estados (enviada, aceptada, rechazada, vencida, convertida) y PDF por correo | RF-04 |
| Stock incierto al vender | La venta valida y descuenta el stock; alerta de stock mínimo; ajustes con motivo | RF-07, RF-31 |
| Facturación y detracción manuales | Comprobante con correlativo y cálculo de detracción o retención | RF-09, RF-24 |
| Agenda de técnicos de memoria | Órdenes con hora y duración; no deja cruzar dos visitas | RF-25, RF-33 |
| Deudas de clientes en un cuaderno | Saldo por venta, días de atraso, recordatorio y voucher único | RF-20, RF-23 |
| Deudas con proveedores sin control | Cuentas por pagar con vencimiento y pagos parciales | RF-30 |
| Sin saber cuánto se gana | Rentabilidad por venta, cliente, producto y técnico | RF-32 |