Finances

Por qué lo construí

Todas las apps de finanzas que usé acabaron rediseñando su modelo de datos debajo de mí: las categorías se fusionaron, los presupuestos se volvieron otra cosa, las exportaciones dejaron de cuadrar. No quería funciones; quería registrar transacciones de la misma forma durante una década. Tras usar esas herramientas a diario durante años, los requisitos estaban inusualmente claros, así que construir salió más barato que adaptarse otra vez.

Arquitectura

El objetivo de diseño era la facilidad de despliegue. Un único proceso PostgREST delante de PostgreSQL es todo el backend: tablas, vistas y funciones definen la API, los roles de la base de datos imponen permisos y el login es un procedimiento almacenado que valida un token hasheado y emite un JWT. No hay servidor de aplicación que parchear ni escalar. El frontend es una app React, Vite, TypeScript y Tailwind que compila a archivos estáticos, así que puede vivir en Vercel o Cloudflare mientras la base de datos está en una pequeña instancia gratuita de Oracle. Docker Compose levanta todo en local sin configuración.

Funcionalmente cubre cuentas organizadas por tipo, un libro mayor con totales acumulados por día y exportación, un gráfico de historial de composición de activos y presupuestos planificados anualmente y ejecutados mensualmente con mínimo, máximo y restante por categoría. El servidor MCP permite que un asistente lea saldos y registre transacciones directamente.