프로젝트 배경
1) 예상 리스크 및 대응 계획 - Redis Streams 컨슈머 그룹에서 웹훅 메시지 중복 소비 없이 exactly-once 처리를 보장하는 구조 설계 - 다중 PG 라우팅 시 한 PG 장애가 전체 결제 흐름에 전파되지 않도록 격리하는 Circuit Breaker 패턴 적용 - INSERT-only 감사 로그와 실시간 조회 성능 균형을 위한 파티셔닝 및 인덱스 전략 수립 - 부분 환불 요청과 정산
프로젝트 성과
Redis Streams 기반 실시간 웹훅 이벤트 파이프라인 구현
고부하 웹훅 수신 환경에서 Redis Streams로 이벤트를 버퍼링하고 SSE로 관리 콘솔에 실시간 전달하는 확장 가능한 파이프라인 구조를 설계할 예정입니다.
불변 감사 로그 구조로 인증 이력 무결성 보장
PostgreSQL INSERT-only 트리거와 Prisma 미들웨어를 결합해 인증 이벤트가 수정·삭제될 수 없는 감사 로그 구조를 구현하고, 개인정보 마스킹을 자동 적용할 예정입니다.
다중 PG 자동 폴백 라우팅 엔진 설계
PG사별 헬스체크 결과를 Redis에 캐싱하고, 장애 감지 시 자동으로 예비 PG로 전환하는 폴백 라우팅 엔진을 Node.js 레이어에 구현할 예정입니다.
부분 환불 트랜잭션 무결성 처리 구현
원결제 금액·기환불 합계를 SELECT FOR UPDATE로 잠근 뒤 환불 가능 잔액을 검증하고 PG API 호출과 DB 갱신을 하나의 트랜잭션으로 처리하는 구조를 구현할 예정입니다.
역할 기반 접근 제어(RBAC) 관리 콘솔 구현
관리자·운영자·감사자 역할별 메뉴 노출과 API 엔드포인트 접근을 분리하는 미들웨어 레이어를 Express와 React Router에 적용할 예정입니다.
핵심 기능
진행 단계
다중 PG 라우팅 레이어 설계
2026.04
PG사별 헬스체크, 가중치 라우팅 룰, Redis 상태 캐시 구조 설계
프로젝트 상세
1) 포트폴리오 소개 결제 PG·본인인증 연동을 넘어 다중 PG 라우팅, 실시간 트랜잭션 모니터링, 인증 이력 감사 로그까지 확장한 통합 관리 콘솔 데모입니다. Node.js/Express 기반 BFF 레이어와 Redis 큐를 결합해 고부하 웹훅 환경에서도 트랜잭션 무결성을 유지하는 확장 아키텍처를 구현할 예정입니다. 2) 작업 범위 - 다중 PG 결제 라우팅 관리: KG이니시스를 포함한 복수 PG사







