FinTrack

Aplicación móvil de gestión financiera personal desarrollada con Ionic y Angular. Permite registrar ingresos y gastos, organizarlos por categorías, establecer presupuestos mensuales y visualizar reportes gráficos.

Capturas de Pantalla

Agrega aquí capturas de pantalla de la aplicación.

Características

• Registro de ingresos y gastos con categorías personalizadas
• Iconos personalizables por categoría
• Presupuestos mensuales con indicadores de progreso y alertas
• Gráficos interactivos: doughnut (gastos por categoría) y barras (ingreso vs gasto, últimos 6 meses)
• Filtros por tipo, categoría y mes
• Exportación de transacciones a CSV
• Backup y restauración de datos en formato JSON
• Multi-moneda: USD, EUR, MXN, COP, ARS, CLP
• Modo oscuro
• Datos demo precargados para pruebas inmediatas

Tecnologías

• Frontend: Angular 20
• UI Framework: Ionic 8
• Plataforma móvil: Capacitor 8 (Android)
• Gráficos: Chart.js + ng2-charts
• Lenguaje: TypeScript 5.9
• Almacenamiento: localStorage

Instalación

Prerrequisitos

• Node.js 18 o superior
• npm o yarn
• Angular CLI (npm install -g @angular/cli)
• Ionic CLI (npm install -g @ionic/cli)

Pasos

# Clonar el repositorio
git clone https://github.com/NightOwl-SV/FinTrack.git

# Entrar al directorio
cd FinTrack

# Instalar dependencias
npm install

# Ejecutar en el navegador
ionic serve

Build para Android

# Agregar plataforma Android
npx cap add android

# Sincronizar assets
npx cap sync

# Abrir en Android Studio
npx cap open android

Build Web (producción)

ng build --configuration production

Los archivos de salida se generarán en la carpeta www/.

Estructura del Proyecto

src/app/
├── models/           # Interfaces de datos (Transaction, Category, Budget)
├── services/         # Servicio de base de datos y lógica de negocio
├── components/       # Modales (Transaction, Category, Budget)
├── tab1/             # Dashboard principal
├── tab2/             # Lista de transacciones con filtros
├── tab3/             # Presupuestos mensuales
├── tab4/             # Reportes y gráficos
├── category/         # Gestión de categorías
├── settings/         # Configuración y administración de datos
└── tabs/             # Contenedor de navegación por tabs

Funcionalidad

Funcionalidad	Estado
CRUD de transacciones	Completado
CRUD de categorías	Completado
CRUD de presupuestos	Completado
Dashboard con resumen mensual	Completado
Filtros de transacciones	Completado
Gráficos interactivos	Completado
Exportación CSV	Completado
Backup/Restore JSON	Completado
Multi-moneda	Completado
Modo oscuro	Completado

Autor

NightOwl-SV

Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.