pgledger: kit de inicio para contadores en PostgreSQL

Fuentes: pgledger: A PostgreSQL-ledger starter kit for coding agents

pgledger es una implementación de contadores (ledger) construida exclusivamente en PostgreSQL, diseñada no como una librería de dependencias tradicional, sino como un kit de inicio que consiste en tablas de base de datos y funciones SQL. Su objetivo es permitir a los desarrolladores integrar la lógica de contabilidad directamente en su stack técnico mediante migraciones y llamadas a funciones, adaptándose a la arquitectura existente del proyecto.

El proyecto ha evolucionado significativamente con la llegada de los agentes de codificación (coding agents). Antes, la personalización requería trabajo manual, pero ahora los agentes pueden extraer, adaptar y modificar el kit según las necesidades específicas de la aplicación, como añadir claves foráneas o cambiar formatos de identificadores. Esta capacidad ha llevado al autor a reconsiderar el equilibrio entre la simplicidad del núcleo y la funcionalidad avanzada.

Para resolver la tensión entre la facilidad de personalización y la robustez, se ha implementado el soporte para idempotencia. Esta función permite que repetir la misma operación no duplique los registros, sino que devuelva el existente, lo cual es crucial para manejar tiempos de espera o operaciones multi-etapa. La idempotencia se gestiona mediante una clave específica que, si ya existe, impide la creación de un nuevo registro si los argumentos no coinciden. Esta decisión responde a criterios de adopción masiva, complejidad técnica y riesgo de integración, asegurando que el componente sea fiable y fácil de mantener o eliminar según las preferencias del usuario.