Skip to content

Matriz de Roles / Permisos (configurable por Admin) ​

Análisis Funcional: Integración Soterex — parte 3 de 8. ← Sitemap · Índice · Siguiente: User Flows →

Definición (2026-07-24): la matriz de roles no es fija — es un módulo de configuración editable por el rol Admin (ABM Roles y Permisos, agregado al Sitemap). Para cada módulo/recurso del sistema, el Admin puede activar/desactivar 3 permisos por rol: Leer (L), Escribir (E), Borrar (B), con toggles on/off.

Regla de dependencia confirmada por el cliente: si Borrar = ON, entonces Escribir se activa automáticamente y no puede desactivarse mientras Borrar siga ON (Borrar depende de Escribir). Por consistencia del mismo patrón, se asume además que Escribir = ON requiere Leer = ON (no se puede escribir algo que no se puede leer) — a confirmar con el cliente, queda como sub-punto de la Pregunta Abierta #5.

Esto significa que el módulo de roles pasa a ser datos de configuración (seed), no un requisito fijo de negocio. Los 3 roles detectados en la charla (Backoffice, Supervisor, Admin) se cargaron como valores iniciales por defecto, editables luego desde ABM Roles y Permisos.

Actualizado 2026-10-02 (B6, ADR-014): el cliente pidió cuatro perfiles: Cajero, Supervisor, Tesorería y Admin. El Backoffice de la charla se llama ahora Cajero (se renombró la fila del rol, no se creó otro) y Tesorería es un perfil nuevo. En los documentos del cliente, el «Backoffice central / regional» es el Admin. La matriz de 2.1 es la de los cuatro. Los otros apartados fechados antes de B6 conservan el nombre de su época.

Actualizado 2026-10-07 (G8, plan de ajustes v3, ADR-014): (1) el tipo de cambio deja de ser de lectura para el Cajero y el Supervisor: lo ven y lo editan solo Tesorería y Admin (fila de 2.1 y nota ⑿); (2) Tesorería es un único perfil y es regional por asignación (2.3.3); (3) con más de una asignación se mezclan las opciones y no hay selector de perfil (2.3.2), y 2.3.1 separa qué confirmó el cliente de qué es diseño; (4) en Reportes, el nombre del beneficiario y el selector de país siguen la misma regla que el resto de la mezcla (nota ⑽).

2.1 Matriz por defecto (seed inicial, editable desde Admin) ​

Reescrita el 2026-10-02 (B6) para los cuatro perfiles, con las decisiones del cliente del 2026-10-01 y las de Carlos del 2026-10-02 (el Admin cancela y paga; Cumplimiento es solo del Admin; el Supervisor ya no ve la comisión del Dashboard). Es el seed real (backend/database/seeders/RoleSeeder.php, MATRIX); la versión del 2026-08-05 tenía tres columnas y quedó en el historial de git. Los nombres entre paréntesis son las claves de módulo, que no cambiaron aunque la pantalla se llame distinto.

Módulo / RecursoCajero (L/E/B)Supervisor (L/E/B)Tesorería (L/E/B)Admin (L/E/B)
Pago (pago): buscar y pagar ⑵L·E·—L·E·——·—·—L·E·—
Reporte individual (transacciones): listado, detalle, datos del pago y soportes ⑴L·E·—L·E·——·—·—L·E·B
  ↳ Pagar una transacciónexige pago·Eexige pago·Enoexige pago·E
  ↳ Cancelar una transacciónnononoexige transacciones·B
Saldos (caja): cajas, movimientos, reporteL·E·—L·E·—L·—·—L·E·B
Apertura / cierre de caja (apertura_cierre_caja) ⑸L·E·—L·E·——·—·—L·E·B
Fondeo y ajuste de caja (fondeo_caja) ⑼—·—·—L·—·—L·E·—L·E·B
Prefondeo Soterex (prefondeo, la Holding) ⑶—·—·——·—·—L·E·—L·E·B
Fondeo PDVs (prefondeo_pais) ⑷—·—·——·—·—L·E·—L·E·B
Tipo de cambio (tipo_cambio) ⑿L·—·— —·—·—L·—·— —·—·—L·E·—L·E·B
Reportes contables (reportes: estado de situación, volumen, cajas) ⑽—·—·—L·—·—L·—·—L·—·—
Dashboard de volumen/comparativas por país y PDV (dashboard) ⑾—·—·—L·—·—L·—·—L·—·—
Reporte de Cumplimiento (reporte_cumplimiento) ⑻—·—·——·—·——·—·—L·—·—
ABM Usuarios—·—·——·—·——·—·—L·E·B
ABM Países ⑹—·—·——·—·——·—·—L·E·B
ABM Estaciones / PDV—·—·——·—·——·—·—L·E·B
ABM Catálogos (abm_catalogos)—·—·——·—·——·—·—L·E·B
ABM Configuración (timeout sesión, integración Soterex)—·—·——·—·——·—·—L·E·B
ABM Roles y Permisos—·—·——·—·——·—·—L·E·B
ABM Asignación de Roles Multipaís/PDV—·—·——·—·——·—·—L·E·B
Logs de auditoría (movimientos y logins) ⑺—·—·——·—·——·—·—L·—·—

⑴ El Cajero y el Supervisor leen Transacciones, pero no la bolsa entera. Tienen transacciones en L·E sin B a propósito: el listado del Cajero se acota en el backend a lo que resolvió él (PermissionService::isScopedToOwnTransactions), y nunca ve las ACCEPTED del país. El Supervisor y el Admin ven todo lo de su alcance. Tesorería no tiene el módulo: no ve ni opera transacciones. «Ve todo lo de su alcance» se decide dentro de una misma asignación (la que junta fondeo_caja·L y acceso a transacciones): quien suma Cajero y Tesorería en el mismo país sigue acotado a lo que pagó él, porque ninguna de las dos asignaciones reúne las dos cosas (ver 2.3.2). La columna Procesada por (G4.3) sigue ese mismo alcance: dice quién resolvió cada transacción, así que el Cajero ve solo su propio correo y el Supervisor y el Admin ven el de cada operador de lo suyo. Es dato del operador, no del beneficiario (5.9 de Secuencias de pantalla). ⑵ Pantalla de E2. Pagar exige pago·E, y cancelar exige transacciones·B. Antes eran el mismo permiso (transacciones·E); se separaron en B6 (P5). Cargar los datos del pago y subir los soportes siguen en transacciones·E. El Admin paga y cancela (Carlos, 2026-10-02): su celda pago es L·E; transacciones·B es el único permiso de la matriz que hoy tiene solo él, y por eso solo el Admin cancela. La cancelación que pide Soterex por la API (POST /api/c2p/v1/Cancel) no pasa por estos permisos (ADR-012). ⑶ Es el módulo prefondeo que ya existe. Renombrado a «Holding» el 2026-08-05 (ADR-007) y a «Prefondeo Soterex» en el menú el 2026-10-02 — descuenta principal + comisión. ⑷ Módulo prefondeo_pais, agregado por E4b y en el menú desde B6 como «Fondeo PDVs». Descuenta solo principales, lo carga tesorería y puede quedar negativo. Desde B7 la pantalla tiene dos pestañas con permiso propio: País (prefondeo_pais) y PDV (fondeo_caja, ver ⑼); el ítem del menú se abre con cualquiera de los dos, así que el Supervisor entra aunque su celda de esta fila sea —·—·— y ve solo la pestaña PDV. ⑸ No requiere autorización de un Supervisor (2026-08-05, ADR-007): la ejecuta el operador con su propia sesión. Tesorería no abre ni cierra cajas. Cada caja la cierra quien la abrió (G6, 2026-10-06, ADR-021): la que abrió otra persona la cierran solo quien reúna apertura_cierre_caja·E y fondeo_caja·L en una misma asignación que cubra el PDV de la caja —el Supervisor de ese PDV y el Admin—. No es una celda nueva de la matriz: se deriva de las dos que ya existen. ⑹ Ya no incluye «% comisión por país»: el campo se eliminó (ADR-005) — la comisión la fija Soterex por transacción. Sí incluye el flag del módulo Caja, la moneda local, la moneda de pago y el formato de recibo. ⑺ CORREGIDO (2026-10-02): Confirmado con Carlos (2026-07-29): el mockup final de la pantalla Pago muestra Auditoría en el sidebar de Backoffice. El cliente pidió el 2026-10-01 que Auditoría sea solo del Administrador (R8). Sigue sin tener ruta de escritura.

⑻ Módulo nuevo de B4.2 (plan de Ajustes v2, P7, confirmado por Carlos el 2026-10-02). El reporte exporta a Excel los datos personales de todos los beneficiarios de un país (nombre, fecha de nacimiento, documento, teléfono, dirección), así que no viaja con el permiso general de Reportes: tener reportes no da acceso (403 por API). Es solo lectura —no hay nada que escribir— y se siembra únicamente para Admin; los demás roles, incluidos los que el Admin cree a mano, quedan en 0/0/0. Darlo a otro perfil es una celda de esta matriz, sin código. Quien lo reciba ve también la comisión de cada pago (el reporte trae el principal y el total con comisión, columnas 14 y 15), aunque no tenga prefondeo:read, que es lo que limita la comisión en el resto de la app (P11). Hoy no hay fuga —solo Admin tiene los dos permisos—, pero la ficha del usuario no lo advierte: tenerlo presente al dárselo a otro perfil. Llega a las bases existentes por una migración de datos, no por db:seed (2026_10_02_110000_b4_permiso_reporte_cumplimiento.php). En la app es la pestaña Cumplimiento de Reportes: se dibuja solo a quien tiene este permiso, y se puede dar o quitar desde la ficha del usuario como cualquier otro módulo (fila «Reporte de Cumplimiento»). Ver Secuencias de pantalla, 5.7.

⑼ El Supervisor ve las cajas de su PDV, pero no las fondea ni las ajusta (C6, respuesta del cliente del 2026-10-01). fondeo_caja·L es «ve los saldos y movimientos de las cajas de su alcance»; fondeo_caja·E es fondear y ajustar, y lo tienen Tesorería y Admin. fondeo_caja·L es además el permiso del extracto de un PDV (Fondeo PDVs › PDV, B7): el Supervisor lo ve solo para los PDVs de su asignación, y pedir otro responde 403 por API (ADR-015 §5). Por eso la señal que decide quién «supervisa transacciones» ya no es fondeo_caja·L a secas, sino ese permiso junto con el acceso a Transacciones, dentro de la misma asignación (ADR-014 §6): Tesorería ve los saldos para fondear y eso no le da nada sobre las transacciones. ⑽ Reportes lo ven todos los perfiles menos el Cajero (C5). Estado de Situación muestra la comisión de cada pago a cualquiera con reportes·L, incluida Tesorería; el nombre del beneficiario, en cambio, solo a quien además tiene transacciones·L en el país es Supervisor o Admin del PDV del pago (G8, 2026-10-07, H3-01: la señal del listado del Reporte individual, SUPERVISOR_DE_TRANSACCIONES, dentro de una misma asignación y contestada por PDV). Lo ven el Supervisor y el Admin; a Tesorería le llega vacío (pantalla y export), y también a quien suma Cajero y Tesorería, que antes lo recibía solo por juntar los permisos de dos asignaciones. Un Supervisor de un PDV que además es Tesorería lo recibe solo en los pagos de su PDV, aunque Reportes le muestre todo el país (revisión de G8). El selector de país de Estado de Situación, Volumen, Cajas y Reporte individual ofrece solo los países donde rige el permiso de esa pantalla (H3-02): con Cajero en un país y Tesorería en otro, Reportes ofrece solo el segundo y la primera carga ya no da 403. Queda abierta una decisión de producto: el Supervisor, que perdió Prefondeo, sigue viendo el saldo y los asientos de prefondeo por esta pantalla (ADR-014, Consequences). ⑾ La comisión del Dashboard la ve quien tiene prefondeo·L en el país (P11): Tesorería y Admin. El Supervisor dejó de verla; antes la veía solo el rol llamado Supervisor, ni siquiera el Admin.

⑿ El tipo de cambio es de Tesorería y Admin (G8, 2026-10-07, D3-11). B6 les había dejado la lectura al Cajero y al Supervisor por decisión nuestra, no por un pedido: la hoja de menús del cliente reserva el tipo de cambio a Administrador y Tesorería. Nada operativo lo necesita: el pago lee el tipo de cambio vigente por su cuenta (ExchangeRateService), sin pasar por este permiso, y Guatemala paga en dólares. Desde G8 GET /tipo-cambio/{país} da 403 al Cajero y al Supervisor, el ítem desaparece de su menú y el manual en PDF de esos dos perfiles pierde la sección. Llegó a las bases existentes por una migración de datos (2026_10_07_000236_v3_tipo_de_cambio_solo_tesoreria_y_admin.php), que cambia permisos de usuarios reales y por eso se avisa al cliente antes del deploy.

Esta tabla es el seed inicial, no una regla rígida: el Admin puede reconfigurar cualquier celda desde la ficha del usuario, respetando la dependencia Borrar→Escribir(→Leer).

2.1.1 Cómo llegó a las bases existentes ​

El deploy corre migrate y no seeders, y RoleSeeder pisa lo que un Admin editó desde la app. Por eso la matriz de cuatro perfiles llega a Staging y a Producción por una migración de datos (2026_10_02_130000_b6_perfiles_y_matriz_de_cuatro_roles.php), en este orden y sin disparar los eventos del modelo: (1) renombra la fila Backoffice a Cajero —las asignaciones de los usuarios apuntan por role_id y se conservan—, (2) crea Tesorería con una fila por módulo, y (3) fija celda por celda solo las que cambian. Las celdas que no están en esa lista no se tocan; las que sí, se fijan al valor del cliente aunque alguien las haya editado. Deja un evento de Auditoría sin usuario por cada cambio. Desde G8 hay una segunda migración que fija dos celdas del tipo de cambio (nota ⑿, 2026_10_07_000236_v3_tipo_de_cambio_solo_tesoreria_y_admin.php), y RoleSeeder::MATRIX es el resultado de las dos, en orden, para las bases nuevas. Detalle y razones en el ADR-014.

2.1.2 Quién puede qué, en una mirada ​

Dos lecturas que conviene tener a mano: el único perfil que cancela es el Admin (un Cajero que se equivocó de transacción tiene que pedírselo), y Tesorería mueve la plata pero no toca transacciones (no paga, no cancela, no abre una transacción ni busca en Pago).

2.2 ¿Se necesita UI/UX en esta etapa? ​

No. En esta fase (Análisis Funcional del Product Owner) alcanza con dejar definida la regla de negocio (matriz configurable, dependencia Borrar→Escribir) y el módulo en el sitemap. El diseño visual del componente de toggles (cómo se ve la grilla, si se bloquea visualmente el toggle de Escribir cuando Borrar está ON, etc.) es responsabilidad del agente ui-engineer en la etapa de diseño, y ya quedó anotado como señal de handoff (ver Señales de Handoff).

2.3 Asignación de Roles Multipaís / Multi-PDV (confirmado 2026-07-24) ​

Esta es una dimensión adicional a la matriz L/E/B de 2.1 (que define qué puede hacer cada rol) — acá se define qué rol tiene cada usuario, en qué país, y en qué PDV, y también debe ser editable desde Admin (ABM Asignación de Roles Multipaís/PDV).

Reglas confirmadas por el cliente:

  • Un mismo usuario puede tener roles distintos en distintos países (ej: Admin en Guatemala y Supervisor en otro país).
  • Un Supervisor puede estar a cargo de más de un PDV.
  • Toda esta lógica de asignación (usuario × país × rol, y supervisor × PDVs) debe ser editable, no fija.

Nota de diseño para el architect: esto implica que el control de acceso no es simplemente "Usuario → Rol", sino "Usuario → (País, Rol, [PDVs])" — cada sesión/consulta debe filtrar datos según el conjunto de países/PDVs donde el usuario tiene un rol asignado.

2.3.1 Qué confirmó el cliente y qué es diseño (G8, 2026-10-07) ​

Lo de arriba se confirmó con el cliente el 2026-07-24 y habla de países y de PDVs. Qué pasa cuando una persona tiene dos asignaciones en el mismo país, o cómo se combina el menú, no estaba en esa conversación: salió de las decisiones de diseño de B6 (ADR-014 §6). Esta tabla separa las dos cosas para que nadie le atribuya al cliente lo que es del sistema, ni al revés:

ReglaDe quién es
Una persona tiene roles distintos en países distintosCliente, 2026-07-24
Un Supervisor puede estar a cargo de varios PDVsCliente, 2026-07-24
Todo esto es editable, no fijoCliente, 2026-07-24
Con dos asignaciones en el mismo país se suman los permisosDiseño (ADR-014 §6, B6). No se le consultó al cliente; su captura de «Cajero y Admin» en el mismo país (img 31) es justo ese caso
El menú y las rutas son la unión de todas las asignaciones, sin mirar el paísDiseño
«Supervisa» se decide dentro de una misma asignaciónDiseño (ADR-014 §6; G5 y G6)
No hay selector de perfil: se mezclan las opcionesDecisión de Carlos, 2026-10-04 (D3-T2). El cliente lo pidió en la hoja Menús y perfiles (ítem 1) y se le contesta por qué no
Tesorería es un único perfil y es regional por asignaciónDecisión de Carlos, 2026-10-04 (D3-T1), sobre cómo leer el «Local o Regional» de la misma hoja

2.3.2 Cómo se combinan las asignaciones de una persona ​

Es una regla de producto, no un detalle de implementación: con más de una asignación se mezclan las opciones, y lo que se le asigna a la persona es lo que puede hacer. El diagrama muestra qué capa decide cada cosa; el detalle (y las combinaciones sensibles) está en ADR-014 §6, y la pantalla por pantalla, en Secuencias de Pantalla, 5.1.1.

Dos consecuencias para el Admin: «Admin más cualquier perfil» en el mismo país es el Admin (el Admin ya incluye lo del Cajero, del Supervisor y de Tesorería: lo fija un test), y un Admin en un solo país tiene los ABMs, la Configuración y la Auditoría de todo el sistema, porque esos permisos no tienen país.

2.3.3 Tesorería es un único perfil, regional por asignación (D3-T1) ​

La hoja de menús del cliente escribe cinco veces «Tesorería Local o Regional según corresponda». Se lee «Tesorería»: no existe una «Tesorería Local» ni se crea otro rol. «Regional» es la asignación: una persona con Tesorería asignada a todos los países (una asignación por país; no existe una asignación «todos los países», y al dar de alta un país hay que sumárselo) es regional; con un país, local. Lo que carga lo hace solo en los países de sus asignaciones; la Holding, que es global, se ve completa solo con cobertura de todos los países. «CIS Guatemala solo su estado de cuenta» queda cubierto por una asignación de Tesorería a Guatemala, para los extractos de País y de PDV. Una asignación acotada por PDV no lee los extractos de país: las de Tesorería se dan por país entero, y quien ve un PDV solo es un Supervisor. El detalle está en ADR-014 §1.

Quién ve qué extracto. La hoja «Módulo tesorería» del cliente (fila 112, «Perfiles») le pone a cada entidad un perfil: Tesorería Regional a Soterex ↔ CIS Holding y a CIS Holding, Tesorería Local a CIS Guatemala y a los PDV. Para el sistema es el mismo perfil, Tesorería: lo que cambia es la asignación, y lo que no se ve lo decide el backend por API, no solo la pestaña.

Entidad de la hoja (extracto)Cómo la llama la hojaTesorería con todos los países, o AdminTesorería de un solo país (Guatemala)Supervisor de un PDV
Soterex ↔ CIS Holding (E1)Tesorería RegionalCompleto y global, sin aviso; la tarjeta Saldo con Soterex suma todos los paísesSolo la parte de Guatemala, con el aviso de «parcial»; la tarjeta se llama Saldo de la Holding — de sus países y suma solo los suyos (G12, D3-19 b, ADR-007 §1). Nada de los demás países403
CIS Holding (E2)Tesorería RegionalCompleto y global, con «de los cuales comisiones» en el encabezadoSolo la parte de Guatemala, con el aviso de «parcial»403
CIS Guatemala (E3, el extracto País)Tesorería LocalEl de cada país, uno por vezCompleto: cada fondeo y cada pago de todos los PDV de Guatemala. El de otro país: 403403
PDV1, PDV2 (E4)Tesorería LocalEl de cualquier PDVCompleto el de cada PDV de Guatemala. Un PDV de otro país: 403, exista o noSolo los suyos; uno ajeno, 403 exista o no

Lo que cubre y lo que no: con una asignación de Tesorería a Guatemala, «CIS Guatemala solo su estado de cuenta» queda cubierto para País y PDV, y esa persona ve también la porción de su país de los dos extractos de la Holding, porque la Holding es global y el cliente no pidió quitarla (QC-32, por defecto). Quien tiene que ver un solo PDV es un Supervisor: una asignación de Tesorería acotada por PDV no lee los extractos de país entero.

El alcance de la tarjeta y el de los extractos es el mismo, y es de país entero (G12, revisión): PermissionService::wholeCountryIds(), un solo lugar. Un país donde la asignación está acotada por PDV no cuenta ni en la tarjeta ni en los extractos de la Holding y del país, y pedirlo a mano (GET /prefondeo?country_id=…, o el extracto con country_id) responde 403. El Admin no es una excepción: tiene sus asignaciones por país y, si da de alta un país, su vista pasa a parcial hasta que se asigne en él.

Un país inactivo y sin movimientos (El Salvador y Honduras se siembran así) no cuenta para decidir si una Tesorería «cubre todos los países»: no hay nada que ocultarle, así que no ve el aviso de «parcial» ni se le calcula el saldo con un país de menos. Uno inactivo con movimientos sí cuenta, y un país que se da de alta activo cuenta desde el primer momento: hay que sumárselo a la Tesorería regional para que vuelva a ver la Holding completa.

2.4 ⚠️ CORRECCIÓN (2026-07-25): el PDV de una transacción NO se conoce al ingresar — se asigna recién al resolverla ​

Esto corrige una implementación ya hecha en M1 — quedó documentado acá porque afecta directamente el alcance por PDV descripto en 2.3, y porque el criterio de aceptación original de M1 ("el listado no muestra transacciones... sin PDV") es exactamente el error inverso: si las transacciones entran sin PDV (como corresponde), esa regla haría que ningún Cajero (entonces Backoffice) viera jamás una transacción pendiente.

Regla correcta:

  • Soterex/SendRequest no informa PDV — a esa altura es imposible saberlo. Una transacción ACCEPTED recién ingresada no tiene PDV asignado, solo país.
  • Todas las transacciones ACCEPTED de un país conforman una bolsa compartida — cualquier Cajero o Supervisor con acceso a ese país (sin importar a qué PDV específico esté asignado) puede tomarlas. (Desde A5.1 el Cajero no ve la bolsa en un listado: llega a cada transacción buscándola en Pago, y su Reporte individual muestra solo lo que resolvió él.)
  • El PDV recién se define cuando un usuario la resuelve (la pasa a PAID o CANCELLED): en ese momento se graba qué usuario y de qué PDV la resolvió (el PDV activo de ese usuario en su sesión — ver la pregunta nueva más abajo sobre qué pasa si el usuario tiene más de un PDV asignado). (Desde G4, 2026-10-06, ADR-020: al pagar, el PDV sale del PDV activo, del único PDV del alcance o, en un país con módulo Caja, de la caja de la que sale la plata, en ese orden y sin que la caja pise a los anteriores; con 2+ PDV sin activo ni caja se rechaza con 422 en vez de dejar la transacción sin PDV. Al cancelar la regla es la de antes y no cambió: es transacciones:delete, solo del Admin en la matriz de fábrica.)
  • El acotamiento por PDV de la matriz de permisos (2.3) aplica a transacciones ya resueltas (para reporting/auditoría por PDV), no a las ACCEPTED pendientes — esas son visibles a nivel país para cualquier Cajero/Supervisor con acceso a ese país.

Requisito reforzado — verificación hasta el último momento: como ahora varios cajeros de distintos PDVs pueden estar mirando la misma transacción pendiente al mismo tiempo (comparten la bolsa del país), el riesgo de que dos personas intenten resolver la misma transacción a la vez sube — no es un caso raro, es esperable. El sistema tiene que volver a verificar el estado actual de la transacción justo antes de confirmar el cambio (no alcanza con haberlo chequeado cuando se abrió la pantalla) — si otro usuario ya la resolvió un instante antes, se rechaza el cambio con un error claro ("esta transacción ya fue procesada por [otro usuario]") y se refresca el listado, en vez de permitir un doble procesamiento.

2.5 ⚠️ NUEVO (2026-07-25): la comisión es información restringida — solo Reportes y el Dashboard de Tesorería y Admin ​

CORREGIDO (2026-10-02, B6, P11 confirmada por Carlos): «Dashboard, pero solo para el rol Supervisor». La comisión del Dashboard ya no se decide por el nombre del rol: la ve quien tiene prefondeo·L en el país, que es Tesorería y Admin. El Supervisor dejó de verla (antes era el único que la veía, ni siquiera el Admin). La razón: es la misma audiencia que ya ve de dónde sale esa plata, el saldo de la Holding, y un rol creado a mano con los mismos permisos ahora se comporta igual. En Reportes la comisión sigue estando para quien tiene reportes·L, el Supervisor incluido. El resto de la regla —ni en el listado, ni en el detalle, ni en el modal de pago— no cambia. Lo que sigue es el texto original, con los nombres de su época.

Regla de negocio confirmada por el cliente: el monto de la comisión CIS de una transacción no se muestra en ningún lugar operativo del sistema — ni en el listado de Transacciones, ni en el detalle de una transacción, ni en el modal de confirmación de pago/cancelación. Se muestra únicamente en:

  1. Reportes (estado de situación contable, agregados).
  2. Dashboard, pero solo para el rol Supervisor (no para Backoffice ni cualquier otro rol que entre al Dashboard).

Por qué importa más que un cambio visual: esto no se resuelve solo ocultando el campo en el frontend — si el backend sigue devolviendo fee/comision en la respuesta de la API para cualquier usuario, alcanza con abrir las DevTools del navegador para verlo igual. La restricción tiene que aplicarse en el backend, condicionando qué campos incluye la respuesta según el rol del usuario que hace el request — el frontend ocultando el campo es una capa extra, no la protección real.

Alcance de la restricción — qué SÍ sigue visible:

  • ABM Países (donde el Admin configura el % de comisión editable por país) — esto es configuración del sistema, no una "revelación" de la comisión de una transacción puntual. Se asume que sigue visible/editable para Admin sin cambios. A confirmar con el cliente si esta lectura es correcta o si también hay que restringir esta pantalla.

Módulos afectados (a auditar y corregir):

  • GET /api/transacciones y GET /api/transacciones/{id} — el campo de comisión no debe venir en la respuesta salvo que el usuario sea Supervisor consultando desde el contexto de Reportes/Dashboard.
  • Listado de Transacciones (columna "Comisión") — sacar para todos los roles excepto el caso de uso de Reportes.
  • Detalle de Transacción — sacar el dato de comisión de la vista.
  • Modal de confirmación de pago/cancelación (el "recibo") — sacar la fila de comisión por completo, no mostrarla ni siquiera al Supervisor en este flujo puntual (la regla es "Reportes y Dashboard", no "donde sea que el Supervisor esté parado").

← Sitemap · Índice · Siguiente: User Flows →

Documentación viva — se actualiza junto con el código, no es un anexo aparte.