Modela estados, no suposiciones

Encuentra los estados que importan

Un trabajo puede estar pendiente, en ejecución, exitoso o fallido.

Esas etiquetas solo sirven cuando las transiciones están definidas. ¿Un trabajo exitoso puede volver a ejecutarse? ¿Un trabajo fallido puede reintentarse?

¿La cancelación aplica al trabajo en ejecución? Dibuja las transiciones permitidas antes de agregar condicionales por todo el código. Cada transición tiene precondiciones y efectos.

Una máquina de estados (state machine) hace visibles los casos que faltan y da a las pruebas (tests) una estructura natural. También evita que varias banderas booleanas representen combinaciones contradictorias, como estar completado y pendiente a la vez.

Deja que el modelo cargue las restricciones

Las dataclasses de Python agrupan campos relacionados, mientras que los enums nombran un conjunto finito de estados.

Las anotaciones de tipo comunican las formas esperadas y ayudan al análisis estático a detectar incoherencias antes de ejecutar. No reemplazan la validación de JSON externo ni de filas de una base de datos. Valida en las fronteras de confianza y mantén suposiciones más fuertes hacia adentro.

Prefiere un modelo cuyos campos tengan un significado claro en cada etapa. Si un objeto gigante tiene decenas de campos opcionales, considera si estados distintos u objetos más pequeños expresarían el ciclo de vida con más precisión.

Compón el comportamiento donde varía

Un worker combina planificación, almacenamiento y ejecución de trabajos.

Pasar estos colaboradores de forma explícita hace visibles sus responsabilidades y permite sustituirlos de forma enfocada en las pruebas. La herencia es útil cuando existe una relación de sustitución genuina, pero una jerarquía profunda suele hacer más difícil encontrar el comportamiento. Elige un patrón porque resuelve un problema con nombre, no porque te resulte familiar.

En Relay, distintos manejadores de trabajos pueden compartir un contrato pequeño de función mientras el almacenamiento y la política de reintentos siguen siendo independientes. El buen diseño reduce la cantidad de hechos que alguien tiene que tener en la cabeza al mismo tiempo.