l4rm4nd/VoucherVault

어떤 프로젝트인가요?

핵심 기능

• 01바우처, 쿠폰, 기프트 카드, 멤버십 카드와 사용 코드를 저장합니다.
• 02코드를 QR 코드나 바코드로 표시하며, 항목 생성 시 클라이언트 측 스캔을 지원합니다.
• 03Apprise를 통해 만료 알림을 전송합니다.
• 04여러 사용자, 항목 공유, OIDC 싱글 사인온을 지원합니다.
• 0548시간 오프라인 캐시를 제공하는 모바일 친화적인 PWA를 지원합니다.
• 06Home Assistant 및 기타 대시보드용 통계가 포함된 REST API를 제공합니다.

활용 사례

• 여러 매장의 멤버십 카드와 기프트 카드를 디지털 지갑 하나로 관리하기.
• 바우처나 쿠폰이 만료되기 전에 알림 받기.
• 홈 서버에서 가족과 기프트 카드 공유하기.
• 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

사용 전 알아둘 점

• !프로덕션 환경에서 안전하게 사용하려면 Docker와 TLS를 지원하는 리버스 프록시가 필요합니다.
• !셀프 호스팅 설정에는 볼륨 권한 변경과 환경 구성을 수동으로 수행해야 합니다.
• !GPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 파생 저작물도 오픈 소스로 공개해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

VoucherVault은(는) 무엇인가요?

만료 알림을 지원하는 셀프 호스팅 Django 웹 앱으로, 바우처·쿠폰·멤버십 카드·기프트 카드를 보관하고 관리합니다. VoucherVault는 바우처, 쿠폰, 멤버십 카드, 기프트 카드를 한곳에서 관리할 수 있는 셀프 호스팅 Django 웹 애플리케이션입니다. 각 항목에 사용 코드를 저장하면 QR 코드나 바코드로 표시되며, 이미지나 PDF를 업로드해 첨부할 수도 있습니다. 기프트 카드에는 거래 내역도 기록됩니다.

VoucherVault은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

VoucherVault은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

VoucherVault은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. VoucherVault의 마지막 커밋은 2026년 11월 3일입니다.

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