Señales de Handoff (siguiente paso: PRD + Backlog)
Análisis Funcional: Integración Soterex — parte 8 de 8. ← Preguntas Abiertas · Índice
⛔ CORREGIDO (2026-09-30, ADR-012): este documento es del 2026-07-24 y quedó desactualizado en dos puntos de hecho, no solo en la pregunta abierta que menciona: (1) el mecanismo no es "WebApp→Soterex vía cron de 30 min" — es al revés, Soterex llama a CIS bajo demanda, sin cron; (2) el MTCN no es "secuencial único" — es aleatorio (CSPRNG) y único (D11). La Pregunta Abierta #2b se disolvió, no quedó "resuelta" como bloqueante del PRD — ver Preguntas Abiertas. Lo que sigue vigente tal cual de este handoff: todo lo de permisos, roles multipaís/PDV, timeout de sesión y SSO.
- → architect: estructura del sitemap, diagramas de actividad (
el mecanismo WebApp→Soterex vía cron de 30 min ya está confirmado; queda bloqueante la Pregunta Abierta #2b sobre cómo llega una cancelación iniciada por Soterex— ver corrección arriba), modelo multi-país con roles multipaís/multi-PDV editables (ver Matriz de Roles y Permisos), comisión editable por país, prefondeo como pool por país, necesidad de log/auditoría completo, y arquitectura de login preparada para agregar SSO Google/Microsoft en Fase 2 aunque el MVP1 sea solo usuario/contraseña. - → backend-dev: modelo de datos de permisos (Módulo x Rol x Leer/Escribir/Borrar, con dependencia Borrar→Escribir), modelo de asignación Usuario × País × Rol × [PDVs], los 4 contratos de API de Soterex (
tokenC2P,SendRequest,Cancel,Notifications— ver corrección arriba sobre quién llama a quién), lógica de generación de MTCNsecuencialaleatorio único, lógica de descuento de prefondeo (pool por país) y bloqueo por saldo insuficiente, entidad Estación/PDV con código interno de sucursal como identificador y múltiples mails de notificación editables, timeout de sesión en 3 niveles (global/rol/usuario). - → ui-engineer: lista de pantallas de Secuencias de Pantalla como cola de producción, estados visuales de transacción (ACCEPTED/CANCELLED/PAID), alertas de saldo insuficiente y de error de actualización, diseño del componente de grilla de permisos L/E/B con su regla de dependencia, y diseño de la pantalla de asignación de roles multipaís/PDV por usuario.
- → security: manejo de JWT (
tokenC2P— reemplazado por OAuth 2.0 Client Credentials estándar, ver ADR-012), diseño de auth preparado para agregar SSO Google/Microsoft en Fase 2 (MVP1 = solo usuario/password), timeout de sesión configurable en 3 niveles, logs de auditoría de logins (visibles para Supervisor y Admin).
Este documento corresponde al Paso 1 (Análisis Funcional) de la metodología del agente Product Owner. El Paso 2 (PRD + Backlog) se redactará una vez resuelta la Pregunta Abierta #2b (único bloqueante real restante), y se guardará en La Pregunta Abierta #2b se disolvió (ver corrección arriba) — el Paso 2 ya no tiene ese bloqueante.doc/plans/ y como PRD vinculado a este análisis.

