프로젝트 배경
**1) 문제점** 제휴 쿠폰 시스템은 할인코드 수신, 상태 관리, 중복 발급 차단, 관리자 기능, 이력 조회 등 여러 요구사항이 얽혀 있고, 특히 외부 제휴사 API 없이도 실제 동작을 검증할 수 있는 구조가 필요했습니다. **2) 프로젝트 목표** 실 API 연동 없이도 발급 로직·중복 차단·상태 전이가 실제로 동작함을 코드와 테스트로 증명하고, 추후 실 API 전환 시 최소 수정으로 교체 가능한
프로젝트 성과
테스트 신뢰성 100%
통합 테스트 14개 전부 통과, npm audit 취약점 0건으로 코드 안정성을 수치로 증명했습니다.
동시 발급 방어 검증
동일 유저가 쿠폰을 5회 동시 요청해도 1건만 발급 성공하고 나머지 4건은 차단되어, DB에는 정확히 1장만 남습니다.
다중 한도 레이어 개별 검증
일일 발급 한도와 프로모션 전체 발급 상한을 각각 독립적으로 검증해, 두 방어 로직이 실제로 동작함을 증명했습니다.
핵심 기능
진행 단계
기획·설계
2026.07.
쿠폰 발급 시스템에 필요한 핵심 요구사항을 정리하고, 어댑터 경계와 5중 방어 구조로 아키텍처를 설계했습니다.
프로젝트 상세
**1) 포트폴리오 소개** 제휴 쿠폰 발급·상태관리를 담당하는 백엔드 API 서버입니다. 할인코드 수신부터 발급, 중복 차단, 상태 전이, 관리자 기능까지 end-to-end로 구현했고, 통합 테스트 14건 전부 통과·의존성 취약점 0건을 확보했습니다. **2) 작업 범위** 요구사항 분석, 시스템 아키텍처 설계(어댑터 경계 + 5중 방어 구조), 백엔드 API 개발, Docker 기반 재현 환경







