플러스프로젝트 배경
1) 문제점 - 쿠팡·네이버·자사몰 세 채널이 각기 다른 재고 변경 이벤트 포맷과 Webhook 서명 방식을 사용하여 공통 IChannelAdapter 인터페이스를 설계하면서 채널별 특수 동작을 수용하는 균형점 설계 - 동일 상품에 대해 여러 채널에서 재고 변경이 동시에 수신될 때 Last-Write-Wins와 Queue 직렬화 처리를 조합하여 쓰기 경합 없이 일관된 재고 상태를 유지하는 구조 구현 -
프로젝트 성과
BullMQ 4단계 분산 작업 큐 파이프라인 설계
채널별 동기화·재시도·DLQ·알림을 BullMQ 독립 큐로 연결한 파이프라인을 설계하여 단계별 실패 시 안전하게 격리되고 재처리 가능한 구조 구현
IChannelAdapter 인터페이스 기반 NestJS 8모듈 아키텍처 구현
채널 어댑터 3개·ETL·큐·로그·오류추적·알림 모듈을 NestJS DI로 분리하고 IChannelAdapter 공통 인터페이스로 신규 채널 추가 시 상위 레이어 수정 불필요한 구조 설계
Last-Write-Wins 충돌 해결 + 감사 추적 구조 구현
재고 동시 변경 충돌을 타임스탬프 기반 Last-Write-Wins 전략으로 자동 해결하고 충돌 전후 상태를 PostgreSQL에 완전 기록하는 감사 추적 테이블 설계
NestJS 전역 LoggingInterceptor 횡단 관심사 분리 구현
전역 LoggingInterceptor를 Decorator 패턴으로 등록하여 32개 API 엔드포인트 요청·응답·처리시간을 비즈니스 로직 수정 없이 자동 기록하는 구조 구현
Redis Pub/Sub 기반 Socket.io 다중 인스턴스 연동 설계
BullMQ 이벤트를 Redis Pub/Sub으로 분배하고 NestJS Socket.io Gateway가 구독하는 구조로 설계하여 다중 인스턴스 환경에서 모든 처리 이벤트가 대시보드에 통합 수신
핵심 기능
채널 통합 대시보드
쿠팡·네이버·자사몰 채널별 API 연동 상태, 재고 동기화 처리량, BullMQ 작업 큐 현황을 실시간으로 모니터링하는 메인 대시보드.
진행 단계
NestJS 모듈 아키텍처 및 IChannelAdapter 인터페이스 설계
2025.09.
채널 어댑터·ETL·BullMQ·로그 모듈 의존성 맵 설계, IChannelAdapter 공통 인터페이스 정의, AES-256 자격증명 관리 모듈 구현
프로젝트 상세
1) 포트폴리오 소개 쿠팡·네이버 스마트스토어·자사몰 등 복수의 커머스 채널 API와 ERP 재고 시스템을 실시간 연동하는 옴니채널 데이터 허브를 구현하였다. NestJS 기반 모듈형 API 게이트웨이와 BullMQ 분산 작업 큐, PostgreSQL + Redis 아키텍처를 결합하여 채널별 Webhook 수신, 양방향 재고 동기화 ETL, 트랜잭션 로그 관리, 충돌 해결 알고리즘, 실시간 오류 모니터링 기
