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).

1.1 Sitemap real

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

1.2 Qué ve cada rol al entrar

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:

Rol	Aterriza en	Por qué
Backoffice	/pago	No tiene dashboard:read ni transacciones:read — decisión #1 del plan v2
Supervisor	/ (Dashboard)	Tiene el Dashboard, y no tiene pago:read
Admin	/ (Dashboard)	Tiene todo

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 Backoffice 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.
• 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). Por eso el redirect de /admin/ubicaciones es dinámico: un Supervisor que caiga en un redirect fijo a /paises sería rebotado fuera de la sección entera.
• 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 original	Qué pasó
Dashboard como raíz de todo	El Backoffice no lo tiene: entra por /pago
Prefondeo (una sola pantalla)	Se partió en Holding y País (ADR-007)
ABM Países - incluye % comisión	El commission_pct se eliminó (ADR-005); la pantalla ganó módulo Caja, moneda local y moneda de pago
ABM Roles y Permisos	Dejó de ser pantalla: se edita inline en la ficha del usuario (E3)
ABM Asignación de Roles	Cambió de contenido: hoy son propiedades del rol
—	Se agregaron: Pago, Caja, Prefondeo País, Tipo de Cambio, Reportes → Cajas, Documentación

---

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