Manual Técnico de FinTrack

macOS

Descarga el archivo .dmg adaptado a tu arquitectura:

• Apple Silicon (M1/M2/M3/M4): FinTrack-1.0.0-arm64.dmg
• Intel x64: FinTrack-1.0.0.dmg

Arrastra FinTrack a la carpeta de Aplicaciones. Si macOS Gatekeeper bloquea el inicio: ve a Ajustes del Sistema → Privacidad y Seguridad y haz clic en "Abrir igualmente".

Windows

Descarga el instalador ejecutable: FinTrack.Setup.1.0.0.exe

Ejecuta el archivo. Si Windows Defender SmartScreen bloquea el arranque, pulsa en "Más información" → "Ejecutar de todas formas".

En el primer arranque, la aplicación crea un fichero de base de datos SQLite vacío en tu disco de forma silenciosa y te redirige automáticamente a la pantalla de control, sin solicitar contraseñas ni perfiles externos.

Configuración inicial recomendada:

1. Ve a Overview y crea una cuenta bancaria (ej. Corriente, Ahorro).
2. Registra tus primeros ingresos o gastos con el botón Nueva Transacción.
3. Añade activos a tu Portfolio si tienes inversiones (ej. acciones, criptoactivos).

Libro Mayor

Permite la categorización de cobros y gastos, transferencias internas entre cuentas y búsquedas por término en un historial tabular simple. Puedes exportar todos tus movimientos a formato CSV.

Flujo de Caja

Un resumen de métricas clave que calcula tu patrimonio neto sumando todos los balances, y computa tu tasa de ahorro del mes según tus ingresos y gastos registrados.

Gestiona activos de inversión introduciendo el ticker de cotización de Yahoo Finance (ej. AAPL, BTC-USD).

La aplicación consulta las cotizaciones cada 30 segundos en segundo plano mediante llamadas HTTPS directas. Las inversiones cotizadas en divisas extranjeras (USD) se convierten automáticamente a Euros usando el tipo de cambio oficial al instante.

La integración de IA analiza tus tendencias financieras basándose en agregados monetarios. Esta función es totalmente opcional y requiere tu propia API Key.

La aplicación está estructurada como un contenedor Electron que ejecuta Next.js en modo Standalone como un subproceso hijo en local.

Clona el código e inicia el entorno de pruebas local en tu máquina:

# Clonar el proyecto
git clone https://github.com/iPiiix/FinTrack

# Acceder y compilar en desarrollo
cd FinTrack/fintrack-web
npm install
npm run dev:electron

Tus finanzas se escriben en un fichero SQLite denominado fintrack.db. Las rutas absolutas predeterminadas en tu almacenamiento local son las siguientes: