ADR / 009

Modelar la automatización de larga duración como un registro de ejecución con máquina de estados

Cuando la automatización abarca varios pasos, sistemas o días, cada ejecución necesita identidad, estado y guardas por paso, para poder esperar, fallar, reanudarse y terminar exactamente una vez.

Patrón de referencia

Elaborado de forma independiente. No contiene detalles de implementación, nombres internos ni cifras de ningún empleador o cliente.

01Contexto

Un ciclo comercial mensual refresca datos, calcula KPI, clasifica clientes, escribe los resultados en el CRM y genera acciones. Se ejecuta como un único job programado. Cuando falla un paso, el job se relanza desde el principio, los pasos que ya habían terminado se repiten y algunas cuentas reciben sus acciones dos veces. Nadie fuera del equipo de plataforma puede ver en qué punto está una ejecución.

02Factores de decisión

  1. F01

    Los pasos dependen de trabajo que la automatización no controla

  2. F02

    Un relanzamiento no debe repetir pasos terminados

  3. F03

    El responsable de negocio necesita ver el avance y los fallos

  4. F04

    Las ejecuciones de prueba no deben tener efectos

03Opciones consideradas

Opciones consideradas: cuándo sería cada una la elección adecuada, qué cuesta y el veredicto con estas premisas
OpciónEncaja cuandoCoste / contrapartidaVeredicto
Un único job programado que llama a todos los pasosTrabajo corto, local e idempotenteRelanzar desde cero; sin identidad; sin visibilidadDescartada
Una cadena de triggers, uno por pasoDos o tres pasos localesSin identidad de ejecución; un fallo rompe la cadena en silencioDescartada
Registro de ejecución con máquina de estados y guardas por pasoTrabajo de varios pasos, entre sistemas o de larga duraciónUn modelo de ejecución, una guarda por paso y una pequeña vista de ejecucionesElegida

Cada opción es la adecuada con ciertas premisas. El veredicto se refiere al contexto descrito arriba.

04Decisión

Crear un registro de ejecución por clave de negocio (por ejemplo, periodo y alcance), que se rechaza si ya existe. La ejecución recorre estados declarados (creada, en curso, en espera, completada, fallida, abortada) y cada paso registra su propio resultado y comprueba su propia guarda de “ya hecho en esta ejecución”. El trabajo largo se divide en lotes con clave y continuaciones. Un fallo detiene la ejecución en el paso fallido; al reanudarla, continúa desde ahí. Un indicador de simulación ejecuta todas las comprobaciones sin efectos.

05Consecuencias

Lo que esta elección cambia en el resto del sistema.

  1. Observabilidad

    Cualquiera puede abrir una ejecución y ver su estado, paso, avance, fallos y responsable.

  2. Recuperación

    Una reanudación nunca repite un paso ni un efecto ya completados.

  3. Dependencias

    Las dependencias se convierten en estados de espera explícitos, con presupuesto.

  4. Alcance

    Las automatizaciones locales sencillas siguen siendo sencillas: el patrón se reserva para el trabajo que lo necesita.

06Cuándo revisarla

La decisión se sostiene mientras se mantenga su contexto. Hay que cuestionarla cuando:

01

El trabajo cabe en una transacción y en un sistema.

02

Un orquestador de plataforma ofrece de forma nativa identidad de ejecución, estado y reanudación.

07Dónde se aplica esta decisión

La decisión explica por qué se eligió este camino; cada caso muestra cómo forma parte de una arquitectura más amplia.

  1. Caso de automatización / 01Diseñar la orquestación con estado de un proceso comercial de larga duraciónUna ejecución duradera por periodo con una máquina de estados explícita, pasos que arrancan una sola vez, la espera como estado, una continuación ligera que despierta las ejecuciones sin terminar, reintentos clasificados en la frontera de cada paso y un registro de ejecución que responde a las preguntas del operador—para que un fallo en el paso siete se reanude en el paso siete.AutomatizaciónDatos e IntegracionesRevenue OperationsCaso de arquitectura · 12 min

Decisiones de las que depende o a las que condiciona.

  1. ADR / 003Usar código en las fronteras de orquestaciónMantener declarativas las reglas locales y transparentes; llevar la orquestación con estado y entre sistemas detrás de fronteras de servicio probadas.Patrón propuestoAutomatización · Gobierno · Integración
  2. ADR / 010Automatizar las salidas, no solo las entradasToda automatización que crea trabajo cuando un registro entra en un estado debe definir también qué ocurre cuando sale de él; si no, el estado posterior queda obsoleto.Patrón propuestoAutomatización · RevOps · Datos