finances-tracker
Aplicación Flask para seguimiento financiero mensual con soporte Docker y Kubernetes. Usa SQLite, Decimal para valores monetarios, autenticación local u OpenID Connect (Pocket ID), endpoint /health y actualizaciones automáticas de esquema. Ideal para despliegue autoalojado con uv o contenedores prec
Ficha actualizada 28 sept 2026, 3:43 · upstream 28 sept 2026, 3:20 · release v1.2.5
Qué es finances-tracker
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Finances Tracker es una aplicación Flask diseñada para gestionar finanzas personales con trabajo por espacios mensuales protegidos por sesiones. Utiliza SQLAlchemy con SQLite como base de datos persistente, manejando valores monetarios con precisión decimal y proporcionando un endpoint /health para orquestación en entornos Kubernetes o Docker.
La aplicación soporta autenticación local con Flask-Login u OpenID Connect (Pocket ID) opcional, incluyendo modo OIDC-only. Las actualizaciones de esquema se ejecutan automáticamente al iniciar, preservando datos existentes sin migraciones manuales. Incluye soporte para despliegue en contenedores Docker con imagen precompilada en GHCR y Helm charts para Kubernetes.
Para desarrollo local, requiere uv y Python 3.10 o superior. La configuración permite habilitar OpenID Connect mediante variables de entorno específicas, con opciones para auto-provisionamiento de cuentas y control sobre la autenticación local. Se recomienda mantener SECRET_KEY y OIDC_CLIENT_SECRET estables fuera del control de versiones.
- Seguimiento de ingresos y gastos mensuales por espacios de trabajo
- Gestión de cuentas bancarias múltiples con visualización lado a lado
- Autenticación segura con OpenID Connect para despliegues corporativos
- Autoalojamiento en Kubernetes con Helm charts preconfigurados
- Desarrollo local reproducible con uv y Python 3.10+
- Migración automática de esquemas sin pérdida de datos
- Manejo preciso de valores monetarios con Decimal (no float)
- Endpoint /health para checks de liveness en orquestadores
- Actualizaciones automáticas de esquema de base de datos SQLite
- Soporte nativo para Docker y Kubernetes con Helm charts
- Autenticación híbrida: local o OpenID Connect (Pocket ID)
- Imagen precompilada disponible en GHCR
- Base de datos SQLite no escalable para cargas multiusuario pesadas
- Requiere SECRET_KEY configurado correctamente o la app no inicia
- OIDC_ONLY=true elimina fallback local si el proveedor falla
- No hay soporte para bases de datos relacionales externas sin configuración manual
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Despliegue recomendado: usar imagen precompilada en GHCR con volumen persistente para SQLite. Configurar SECRET_KEY desde archivo de entorno o secret store, nunca hardcoded. Para producción, habilitar SESSION_COOKIE_SECURE=true y usar HTTPS. Con Kubernetes, usar Helm chart con secret.create=false y proporcionar secret externo. Backup obligatorio del volumen antes de actualizar versión. Modo OIDC requiere configuración completa de variables antes de activar OIDC_ONLY=true.
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.