spends
Aplicación auto-alojada para rastrear compras, gestionar garantías y analizar patrones de gasto. Utiliza FastAPI en el backend y Alpine.js con Vite en el frontend. Soporta almacenamiento de archivos con deduplicación y análisis visual mediante Chart.js.
Ficha actualizada 27 sept 2026, 23:11 · upstream 27 sept 2026, 22:59 · release sin release detectada
Qué es spends
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Spends es una herramienta auto-alojada diseñada para gestionar compras, controlar garantías y visualizar patrones de gasto personal. La aplicación combina un frontend moderno basado en Vite con Alpine.js y Bootstrap 5, junto a un backend robusto construido con FastAPI, SQLAlchemy y Pydantic. Permite el seguimiento detallado de productos, precios y minoristas, además de la gestión documental para recibos, manuales y fotos.
El sistema incluye capacidades avanzadas de análisis mediante gráficos interactivos con Chart.js y detección automática de expiración de garantías. El almacenamiento utiliza una estrategia de archivos hash-sharded con referencia por conteo, optimizando el espacio en disco. En producción, la base de datos recomendada es PostgreSQL, aunque soporta SQLite para desarrollo.
Para su despliegue, se requieren entornos separados para frontend y backend, configurando puertos predeterminados en 3030 y 3031 respectivamente. Es crucial ejecutar las migraciones de la base de datos antes del uso productivo y gestionar los archivos subidos en el directorio correspondiente.
- Rastreo detallado de compras con metadatos de producto y minorista
- Gestión centralizada de garantías con alertas de expiración automática
- Almacenamiento seguro de recibos, manuales y fotos con deduplicación
- Análisis visual de tendencias de gasto y distribución por marca
- Arquitectura separada frontend/backend para escalabilidad
- Sistema de archivos hash-sharded para optimización de almacenamiento
- API REST completa con documentación automática (Swagger/ReDoc)
- Soporte nativo para análisis de gastos con visualizaciones gráficas
- No incluye contenedores Docker preconfigurados por defecto
- Requiere instalación manual de dependencias de Node.js y Python
- Configuración inicial de base de datos y puertos necesaria manualmente
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar dependencias frontend con npm y backend con pip. Configurar variables de entorno en .env para puertos (3030/3031) y URLs. Ejecutar migraciones Alembic antes de iniciar el servidor. Desplegar uvicorn para backend y Vite dev server o build estático para frontend. Asegurar permisos de escritura en carpeta uploads.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.