← 포트폴리오 목록
모바일 커머스 셀러센터
모바일 커머스 플랫폼의 판매자용 Seller Center를 맞춤 구현하여 입점 신청부터 상품 등록, 주문·배송 처리, 정산 조회까지 이어지는 셀러 운영 흐름을 React + Node.js 기반으로 설계·구현합니다.
주문 상태 동기화 이벤트 아키텍처 설계주문 상태 변경 이벤트를 단일 소스에서 발행해 Admin·App 화면에 WebSocket으로 전파하는 실시간 동기화 구조를 설계합니다.
입점심사 상태 머신 및 이력 관리 구현서류검토·보완요청·승인·반려 4단계 심사 상태를 enum 컬럼으로 관리하는 상태 머신을 구현하고 전이 이력을 별도 테이블에 기록합니다.
AI 상품등록 입력 보조 파이프라인 구축카테고리·핵심 속성을 입력하면 OpenAI API로 상품 설명 초안을 생성하는 입력 보조 파이프라인을 구현해 등록 단계 반복 입력을 줄이는 구조를 설계합니다.
Overview
프로젝트 개요
모바일 커머스 플랫폼의 판매자용 Seller Center를 맞춤 구현하여 입점 신청부터 상품 등록, 주문·배송 처리, 정산 조회까지 이어지는 셀러 운영 흐름을 React + Node.js 기반으로 설계·구현합니다. 백엔드 API를 매개로 Admin과 모바일 App에 상태 변경이 실시간으로 반영되는 구조를 함께 구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
판매자·운영자·최종고객 3주체가 동시에 참조하는 주문 상태 데이터의 정합성을 유지해야 하는 과제가 있으며
단일 상태 발행 소스와 이벤트 기반 동기화로 대응합니다
입점심사 반려 사유와 재심사 이력을 누락 없이 추적해야 하는 과제가 있으며
상태 전이마다 스냅샷을 남기는 이력 테이블로 대응합니다
PG 결제·KYC/KYB 사업자 인증처럼 통제 밖의 실거래 인증이 필요한 영역은 표준 연동 인터페이스로 경계를 분리해 대응할 계획입니다
상품 옵션·재고 조합이 많아질수록 SKU 관리 복잡도가 증가하는 리스크
조합형 SKU 테이블과 재고 변동 이력 로그로 대응합니다
구현 내용
핵심 기능 상세
핵심 기능 1
입점 신청 및 판매자 대시보드
사업자 정보와 증빙서류를 등록해 입점을 신청하고, 심사 진행 상태와 오늘의 주문·정산 현황을 하나의 화면에서 확인합니다
핵심 기능 2
상품 등록 및 심사 상태 관리
다단계 입력 폼으로 상품 정보·옵션·가격·재고를 등록하고, OpenAI API 연동 AI 입력 보조로 상품 설명 초안을 자동 생성하며 심사·재심사 진행 상태를 추적합니다
핵심 기능 3
주문·배송 처리 및 상태 동기화
주문 확인부터 출고·송장 등록·배송 조회·구매확정까지 처리하며, 취소·반품·교환·분쟁 요청이 접수되면 별도 처리 흐름으로 연계합니다
핵심 기능 4
정산 조회 및 지급 내역 관리
정산예정 금액, 지급 내역, 수수료·공제 내역을 기간별로 조회하고 세무자료 발급 신청 현황을 확인합니다
구현 과정
프로젝트 진행 단계
STEP 1
업무 프로세스 분석 및 셀러센터 ERD 설계
입점·상품·주문·정산 도메인 테이블 설계, 상태 전이 규칙 정의 및 관계 매핑
STEP 2
입점심사 및 상품 등록 API 개발
사업자 인증 연동 지점 설계, 다단계 상품 등록·심사 상태 API 구현
STEP 3
주문·배송 상태 동기화 엔진 개발
주문 상태 머신과 Socket.io 기반 Admin·App 실시간 이벤트 브로드캐스트 구현
STEP 4
정산 조회 및 셀러센터 UI 개발
React 기반 대시보드·상품·주문·정산 화면 구현, 정산 조회 API 연동
STEP 5
통합 QA 및 상태 동기화 검증
입점→등록→주문→정산 전체 플로우 통합 테스트, 다중 세션 동기화 시나리오 검증
프로젝트 성과
주요 성과
주문 상태 동기화 이벤트 아키텍처 설계주문 상태 변경 이벤트를 단일 소스에서 발행해 Admin·App 화면에 WebSocket으로 전파하는 실시간 동기화 구조를 설계합니다.
입점심사 상태 머신 및 이력 관리 구현서류검토·보완요청·승인·반려 4단계 심사 상태를 enum 컬럼으로 관리하는 상태 머신을 구현하고 전이 이력을 별도 테이블에 기록합니다.
AI 상품등록 입력 보조 파이프라인 구축카테고리·핵심 속성을 입력하면 OpenAI API로 상품 설명 초안을 생성하는 입력 보조 파이프라인을 구현해 등록 단계 반복 입력을 줄이는 구조를 설계합니다.
정산·세무 조회 인터페이스 설계정산예정·지급내역·수수료 공제를 조회 전용 API로 분리하고, 전자세금계산서 발급 신청 연동 지점을 표준 인터페이스로 설계합니다.
Highlights
기술적 주안점
- 입점심사부터 일일 운영 지표까지 한 화면에서 조회 가능한 대시보드 구조를 설계하고, 사업자 확인·PG 등 실거래 인증이 필요한 지점은 외부 연동 인터페이스로 분리해 확장 가능하게 구현합니다
- 상품 심사 상태 전이를 이력 테이블에 남겨 재심사 사유를 추적 가능하게 하고, AI 상품등록 입력 보조로 등록 단계의 반복 입력 부담을 줄이는 구조를 구현합니다
- 주문 상태 변경 이벤트를 단일 소스에서 발행해 Seller Center·Admin·App 세 화면의 데이터 불일치를 구조적으로 방지하는 상태 동기화 아키텍처를 구현합니다
