Usar código en las fronteras de orquestación
Mantener declarativas las reglas locales y transparentes; llevar la orquestación con estado y entre sistemas detrás de fronteras de servicio probadas.
Elaborado de forma independiente. No contiene detalles de implementación, nombres internos ni cifras de ningún empleador o cliente.
01Contexto
Un proceso comercial combina aprobaciones, llamadas a sistemas externos, trabajo que hay que reintentar y pasos que los usuarios siguen. Los administradores de negocio pueden cambiar la automatización declarativa en horas; los ingenieros pueden probar y recuperar servicios en código. Si todo va en flujos declarativos, los reintentos, la idempotencia y la compensación se esconden en automatizaciones encadenadas que fallan a medias. Si todo va en código, cada cambio de umbral se convierte en una release.
02Factores de decisión
- F01
Quién debe poder cambiar la regla, y con qué frecuencia
- F02
Si el paso tiene efectos fuera del sistema
- F03
Si un fallo hay que reintentarlo, compensarlo o reanudarlo
- F04
Si el comportamiento debe probarse antes de cada cambio
03Opciones consideradas
| Opción | Encaja cuando | Coste / contrapartida | Veredicto |
|---|---|---|---|
| Solo automatización declarativa | Reglas locales y deterministas sobre registros, sin efectos externos | Reintentos, idempotencia y compensación se esconden en flujos encadenados; los fallos aparecen como cambios aplicados a medias | Descartada |
| Solo servicios en código | Equipos en los que todas las reglas son complejas e ingeniería controla todos los cambios | Los umbrales sencillos pasan a ser código con gestión de releases; los administradores de negocio pierden reglas que deberían ser suyas | Descartada |
| Separar por frontera: declarativo dentro del registro, código para la orquestación entre sistemas | Procesos que mezclan reglas locales con pasos entre sistemas que mantienen estado | La frontera hay que definirla, documentarla y gobernarla; dos perfiles técnicos que mantener | Elegida |
Cada opción es la adecuada con ciertas premisas. El veredicto se refiere al contexto descrito arriba.
04Decisión
Usar automatización declarativa para las reglas locales e inspeccionables que cambian a menudo: validaciones, asignaciones y umbrales. Llevar a un servicio de orquestación en código, con pruebas, todo lo que cruza una frontera entre sistemas, mantiene estado entre pasos, necesita idempotencia o debe compensar. La automatización declarativa puede iniciar una orquestación; no puede encadenar por sí misma efectos externos.
05Consecuencias
Lo que esta elección cambia en el resto del sistema.
- Responsabilidad
Quién cambia qué sigue a la frontera: los administradores de negocio responden de las reglas locales; ingeniería, de la orquestación.
- Fallos
Los efectos externos nunca se encadenan en flujos declarativos, así que un fallo no puede dejar el trabajo aplicado a medias.
- Estado de negocio
La orquestación publica su estado en el registro del usuario, así que el avance se ve donde la gente trabaja.
- Cambio y releases
Los umbrales cambian sin release; el comportamiento entre sistemas solo cambia mediante releases probadas.
06Cuándo revisarla
La decisión se sostiene mientras se mantenga su contexto. Hay que cuestionarla cuando:
El proceso pasa a ser local: sin llamadas externas ni estado entre pasos.
La orquestación nativa de la plataforma ofrece idempotencia, reintentos, compensación y pruebas equivalentes al código.
Los administradores de negocio dejan de cambiar las reglas, y desaparece el argumento de rapidez de la automatización declarativa.
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.
- 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.
- Caso de modelo operativo / 05Hacerse cargo del modelo operativo y hacerlo evolucionar después del go-liveEl modelo completo posterior al go-live: cada responsabilidad del proyecto traspasada a un responsable operativo con nombre antes del go-live, la fricción recurrente clasificada en un backlog gobernado, autoridad sobre el cambio por dominio, versiones identificadas, foros de operación y de versiones, y revisiones de la adopción y del modelo que convierten lo que cuesta a los usuarios en cambios de diseño—para que el modelo siga mejorando cuando el proyecto termina.
08Decisiones relacionadas
Decisiones de las que depende o a las que condiciona.
- ADR / 009Modelar la automatización de larga duración como un registro de ejecución con máquina de estadosCuando 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.
- ADR / 007Tratar un resultado de integración incierto como desconocido, no como fallidoUn timeout no dice nada sobre si el receptor confirmó la operación. Modelar ‘desconocido’ como estado propio, resolverlo por clave de petición y solo entonces reintentar o darlo por fallido.