Local-coupon-platform

---

🎯 프로젝트 목표

"높은 동시 트래픽에 견디며, 지역 상권의 디지털 전환을 지원하는 확장 가능하고 신뢰성 있는 쿠폰 발급/사용 시스템 구축""

• Redis 기반의 선착순 쿠폰 발급 처리 로직을 통해 높은 TPS 상황에서도 빠른 응답을 제공, 동시성 이슈를 해결합니다.
• QR 인증 방식을 통해 쿠폰의 실제 방문 사용 여부를 검증하여 사용 추적이 가능하도록 설계합니다.
• CQRS 패턴을 도입하여 읽기/쓰기 트래픽을 분리하고 확장성을 높입니다.

---

프로젝트 배경

• 지역 소상공인의 홍보 채널 다변화와 정교한 마케팅 수단에 대한 수요 증가

• 모바일 쿠폰 시스템 도입 시, 트래픽 폭증과 불법 사용 방지가 주요 과제

• 관리자는 캠페인 성과를 실시간으로 파악 및 관리

✨ 주요 기능

✅ 쿠폰 사용 흐름

1. 사용자는 앱에서 조건에 맞는 쿠폰을 확인하고 발급합니다. (선착순, TTL 처리)
2. 매장에 방문하여 쿠폰을 직접 제시하거나, QR 코드/코드 입력 방식으로 사용합니다.
3. 점주는 대시보드에서 쿠폰 사용 처리를 하고, 사용 내역이 기록됩니다.

✅ 사용자 측

• 위치 기반 쿠폰 탐색 (내 주변 쿠폰 보기)
• 조건 필터링 (요일, 시간대, 계절, 지역)
• 선착순 쿠폰 발급 처리 (Redis TTL 기반)
• QR 코드 기반 쿠폰 사용 인증

✅ 점주 측

• 쿠폰 등록 및 상세 조건 설정 (기간 및 시간대)
• 발급 수량 제한, 자동 만료 설정
• 쿠폰 실시간 발급 현황 확인

✅ 관리자 측

• Redis 실패, 쿠폰 발급 실패율 상승 시 Slack 등으로 관리자 알림 전송
• Prometheus + Grafana 기반 지표 시각화 및 Alert 시스템 구성

---