Saga, una herramienta para inyectar estado en las pruebas

El problema

Para revisar un error en el paso 5 del flujo KYC, primero había que rellenar datos personales válidos, subir documentos de identidad y superar las pruebas de liveness de los pasos 1 a 4. Cada vez, en cada pull request y en cada ejecución automática.

El enfoque

Saga permite que una persona de pruebas o un script abra la aplicación ya en el estado que necesita.

1. Un script de Playwright o un ingeniero de QA carga la página con un token de prueba seguro, por ejemplo ?state=step_4_ready.
2. El frontend detecta el token durante la hidratación y lo reenvía en una cabecera al BFF.
3. El BFF comprueba que el entorno no es en absoluto producción y prepara la sesión del usuario en la base de datos de pruebas: pasos 1 a 3 completados y el puntero activo en el paso 4.
4. El BFF devuelve un token de sesión real y la interfaz muestra el paso 4 al instante.

Elegí la inyección desde el servidor en lugar de simular localStorage en el cliente. Las aplicaciones modernas validan las sesiones en el backend, así que una simulación solo en el cliente se aleja de la realidad y produce pruebas que pasan aquí y fallan en producción.

El resultado

La preparación de las pruebas de regresión pasó de 10–20 minutos por ciclo a menos de un minuto. Con decenas de ejecuciones de pull requests y suites de automatización cada semana, eso devolvió cientos de horas de ingeniería por trimestre.