l4rm4nd/VoucherVault

O que é?

Recursos principais

• 01Armazena vouchers, cupons, cartões-presente e cartões de fidelidade com códigos de resgate.
• 02Exibe os códigos como QR codes ou códigos de barras e permite escaneá-los no cliente durante a criação.
• 03Envia notificações de vencimento pelo Apprise.
• 04Oferece suporte a vários usuários, compartilhamento de itens e login único (SSO) com OIDC.
• 05Oferece uma PWA otimizada para dispositivos móveis, com cache offline por 48 horas.
• 06Disponibiliza uma REST API com estatísticas para o Home Assistant e outros dashboards.

Casos de uso

• Manter cartões de fidelidade e cartões-presente de várias lojas em uma carteira digital.
• Receber lembretes antes do vencimento de vouchers ou cupons.
• Compartilhar cartões-presente com familiares em um servidor doméstico.
• Exibir estatísticas de vouchers em um dashboard do Home Assistant.

Início rápido

1. 1

   Crie o diretório do volume de persistência

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

   Altere o proprietário do volume para www-data (UID/GID 33)

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

   Inicie a pilha de contêineres com Docker Compose

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

   Acesse http://127.0.0.1:8000 e consulte nos logs do contêiner a senha de administrador gerada automaticamente

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

Antes de usar

• !Para uso seguro em produção, é necessário ter o Docker e um proxy reverso com TLS.
• !A configuração de hospedagem própria exige alterações manuais nas permissões do volume e na configuração do ambiente.
• !Licenciado sob a GPL-3.0, uma licença copyleft que exige que obras derivadas sejam de código aberto.

Em coleções

Tópicos

Perguntas frequentes

O que é VoucherVault?

Aplicativo web Django auto-hospedado para armazenar e gerenciar vouchers, cupons, cartões de fidelidade e cartões-presente, com notificações de vencimento. VoucherVault é um aplicativo web Django auto-hospedado para organizar vouchers, cupons, cartões de fidelidade e cartões-presente em um só lugar. Cada item pode armazenar seu código de resgate, exibido como QR code ou código de barras, e incluir imagens ou PDFs enviados. Os cartões-presente também mantêm um histórico de transações.

VoucherVault é gratuito? Qual é a licença?

VoucherVault é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

VoucherVault ainda é mantido?

Manutenção ativa. O último commit de VoucherVault foi em 3 de nov. de 2026.

Para que posso usar VoucherVault?

Manter cartões de fidelidade e cartões-presente de várias lojas em uma carteira digital. Receber lembretes antes do vencimento de vouchers ou cupons. Compartilhar cartões-presente com familiares em um servidor doméstico. Exibir estatísticas de vouchers em um dashboard do Home Assistant.

Como instalar VoucherVault?

Crie o diretório do volume de persistência: mkdir -p ./volume-data/database Altere o proprietário do volume para www-data (UID/GID 33): sudo chown -R 33:33 volume-data/* Inicie a pilha de contêineres com Docker Compose: docker compose -f docker/docker-compose-sqlite.yml up -d Acesse http://127.0.0.1:8000 e consulte nos logs do contêiner a senha de administrador gerada automaticamente: docker compose -f docker/docker-compose-sqlite.yml logs -f

Onde consigo VoucherVault?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/l4rm4nd/VoucherVault