Caso de automatización / 01 · Identidad de la ejecución, máquina de estados, continuación y reanudación segura

Diseñar la orquestación con estado de un proceso comercial de larga duración

Un caso contado a través de un ciclo de rendimiento comercial: el patrón es la orquestación con estado, no un proceso mensual.

El caso en síntesis

Realidad actual

Un proceso comercial recurrente ejecuta sus pasos dependientes como un único proceso programado, una larga cadena o varias automatizaciones poco coordinadas—así que, cuando falla el paso siete, nadie sabe qué terminó, qué puede volver a ejecutarse ni qué efectos externos ya se consolidaron.

Qué tiene que llegar a ser cierto

Cada ejecución tiene una identidad duradera y un estado explícito. Arranca una sola vez, ejecuta sus pasos en orden, espera y se reanuda, reintenta solo lo que es seguro, omite el trabajo ya completado, se detiene cuando continuar no es seguro, muestra su progreso y termina con un resultado definitivo—para que un fallo en el paso siete nunca obligue a repetir a ciegas los pasos uno a seis.

Pregunta de diseño

¿Cómo puede un proceso de negocio de larga duración avanzar por pasos dependientes y esperas externas sin dejar de ser seguro de reanudar, reintentar y operar?

01La realidad · situación actual

Qué hace hoy la automatización.

Cada periodo, un ciclo comercial prepara los datos de origen, calcula el estado analítico, clasifica las cuentas en segmentos, publica las señales resultantes en el CRM, activa el seguimiento, concilia lo ocurrido y cierra la ejecución. Los pasos dependen unos de otros y de trabajo que el ciclo no controla: una actualización de datos, un cálculo analítico, una plataforma aguas abajo que procesa a su propio ritmo. La primera versión era un único proceso programado que llamaba a cada paso en secuencia. Cuando fallaba a mitad, un administrador lo relanzaba desde el principio.

  • Nadie sabe a qué periodo pertenece una ejecución, ni si terminó
  • Relanzar tras un fallo repite pasos que ya habían ido bien
  • Las cuentas reciben seguimiento duplicado cuando un paso se ejecuta dos veces
  • El proceso arranca antes de que estén listos los datos de los que depende
  • Una respuesta tardía se interpreta como «nunca arrancó», así que el trabajo se lanza otra vez
  • Los fallos solo se ven en un log técnico, y una ejecución atascada no tiene responsable
  • Una simulación y una ejecución de producción son indistinguibles

02Por qué falla la versión ingenua

Lo que la primera automatización no puede responder.

Una implementación ingenua ejecuta los pasos como un único proceso programado, una larga cadena o varias automatizaciones poco coordinadas. Cuando algo falla a mitad, las preguntas que importan no tienen respuesta.

  • ¿Qué pasos terminaron?Ningún registro duradero lo dice; el log del proceso acaba en el error.
  • ¿Cuáles no?Un paso que estaba en curso se ve igual que uno que nunca arrancó.
  • ¿Cuáles pueden volver a ejecutarse sin riesgo?Algunos pasos pueden repetirse sin daño; otros crean trabajo para personas reales.
  • ¿Qué operaciones externas ya se consolidaron?La plataforma aguas abajo puede haber aceptado un lote del que el proceso nunca recibió respuesta.
  • ¿Debe reiniciarse todo el proceso?Reiniciar es la única recuperación que ofrece el diseño—y lo repite todo.
  • ¿Quién es responsable de una ejecución atascada?No hay nadie designado; el primero que se da cuenta se convierte en responsable.
  • ¿Y si una dependencia termina más tarde?El proceso ya ha fallado o ha seguido adelante; nada retoma el trabajo.

03Dimensión clave · Identidad de la ejecución, máquina de estados, continuación y reanudación segura

Una ejecución, una máquina de estados, un solo sitio donde mirar

El estado determina qué puede ejecutarse a continuación. El registro de ejecución es la memoria de la orquestación y su plano de control: qué periodo, qué estado, qué paso, a qué espera, qué falló y quién es el responsable.

Progreso de la ejecución
  1. 01Preparar los datos de origenCompletadoActualización confirmada para 2026-09
  2. 02Calcular el estado analíticoCompletadoMarcas de inicio y de finalización registradas
  3. 03Clasificar las cuentasCompletadoPoblación = cuentas clasificadas
  4. 04Publicar las señales operativasEn esperaLote 6 de 12 confirmado; la continuación vuelve a comprobarlo
  5. 05Activar las accionesSin empezarSolo puede arrancar cuando el paso 4 esté confirmado
  6. 06Conciliar los resultadosSin empezarUna vez por ejecución
  7. 07Cerrar la ejecuciónSin empezarLa cierra una persona
Salidas del camino
  • Reintentar

    Un fallo transitorio: reintentar el paso o el lote, no la ejecución

  • Intervención

    No es seguro continuar: actúa un responsable designado y después la ejecución se reanuda

  • Cancelar

    Detenida a propósito, con un motivo; nada continúa en silencio

  • Completar

    Todos los pasos hechos, conciliados y cerrados por una persona

Recorrido de la ejecución
Fallo
Recuperación
Paso 4 de 7
Recorrido de la ejecución

En espera

Una dependencia aún no ha terminado. Esperar es un estado, no un fallo: la ejecución sale de la transacción y continúa más tarde.

Puede pasar a
  • ProcesandoLa comprobación de continuación encuentra la dependencia completadaReloj
  • ConciliandoLa comprobación de continuación encuentra la activación confirmada aguas abajoReloj
  • Requiere intervenciónLa dependencia no está lista dentro de su presupuestoReloj

Se llega desde Preparando, Procesando, Activando.

  1. Creada · Recorrido de la ejecución

    La ejecución existe para su periodo y su ámbito; las entradas quedan congeladas.

    Puede pasar a: Preparando (Pasa la guarda de arranque: no hay otra ejecución para este periodo y ámbito)
  2. Preparando · Recorrido de la ejecución

    Comprobando que los datos de origen del periodo están listos.

    Puede pasar a: Procesando (Datos de origen listos para el periodo); En espera (La actualización de origen no ha terminado); Cancelada (La simulación encuentra una condición que hace inseguro continuar)
  3. Procesando · Recorrido de la ejecución

    Calculando, clasificando y publicando—paso a paso.

    Puede pasar a: En espera (El cálculo analítico sigue pendiente); Activando (Señales publicadas y confirmadas); Requiere intervención (Error de diseño o de datos, p. ej., población ≠ cuentas clasificadas)
  4. En espera · Recorrido de la ejecución

    Una dependencia aún no ha terminado. Esperar es un estado, no un fallo: la ejecución sale de la transacción y continúa más tarde.

    Puede pasar a: Procesando (La comprobación de continuación encuentra la dependencia completada); Conciliando (La comprobación de continuación encuentra la activación confirmada aguas abajo); Requiere intervención (La dependencia no está lista dentro de su presupuesto)
  5. Activando · Recorrido de la ejecución

    Entregando las señales publicadas a la acción, lote a lote.

    Puede pasar a: En espera (La plataforma aguas abajo sigue procesando); Requiere intervención (Resultado desconocido en un lote—resolverlo antes de cualquier reintento)
  6. Conciliando · Recorrido de la ejecución

    Comparando lo esperado con lo que existe aguas abajo.

    Puede pasar a: Completada (Diferencias dentro de la tolerancia; el responsable cierra la ejecución); Requiere intervención (Diferencias fuera de la tolerancia)
  7. Completada · Recorrido de la ejecución · final

    Todos los pasos hechos y conciliados; el responsable cerró la ejecución.

    Sin salida automática
  8. Requiere intervención · Fallo

    Continuar automáticamente no sería seguro; debe actuar un responsable designado. La ejecución se mantiene en su paso.

    Puede pasar a: Reanudando (El responsable corrigió la causa); Cancelada (El responsable abandona la ejecución del periodo, con un motivo)
  9. Cancelada · Fallo · final

    Detenida a propósito, con un motivo. Los pasos completados siguen registrados.

    Sin salida automática
  10. Reanudando · Recuperación

    Continuando desde el paso que se detuvo, con la misma ejecución y las mismas claves de efecto.

    Puede pasar a: Procesando (El paso detenido era un paso de procesamiento); Activando (Continuar desde el último lote confirmado)
El registro de ejecución · Valores de ejemplo
ID de ejecución
RUN-2609-ALL (ejemplo)
Periodo / ámbito
2026-09 · todas las sociedades
Inicio
1 oct, 06:10
Estado actual
En espera
Paso actual
4 · Publicar las señales operativas
Situación
Lote 6 de 12 confirmado
Última transición
Procesando → En espera, 07:42
Resultado
Abierta
Motivo del fallo
Ninguno
Responsable / intervención
Operaciones comerciales · no se requiere

La continuación no contiene lógica de negocio. Encuentra las ejecuciones sin terminar, comprueba si su dependencia ha avanzado y despierta a la máquina de estados—que decide qué puede ejecutarse a continuación.

04Contrato de pasos

Cada paso, con su modo, su actor y su guarda.

Disparador

Se abre el periodo y todavía no existe la ejecución para ese periodo y ese ámbito.

Terminado significa
  • Cada cuenta apta tiene una señal vigente para el periodo
  • El seguimiento existe una sola vez por Cuenta + segmento + periodo de entrada
  • La ejecución termina en Completada con un informe de conciliación—o en Cancelada con un motivo
  • El responsable de negocio tiene el resumen

Sistemas y actoresPlanificadorPlataforma de datosCRMPlataforma de campañas

  1. 01
    Preparar los datos de origen

    Esperar a la actualización del periodo: es una dependencia, no un paso que la ejecución lleve a cabo.

    OrquestadoPlataforma de datosGuardaActualización completa para el periodo
  2. 02
    Calcular el estado analítico

    Calcular el rendimiento frente al objetivo del periodo a partir de entradas congeladas.

    AutomatizadoPlataforma de datosGuardaAún no calculado para esta ejecución
  3. 03
    Clasificar las cuentas

    Exactamente un segmento por cuenta apta.

    AutomatizadoPlataforma de datosGuardaPoblación = cuentas clasificadas
  4. 04
    Publicar las señales operativas

    Publicar la versión del periodo y aplicarla por lotes; se reanuda desde el último lote confirmado.

    OrquestadoIntegración → CRMGuardaCursor de lotes
  5. 05
    Activar las acciones

    Entregar las señales a la automatización de ciclo cerrado; el seguimiento lleva clave y nunca se repite.

    AutomatizadoAutomatización del CRMGuardaCuenta + segmento + periodo de entrada
  6. 06
    Conciliar los resultados

    Comparar las señales y acciones esperadas con las reales; clasificar las diferencias.

    AutomatizadoConciliadorGuardaUna vez por ejecución
  7. 07
    Cerrar la ejecución

    Revisar el resumen y cerrar la ejecución—o cancelarla con un motivo.

    HumanoOperaciones comercialesGuardaConciliación dentro de la tolerancia
Contrato de pasos: cuándo puede arrancar cada paso, su guarda de arranque, a qué espera, cómo falla y quién interviene
PasoArranca cuandoGuarda de arranqueEspera aSi fallaResponsable de intervenir
1 · PrepararEjecución creada para el periodoEntradas congeladas una sola vezLa actualización de origenTiempo agotado → intervención (equipo de datos)Equipo de datos
2 · CalcularPaso 1 completadoMarca de inicio para esta ejecuciónEl cálculo analíticoTransitorio → reintento; error de datos → intervenciónEquipo de la plataforma de datos
3 · ClasificarPaso 2 completadoPoblación = cuentas clasificadas—Error de datos → detenerse antes de publicarOperaciones de ventas
4 · PublicarPaso 3 completadoVersión publicada una sola vez; cursor de lotesLa confirmación de los lotes aguas abajoResultado desconocido → resolver por clave y después reintentarOperaciones de integración
5 · ActivarPaso 4 confirmadoCuenta + segmento + periodo de entradaEl procesamiento aguas abajoRechazo → cola de reparación; la ejecución continúaOperaciones comerciales
6 · ConciliarPaso 5 completadoUna vez por ejecución—Fuera de tolerancia → intervenciónOperaciones comerciales
7 · CerrarConciliación dentro de la toleranciaCerrada una sola vez, por una personaLa revisión del responsableEl responsable cierra o cancela con un motivoOperaciones comerciales

05Seguridad de la ejecución

Si puede ejecutarse dos veces, está diseñado para ejecutarse dos veces.

Patrón de ejecuciónRegistro de ejecución duradero + máquina de estados explícita + pasos que arrancan una sola vez + continuación ligera

El ciclo dura más que una transacción, depende de trabajo que no controla, toca sistemas cuyos efectos una repetición no puede deshacer y debe reanudarse en el paso que se detuvo.

Clave de ejecución
Periodo + ámbito (p. ej., 2026-09 · todas las sociedades)
Arrancar una sola vez
Una segunda ejecución con la misma clave se rechaza de forma atómica
Marca de inicio
Se persiste antes de que un paso lance trabajo; iniciado no es completado
Guarda de paso
Cada paso comprueba su propio estado para esta ejecución antes de ejecutarse
Claves de efecto
Cuenta + segmento + periodo de entrada para cada seguimiento
Continuación
Una comprobación recurrente despierta las ejecuciones sin terminar; nunca crea una
Simulación
Misma ejecución, mismas comprobaciones, sin efectos secundarios—y se cancela cuando continuar no sería seguro
Cancelación
Un estado final con motivo; los pasos completados siguen registrados

06Reintento, idempotencia y fallo seguro

El reintento pertenece a la frontera del paso—y no todo fallo es un reintento.

Un fallo se clasifica antes de que nada vuelva a ejecutarse. «Exactamente una vez» no es una garantía de entrega que ofrezca la plataforma: es una propiedad del efecto de negocio que el diseño se gana con estado duradero, guardas de paso y fronteras idempotentes.

Cuatro clases de fallo

Clases de fallo: un ejemplo, el comportamiento y dónde continúa la ejecución
ClaseEjemploComportamientoDónde continúa la ejecución
TransitorioSe alcanza un límite de la plataforma a mitad de un loteEsperar y reintentar el loteEn el cursor de lotes
Rechazo de negocioEl sistema aguas abajo rechaza un registro de una cuenta cerradaSin reintento; el registro va a una cola de reparaciónLa ejecución sigue; el registro vuelve cuando se repara
Resultado desconocidoUna llamada agota el tiempo después de que la petición haya salidoResolver primero: buscar por la clave del paso; reintentar solo si no existe nadaEn el mismo paso, cuando se conoce el resultado
Error de diseño o de datosLas cuentas clasificadas no cuadran con la poblaciónDetenerse antes de publicar nadaIntervención y después reanudar—o cancelar

Si un paso puede invocarse dos veces

Cada paso decide de antemano qué significa una segunda invocación.

Fronteras de idempotencia: la situación, qué hace la segunda invocación y el mecanismo que lo explica
SituaciónLa segunda invocaciónPorque
El paso ya se completóSe ignoraLa guarda del paso lee Completado para esta ejecución
El paso sigue en cursoSe rechaza; la primera continúaLa marca de inicio se persistió antes de empezar ningún trabajo
El paso se detuvo a mitadSe reanudaEl cursor de lotes registra el último lote confirmado
El resultado ya existe aguas abajoLo detecta y lo registraCada efecto se busca por su clave antes de crearlo
El cálculo se vuelve a ejecutarProduce el mismo resultadoLas entradas se congelaron al crear la ejecución
Nunca llegó una respuestaNo da por hecho que el paso nunca se lanzóIniciado y completado son hechos distintos; la clave se comprueba aguas abajo

Una cancelación controlada es mejor que una continuación silenciosa

Fallo seguro: la condición, por qué no es seguro continuar y la respuesta
CondiciónPor qué no es seguro continuarRespuesta
Una simulación llega a un paso que necesitaría un efecto secundario que no puede simularEl ensayo dejaría de ser un ensayoCancelar la simulación con un motivo; informar de lo que habría pasado
Las entradas cambiaron después de crear la ejecuciónLos pasos posteriores no cuadrarían con los anterioresCancelar; arrancar una ejecución nueva para el mismo periodo
Ya hay una ejecución Completada para el mismo periodoUna segunda repetiría seguimiento realRechazar el arranque

07Fallo y recuperación

No todo fallo se resuelve reintentando.

  • Actualización de origen con retraso DependenciaDependencia incompleta al arrancar la ejecuciónEsperar como estado; la continuación vuelve a comprobar; escalar al agotar el presupuestoEquipo de datos
  • Límite de la plataforma alcanzado a mitad de un lote Transitorio · reintentoError de límite en un loteEsperar; continuar desde el cursorLa automatización
  • Ejecución arrancada dos veces DuplicadoLa clave de ejecución ya existeRechazar el segundo arranqueNadie: se absorbe
  • Resultado del lote desconocido DependenciaTiempo agotado después de que saliera la peticiónBuscar por clave antes de cualquier reintento; intervención si sigue sin estar claroOperaciones de integración
  • Registro rechazado aguas abajo RechazoRechazo de negocio sobre un registroCola de reparación; la ejecución continúaOperaciones comerciales
  • Clasificación incompleta ValidaciónPoblación ≠ número de cuentas clasificadasDetenerse antes de publicar; intervenciónOperaciones de ventas

08Observabilidad

Observabilidad de negocio, no solo logs.

Un operador—no solo un ingeniero—debe poder responder a estas preguntas desde la propia ejecución.

Preguntas del operador, qué las responde y dónde se ve
PreguntaLo respondeSe ve en
¿Qué ejecución está activa?ID de ejecución, periodo y ámbitoLista de ejecuciones
¿Dónde está?Estado actual y paso actualRegistro de ejecución
¿Cuánto tiempo lleva ahí?La última transición frente al presupuesto del pasoIndicador de antigüedad en la ejecución
¿Qué dependencia está pendiente?El motivo de la esperaRegistro de ejecución
¿Qué se ha ejecutado ya?Marcas de inicio y de finalización por pasoHistorial de pasos
¿Qué falló?Clase y motivo del falloRegistro de ejecución e historial de pasos
¿Puede reanudarse automáticamente?La clase de fallo: transitorio o noRegistro de ejecución
¿Quién es responsable de intervenir?El responsable de intervención del pasoRegistro de ejecución y cola del responsable
¿Qué pasará a continuación?Las transiciones válidas desde el estado actualMáquina de estados

09Las contrapartidas

Opciones creíbles, evaluadas frente a estas premisas.

Según el contexto

Un único proceso programado que llama a cada paso

Trabajo corto, local e idempotente que termina de una vez

Coste: Reinicio desde cero; duplicados; sin visibilidad
Descartada

Automatizaciones encadenadas sin estado de ejecución duradero

Dos o tres pasos locales sin esperas externas

Coste: Sin identidad de ejecución; los fallos rompen la cadena en silencio
Elegida

Ejecución duradera, máquina de estados explícita y continuación

Trabajo largo, dependiente y recurrente entre sistemas

Coste: Hay que construir y mantener un modelo de ejecución, una continuación y una pequeña vista de ejecuciones

Criterio a criterio

La ejecución duradera compensa su coste aquí porque el proceso dura más que una transacción, espera trabajo que no controla, toca sistemas cuyos efectos una repetición no puede deshacer y se repite cada periodo. Para trabajo corto, local e idempotente, un único proceso programado sigue siendo la respuesta correcta y más sencilla.

Opciones de orquestación comparadas criterio a criterio
CriterioUn único proceso programadoAutomatizaciones encadenadasEjecución duradera + máquina de estados
RecuperabilidadReinicio desde ceroDepende de dónde se rompió la cadenaReanudación en el paso detenido
VisibilidadUn log técnicoRepartida entre automatizacionesUn único registro de ejecución
Seguridad al repetirLo repite todoPoco clara en cada eslabónGuardas y claves por paso
Esperas largasRetiene una transacción o fallaSe pierden entre eslabonesEsperar es un estado
Gestión de dependenciasSe dan por listasImplícitaExplícita, con un presupuesto
SoporteQuien se dé cuentaQuien construyó el eslabónResponsable designado por paso
Complejidad de implementaciónBajaBaja al empezar, alta al mantenerMayor: modelo de ejecución y continuación

Decisión de diseño

Persistir una única ejecución de orquestación duradera, modelar la ejecución como una máquina de estados explícita, hacer que cada paso arranque una sola vez y pueda reanudarse sin riesgo, tratar la espera y los resultados inciertos como estados y no como fallos, y usar un mecanismo de continuación ligero para hacer avanzar las ejecuciones incompletas.

Principio claveUn planificador le dice al trabajo cuándo despertar. Una máquina de estados le dice qué tiene permitido hacer.

10La segunda capa

Preguntas que cambian el diseño.

Identidad y arranque

  1. ¿Cómo se identifica una ejecución?
  2. ¿Cómo se evita un arranque duplicado?
  3. ¿Cómo se representan las dependencias?

Fallo y reanudación

  1. ¿Qué pasa cuando falla el paso 4?
  2. ¿Puede arrancar dos veces el paso 5?
  3. ¿Qué significa una respuesta tardía?

Finalización y control

  1. ¿Cuándo se considera completa la ejecución?
  2. ¿En qué se diferencia una simulación de una ejecución de producción?
  3. ¿Quién ve el estado de la ejecución—y quién es responsable de una ejecución atascada?

11Decisiones y entregables

Qué produce el trabajo.

  1. 01Modelo y clave de ejecución
  2. 02Máquina de estados
  3. 03Contrato de pasos
  4. 04Diseño de la continuación
  5. 05Clases de reintento y fronteras de idempotencia
  6. 06Semántica de simulación y cancelación
  7. 07Vista del estado de la ejecución