finx
FinX es una aplicación open source para seguimiento financiero auto-alojada, con frontend React/Node.js y base de datos PostgreSQL. Incluye app nativa Android con modo offline y sincronización bidireccional vía SSE.
Ficha actualizada 27 sept 2026, 9:36 · upstream 27 sept 2026, 9:21 · release v1.3.4
Qué es finx
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
FinX es una plataforma de gestión financiera personal diseñada para ejecutarse en infraestructura propia sin componentes en la nube. La arquitectura combina un frontend React 19 con Vite 6, un backend Node.js/Express 4 y PostgreSQL 15 como persistencia de datos. El sistema soporta dos modos de operación: local (todos los datos en el dispositivo) y servidor (sincronización entre múltiples dispositivos).
La aplicación implementa autenticación JWT con gestión granular de permisos, permitiendo compartir acceso a cuentas financieras entre usuarios con control de edición y visualización. Incluye funcionalidad offline robusta mediante cola de transacciones que se sincroniza automáticamente al recuperar conectividad. La app Android nativa soporta tanto modo local como conexión al backend auto-alojado.
El despliegue es flexible: Docker Compose para entornos modernos, o scripts de instalación interactivos para Debian/Ubuntu. El sistema incluye migraciones de base de datos automáticas y soporte para importación CSV con detección de duplicados.
- Gestión de transacciones personales con categorías, fuentes y objetivos
- Sincronización multi-dispositivo vía SSE en tiempo real
- Modo offline con cola de transacciones para sincronización posterior
- Compartir acceso a cuentas financieras entre usuarios con permisos granulares
- Arquitectura cliente-servidor sin componentes en la nube
- Sincronización bidireccional vía Server-Sent Events (SSE)
- App Android nativa con modo local y servidor
- Importación CSV con detección de duplicados automática
- Sin Dockerfile, requiere docker compose o instalación manual
- Complejidad HIGH según análisis técnico del repositorio
- Requiere Node.js 20.19+ y PostgreSQL 15+
- Licencia Apache-2.0 con cláusula Commons (prohíbe venta del software)
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Docker: docker compose up -d --build; editar .env con DB_NAME, DB_USER, DB_PASSWORD, JWT_SECRET. Debian/Ubuntu: sudo bash setup.sh. Habilitar HTTPS detrás de Nginx/Apache. Desactivar DISABLE_REGISTRATION=false en producción. Verificar migraciones: npm run migrate-db.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.