Saltar a contenido

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, cobranza y proformas-pendientes siguen en el paquete transitorio reportes (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 cada mvn 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 un IN (...), 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 por issuer-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 #F3F4F6 como 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 a C:\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 en respaldos\respaldo_automatico.log.
  • RNF-09 (Observabilidad): perfiles dev/prod, logs con logback-spring.xml y Actuator health/info para 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)

AS-IS venta, instalación y cobro

TO-BE (con SGE-JD)

TO-BE venta, instalación y cobro

Proceso 2 · Compra, pago al proveedor e inventario

AS-IS (borrador)

AS-IS compra e inventario

TO-BE (con SGE-JD)

TO-BE compra, cuentas por pagar e inventario

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