Stack de Finanzas Personales

Qué incluye este pack

Este pack reúne las seis aplicaciones financieras auto-alojables que, juntas, reemplazan YNAB, Mint, QuickBooks Self-Employed, Stripe Billing, y tu caja de zapatos llena de recibos. Todas son open source y corren desde imagen Docker. El parser IA de recibos es el pegamento: recibe una foto de móvil y emite una transacción estructurada que las otras herramientas aceptan.

Firefly III es el pilar: corre contabilidad de doble entrada, multi-divisa, y acepta CSV de todos los bancos grandes. Los otros cinco se enchufan a él.

Por qué controlar tu tooling financiero

Las apps de dinero son el software más longevo que mantendrás. Un recibo de 2018 puede importar en una auditoría de 2026; una app SaaS que usaste en 2018 puede estar muerta, adquirida, o detrás de paywall hoy. Auto-alojar tu stack de dinero es por tres cosas:

• Retención larga sin riesgo de vendor. Tus transacciones viven en Postgres en tu disco. En diez años seguirán abriéndose.
• Privacidad. Mint y Personal Capital venden datos agregados a anunciantes. Tu banco ya sabe qué compraste; el vendor analítico no necesita saberlo.
• Reglas custom. El motor de reglas de Firefly III es más flexible que el mapeador de categorías de Mint. Categorizas por merchant + monto + patrón de fecha, no solo por match de string.

El coste: operas un pequeño stack Postgres + Redis + Docker y lo respaldas. Firefly III lleva 5 años de releases estables, así que la carga operativa tras la instalación inicial es baja.

Instala en un comando

# Instala el pack completo
tokrepo install pack/personal-finance-stack

# O elige las apps que necesitas
tokrepo install firefly-iii
tokrepo install actual-budget
tokrepo install ai-receipt-parser

El manifiesto TokRepo provee un solo Docker Compose con Postgres compartido, el parser IA precableado a la API de import de Firefly III, y un script de backup que corre pg_dump nocturno a un directorio rclone-friendly local.

Trampas comunes

• Drift de formato CSV bancario. Los bancos cambian el orden de columnas sin avisar. Pin el perfil importer de Firefly III a un formato específico y re-test tras cada descarga trimestral de extracto.
• Ambigüedad multi-divisa. Firefly III maneja multi-divisa bien, pero debes definir la moneda base en la primera instalación y no puedes cambiarla después sin migración manual. Elige la moneda con la que declaras impuestos.
• Alucinación del parser IA. Aún un modelo bien tuneado a veces inventa un nombre de vendor desde un recibo borroso. Rutea siempre la salida del parser por una cola de revisión humana antes de postear a Firefly III. No auto-commitees.
• Lago para uso personal es exagerado. Lago se hizo para facturación SaaS por uso. Si no vendes software medido, sáltalo. Lo dejamos en el pack porque freelancers que cobran por hora o por llamada API lo necesitan.
• El motor fiscal de Invoice Ninja necesita config por región. La instalación default asume modelo US sales-tax. EU VAT e India GST se soportan pero requieren setup explícito antes de mandar la primera factura.

Errores conceptuales comunes

La gente piensa a menudo que un stack financiero auto-alojado significa renunciar al sync bancario. No. Firefly III importa CSV de todos los bancos grandes. Los power users añaden nordigen / GoCardless Bank Account Data, Plaid vía firefly-iii-data-importer, o scrapes programados — según el país. El modelo es más cercano a "cada dos días, import en lote" que al "tiempo real" de Mint. Para la mayoría de hogares es feature, no bug: realmente miras tus transacciones.