flogr
Aplicación web auto-alojada para registro de repostajes y seguimiento del consumo de combustible por vehículo, construida con Flask, SQLite y Chart.js.
Ficha actualizada 25 sept 2026, 13:58 · upstream 25 sept 2026, 13:38 · release v3.5.2
Qué es flogr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
fLOGr es una aplicación web auto-alojada diseñada para registrar compras de combustible y calcular estadísticas de economía de combustible (litros/100km), tendencias de precios y comparativas entre vehículos. Está construida con Python (Flask) y utiliza SQLite como base de datos, ofreciendo una solución ligera y fácil de mantener.
La aplicación permite gestionar múltiples vehículos en un "garaje" virtual, registrar cada repostaje con detalles como ubicación, tipo de combustible y nivel del tanque, y calcular automáticamente métricas clave. Incluye autenticación robusta mediante TOTP (autenticador) y soporte para SSO con Authentik (OIDC). Además, ofrece una API tokenizada para integraciones externas y un registro de auditoría inmutable por usuario.
Las visualizaciones se generan con Chart.js y Bootstrap 5, permitiendo gráficos interactivos de tendencias económicas, gasto por ubicación e historial de precios. La aplicación soporta exportación a CSV y cuenta con un sistema de logs detallado en el contenedor Docker para supervisión operativa.
- Seguimiento del consumo de combustible (L/100km) y costes operativos por vehículo.
- Análisis de tendencias de precios del combustible a nivel local o temporal.
- Gestión de flotas pequeñas con comparativas de economía entre vehículos.
- Auditoría de gastos de combustible con registro inmutable de cambios en los datos.
- Cálculo automático de L/100km y costes ajustado por llenados parciales del tanque.
- Integración nativa con Authentik para SSO (OIDC) y autenticación TOTP.
- API tokenizada con escopos granulares para acceso programático seguro.
- Registro de auditoría inmutable por usuario para trazabilidad completa.
- Persistencia de datos en SQLite con soporte para migraciones automáticas.
- No soporta unidades alternativas como millas, galones o MPG (solo litros/km).
- Falta exportación nativa a PDF de informes y gráficos.
- Gestión de usuarios limitada: no permite editar/borrar cuentas ni recuperación por email.
- Dependencia de un contenedor Docker para despliegue estándar.
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.
Desplegar con Docker usando el archivo docker-compose.yml. Persistir la base de datos SQLite en /path/to/flogr/data:/flask-app/data. Configurar SECRET_KEY en variables de entorno antes del despliegue en producción. Mapear el puerto 8080 del contenedor al host (ej. 15001). Asegurar que la red Docker sea externa o configurar correctamente las redes internas.
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.