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.
- 01Preparar los datos de origenCompletadoActualización confirmada para 2026-09
- 02Calcular el estado analíticoCompletadoMarcas de inicio y de finalización registradas
- 03Clasificar las cuentasCompletadoPoblación = cuentas clasificadas
- 04Publicar las señales operativasEn esperaLote 6 de 12 confirmado; la continuación vuelve a comprobarlo
- 05Activar las accionesSin empezarSolo puede arrancar cuando el paso 4 esté confirmado
- 06Conciliar los resultadosSin empezarUna vez por ejecución
- 07Cerrar la ejecuciónSin empezarLa cierra una persona
- 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
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.
- 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.
- Creada
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) - Preparando
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) - Procesando
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) - 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: 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) - Activando
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) - Conciliando
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) - Completada
Todos los pasos hechos y conciliados; el responsable cerró la ejecución.
Sin salida automática - Requiere intervención
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) - Cancelada
Detenida a propósito, con un motivo. Los pasos completados siguen registrados.
Sin salida automática - Reanudando
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)
- 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.
Se abre el periodo y todavía no existe la ejecución para ese periodo y ese ámbito.
- 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
PlanificadorPlataforma de datosCRMPlataforma de campañas
- 01Preparar los datos de origen
Esperar a la actualización del periodo: es una dependencia, no un paso que la ejecución lleve a cabo.
- 02Calcular el estado analítico
Calcular el rendimiento frente al objetivo del periodo a partir de entradas congeladas.
- 03Clasificar las cuentas
Exactamente un segmento por cuenta apta.
- 04Publicar las señales operativas
Publicar la versión del periodo y aplicarla por lotes; se reanuda desde el último lote confirmado.
- 05Activar las acciones
Entregar las señales a la automatización de ciclo cerrado; el seguimiento lleva clave y nunca se repite.
- 06Conciliar los resultados
Comparar las señales y acciones esperadas con las reales; clasificar las diferencias.
- 07Cerrar la ejecución
Revisar el resumen y cerrar la ejecución—o cancelarla con un motivo.
| Paso | Arranca cuando | Guarda de arranque | Espera a | Si falla | Responsable de intervenir |
|---|---|---|---|---|---|
| 1 · Preparar | Ejecución creada para el periodo | Entradas congeladas una sola vez | La actualización de origen | Tiempo agotado → intervención (equipo de datos) | Equipo de datos |
| 2 · Calcular | Paso 1 completado | Marca de inicio para esta ejecución | El cálculo analítico | Transitorio → reintento; error de datos → intervención | Equipo de la plataforma de datos |
| 3 · Clasificar | Paso 2 completado | Población = cuentas clasificadas | — | Error de datos → detenerse antes de publicar | Operaciones de ventas |
| 4 · Publicar | Paso 3 completado | Versión publicada una sola vez; cursor de lotes | La confirmación de los lotes aguas abajo | Resultado desconocido → resolver por clave y después reintentar | Operaciones de integración |
| 5 · Activar | Paso 4 confirmado | Cuenta + segmento + periodo de entrada | El procesamiento aguas abajo | Rechazo → cola de reparación; la ejecución continúa | Operaciones comerciales |
| 6 · Conciliar | Paso 5 completado | Una vez por ejecución | — | Fuera de tolerancia → intervención | Operaciones comerciales |
| 7 · Cerrar | Conciliación dentro de la tolerancia | Cerrada una sola vez, por una persona | La revisión del responsable | El responsable cierra o cancela con un motivo | Operaciones comerciales |
05Seguridad de la ejecución
Si puede ejecutarse dos veces, está diseñado para ejecutarse dos veces.
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
| Clase | Ejemplo | Comportamiento | Dónde continúa la ejecución |
|---|---|---|---|
| Transitorio | Se alcanza un límite de la plataforma a mitad de un lote | Esperar y reintentar el lote | En el cursor de lotes |
| Rechazo de negocio | El sistema aguas abajo rechaza un registro de una cuenta cerrada | Sin reintento; el registro va a una cola de reparación | La ejecución sigue; el registro vuelve cuando se repara |
| Resultado desconocido | Una llamada agota el tiempo después de que la petición haya salido | Resolver primero: buscar por la clave del paso; reintentar solo si no existe nada | En el mismo paso, cuando se conoce el resultado |
| Error de diseño o de datos | Las cuentas clasificadas no cuadran con la población | Detenerse antes de publicar nada | Intervenció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.
| Situación | La segunda invocación | Porque |
|---|---|---|
| El paso ya se completó | Se ignora | La guarda del paso lee Completado para esta ejecución |
| El paso sigue en curso | Se rechaza; la primera continúa | La marca de inicio se persistió antes de empezar ningún trabajo |
| El paso se detuvo a mitad | Se reanuda | El cursor de lotes registra el último lote confirmado |
| El resultado ya existe aguas abajo | Lo detecta y lo registra | Cada efecto se busca por su clave antes de crearlo |
| El cálculo se vuelve a ejecutar | Produce el mismo resultado | Las entradas se congelaron al crear la ejecución |
| Nunca llegó una respuesta | No 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
| Condición | Por qué no es seguro continuar | Respuesta |
|---|---|---|
| Una simulación llega a un paso que necesitaría un efecto secundario que no puede simular | El ensayo dejaría de ser un ensayo | Cancelar la simulación con un motivo; informar de lo que habría pasado |
| Las entradas cambiaron después de crear la ejecución | Los pasos posteriores no cuadrarían con los anteriores | Cancelar; arrancar una ejecución nueva para el mismo periodo |
| Ya hay una ejecución Completada para el mismo periodo | Una segunda repetiría seguimiento real | Rechazar 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.
| Pregunta | Lo responde | Se ve en |
|---|---|---|
| ¿Qué ejecución está activa? | ID de ejecución, periodo y ámbito | Lista de ejecuciones |
| ¿Dónde está? | Estado actual y paso actual | Registro de ejecución |
| ¿Cuánto tiempo lleva ahí? | La última transición frente al presupuesto del paso | Indicador de antigüedad en la ejecución |
| ¿Qué dependencia está pendiente? | El motivo de la espera | Registro de ejecución |
| ¿Qué se ha ejecutado ya? | Marcas de inicio y de finalización por paso | Historial de pasos |
| ¿Qué falló? | Clase y motivo del fallo | Registro de ejecución e historial de pasos |
| ¿Puede reanudarse automáticamente? | La clase de fallo: transitorio o no | Registro de ejecución |
| ¿Quién es responsable de intervenir? | El responsable de intervención del paso | Registro de ejecución y cola del responsable |
| ¿Qué pasará a continuación? | Las transiciones válidas desde el estado actual | Máquina de estados |
09Las contrapartidas
Opciones creíbles, evaluadas frente a estas premisas.
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 visibilidadAutomatizaciones 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 silencioEjecució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 ejecucionesCriterio 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.
| Criterio | Un único proceso programado | Automatizaciones encadenadas | Ejecución duradera + máquina de estados |
|---|---|---|---|
| Recuperabilidad | Reinicio desde cero | Depende de dónde se rompió la cadena | Reanudación en el paso detenido |
| Visibilidad | Un log técnico | Repartida entre automatizaciones | Un único registro de ejecución |
| Seguridad al repetir | Lo repite todo | Poco clara en cada eslabón | Guardas y claves por paso |
| Esperas largas | Retiene una transacción o falla | Se pierden entre eslabones | Esperar es un estado |
| Gestión de dependencias | Se dan por listas | Implícita | Explícita, con un presupuesto |
| Soporte | Quien se dé cuenta | Quien construyó el eslabón | Responsable designado por paso |
| Complejidad de implementación | Baja | Baja al empezar, alta al mantener | Mayor: 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.
Un 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
- ¿Cómo se identifica una ejecución?
- ¿Cómo se evita un arranque duplicado?
- ¿Cómo se representan las dependencias?
Fallo y reanudación
- ¿Qué pasa cuando falla el paso 4?
- ¿Puede arrancar dos veces el paso 5?
- ¿Qué significa una respuesta tardía?
Finalización y control
- ¿Cuándo se considera completa la ejecución?
- ¿En qué se diferencia una simulación de una ejecución de producción?
- ¿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.
- 01Modelo y clave de ejecución
- 02Máquina de estados
- 03Contrato de pasos
- 04Diseño de la continuación
- 05Clases de reintento y fronteras de idempotencia
- 06Semántica de simulación y cancelación
- 07Vista del estado de la ejecución