🚀 Money Manager - Sistema de Gestión Financiera Personal

📸 Demo

Inicio de Sesión

Dashboard Financiero

Registro Ingreso/Gasto

Formulario de Transferencia

Descripción

Money Manager es una aplicación web completa para la gestión de finanzas personales desarrollada con Django. Permite a los usuarios registrar, categorizar y visualizar sus ingresos y gastos, así como realizar transferencias entre usuarios, establecer presupuestos y monitorear su salud financiera a través de un intuitivo dashboard.

Tip

Este proyecto fue diseñado con un enfoque modular para facilitar su mantenimiento y expansión.

---

Características Principales

• Dashboard Financiero: Visualización gráfica de ingresos vs gastos
• Registro de Transacciones: Gestión completa de ingresos y gastos con categorización
• Transferencias: Sistema para enviar y recibir dinero entre usuarios
• Presupuestos: Definición de límites por categoría con alertas de excesos
• Perfiles Personalizados: Configuración de moneda preferida y opciones de usuario
• Sistema de Autenticación: Registro, inicio de sesión y gestión de sesiones
• Interfaz Responsiva: Diseño adaptable a diferentes dispositivos
• Notificaciones: Alertas por correo electrónico para presupuestos y movimientos importantes
• Búsqueda Avanzada: Filtrado de transacciones por múltiples criterios

---

Tecnologías Utilizadas

• Backend: Django 5, Python 3
• Frontend: HTML5, CSS3, JavaScript, Bootstrap 4.6
• Visualización de Datos: Chart.js
• Iconos: Font Awesome 5
• Base de Datos:
  • Desarrollo: SQLite
  • Producción: PostgreSQL en Vercel (anteriormente MySQL)
• Testing: Django Test Framework, Pytest
• Despliegue: Vercel

Note

Este proyecto utiliza una arquitectura MVT (Model-View-Template) típica de Django, pero con una organización modular mejorada.

---

Estructura del Proyecto

money-manager-python/
│
├── finanzas/                # Aplicación principal
│   ├── admin/               # Configuración del panel de administración
│   ├── forms/               # Formularios para la entrada de datos
│   ├── migrations/          # Migraciones de la base de datos
│   ├── models/              # Modelos de datos (estructura de la BD)
│   ├── views/               # Vistas y lógica de negocio
│   ├── signals.py           # Señales para acciones automáticas
│   ├── middleware.py        # Middleware personalizado para optimizaciones
│   ├── apps.py              # Configuración de la aplicación
│   └── urls.py              # Rutas de la aplicación
│
├── money_manager/           # Configuración del proyecto
│   ├── settings.py          # Configuración principal
│   ├── urls.py              # Rutas del proyecto
│   ├── wsgi.py              # Configuración WSGI para despliegue
│   └── asgi.py              # Configuración ASGI para despliegue
│
├── templates/               # Plantillas HTML
│   ├── admin/               # Personalizaciones del admin
│   ├── finanzas/            # Plantillas de la aplicación
│   └── base.html            # Plantilla base
│
├── static/                  # Archivos estáticos (CSS, JS)
│
├── manage.py                # Utilidad de línea de comandos
└── README.md                # Este archivo

---

Instalación y Configuración

Prerrequisitos

• Python 3.9 o superior
• pip (gestor de paquetes de Python)
• Virtualenv (recomendado)

Pasos de Instalación

1. Clonar el repositorio

git clone https://github.com/PontnauGonzalo/money-manager-python
cd money-manager-python

2. Crear y activar entorno virtual

# En Windows
python -m venv venv
venv\Scripts\activate

3. Instalar dependencias

pip install -r requirements.txt

4. Aplicar migraciones

python manage.py migrate

5. Crear superusuario

python manage.py createsuperuser

6. Iniciar servidor de desarrollo

python manage.py runserver

Tip

Para un entorno de producción, asegúrate de configurar un servidor web como Nginx o Apache junto con Gunicorn o uWSGI.

---

Características Avanzadas

Sistema de Signals

El proyecto utiliza el sistema de signals de Django para acciones automáticas:

• Creación automática de categorías predeterminadas para nuevos usuarios
• Actualización de saldos cuando se realizan transacciones

Transacciones Atómicas

Las transferencias entre usuarios utilizan transacciones atómicas para garantizar la integridad de los datos, evitando problemas si una operación falla.

Personalización del Admin

El panel de administración ha sido personalizado para proporcionar:

• Filtros específicos por usuario
• Visualización mejorada con gráficos
• Resúmenes y estadísticas

Tip

Puedes extender fácilmente los modelos agregando nuevos archivos en la carpeta models/ sin modificar la estructura existente.

---

Despliegue en Vercel

El proyecto está desplegado en Vercel, aprovechando su plataforma para aplicaciones web. Algunos aspectos importantes del despliegue:

Migración de Base de Datos

• Desarrollo: Se utiliza SQLite para desarrollo local por su simplicidad y portabilidad.
• Producción actual: PostgreSQL 14 en Neon, un servicio serverless que proporciona autoscaling y alta disponibilidad, integrado con Vercel.
• Optimizaciones recientes:
  • Implementación de índices compuestos para consultas frecuentes por fecha y categoría
  • Creación de vistas materializadas para los reportes del dashboard
  • Optimización de consultas con filtros de rango de fechas
  • Aprovechamiento del modo serverless de Neon para reducir costos cuando la aplicación no está en uso
• Adaptación: El proyecto incluye configuraciones automáticas que detectan el entorno de despliegue y utilizan la base de datos apropiada sin necesidad de modificar el código.

Optimizaciones Implementadas

• Middleware de Caché: middleware personalizado para mejorar el rendimiento mediante caché de recursos estáticos.
• Consultas Optimizadas: Se utilizan select_related y prefetch_related para reducir el número de consultas a la base de datos.
• Índices de Base de Datos: Incorporación de índices estratégicos en campos de búsqueda frecuente para mejorar tiempos de respuesta.
• MutationObserver: Reemplacé los intervals de sondeo por MutationObserver para mejorar el rendimiento del frontend.

---

Estado del Proyecto

El proyecto está actualmente completado y en fase de mantenimiento. Se aceptan sugerencias y mejoras.

---

Lecciones Aprendidas y Desafíos

• La importancia de una arquitectura modular para facilitar el mantenimiento
• Cómo implementar transacciones atómicas en Django
• La personalización del panel de administración para mejorar la usabilidad

Migración de Base de Datos y Despliegue

• Portabilidad de Django ORM: El ORM de Django permitió migrar entre diferentes sistemas de bases de datos (SQLite, MySQL, PostgreSQL) con mínimos cambios de código.
• Utilización de características avanzadas de PostgreSQL: Implementación de particionamiento de tablas e índices parciales para optimizar consultas históricas.
• Compatibilidad de Vercel: Aprendí a configurar aplicaciones Django para Vercel, incluyendo la integración con PostgreSQL.
• Uso de Variables de Entorno: La configuración basada en variables de entorno facilitó el despliegue en distintos entornos sin cambios en el código.
• Estrategias de migración de datos: Desarrollo de scripts específicos para la migración eficiente de datos históricos sin tiempo de inactividad.

Algunos de los desafíos enfrentados incluyen:

• Garantizar la integridad de los datos durante las transferencias
• Optimizar las consultas a la base de datos para mejorar el rendimiento
• Diseñar esquemas eficientes de particionamiento para datos históricos
• Manejar la migración de datos entre diferentes sistemas de bases de datos

---

👨‍💻 Desarrollado por

Ing. Pontnau, Gonzalo Martín

💼 LinkedIn 📧 Email

---