Expense Tracker

Un rastreador de gastos personal que procesa automáticamente notificaciones bancarias recibidas por correo electrónico (Gmail) y registra transacciones en una base de datos SQLite.

Actualmente soporta:

• Hey Banco (compras con tarjeta, pagos de tarjeta, transferencias SPEI entrantes/salientes)
• Nu (Nubank México) – transferencias SPEI salientes (en desarrollo)
• RappiCard – notificaciones de compras, transferencias y pagos
• Banorte – transferencias SPEI salientes
• Mercado pago - transferencias SPEI salientes

Soporte futuro para más bancos

El proyecto está diseñado para ser fácilmente extensible. Los próximos bancos que se planea agregar son:

• PayPal – alertas de compras y pagos enviados
• DiDi Prestamos - Depositos y pagos de prestamos
• Banamex - Compras, transferencias y pago de tarjeta
• American Express - Compras y pago de tarjeta

Características

• Conexión segura a Gmail vía OAuth 2.0
• Búsqueda global de correos de los bancos soportados
• Parsers específicos por banco
• Guardado automático de cuerpos de email en disco (data/) para depuración y desarrollo de parsers
• Base de datos SQLite con:
  • Tabla para almacenar transacciones realizadas
  • Tablas preparadas para categorías y subcategorías (próxima funcionalidad)
• Logging detallado
• Arquitectura limpia y extensible

Interfaz Gráfica (Frontend)

Se incluye una interfaz web construida con React + TypeScript + Tailwind CSS.

Ejecutar el proyecto

# Terminal 1 - Backend
fastapi dev api.py

# Terminal 2 - Frontend
cd frontend
npm run dev

• Backend: http://localhost:8000
• Frontend: http://localhost:5173

La interfaz permite ver, filtrar y buscar transacciones, además de disparar manualmente la sincronización con Gmail.