receipt-radar
receipt-radar es una herramienta auto-alojada para analizar recibos digitales de Kaufland y REWE en Alemania. Proporciona historial de precios, detección de ofertas falsas comparadas con tu propio historial, agregación de gastos y sincronización de inventario con Grocy.
Ficha actualizada 24 sept 2026, 21:13 · upstream 24 sept 2026, 20:44 · release sin release detectada
Qué es receipt-radar
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto convierte tus recibos digitales (Digitale Kassenbons) en datos estructurados para un análisis financiero personal sin depender de servicios en la nube. Al ser una herramienta auto-alojada, mantienes el control total sobre tus datos de compra sensibles, evitando convertirte en procesador de información de terceros. La arquitectura combina Next.js para la interfaz web y FastAPI/Python para el procesamiento de backend, permitiendo una ejecución robusta en entornos locales como NAS o servidores personales.
La herramienta destaca por su capacidad de verificación de integridad de precios, comparando el precio actual con la mediana de tus compras anteriores en la misma tienda para identificar si un descuento es real o solo nominal. Además, integra directamente con Grocy mediante una API, permitiendo actualizar automáticamente tu inventario doméstico al procesar cada recibo. El enfoque de diseño prioriza la privacidad y la interoperabilidad, asegurando que los datos nunca salgan de tu infraestructura sin consentimiento explícito.
Sin embargo, el proyecto tiene limitaciones inherentes a su naturaleza actual: solo soporta tiendas alemanas (Kaufland y REWE) desde julio de 2024 debido a cambios en el formato PDF. No existe sincronización automática; los recibos deben exportarse manualmente como PDFs desde la aplicación móvil o web. La interfaz no incluye autenticación nativa en el endpoint de subida, por lo que se recomienda obligatoriamente un proxy inverso con control de acceso si se expone a redes externas.
- Visualizar historial de precios de productos específicos mediante gráficos sparkline y tablas ordenadas por fecha.
- Verificar la autenticidad de descuentos en el punto de venta comparando con tu propio historial de compras.
- Agregar automáticamente artículos a Grocy para mantener el inventario del hogar actualizado tras cada compra.
- Calcular el gasto total acumulado desglosado por tienda y periodo temporal.
- Exportar datos de recibos en formato CSV o Markdown para análisis externo o archivado personal.
- Arquitectura auto-alojada que garantiza privacidad total sin enviar datos a servidores externos.
- Integración nativa con Grocy mediante API para gestión automática de inventario doméstico.
- Algoritmo de detección de ofertas basado en la mediana personal del usuario, no en bases de datos externas.
- Soporte multi-archivo para procesar recibos PDFs sin necesidad de OCR (solo texto extraíble).
- Interfaz web moderna construida con Next.js y accesible vía navegador local.
- Compatibilidad restringida a Kaufland y REWE en Alemania desde julio de 2024.
- Falta de autenticación nativa en el endpoint de subida, requiriendo proxy inverso para seguridad.
- Procesamiento manual de recibos (exportar PDF) sin sincronización automática con la app del retailer.
- Soporte limitado a un único usuario por instancia (sin multi-tenencia ni cuentas).
- Sin integración nativa con Home Assistant, aunque Grocy está soportado.
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 usando `docker compose up -d`. Montar volumen persistente `./data:/data` para guardar recibos y datos. Configurar variables de entorno `.env` opcionales para Grocy (`GROCY_URL`, `GROCY_API_KEY`). Ejecutar en red confiable o detrás de proxy inverso con autenticación. Imagen multi-architectura disponible (amd64/arm64).
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.