Skip to content

Sitemap ​

Análisis Funcional: Integración Soterex — parte 2 de 8. ← Resumen · Índice · Siguiente: Roles y Permisos →

⚠️ ACTUALIZADO (2026-08-07) ​

El sitemap original (2026-07-24) era un árbol de intenciones: se escribió antes de que existiera una sola pantalla. Lo que sigue es el sitemap real, derivado de frontend/src/router/index.ts y de la navegación de frontend/src/layouts/AppLayout.vue, con las rutas tal cual son. El árbol viejo quedó abajo, tachado en lo que ya no aplica, porque varias de sus decisiones se revirtieron y conviene ver contra qué.

Los tres cambios que hacen que el árbol viejo no sirva más:

  1. Apareció la pantalla Pago, que es el punto de entrada del Backoffice (no Transacciones).
  2. Apareció el módulo Caja entero, con su tipo de cambio.
  3. El prefondeo se partió en dos pantallas (Holding y País).

Además, los ABMs sueltos que listaba el árbol viejo se agruparon en dos secciones con solapas —Usuarios y Accesos, Ubicaciones— y "ABM Roles y Permisos" dejó de ser una pantalla propia: los permisos se editan inline desde la ficha del usuario (E3).

Actualizado 2026-10-02 (B4): Reportes suma la pestaña Cumplimiento (R5), con permiso propio. Ver la nota en 1.3.

Actualizado 2026-10-02 (B6, ADR-014): el cliente pidió cuatro perfiles —Cajero, Supervisor, Tesorería y Admin— y un menú nuevo. El Backoffice se llama ahora Cajero (se renombró la fila del rol: los usuarios y sus asignaciones siguen siendo los mismos). Lo que cambia en este documento:

  1. El menú se reagrupa: «Operación» desaparece y se parte en Caja y Tesorería; Reportes pasa a ser un grupo propio; Auditoría se muda a Administración.
  2. Tipo de cambio deja de ser una pestaña de Ubicaciones: es una pantalla de Tesorería, con ruta propia (/tipo-cambio). Ubicaciones pasa a llamarse Parámetros.
  3. Cambian los nombres de cuatro pantallas: Transacciones → Reporte individual, Caja → Saldos, Prefondeo Holding → Prefondeo Soterex, Prefondeo País → Fondeo PDVs.
  4. Aparece el perfil Tesorería, que no tiene Pago ni Reporte individual.

Los textos fechados antes de esta actualización (los banners de arriba, el árbol de 1.4) conservan los nombres de su época a propósito. Las secciones 1.1, 1.2 y 1.3 describen lo que hay hoy.

Actualizado 2026-10-02 (B7, ADR-015): las dos pantallas de prefondeo pasan a tener pestañas de extracto (estado de cuenta con saldo corrido). Prefondeo Soterex suma Soterex ↔ CIS Holding y CIS Holding; Fondeo PDVs suma País y PDV. Y como la pestaña PDV la lee fondeo_caja, «Fondeo PDVs» se abre al Supervisor: entra y ve solo los extractos de sus PDVs. Cambia el diagrama de 1.1, el del menú de 1.2 y la barra del celular (el Supervisor pasa a siete destinos).

Actualizado 2026-10-07 (G8, ADR-014): el tipo de cambio sale del Cajero y del Supervisor (es solo de Tesorería y Admin). Cambia el menú de 1.2 (el Cajero ya no tiene el grupo Tesorería y el Supervisor tiene solo Fondeo PDVs), la barra del celular (el Cajero tiene tres destinos y el Supervisor vuelve a seis, sin «Más») y las notas de 1.3. Y 1.2 dice qué menú ve quien tiene más de un perfil: la suma de los de cada uno.

1.1 Sitemap real ​

Qué hay adentro de cada pantalla (el detalle, con sus rutas y permisos, está en Secuencias de Pantalla):

PantallaLo que tiene
PagoBuscador por MTCN; ficha del resultado con los datos, los soportes y Pagar (Cancelar solo lo ve el Admin); «Mis transacciones», lo que resolvió el propio usuario
Reporte individualListado de transacciones (con la columna Procesada por: quién la resolvió) y su export a Excel; de cada una, su detalle con historial y la sección de documentos y papeleta. Pagar y cancelar con las mismas reglas que en Pago
SaldosSelector de caja (solo si hay más de una); apertura y cierre de sesión, diarios; fondeo y ajuste (Tesorería y Admin); movimientos con export a Excel y PDF; totales por PDV
Prefondeo SoterexSaldo con Soterex (principal más comisión; de todos los países, o solo de los del usuario si no los lee todos, con aviso), el alta de asiento (con referencia opcional) y dos pestañas de extracto: Soterex ↔ CIS Holding y CIS Holding, con saldo anterior, rango de fechas y export a Excel y PDF
Fondeo PDVsPestaña País: saldo del país (solo principales, admite negativo), el desglose repartido en cajas / disponible para repartir, el alta de asiento y el extracto del país. Pestaña PDV: el extracto de un PDV, con su columna Caja. Cada pestaña aparece con su permiso: el Supervisor ve solo la de PDV
Tipo de cambioEl vigente por país y el historial inmutable
ReportesEstado de Situación (con balance final), Volumen y Comparativas, Cajas (resumen y detalle), Cierres por día y Cumplimiento (Excel de 36 columnas, permiso propio, solo Admin)
Usuarios y AccesosUsuarios (ABM con permisos y asignaciones en la ficha) y Roles (propiedades del rol, como el timeout)
ParámetrosPaíses (módulo Caja, moneda local y de pago, formato de recibo), Estaciones / PDV (con las cajas de cada uno) y Catálogos (listas de los combos del pago)
ConfiguraciónTimeout de sesión e integración con Soterex
AuditoríaMovimientos y logins, con filtros y export a PDF

Las rutas reales de cada nodo están en Secuencias de Pantalla.

1.2 Qué ve cada perfil ​

No hay redirecciones por nombre de rol: el guard toma la primera ruta que el usuario puede Leer, en el orden de prioridad del sitemap (firstAllowedRoute() en frontend/src/router/index.ts). Con el seed real (backend/database/seeders/RoleSeeder.php) eso da:

PerfilAterriza enPor qué
Cajero/pagoNo tiene dashboard:read, y pago va antes que transacciones en la lista de prioridad
Supervisor/ (Dashboard)Tiene el Dashboard, que va primero
Tesorería/ (Dashboard)Tiene el Dashboard. Sin él caería en Prefondeo Soterex
Admin/ (Dashboard)Tiene todo

Y este es el menú que dibuja cada uno. Cada ítem aparece si el perfil puede Leer su módulo; los grupos que quedan vacíos no se dibujan. Documentación lo ven los cuatro y no se repite en el diagrama.

La barra inferior del celular lleva los destinos de uso diario (Dashboard, Pago, Reporte individual, Saldos, Prefondeo Soterex, Fondeo PDVs, Tipo de cambio y Reportes), filtrados por los mismos permisos. Entran seis: el Cajero tiene tres (Pago, Reporte individual y Saldos), el Supervisor seis y Tesorería seis, y todos entran sin «Más». El Admin tiene ocho: ve cinco y un botón Más que abre el resto. Administración nunca está en la barra. El Cajero tiene cuatro y el Supervisor siete (desde que Fondeo PDVs se le abrió en B7), con Tipo de cambio y Reportes en «Más». Eso era antes de G8: sin el tipo de cambio, al Cajero le bajan los destinos y al Supervisor le entran todos.

Quien tiene más de un perfil ve el menú de la suma: la unión de los menús de cada asignación, sin mirar el país (el menú de un Cajero en Guatemala y Tesorería en El Salvador es el de los dos juntos), y la barra del celular sigue la misma suma: lo que no entra en los seis destinos va a «Más». No hay un selector de perfil, y cae en la primera pantalla que alguno de sus perfiles puede leer (un Cajero que además es Tesorería cae en el Dashboard, no en Pago). El Admin ya incluye lo del Cajero, el Supervisor y Tesorería: «Admin más cualquier perfil» en el mismo país ve exactamente el menú del Admin. Las reglas completas están en Roles y Permisos, 2.3.2.

1.3 Notas ​

  • CORREGIDO (2026-07-28, decisión #1 del plan v2):No existe pantalla de "papeleta" ni de "punto de venta" separada — el punto de venta opera con el rol Backoffice dentro del mismo sitemap. Sigue siendo cierto que no hay una sección "punto de venta": el PDV opera con el rol Cajero (el Backoffice de antes) dentro del mismo sitemap. Lo que cambió es que ese rol tiene ahora su propia pantalla de entrada (/pago), y que la papeleta sí existe — no como pantalla del árbol, sino como PDF que se genera desde la ficha de la transacción y se reimprime desde ahí. Ver Pago con documentos. ✅
  • /admin/roles-permisos ya no existe. La matriz L/E/B dejó de ser una pantalla propia con E3: se edita inline en la ficha del usuario, sobre los roles que ese usuario ya tiene asignados. El permiso abm_roles_permisos sigue existiendo y sigue siendo el gate. RolesPermisosView.vue quedó huérfano en el repo, sin ruta.
  • "Asignación de Roles" cambió de contenido, no solo de lugar. Dejó de ser "buscar usuario y asignarle rol" (eso se mudó a la ficha del usuario) y pasó a ser propiedades del rol — hoy, el timeout de sesión. La ruta y el archivo conservan el nombre viejo a propósito.
  • CORREGIDO (2026-10-02, B6): Tipo de Cambio vive en Ubicaciones, no en Administración. Es configuración por país, y el Supervisor la edita sin tener abm_paises ni abm_estaciones, así que necesita su propio módulo de permiso (tipo_cambio). Tipo de cambio es una pantalla de Tesorería, con ruta propia (/tipo-cambio, mismo name de ruta y mismo módulo tipo_cambio). Lo editan Tesorería y Admin; el Cajero y el Supervisor lo leen (el Supervisor ya no lo edita). Desde G8 (2026-10-07) lo ven y lo editan solo Tesorería y Admin: el Cajero y el Supervisor no lo leen. La URL vieja, /admin/ubicaciones/tipo-cambio, redirige a la nueva. «Parámetros» (antes «Ubicaciones», /admin/ubicaciones) se queda con Países, Estaciones / PDV y Catálogos, y su redirect sigue siendo dinámico: lleva a la primera pestaña que el usuario puede leer, no a una fija.
  • Qué hace el menú y qué no. Los cambios de B6 son de etiquetas y agrupación: las claves de módulo, los name de las rutas y los data-tour del recorrido guiado son los de siempre. Cada ítem sigue a su permiso, sin ningún caso escrito para un perfil.
  • «Fondeo PDVs» se abre con prefondeo_pais o fondeo_caja (B7). Hasta B7 el ítem seguía solo a prefondeo_pais: el Supervisor, que lee fondeo_caja pero no prefondeo_pais, habría entrado a una pantalla que el backend le respondía con 403. Con la pestaña PDV ya hay algo que mostrarle. La ruta declara meta.modules con los dos módulos (meta.module queda como el principal, el que usa el «?»), y el guard, firstAllowedRoute() y el menú siguen esa lista. Dentro de la pantalla cada pestaña aparece con su permiso y no se pide nada que el perfil no pueda leer.
  • El Cajero ve el grupo «Tesorería» con un solo ítem (Tipo de cambio, en solo lectura) y el Supervisor con dos (Fondeo PDVs, solo la pestaña de sus PDVs, y Tipo de cambio). Es consecuencia literal de la matriz (2.1): se saca con una celda. Se sacó con esa celda (G8, 2026-10-07): el Cajero no ve el grupo «Tesorería» y el Supervisor lo ve con un solo ítem, Fondeo PDVs (solo la pestaña de sus PDVs). Tesorería y Admin ven el grupo completo.
  • La pestaña "Cumplimiento" de Reportes tiene permiso propio (reporte_cumplimiento, B4). Exporta los datos personales de los beneficiarios, así que no viaja con reportes: es la única pestaña de Reportes con un módulo distinto, y por eso se dibuja solo a quien puede leerla (como el resto de las pestañas con módulo propio) y su ruta la bloquea el guard. El ítem "Reportes" del menú, y de la barra inferior del celular, aparece con cualquiera de los dos permisos; para quien tiene solo el de Cumplimiento, /reportes lo lleva directo a esa pestaña. No tiene vista previa: es un formulario de filtros y un botón de descarga (5.7).
  • Documentación no tiene módulo de permiso: es visible para cualquier usuario autenticado.

1.4 Sitemap original (2026-07-24) — referencia histórica ​

Se conserva para poder rastrear qué se pensó al principio y qué se terminó construyendo. No es la fuente de verdad; lo es 1.1.

Qué de ese árbol no sobrevivió:

Nodo originalQué pasó
Dashboard como raíz de todoEl Backoffice (hoy Cajero) no lo tiene: entra por /pago
Prefondeo (una sola pantalla)Se partió en Holding y País (ADR-007); desde B6 se llaman Prefondeo Soterex y Fondeo PDVs y viven en el grupo Tesorería; desde B7 cada una tiene pestañas de extracto (ADR-015)
ABM Países - incluye % comisiónEl commission_pct se eliminó (ADR-005); la pantalla ganó módulo Caja, moneda local y moneda de pago
ABM Roles y PermisosDejó de ser pantalla: se edita inline en la ficha del usuario (E3)
ABM Asignación de RolesCambió de contenido: hoy son propiedades del rol
TransaccionesSigue existiendo con el nombre Reporte individual (B6)
Administración con los ABMs sueltosSe agrupó en Usuarios y Accesos, Parámetros (antes Ubicaciones) y Configuración; Auditoría se sumó a ese grupo
—Se agregaron: Pago, Caja (hoy Saldos), Prefondeo País (hoy Fondeo PDVs), Tipo de Cambio, Reportes → Cajas, Reportes → Cumplimiento, Documentación

← Resumen · Índice · Siguiente: Roles y Permisos →

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