← 포트폴리오 목록
오픈마켓 통합 연동 관제 콘솔
지그재그·에이블리 등 패션 오픈마켓 4~5개와의 상품/주문/재고/배송 API 연동을 단일 콘솔에서 관리하는 시스템을 Java(Spring Boot) + React 기반으로 설계·구현합니다.
마켓별 API 어댑터 인터페이스 설계지그재그·에이블리 등 4~5개 마켓의 상이한 API 규격을 공통 인터페이스로 추상화, Strategy 패턴으로 구현체를 분리 설계합니다
상품·주문 데이터 매핑 엔진 구축카테고리·옵션·속성값을 마켓별 규격으로 변환하는 매핑 테이블 15개 이상을 설계, 규칙 기반 변환 로직을 적용합니다
재고·배송 양방향 동기화 구조 설계재고 변동을 이벤트로 감지해 각 마켓 API로 전파하는 동기화 큐를 설계, 낙관적 락으로 동시성을 제어합니다
Overview
프로젝트 개요
지그재그·에이블리 등 패션 오픈마켓 4~5개와의 상품/주문/재고/배송 API 연동을 단일 콘솔에서 관리하는 시스템을 Java(Spring Boot) + React 기반으로 설계·구현합니다. 마켓별 상이한 API 규격을 공통 인터페이스로 추상화하고, 실시간 연동 현황과 실패 건 재처리를 관제탑 형태로 시각화합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
마켓별로 상이한 API 인증 방식(OAuth2/API Key/서명 방식)을 단일 관리 체계로 통합하는 설계가 필요합니다
상품 옵션·카테고리 체계가 마켓마다 달라 발생하는 매핑 불일치를 감지하고 보정하는 로직이 필요합니다
동일 상품의 재고가 여러 마켓에서 동시에 차감될 때 발생하는 초과 판매를 방지하는 동시성 제어가 필요합니다
네트워크 장애로 인한 부분 실패 시 데이터 정합성을 보장하는 재시도·롤백 전략 설계가 필요합니다
구현 내용
핵심 기능 상세
핵심 기능 1
연동 현황 대시보드
지그재그·에이블리 등 오픈마켓별 상품/주문 연동 현황과 최근 처리 시각, 실패 건수를 한눈에 확인할 수 있는 관제 화면입니다
핵심 기능 2
상품 데이터 매핑 관리
자사 상품의 카테고리·옵션·속성을 마켓별 규격으로 변환하는 매핑 규칙을 등록하고 관리하는 화면입니다. 매핑 규칙을 PostgreSQL 테이블로 정규화하여 저장하고, 마켓 추가 시 재사용 가능한 구조로 설계합니다
핵심 기능 3
주문 동기화 모니터
각 마켓에서 수집한 신규 주문을 자사 주문 형식으로 변환하고 처리 상태를 추적하는 화면입니다. 주기적 배치로 신규 주문을 수집하고, 상태 머신으로 주문 처리 단계를 관리합니다
핵심 기능 4
오류 처리 및 재시도
연동 실패 건을 자동으로 감지하고 재시도하며, 최종 실패 건은 수동 재처리할 수 있는 화면입니다. 지수 백오프 재시도 정책을 적용하고, 최대 재시도 초과 건은 실패 큐로 분리합니다
구현 과정
프로젝트 진행 단계
STEP 1
마켓별 API 문서 분석 및 어댑터 설계
지그재그/에이블리 등 API 문서 분석, 공통 인터페이스 및 마켓별 어댑터 구조를 설계합니다
STEP 2
상품·주문 매핑 엔진 개발
Spring Data JPA 기반 매핑 테이블을 설계하고 카테고리/옵션 변환 로직 15개 이상을 구현합니다
STEP 3
동기화 파이프라인 및 재시도 로직 구현
재고·주문·배송 동기화 배치 작업을 구현하고 지수 백오프 재시도 로직을 적용합니다
STEP 4
연동 대시보드 UI 개발 및 통합 테스트
React 기반 관제 대시보드를 구현하고 마켓별 연동 시나리오 통합 테스트를 진행합니다
프로젝트 성과
주요 성과
마켓별 API 어댑터 인터페이스 설계지그재그·에이블리 등 4~5개 마켓의 상이한 API 규격을 공통 인터페이스로 추상화, Strategy 패턴으로 구현체를 분리 설계합니다
상품·주문 데이터 매핑 엔진 구축카테고리·옵션·속성값을 마켓별 규격으로 변환하는 매핑 테이블 15개 이상을 설계, 규칙 기반 변환 로직을 적용합니다
재고·배송 양방향 동기화 구조 설계재고 변동을 이벤트로 감지해 각 마켓 API로 전파하는 동기화 큐를 설계, 낙관적 락으로 동시성을 제어합니다
오류 재시도 및 실패 큐 아키텍처 구현지수 백오프 기반 자동 재시도 로직을 구현, 최종 실패 건은 수동 재처리 큐로 분리하는 구조를 설계합니다
Review
기술적 주안점
- 마켓별 상태를 큰 KPI 카드 대신 슬림 상태바로 압축 표시하는 command-tower 구성을 적용해 정보 밀도와 가독성을 함께 설계합니다
- 상품-마켓 간 다대다 매핑 구조를 설계해 마켓 규격이 달라도 동일한 상품 데이터를 재사용할 수 있도록 구현합니다
- 마켓마다 다른 주문 데이터 포맷을 공통 스키마로 변환하는 어댑터 계층을 구현해 프론트엔드는 단일 포맷만 처리하도록 설계합니다
