l4rm4nd/VoucherVault

¿Qué es?

Funciones clave

• 01Guarda vales, cupones, tarjetas de regalo y tarjetas de fidelidad con sus códigos de canje.
• 02Muestra los códigos como códigos QR o códigos de barras, con escaneo en el cliente al crearlos.
• 03Envía notificaciones de vencimiento a través de Apprise.
• 04Admite varios usuarios, el uso compartido de elementos y el inicio de sesión único con OIDC.
• 05Ofrece una PWA optimizada para móviles, con caché sin conexión de 48 horas.
• 06Proporciona una REST API con estadísticas para Home Assistant y otros paneles.

Casos de uso

• Guardar en una cartera digital las tarjetas de fidelidad y de regalo de varias tiendas.
• Recibir recordatorios antes de que venzan los vales o cupones.
• Compartir tarjetas de regalo con familiares en un servidor doméstico.
• Mostrar estadísticas de vales en un panel de Home Assistant.

Inicio rápido

1. 1

   Crea el directorio del volumen de persistencia

   mkdir -p ./volume-data/database
2. 2

   Cambia el propietario del volumen a www-data (UID/GID 33)

   sudo chown -R 33:33 volume-data/*
3. 3

   Inicia la pila de contenedores con Docker Compose

   docker compose -f docker/docker-compose-sqlite.yml up -d
4. 4

   Abre http://127.0.0.1:8000 y consulta la contraseña de administrador autogenerada en los registros del contenedor

   docker compose -f docker/docker-compose-sqlite.yml logs -f

Antes de usarlo

• !Para un uso seguro en producción, se requiere Docker y un proxy inverso con TLS.
• !La configuración del alojamiento propio requiere cambiar manualmente los permisos del volumen y configurar el entorno.
• !Se distribuye bajo la licencia GPL-3.0, una licencia copyleft que exige que las obras derivadas sean de código abierto.

En colecciones

Temas

Preguntas frecuentes

¿Qué es VoucherVault?

Aplicación web Django autoalojada para guardar y gestionar vales, cupones, tarjetas de fidelidad y tarjetas de regalo, con notificaciones de vencimiento. VoucherVault es una aplicación web Django autoalojada para tener en un solo lugar vales, cupones, tarjetas de fidelidad y tarjetas de regalo. Cada elemento puede guardar un código de canje, que se muestra como código QR o código de barras, y puede incluir imágenes o archivos PDF. Las tarjetas de regalo también conservan un historial de transacciones.

¿VoucherVault es gratuito? ¿Qué licencia tiene?

VoucherVault es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿VoucherVault sigue mantenido?

Mantenimiento activo. El último commit de VoucherVault fue el 3 nov 2026.

¿Para qué puedo usar VoucherVault?

Guardar en una cartera digital las tarjetas de fidelidad y de regalo de varias tiendas. Recibir recordatorios antes de que venzan los vales o cupones. Compartir tarjetas de regalo con familiares en un servidor doméstico. Mostrar estadísticas de vales en un panel de Home Assistant.

¿Cómo se instala VoucherVault?

Crea el directorio del volumen de persistencia: mkdir -p ./volume-data/database Cambia el propietario del volumen a www-data (UID/GID 33): sudo chown -R 33:33 volume-data/* Inicia la pila de contenedores con Docker Compose: docker compose -f docker/docker-compose-sqlite.yml up -d Abre http://127.0.0.1:8000 y consulta la contraseña de administrador autogenerada en los registros del contenedor: docker compose -f docker/docker-compose-sqlite.yml logs -f

¿Dónde consigo VoucherVault?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/l4rm4nd/VoucherVault