transfer-ledger
En desarrolloUn libro mayor de partida doble donde mover dinero no se puede hacer dos veces ni por error
Rol: Desarrollador en solitario
En solitario · Desde nov 2026 · Repo público
Una API en .NET sobre PostgreSQL con cuentas identificadas por alias (un teléfono o un correo), contabilidad de partida doble, claves de idempotencia y un endpoint de conciliación que comprueba que los números cuadran. Está inspirada en la idea de los pagos instantáneos por alias y no sigue la especificación de ningún sistema de pagos real.
Problema
El código que mueve dinero tiene que aguantar a un cliente que reintenta, mil peticiones a la vez y un bug en sus propias comprobaciones. Una columna de saldo que solo se actualiza no deja nada con qué comparar cuando los números dejan de cuadrar.
Solución
Cada transferencia escribe dos asientos que suman cero, y un depósito es una transferencia desde una cuenta del banco que puede quedar en negativo. La clave de idempotencia se inserta en la misma transacción que la transferencia, así que una petición repetida espera en el índice único y recibe la respuesta guardada. La base también rechaza lo que no cuadra: un chequeo contra saldos negativos, un trigger diferido sobre asientos que no suman cero y tablas de solo inserción.
Todavía no
No sigue ninguna especificación de pagos real, tiene una sola moneda, no hay comisiones, límites, detección de fraude ni identidad verificada detrás de un alias, y usa una clave de API compartida en vez de usuarios. Las claves de idempotencia no caducan, no medí el rendimiento y no está desplegado.
Puntos clave de arquitectura
- 60 transferencias concurrentes contra un saldo que cubre 30: pasan exactamente 30, el saldo nunca es negativo y la conciliación sigue limpia. Sin el bloqueo de fila la prueba falla
- 40 peticiones simultáneas con la misma clave de idempotencia dejan una sola transferencia. Sin el ON CONFLICT de la clave fallan cinco pruebas de idempotencia
- La conciliación lee solo los datos: todos los asientos deben sumar cero y cada saldo debe ser igual a la suma de los suyos. Una prueba altera un saldo a mano y el chequeo señala justo esa cuenta
- La base es la última defensa: un trigger diferido rechaza al confirmar asientos que no suman cero, y UPDATE o DELETE sobre asientos y transferencias fallan
- Quitar el ORDER BY id del bloqueo de cuentas no cambió nada en mi prueba de transferencias cruzadas, porque Postgres recorre las filas en un orden estable. Lo dejé como defensa explícita y lo escribí en el código en vez de afirmar que una prueba lo demuestra
- Correr las pruebas por primera vez dejó al descubierto dos errores míos: mi validación rechazaba el alias de la propia cuenta del banco, así que ningún depósito funcionaba, y SUM de bigint devuelve numeric en Postgres