Repolode
l4rm4nd

l4rm4nd/VoucherVault

Самостоятельно размещаемое Django-приложение для хранения и управления ваучерами, купонами, картами лояльности и подарочными картами с уведомлениями об истечении срока действия.

Open source альтернатива:Stocard

Звёзды
515
Форки
28
Открытые issues
3
Последний коммит
3 дня назад

Что это?

VoucherVault — самостоятельно размещаемое веб-приложение на Django, которое помогает хранить ваучеры, купоны, карты лояльности и подарочные карты в одном месте. Для каждой записи можно указать код активации, который отображается в виде QR-кода или штрихкода, а также загрузить изображения или PDF-файлы. Для подарочных карт ведётся история операций.

Приложение работает как PWA, адаптированное для мобильных устройств: в нём есть светлая и тёмная темы, а также ручной офлайн-режим с кэшированием данных на 48 часов. Напоминания об истечении срока действия отправляются ежедневно через Apprise; пороговые значения можно настроить. Пользователи могут делиться записями друг с другом. Проект поддерживает нескольких пользователей, единый вход через OIDC, SQLite3 и PostgreSQL, а также REST API со статистикой для Home Assistant и других дашбордов.

Ключевые возможности

  • 01Хранение ваучеров, купонов, подарочных карт и карт лояльности с кодами активации.
  • 02Отображение кодов в виде QR-кодов или штрихкодов и сканирование на стороне клиента при создании записи.
  • 03Уведомления об истечении срока действия через Apprise.
  • 04Поддержка нескольких пользователей, совместного доступа к записям и единого входа через OIDC.
  • 05PWA с адаптацией для мобильных устройств и офлайн-кэшированием на 48 часов.
  • 06REST API со статистикой для Home Assistant и других дашбордов.

Сценарии использования

  • Хранение карт лояльности и подарочных карт разных магазинов в одном цифровом кошельке.
  • Получение напоминаний до истечения срока действия ваучеров и купонов.
  • Совместное использование подарочных карт с членами семьи на домашнем сервере.
  • Просмотр статистики по ваучерам на дашборде Home Assistant.

Быстрый старт

  1. 1

    Создайте каталог для постоянного хранения данных

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

    Измените владельца тома на www-data (UID/GID 33)

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

    Запустите стек контейнеров с помощью Docker Compose

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

    Откройте http://127.0.0.1:8000 и найдите автоматически созданный пароль администратора в логах контейнера

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

Что важно знать

  • Для безопасного использования в production требуются Docker и обратный прокси с TLS.
  • Настройка собственного хостинга требует вручную изменить разрешения тома и параметры среды.
  • Лицензия GPL-3.0 — лицензия с авторским левом, требующая открытого исходного кода производных работ.

В подборках

Темы

#django#vouchers#coupons#gift-cards#loyalty-cards#self-hosted#pwa#oidc#apprise#asset-manager

Частые вопросы

Что такое VoucherVault?
Самостоятельно размещаемое Django-приложение для хранения и управления ваучерами, купонами, картами лояльности и подарочными картами с уведомлениями об истечении срока действия. VoucherVault — самостоятельно размещаемое веб-приложение на Django, которое помогает хранить ваучеры, купоны, карты лояльности и подарочные карты в одном месте. Для каждой записи можно указать код активации, который отображается в виде QR-кода или штрихкода, а также загрузить изображения или PDF-файлы. Для подарочных карт ведётся история операций.
VoucherVault можно использовать бесплатно? Какая у него лицензия?
VoucherVault распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
VoucherVault всё ещё поддерживается?
Активно поддерживается. Последний коммит в VoucherVault — 3 нояб. 2026 г..
Для чего можно использовать VoucherVault?
Хранение карт лояльности и подарочных карт разных магазинов в одном цифровом кошельке. Получение напоминаний до истечения срока действия ваучеров и купонов. Совместное использование подарочных карт с членами семьи на домашнем сервере. Просмотр статистики по ваучерам на дашборде Home Assistant.
Как установить VoucherVault?
Создайте каталог для постоянного хранения данных: mkdir -p ./volume-data/database Измените владельца тома на www-data (UID/GID 33): sudo chown -R 33:33 volume-data/* Запустите стек контейнеров с помощью Docker Compose: docker compose -f docker/docker-compose-sqlite.yml up -d Откройте http://127.0.0.1:8000 и найдите автоматически созданный пароль администратора в логах контейнера: docker compose -f docker/docker-compose-sqlite.yml logs -f
Где скачать VoucherVault?
Исходный код и инструкции по установке — на GitHub: https://github.com/l4rm4nd/VoucherVault

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Веб-система для самостоятельного размещения, учёта IT-активов и лицензий на ПО: позволяет отслеживать, кому выдано устройство и когда оно было куплено.

15,2 тыс.+27 за неделю4,1 тыс.PHPAGPL-3.0Активно поддерживаетсяОбновлён 6 часов назад

Приложение для самостоятельного размещения, которое отслеживает релизы на GitHub, GitLab, Codeberg и Forgejo и отправляет уведомления по email или через Apprise.

444+5 за неделю15TypeScriptOtherАктивно поддерживаетсяОбновлён 8 часов назад