| RF-01 |
Inicio de sesión seguro |
seguridad · Keycloak, Authorization Code + PKCE (ADR-005) |
Base propia de Keycloak (contraseñas fuera de la app) |
SecurityConfig: todo /admin/** exige JWT RS256 |
/login, /auth/callback |
01_login_token.ps1, 06_s11_pkce.ps1; FlujoCompletoEndToEndTest (sin token → 401) |
✅ |
| RF-02 |
Roles y permisos (ADMIN, ASISTENTE) |
seguridad · roles del realm bomerp |
Roles en Keycloak |
SecurityConfig (reglas por ruta), jwtAuthenticationConverter |
Menú según rol, /sin-permiso |
05_matriz.ps1 (14 casos); FlujoCompletoEndToEndTest (ASISTENTE anula → 403) |
✅ |
| RF-03 |
Catálogo con moneda dual y precio por margen |
catalogo |
PRODUCTOS, CATEGORIAS |
/productos, /categorias |
/catalogo/productos, /catalogo/categorias |
ProductoCrudTest (Oracle), 02_proteccion_catalogo.ps1, 03_modificacion_admin.ps1 |
✅ |
| RF-04 |
Autocompletar cliente/proveedor por RUC o DNI |
clientes, proveedores · API externa apis.net.pe |
CLIENTES, PROVEEDORES |
GET /clientes/autocompletar/ruc/{ruc} y /dni/{dni} |
/clientes/nuevo, /proveedores/nuevo, diálogo "Nuevo cliente" de venta y proforma |
Manual; prueba automática pendiente |
🔶 |
| RF-05 |
Proformas con IGV y subtotales |
proformas |
PROFORMAS, ITEMS_PROFORMA |
POST /proformas, GET /proformas/pagina |
/proformas/nueva, /proformas |
FlujoCompletoEndToEndTest (crea, acepta, convierte) |
✅ |
| RF-06 |
PDF corporativo de la proforma |
proformas.pdf · GeneradorPdfService |
— (se genera al enviar) |
POST /proformas/{id}/enviar |
/proformas (Enviar) |
Manual; prueba automática pendiente |
🔶 |
| RF-07b |
Entrega de la factura o boleta por correo (PDF + XML firmado), con seguimiento, reintentos y reenvío |
facturacion.correo · EntregaComprobanteService ← evento ComprobanteAceptadoEvent; notificaciones (SMTP) |
ENVIOS_CORREO, INTENTOS_CORREO, COMPROBANTES.AMBIENTE_EMISION (fijo, disparador) |
GET /facturacion/{id}/correo, POST /facturacion/{id}/enviar, GET /facturacion/{id}/pdf; conciliación periódica |
/ventas ("Entrega del comprobante") |
ReglasCorreoComprobanteTest (14), NotificadorCorreoRealTest (5), EntregaComprobanteIntegracionTest (17), entrega-correo.spec.ts (5) |
✅ |
| RF-07 |
Envío de la proforma por correo |
notificaciones · SMTP |
— |
POST /proformas/{id}/enviar |
/proformas (Enviar) |
Manual con Gmail (26/10); pendiente el correo de la empresa |
⚠️ |
| RF-08 |
Convertir proforma aceptada en venta |
ventas ← proformas (fachada ProformaService) |
VENTAS, PROFORMAS.VENTA_ID |
POST /ventas/desde-proforma/{id} |
/proformas (diálogo Convertir) |
FlujoCompletoEndToEndTest (CONVERTIDA, precios y TC respetados) |
✅ |
| RF-09 |
Control de créditos y deudas atrasadas |
ventas, cobranza |
VENTAS (tipo de pago, fecha límite, estado de pago) |
GET /ventas/pagos-atrasados, GET /cobranza/por-cobrar |
/ventas (Pagos atrasados), /cobranza |
CobranzaServiceTest; FlujoCompletoEndToEndTest |
✅ |
| RF-10 |
Facturación electrónica UBL 2.1 |
facturacion · envío directo a SUNAT (SEE Del Contribuyente), evento VentaRegistradaEvent |
COMPROBANTES, ENVIOS_SUNAT, NOTAS_CREDITO, SERIES_COMPROBANTE |
/facturacion/estados, /{id}/reenviar, /{id}/reemplazar, /{id}/envios, /plazo-envio, /{id}/xml, /{id}/cdr |
/ventas (estado SUNAT, XML, CDR, Reenviar, comprobante de reemplazo, historial de envíos, plazo de 3 días) |
EnvioSunatServiceTest, ClasificacionCodigosSunatTest, ComprobanteReemplazoIntegracionTest, SunatBetaTest (beta real, SUNAT_BETA=1), FlujoCompletoEndToEndTest (comprobante PENDIENTE) |
⚠️ falta usuario SOL y certificado de JD |
| RF-11 |
Descuento de stock atómico al vender |
catalogo (fachada ProductoService.descontarStock) ← ventas |
PRODUCTOS.STOCK_ACTUAL (bloqueo de fila) |
POST /ventas/directa, /ventas/desde-proforma/{id} (409 sin stock) |
/ventas/nueva |
StockProductoTest; FlujoCompletoEndToEndTest (10 → 7 → 10 al anular) |
✅ |
| RF-12 |
Incremento de stock al comprar; subtotal e IGV de la compra y último costo del producto (auditoría M1 y M2) |
compras → catalogo |
COMPRAS (subtotal, igv), DETALLE_COMPRA, PRODUCTOS.ULTIMO_COSTO_COMPRA |
POST /compras |
/compras/nueva |
CompraServiceTest, PrecioDeLineaTest, PrecioEditadoIntegracionTest |
✅ |
| RF-13 |
Alerta diaria de stock mínimo |
inventario · @Scheduled 8:00 |
PRODUCTOS.STOCK_MINIMO |
InventarioScheduledService |
Campana de avisos |
Manual; prueba automática pendiente |
⚠️ falta el correo de la empresa |
| RF-14 |
Rutina de mantenimiento al vender equipos |
ventas → postventa por evento (VentaRegistradaEvent + RutinaMantenimiento, ADR-002) |
MANTENIMIENTOS |
rutinaMantenimiento en POST /ventas/directa y /ventas/desde-proforma/{id} |
/ventas/nueva y /proformas (botón "Implementar rutinas de mantenimiento") |
RutinaMantenimientoTest, RutinaMantenimientoIntegracionTest (Oracle), FlujoCompletoEndToEndTest |
✅ |
| RF-15 |
Aviso de mantenimientos próximos |
postventa · @Scheduled 8:00 |
MANTENIMIENTOS.ALERTA_ENVIADA |
MantenimientoScheduledService, POST /mantenimientos/simular-alerta |
Campana, /postventa |
Manual (simular-alerta); prueba automática pendiente |
⚠️ falta el correo de la empresa |
| RF-16 |
Reportes por moneda |
reportes, ventas |
VENTAS, DETALLE_VENTA, COBROS |
GET /ventas/pagina (resumen), /reportes/ventas-resumen, /reportes/cobranza |
/ventas, /cobranza, / (tablero) |
FlujoCompletoEndToEndTest (total del servidor = suma de todas las páginas) |
✅ |
| RF-17 |
Anular venta |
ventas → catalogo por fachada (ProductoService.sumarStock, misma transacción); → facturacion, postventa, cobranza por VentaAnuladaEvent (corregido 10/11: el stock nunca viajó por el evento) |
VENTAS.ESTADO, NOTAS_CREDITO, DEVOLUCIONES |
PATCH /ventas/{id}/anular (409 si ya estaba anulada) |
/ventas (Anular) |
FlujoCompletoEndToEndTest (stock, visitas canceladas, devolución, 409) |
✅ |
| RF-18 |
Venta en soles o dólares con tipo de cambio |
config.tipocambio |
VENTAS.MONEDA, VENTAS.TIPO_CAMBIO |
GET /tipo-cambio/hoy (Cache-Control 10 min) |
/ventas/nueva, /proformas/nueva |
VentaCostoTest, DeduccionTributariaServiceTest (dólares), OrdenTest (total en soles) |
✅ |
| RF-19 |
Descuento por línea con tope por rol |
seguridad.descuento · TopeDescuentoService |
DETALLE_VENTA.DESCUENTO_PORCENTAJE, ITEMS_PROFORMA |
GET /descuentos/tope; GET/PUT /descuentos/topes (cambiar: solo ADMIN); validado al registrar |
/ventas/nueva, /proformas/nueva, /configuracion |
VentaCostoTest (subtotal con descuento), TopeDescuentoServiceTest (tope por rol y topes del administrador) |
✅ |
| RF-20 |
Cobranza con abonos |
cobranza |
COBROS, DETALLE_COBRO |
POST /cobranza/cobros, GET /cobranza/por-cobrar |
/cobranza |
CobranzaServiceTest (9); FlujoCompletoEndToEndTest (abono parcial y total) |
✅ |
| RF-21 |
Agenda de postventa |
postventa |
MANTENIMIENTOS |
GET /mantenimientos, PATCH /{id}/realizado, /{id}/reprogramar |
/postventa |
FlujoCompletoEndToEndTest (visitas de la venta); realizar y reprogramar: manual |
🔶 |
| RF-22 |
Devolución al anular una venta pagada |
cobranza.devolucion ← VentaAnuladaEvent |
DEVOLUCIONES |
GET /cobranza/devoluciones, POST /{id}/registrar |
/cobranza (Devoluciones) |
CobranzaServiceTest; FlujoCompletoEndToEndTest (devolución por lo pagado) |
✅ |
| RF-23 |
Anular cobros y evitar pagos duplicados |
cobranza |
COBROS (estado, motivo, usuario) |
POST /cobranza/cobros/{id}/anular |
/cobranza |
CobranzaServiceTest |
✅ |
| RF-24 |
Detracción (SPOT) y retención del IGV |
ventas.tributos · DeduccionTributariaService |
VENTAS (tipo, % y monto de deducción) |
Se aplica al registrar la venta |
/ventas/nueva, factura PDF |
DeduccionTributariaServiceTest (5) |
✅ (regla por confirmar con el contador) |
| RF-25 |
Órdenes de trabajo |
servicios |
ORDENES_TRABAJO, MATERIALES_ORDEN |
/ordenes |
/servicios/ordenes |
AgendaHorarioTest (cruces); cierre y facturación: manual |
🔶 |
| RF-26 |
Sedes y equipos instalados |
clientes.sede, postventa.equipo |
SEDES_CLIENTE, EQUIPOS_INSTALADOS |
/clientes/{id}/sedes, /equipos |
/servicios/equipos |
Manual; prueba automática pendiente |
🔶 |
| RF-27 |
Plan por equipo y contratos |
postventa |
CONTRATOS_MANTENIMIENTO, MANTENIMIENTOS |
/contratos, /equipos |
/servicios/contratos, /servicios/equipos |
Manual; prueba automática pendiente |
🔶 |
| RF-28 |
Permisos delegables |
seguridad.permisos · roles PERM_* en Keycloak |
Roles en Keycloak |
/permisos |
/configuracion/permisos |
PermisosServiceTest (6) |
✅ |
| RF-29 |
Historial de cambios (auditoría) |
seguridad.auditoria · filtro en la cadena de seguridad |
HISTORIAL_CAMBIOS |
GET /auditoria, /auditoria/sesiones |
/configuracion/historial |
AuditoriaServiceTest (6); FlujoCompletoEndToEndTest (acción EXITO y DENEGADO con el usuario del token) |
✅ |
| RF-30 |
Cuentas por pagar a proveedores |
compras |
COMPRAS, PAGOS_PROVEEDOR |
/cuentas-por-pagar |
/compras/por-pagar |
CuentasPorPagarServiceTest (8) |
✅ |
| RF-31 |
Ajustes de inventario |
inventario.ajuste |
AJUSTES_INVENTARIO |
/inventario/ajustes |
/inventario/ajustes |
AjusteInventarioServiceTest (7) |
✅ |
| RF-32 |
Rentabilidad |
reportes.rentabilidad |
DETALLE_VENTA.COSTO_UNITARIO |
/reportes/rentabilidad |
/reportes/rentabilidad |
RentabilidadServiceTest, VentaCostoTest |
✅ |
| RF-33 |
Agenda de técnicos |
servicios |
ORDENES_TRABAJO (hora, duración) |
/ordenes (409 si se cruzan) |
/servicios/agenda |
AgendaHorarioTest (6) |
✅ |
| RF-34 |
Ordenar listados por columna |
config.paginacion.Orden (servidor) y core/layout/orden.ts (SPA) |
— (ordena antes de paginar) |
Parámetro orden=campo,asc\|desc en /ventas/pagina, /proformas/pagina, /compras/pagina |
Encabezados de las 13 listas |
OrdenTest (4); verificación en el navegador (07/11) |
✅ |
| RF-35 |
Registrar un cliente sin salir de la venta o proforma |
SPA · ClienteFormComponent en modo diálogo |
CLIENTES |
POST /clientes |
/ventas/nueva, /proformas/nueva (botón "Nuevo cliente") |
Verificación en el navegador; prueba automática pendiente |
🔶 |