lubelogger-telegram-bot
Bot para registrar combustible, servicios y kilometraje en Telegram con LubeLogger.
Ficha actualizada 23 sept 2026, 7:01 · upstream 23 sept 2026, 6:45 · release v1.2.0
Qué es lubelogger-telegram-bot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este bot permite registrar entradas de combustible, registros de servicio y lecturas del kilometraje directamente desde el teléfono móvil sin necesidad de una interfaz web. Funciona como un puente entre la aplicación LubeLogger (que puede ejecutarse localmente o en un servidor) y Telegram. Es especialmente útil cuando LubeLogger no tiene acceso público a internet, ya que el bot se conecta al servidor local mediante red local y Telegram actúa como intermediario. Si LubeLogger está temporalmente caído, los registros se guardan en cola local y se sincronizan cuando la aplicación vuelva online.
Además, el bot soporta múltiples idiomas (principalmente inglés e italiano) y permite personalizar la interfaz mediante configuraciones de usuario. Se integra con Python 3.11+ a través del framework Next.js para una experiencia de usuario moderna y accesible desde cualquier dispositivo.
- Registrar un llenado de combustible en tiempo real mientras se conduce, sin necesidad de abrir el navegador ni navegar a la web.
- Documentar servicios mecánicos realizados (cambio de aceite, filtros, etc.) directamente desde Telegram con datos como kilometraje y costo del servicio.
- Mantener un historial de lecturas de kilometraje para calcular el consumo promedio o detectar anomalías en el desgaste del vehículo.
- Compartir registros de combustible entre miembros de una comunidad o grupo de usuarios sin necesidad de compartir enlaces ni contraseñas.
- Automatizar la sincronización de datos diarios con LubeLogger, permitiendo que los registros se actualicen automáticamente cada vez que se llene el tanque.
- Crear un sistema de registro de mantenimiento preventivo donde el usuario pueda seleccionar vehículos y registrar costos asociados a cada servicio.
- Soporta múltiples idiomas mediante archivos JSON separados, permitiendo cambiar la interfaz sin recompilar el código.
- Permite guardar registros en cola local con persistencia en SQLite, asegurando que no se pierdan si LubeLogger está caído temporalmente.
- Utiliza HTTPx para conexiones asíncronas a LubeLogger, lo que permite manejar múltiples solicitudes simultáneamente sin bloquear el hilo principal.
- Incluye validación de datos mediante Pydantic v2, asegurando que los campos como kilometraje y litros se mantengan en formato numérico correcto.
- Soporta autenticación básica para versiones antiguas de LubeLogger mediante variables de entorno LUBELOGGER_USERNAME y LUBELOGGER_PASSWORD.
- No permite la creación o edición de vehículos desde el bot; los usuarios deben seleccionar un vehículo existente previamente configurado.
- La sincronización con LubeLogger depende del estado de conexión del servidor, por lo que si este está caído, los registros se pierden hasta que vuelva online.
- El uso de variables de entorno como LUBELOGGER_API_KEY puede ser inseguro en entornos públicos o no controlados, ya que se exponen en el código fuente.
- No incluye un sistema de notificaciones push para alertar sobre nuevos registros pendientes; solo muestra los últimos datos disponibles.
- La persistencia de datos se realiza mediante SQLite local, lo que limita la escalabilidad y la capacidad de compartir datos entre dispositivos sin una base de datos centralizada.
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.
Para desplegar el bot en un entorno Docker, se recomienda usar docker-compose con un archivo .env que contenga las variables de configuración. Se debe configurar LUBELOGGER_URL apuntando al servidor local o a la URL del servicio LubeLogger (por ejemplo, http://192.168.1.100:8080). Si se desea ejecutar el bot junto con LubeLogger en un entorno Docker completo, se puede usar docker-compose.full.yml que carga las variables de configuración desde .env y sobrescribe solo la URL del servicio. Se recomienda configurar HTTPS para mejorar la seguridad al transmitir datos sensibles como claves API o credenciales básicas.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.