디지털 악보 카탈로그 자동등록 시스템

FTP-CSV, FTP-XML, REST-JSON 등 서로 다른 연동 방식의 출판사 피드를 하나의 수집 파이프라인으로 정규화하고, 신규·변경 상품만 증분 동기화합니다.

• 출판사별 Adapter 패턴(FTP-CSV/FTP-XML/REST-JSON)으로 프로토콜 차이를 추상화하는 수집 계층 설계
• 마지막 동기화 시점 기준 증분 수집과 페이지네이션 커서 저장으로 중복 수집을 방지하는 구조 구현
• 수집 원본과 정규화 결과를 분리 저장하여 매핑 오류 발생 시 원본 재처리가 가능한 구조 설계

Strategy 패턴 기반 출판사별 어댑터로 프로토콜이 달라도 동일한 정규화 파이프라인을 통과시키는 구조를 구현합니다.

정규화된 출판사 상품 데이터를 카페24 Admin API로 자동 등록하고, 가격·재고·상세정보 변경 시 기존 상품을 갱신합니다.

• 카페24 Admin API OAuth 토큰 자동 갱신과 만료 전 선제 재발급 로직 구현
• Bull Queue 기반 등록 요청 큐잉으로 API Rate Limit 초과 시 자동 지연·재시도 처리
• 등록·갱신 실패 상품을 별도 재처리 테이블에 적재해 원인별 재시도가 가능한 구조 설계

출판사 수집 데이터와 카페24 상품 스키마 간 매핑 계층을 두어, 출판사 필드가 늘어나도 매핑 규칙만 추가하면 되는 확장 구조를 구현합니다.

카페24 결제 완료 웹훅을 수신해 구매자에게 다운로드 권한을 자동 부여하고, 환불 시 권한을 자동 회수합니다.

• 카페24 결제완료 웹훅 수신→출판사별 주문 제출 API 호출→다운로드 URL 저장 파이프라인 구현
• 권한 부여 실패 시 지수 백오프 재시도와 3회 초과 시 담당자 알림 발송 로직 구현
• 환불 웹훅 수신 시 다운로드 권한을 즉시 회수하고 회수 이력을 감사 로그에 기록

결제-권한부여-환불회수를 하나의 상태 머신으로 모델링하여 중간 실패에도 상태 일관성을 보장하는 구조를 구현합니다.

자동 연동 API가 없는 출판사 D 상품에 대해, 구매자 정보를 삽입한 워터마킹 PDF와 만료·횟수 제한이 있는 서명 URL을 직접 생성합니다.

• PDF 라이브러리 기반 구매자 식별 정보(주문번호) 워터마킹 삽입 엔진 구현
• HMAC 서명과 만료시각·다운로드 횟수 제한을 포함한 서명 URL 발급 로직 구현
• 다운로드 시도 이력(IP·시각·성공여부)을 별도 로그 테이블에 적재해 이상 다운로드 탐지 기반 마련

서명 URL에 만료시각과 잔여 횟수를 인코딩해 별도 세션 없이도 상태를 검증할 수 있는 무상태 다운로드 게이트를 구현합니다.