odograph
Odograph es un rastreador de kilómetros autoalojado que calcula deducciones fiscales para viajes de negocios integrando OwnTracks. Utiliza Next.js y FastAPI con PostgreSQL, diseñado para Linux con soporte Docker y Compose.
Ficha actualizada 23 sept 2026, 20:14 · upstream 23 sept 2026, 20:08 · release v0.11.2
Qué es odograph
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Odograph es una aplicación autoalojada diseñada para registrar automáticamente los desplazamientos mediante la integración con OwnTracks en dispositivos móviles. Permite detectar viajes, clasificarlos como personales o de negocio, visualizar rutas en mapas basados en OpenStreetMap y calcular estimaciones de deducciones fiscales según las tasas estándar del IRS para usuarios estadounidenses. También gestiona gastos por vehículo y permite comparar los kilómetros rastreados contra el odómetro físico.
- Rastreo automático de desplazamientos diarios mediante OwnTracks en teléfonos móviles
- Cálculo de deducciones fiscales estimadas para viajes de negocios en EE.UU.
- Gestión de flotas pequeñas y control de gastos por vehículo
- Visualización de rutas geográficas y puntos de interés en mapas interactivos
- Recordatorios para categorizar viajes pendientes de clasificación fiscal
- Exportación de datos y generación de informes para auditoría o contabilidad
- Arquitectura autoalojada que mantiene todos los datos (trips, puntos, vehículos) en el servidor local
- Integración nativa con OwnTracks para ingestión continua de ubicación sin intervención manual
- Stack tecnológico moderno basado en Next.js y FastAPI con base de datos PostgreSQL
- Soporte oficial para despliegue con Docker Compose o Podman en entornos Linux
- Enfoque estricto en privacidad con HTTPS obligatorio para cookies de sesión seguras
- Scripts incluidos para copias de seguridad, restauración y gestión de claves criptográficas
- Las deducciones fiscales calculadas son válidas exclusivamente para el sistema tributario del IRS (EE.UU.)
- Por defecto opera en modo single-user sin soporte nativo para invitaciones o multiusuario
- Requiere un servidor Linux que permanezca activo, ya que el tracking depende de la ingestión continua de datos
- La recuperación de sesión y gestión de cuentas requiere HTTPS configurado correctamente en el proxy inverso
- Las actualizaciones entre versiones pueden requerir migración manual de la imagen del contenedor y verificación de backups
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.
Requiere servidor Linux con Docker Engine o Podman. Necesita PostgreSQL (imagen oficial 16.15/PostGIS 3.6.4), OpenSSL para generar secretos y un proxy inverso que termine HTTPS. El despliegue recomendado usa scripts de generación de entorno (`generate_env.sh`) y creación manual del administrador inicial. Se recomienda mantener el servidor despierto para recibir datos en tiempo real. Las copias de seguridad se gestionan mediante scripts incluidos, evitando comandos `down -v` a menos que sea necesario borrar la base de datos.
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.