Skip to content

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 MTCN secuencial aleatorio ú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 doc/plans/ y como PRD vinculado a este análisis. La Pregunta Abierta #2b se disolvió (ver corrección arriba) — el Paso 2 ya no tiene ese bloqueante.


← Preguntas Abiertas · Índice

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