~/studies/work 2026-11-21
Sagas a mano vs ejecución durable
Una comparación de diseño, sin mediciones, entre sagas hechas a mano y un motor de workflows durables: qué escribes tú mismo en cada una y qué sigue siendo tu problema en ambas.
- saga
- workflow
- design
- idempotency
- ~/project/versatile-sh
Qué es esto y qué no es
Ni los docs de nagare, ni los ADR, ni los estudios de investigación que leí comparan los dos enfoques, y nadie midió uno contra el otro. Este post es una comparación de diseño. A propósito no contiene números de benchmark.
La comparación trata de trabajo, no de velocidad: qué piezas escribes y operas tú mismo y cuáles te da un motor durable. Las afirmaciones del lado del motor vienen de los ADR de nagare. El lado a mano es la forma habitual del patrón, no el registro de un sistema concreto.
Una saga a mano
Una saga divide una operación de negocio en pasos locales, cada uno con un paso compensatorio que lo deshace. A mano, casi siempre terminas construyendo el mismo conjunto de piezas.
- Una tabla de estado que registra a qué paso llegó cada instancia, escrita en la misma transacción que el efecto del paso.
- Una forma de entregar el siguiente comando después de ese commit, lo que normalmente significa una tabla outbox y un relay.
- Un inbox o una clave única por mensaje, porque el relay y el broker entregan al menos una vez.
- Timers para deadlines y reintentos, con su propio almacenamiento y un poller.
- Compensaciones que a su vez son idempotentes y reintentables.
- Un job de recuperación que encuentra instancias atascadas a la mitad y las hace avanzar.
Nada de esto es difícil por separado. El costo es que el flujo de control de la operación de negocio termina repartido entre handlers, tablas y tipos de mensaje. Para responder dónde está una instancia, lees una tabla de estado y reconstruyes la historia.
Lo mismo en un motor durable
Un motor durable mueve las primeras cinco piezas por debajo de tu código. La tabla de estado es el journal. La entrega después del commit es un outbox y un inbox que son del motor. Los timers son sleeps durables. La recuperación es replay: la ejecución se retoma desde su historial registrado.
En nagare el flujo es un grafo y cada nodo termina con un resultado. Un transporte devuelve una falla con un código y una marca retryable. Una falla retryable se reintenta, y una final da el resultado `failed`. La ejecución continúa entonces por la arista de ese resultado, y si no existe arista la ejecución falla. Una compensación es por tanto una rama normal del grafo, alcanzable desde la arista de falla del paso que deshace (ADR-0003).
Dónde está una instancia se lee desde su event log. Los eventos de cada ejecución se agregan en una sola transacción junto con el read model y las filas del outbox, así que la historia es un historial almacenado y no una reconstrucción.
Lo que sigue siendo tuyo en ambos casos
- El diseño de la compensación. Un motor no puede saber cómo deshacer una captura de pago. Tú sigues decidiendo la operación inversa y si es posible siquiera.
- Destinatarios idempotentes. La entrega es al menos una vez en ambos mundos. En nagare cada paso lleva una clave construida con run, node, visit y attempt, y solo sirve si el servicio que la recibe la respeta. La llamada de cancelación también está documentada como at-least-once, así que debe tratar una referencia desconocida o ya terminada como éxito.
- Aislamiento. Una saga no es una transacción: otros lectores pueden ver el estado intermedio entre pasos.
Lo que te cobra el motor
La ejecución durable no está libre de costo de diseño. El código del workflow, o aquí el intérprete, debe ser determinista: sin reloj, aleatoriedad ni I/O fuera de las llamadas registradas. Las claves de paso se vuelven un contrato, porque el replay se ancla en ellas. Un cambio incompatible en el intérprete sale como un build nuevo que drena las ejecuciones antiguas, ya que las ejecuciones estacionadas no se parchean en el lugar (ADR-0011).
También asumes un motor como dependencia que operar y, en el caso de nagare, una decisión sobre qué motor queda detrás del port. Esa decisión es el tema del post sobre el port del motor durable.
Mi regla práctica, como hipótesis y no como hallazgo: una saga hecha a mano es razonable para dos o tres pasos en un servicio que ya tiene un outbox. Cuando hacen falta a la vez timers, esperas de eventos externos, cancelación e historial de ejecución, la lista de piezas de arriba es un motor durable escrito despacio.