프로젝트 배경
1) 예상 리스크 및 대응 계획 - 외부 핀 번호 검증 API의 응답 지연 및 Rate Limit 제한 상황에서 대량 신청 건을 순서 보장·병렬 제한으로 처리하는 비동기 워커 설계가 필요합니다. - 자동 송금 API 호출 중 타임아웃·잔액 부족·계좌 오류 등 다양한 실패 케이스를 구분하고, 각 케이스별로 재시도·수동 개입 요청·반려 처리를 자동 분기하는 오류 처리 전략이 필요합니다. - 상품권 수수료율을
프로젝트 성과
Socket.io + Redis 실시간 알림 파이프라인 구현
신규 매입 신청 발생 시 Redis Pub/Sub로 이벤트를 발행하고, Socket.io 서버가 구독하여 관리자 브라우저에 실시간 push 알림을 전달하는 서버-클라이언트 이벤트 파이프라인을 설계합니다.
Bull Queue 기반 자동 입금 처리 자동화
Redis Bull Queue로 자동 입금 작업을 큐잉하여 외부 송금 API 호출 순서를 보장하고, 실패 시 지수 백오프 재시도 및 관리자 알림까지 자동화되는 입금 처리 파이프라인을 구현합니다.
금액 구간별 다중 수수료 정책 엔진 설계
상품권 종류·금액 구간 조합으로 수수료율을 동적으로 산출하는 FeeRule 모델을 Prisma로 설계하고, 설정 변경 즉시 실시간 미리보기에 반영되는 수수료 계산 엔진을 구현합니다.
Prisma 집계 쿼리 기반 정산 관리 시스템
Prisma의 groupBy + _sum aggregation으로 사용자별·기간별 정산 합계를 단일 쿼리로 산출하고, Redis TTL 캐시로 반복 집계 부하를 분산하는 정산 관리 시스템을 구현합니다.
Recharts 기반 매입 현황 시각화 대시보드
일별 매입 건수 추이(AreaChart), 상품권 종류별 비중(PieChart)을 Recharts로 구현하고, 소켓 이벤트 수신 시 차트 데이터를 실시간 업데이트하는 대시보드를 설계합니다.
핵심 기능
진행 단계
Socket.io + Redis Pub/Sub 실시간 파이프라인 설계
2026.04
신규 신청 알림 브로드캐스트 구조 구축, 관리자 room 기반 이벤트 분리 설계
프로젝트 상세
1) 포트폴리오 소개 관리자가 상품권 매입 신청을 실시간 모니터링하고, 핀 번호 검증·자동 입금 처리·수수료 설정·정산 관리까지 통합 운영할 수 있는 어드민 플랫폼 확장 데모입니다. Socket.io 기반 실시간 알림, Redis 큐 기반 자동 송금 처리, 차트 기반 통계 시각화를 구현합니다. 2) 작업 범위 - 관리자 실시간 대시보드: 신규 매입 신청·입금 대기·처리 완료 건수를 실시간으로 모니터링







