Este repositorio educativo, inspirado en el clásico tutorial 'Kubernetes the hard way', ofrece una guía exhaustiva para construir un motor de ejecución durable (o workflow engine) desde cero utilizando Go y PostgreSQL. La ejecución durable es un mecanismo crítico en la arquitectura moderna de software, especialmente relevante para sistemas de agentes de IA que requieren procesos largos y con estado. Su función principal es guardar el progreso de una función de forma incremental (checkpoints), permitiendo que el sistema se recupere automáticamente ante fallos inesperados, en lugar de reiniciar desde cero.
La explicación técnica se centra en cómo implementar esta persistencia utilizando exclusivamente PostgreSQL como base de datos. A través de siete lecciones progresivas, el usuario construye la infraestructura desde cero, comenzando con una simple cola de tareas y terminando con un sistema capaz de gestionar tareas duraderas y eventos. El proyecto utiliza sqlc para generar código SQL seguro y pgx para la conexión. Un punto técnico clave es la distinción entre reintentos (intentar de nuevo sin perder el estado) y replays (reiniciar el historial desde el principio), conceptos fundamentales para la consistencia en sistemas distribuidos.
Este recurso es ideal para desarrolladores que desean comprender a fondo cómo funcionan herramientas como Temporal o Hatchet, o para ingenieros que estén diseñando sus propios sistemas de orquestación. Sin embargo, es importante tener en cuenta que el enfoque es puramente educativo y minimalista; el código no incluye SDKs de cliente ni optimizaciones de productividad, sino que prioriza la comprensión de los fundamentos de la base de datos y la lógica de backend.