💰 Finlia
Gestión de finanzas personales y familiares
¿Cuánto dinero puedo gastar realmente sin comprometer mis obligaciones?
finlia.online · Entrar a la app
Finlia es una aplicación web que ayuda a personas y familias a registrar ingresos y gastos, controlar deudas y tarjetas, crear presupuestos y metas de ahorro, y —sobre todo— calcular cuánto dinero tienen realmente disponible para gastar. Pensada para usarse a diario desde el celular.
🇨🇴 Dirigida inicialmente al mercado colombiano (COP, español). Diseñada para permitir futura expansión a otras monedas y países.
🎯 El problema
Las apps de finanzas personales responden bien a «¿en qué se me fue el dinero?». Casi ninguna responde a la pregunta que una familia se hace de verdad el día 12 del mes, con el mercado por hacer y la cuota de la moto pendiente:
¿Cuánto puedo gastar hoy sin quedar mal a fin de mes?
El saldo del banco no lo dice. Ese número no sabe que el arriendo sale el día 5, que el SOAT vence en marzo, ni que hay $800.000 comprometidos en la cuota de la tarjeta. Mirar solo el saldo es exactamente como se llega a fin de mes en rojo habiendo «tenido plata» todo el mes.
💡 La solución
Finlia calcula el dinero realmente disponible con la plata que ya tienes, no con la que esperas recibir:
disponible hasta el cobro = saldo real en cuentas
− lo ya apartado en metas de ahorro
− gastos fijos y obligaciones que vencen antes del próximo pago
− cuotas de deuda que vencen antes del próximo pago
− ahorro programado de esos días
puedes gastar hoy = disponible hasta el cobro ÷ días que faltan para el pago
El sueldo que aún no llega no suma: el día de cobro solo dice hasta cuándo tiene que alcanzar lo de hoy. Por eso la cifra sirve desde el primer día, sin historial, y no miente si un pago se atrasa. Los ingresos esperados alimentan el plan del mes (la proyección del mes siguiente y un tope para que la cifra no se dispare), nunca la aumentan (ADR-0040).
Ese cálculo vive en un único servicio de dominio (BudgetCalculatorService) y es la cifra que la app pone en primer plano: «Puedes gastar hoy $81.521», no «tu saldo es $19.992.420».
📸 Capturas
Datos de demostración generados con Faker (es_CO). El repositorio nunca contiene datos financieros reales.
| Panel | Dinero disponible | Registrar gasto |
|---|
| | |
| Reportes | Deudas | Metas de ahorro |
| | |
Se regeneran con la app corriendo y sembrada. La clave es la del usuario demo
de más abajo; va por entorno para no dejarla escrita en el repositorio:
SHOTS_PASSWORD=finlia123 npm run screenshots
🙋 Why this project?
Finlia no nació de un tutorial ni de un ejercicio: nació de un problema real de administración financiera de un hogar colombiano. Llevar las cuentas en una hoja de cálculo respondía qué había pasado, pero nunca qué se podía hacer hoy — y esa es la decisión que uno toma a diario, no una vez al mes.
Eso condicionó cada decisión técnica del proyecto:
- Mobile-first de verdad, no un escritorio encogido: el gasto se registra en la fila de la caja, en menos de cinco segundos, con el pulgar.
- Multi-hogar desde el diseño, porque las finanzas de una familia son de dos personas, no de una cuenta compartida por contraseña. El aislamiento entre hogares es la amenaza #1 del proyecto y tiene su propio barrido de tests.
- Hosting compartido como restricción, no como accidente: nada de colas persistentes, Redis ni Docker. Todo lo periódico entra por una única línea de cron.
- Las estimaciones se marcan como estimaciones. La proyección de fin de deuda dice que es aproximada, porque presentar un cálculo propio como si fuera el estado de cuenta del banco es cómo se pierde la confianza del usuario.
Las decisiones que no eran obvias están escritas y fechadas en docs/DECISIONS.md — 37 ADR con contexto, alternativas descartadas y consecuencias.
✨ Funcionalidades (roadmap)
- Registro rápido de ingresos y gastos (mobile-first)
- Cuentas, medios de pago y tarjetas de crédito
- Categorización de movimientos
- Presupuestos por categoría y cálculo de dinero disponible
- Gastos recurrentes y obligaciones futuras (SOAT, seguros, matrículas…)
- Deudas y tarjetas de crédito
- Metas de ahorro (con fondo de emergencia)
- Dashboard y reportes con gráficos
- Recordatorios de pagos próximos
- Hogares compartidos con roles e invitaciones
El estado detallado de cada funcionalidad está en docs/ROADMAP.md.
🧱 Stack
- Laravel 13.8 · PHP 8.4
- MySQL/MariaDB o PostgreSQL (SQLite para tests) — ambos soportados, ADR-0036
- Blade · Bootstrap 5 · JavaScript vanilla · Chart.js
- Eloquent · Migrations · Seeders · Factories
- PHPUnit
- Despliegue: Hostinger (hosting compartido)
- UI mobile-first propia sobre Bootstrap 5 (glass, chips, barra inferior + FAB) — ver docs/UI_DESIGN.md
🚀 Instalación local
git clone https://github.com/ronaldo-duran/Finlia.git
cd Finlia
composer install
cp .env.example .env
php artisan key:generate
Configura la base de datos en .env. Finlia soporta MySQL/MariaDB y PostgreSQL (ADR-0036); elige uno (ver docs/DEPLOYMENT.md para los valores exactos y la configuración de Colombia):
This is the beginning of the README. Read the rest at the original. Read the full README ↗
