Una aplicación web moderna para controlar esos pequeños gastos diarios que pasan desapercibidos pero que al final del año suman cantidades importantes. Incluye sistema de automatización con n8n para reportes mensuales inteligentes con IA.
Los gastos hormiga son pequeños desembolsos cotidianos que individualmente parecen insignificantes, pero acumulados representan una parte considerable del presupuesto:
- Café diario: €2,50 × 365 días = €912 al año
- Delivery impulsivo: €12 × 2 veces/semana = €1,248 al año
- Taxis innecesarios: €7 × 3 veces/semana = €1,092 al año
- Suscripciones no usadas: €9 × 12 meses = €108 al año
Total: €3,360 al año en gastos "pequeños"
La vista principal con métricas en tiempo real, gráficos interactivos y lista de gastos recientes.
Lista completa de gastos con filtros avanzados y funcionalidad CRUD completa.
Formularios dinámicos que se abren sin recargar la página.
| Agregar Gasto | Editar Gasto |
|---|---|
 |
 |
Configuración personal y alertas automáticas para reportes mensuales.
Página de login con diseño limpio y profesional.
Modal para configurar presupuesto mensual y alertas automáticas.
La aplicación se adapta perfectamente a dispositivos móviles con navegación optimizada y formularios táctiles.
Sistema de filtros inteligentes por período, categoría y monto.
La aplicación cuenta con un diseño completamente responsive que se adapta perfectamente a dispositivos móviles.
Dashboard optimizado para pantallas pequeñas con navegación intuitiva.
Menú hamburguesa con acceso rápido a todas las funcionalidades.
Página de login optimizada para dispositivos táctiles.
Lista de gastos y formularios adaptados para móviles.
| Lista de Gastos | Agregar Gasto |
 |
 |
Perfil de usuario y configuraciones optimizadas para móvil.
- Métricas en tiempo real con filtros por período
- Gráficos interactivos (dona y líneas) con Chart.js
- Auto-actualización sin recargar página (HTMX)
- Diseño responsive optimizado para móviles
- Distribución por categorías con colores personalizados
- Tendencias temporales para identificar patrones
- Proyecciones anuales automáticas
- Comparativas mensuales
- Interfaz HTMX sin recargas de página
- Modales dinámicos para operaciones CRUD
- Auto-refresh en listas y métricas
- Navegación fluida entre secciones
- Filtros inteligentes por fecha, categoría y monto
- CRUD completo con validación en tiempo real
- Sistema de categorías con colores personalizados
- Gestión de usuarios con autenticación segura
- Sistema de alertas de presupuesto automatizado
- API REST: Endpoints específicos para integración con n8n
- Reportes Automatizados: Generación mensual de reportes con IA
- Webhooks: Sistema de notificaciones automáticas
- Django 5.2.3: Framework web robusto
- Django REST Framework: API REST para integración con n8n
- PostgreSQL: Base de datos para desarrollo y producción
- Python 3.12: Lenguaje base
- Gunicorn: Servidor WSGI para producción
- HTMX: Interactividad sin JavaScript complejo
- Tailwind CSS: Framework de utilidades CSS
- Chart.js: Gráficos interactivos
- Alpine.js: Interactividad ligera
- Docker: Containerización completa
- Nginx: Servidor web y proxy inverso
- n8n: Automatización de workflows y reportes mensuales con IA
- Docker y Docker Compose
- Git
# Clonar repositorio
git clone https://github.com/tu-usuario/hormigah.git
cd hormigah
# Configurar variables de entorno
cp .env.example .env.local
# Iniciar aplicación
docker-compose up -d
# Configurar Django
docker-compose exec web python manage.py migrate
docker-compose exec web python manage.py createsuperuser- Aplicación principal: http://localhost:8000/
- Panel de administración: http://localhost:8000/admin/
hormigah/
├── apps/
│ ├── core/ # Utilidades base y templates
│ ├── expenses/ # App principal de gastos
│ │ ├── api/ # API REST para n8n
│ │ │ ├── authentication.py # Bearer token auth
│ │ │ ├── serializers.py # DRF serializers
│ │ │ ├── views.py # API views
│ │ │ └── urls.py # API endpoints
│ │ ├── models.py # Category, Expense, Budget
│ │ ├── views.py # Lógica de negocio web
│ │ ├── forms.py # Formularios con validación
│ │ ├── utils/ # Utilidades modularizadas
│ │ ├── templates/ # Templates especializados
│ │ └── static/ # CSS y JS específicos
│ └── users/ # Gestión de usuarios
├── config/ # Configuración Django
│ ├── settings/ # Settings modulares
│ │ ├── base.py # Configuración base + API REST
│ │ ├── local.py # Desarrollo
│ │ └── production.py # Producción
│ └── urls.py # URLs principales + API
├── static/ # Archivos estáticos globales
├── docker-compose.yml # Docker desarrollo
├── docker-compose.prod.yml # Docker producción + n8n
├── Dockerfile # Imagen de la aplicación
└── requirements.txt # Dependencias Python + DRF
- Métricas del período seleccionado
- Gráfico de distribución por categorías
- Tendencia temporal de gastos
- Lista de gastos recientes
- Agregar nuevo gasto (modal HTMX)
- Editar gasto existente (modal HTMX)
- Eliminar gasto (confirmación)
- Ver detalles completos
- Por período (Este mes, último mes, últimos 7/30 días)
- Por categoría (Café, Delivery, Transporte, etc.)
- Por rango de fechas personalizado
- Por rango de montos (min/max)
- Alertas automáticas al alcanzar el 90% del presupuesto mensual
- Configuración por usuario (activar/desactivar)
- Reportes Mensuales Automatizados: n8n + OpenAI + Gmail
- API REST: Integración específica para n8n
- Análisis Inteligente: IA personalizada por usuario y período
# Iniciar servicios
docker-compose up -d
# Ver logs
docker-compose logs -f web
# Ejecutar migraciones
docker-compose exec web python manage.py makemigrations
docker-compose exec web python manage.py migrate
# Ejecutar tests
docker-compose exec web python manage.py test
# Acceder a Django shell
docker-compose exec web python manage.py shell# Desplegar aplicación + n8n
docker-compose -f docker-compose.prod.yml up -d
# Ver estado de todos los servicios
docker-compose -f docker-compose.prod.yml ps
# Ver logs específicos
docker-compose -f docker-compose.prod.yml logs web
docker-compose -f docker-compose.prod.yml logs n8n
# Acceder a n8n
# http://tu-dominio.com:5678# Test endpoint usuarios activos
curl -H "Authorization: Bearer {token}" http://localhost:8000/api/users/active/
# Test endpoint usuario completo
curl -H "Authorization: Bearer {token}" http://localhost:8000/api/users/1/complete/
# Verificar documentación API
curl http://localhost:8000/api/docs/La aplicación incluye 2 endpoints específicos desarrollados con Django REST Framework para que n8n pueda generar reportes automáticos.
GET /api/users/active/
Authorization: Bearer {N8N_API_TOKEN}
Propósito: Obtener lista de usuarios elegibles para reportes automáticos
Retorna usuarios que:
- Tienen presupuesto configurado
- Tienen alertas por email activadas
- Han registrado gastos en los últimos 30 días
GET /api/users/{id}/complete/
Authorization: Bearer {N8N_API_TOKEN}
Propósito: Obtener todos los datos necesarios para generar reportes con IA
Retorna datos completos incluyendo:
- Información del usuario y presupuesto
- Historial completo de gastos
- Resúmenes mensuales y por categorías
- Estadísticas y tendencias
- Swagger UI: http://localhost:8000/api/docs/
- OpenAPI Schema: http://localhost:8000/api/schema/
- Desarrollo: Token fijo en settings
- Producción: Token seguro via variables de entorno
- Tipo: Bearer Token personalizado
El sistema incluye dos workflows principales de n8n para automatización completa:
- Schedule Trigger: Se ejecuta automáticamente el día 1 de cada mes a las 9:00 AM
- Detección de Usuarios: Consume endpoint
/api/users/active/para obtener usuarios elegibles - Análisis Individual: Para cada usuario consume
/api/users/{id}/complete/para obtener datos completos - Filtrado Temporal: Procesa únicamente los gastos del mes anterior
- Análisis con IA: GPT-3.5-turbo genera reporte personalizado
- Envío por Email: Gmail con diseño HTML profesional
- Webhook Trigger: Activado cuando Django detecta que un usuario supera el 90% del presupuesto
- Procesamiento Inmediato: Recibe datos del usuario y presupuesto actual
- Envío de Alerta: Email inmediato via Gmail notificando el límite alcanzado
- Prevención de Gastos: Ayuda a evitar superar el presupuesto mensual
- Análisis Temporal Preciso: Solo analiza el mes anterior, no el actual
- Métricas Financieras: Total gastado, porcentaje del presupuesto usado
- Desglose por Categorías: Análisis detallado de cada tipo de gasto
- Recomendaciones Personalizadas: Sugerencias específicas del usuario
- Alertas en Tiempo Real: Notificaciones automáticas al alcanzar límites
- Diseño Profesional: Emails HTML con identidad visual corporativa
- Auto-Refresh Inteligente: Las listas se actualizan automáticamente
- Interfaz Moderna: Modales HTMX sin cambiar de página
- Responsive Design: Optimizado para todos los dispositivos
- Sistema de Automatización Completo: n8n + API REST + IA
- Reportes Mensuales Automatizados: Análisis personalizado con GPT
- Integración Gmail: Emails HTML profesionales automáticos