Loading repository data…
Jaolmos / repository
Aplicación web para control de gastos hormiga con Django 5.2 + HTMX + Tailwind CSS. Dashboard interactivo, modales dinámicos, gráficos Chart.js, filtros avanzados, API REST, automatización n8n con IA, Docker y diseño responsive. Control eficiente de pequeños gastos diarios.
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:
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.
Perfil de usuario y configuraciones optimizadas para móvil.
La aplicación incluye un sistema completo de modo oscuro que se adapta a todas las pantallas y componentes.
El modo oscuro mantiene la legibilidad y jerarquía visual en todas las pantallas.
Vista de lista completa con el tema oscuro aplicado.
# 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
# Crear categorías predeterminadas (8 categorías base)
docker-compose exec web python manage.py create_default_categories
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
# 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:
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:
Selected from shared topics, language and repository description—not editorial ratings.
GonzaloPontnau /
Money Manager es una aplicación web completa para la gestión de finanzas personales desarrollada principalmente con Python (Django), HTML/CSS, JavaScript, Chart.js y PostgreSQL.