문서 목적 · 범위
본 문서는 진승 통합허브(JS-HUB)의 기능 요구사항을 정의합니다. JS-HUB는 진승몰(JS-MALL) · 진승B2B · 통합 인증(SSO)이 공통으로 참조하는 가격 · 재고의 단일한 기준(single source of truth)을 제공하고, 진승의 회계 · 재고 관리 시스템인 이카운트(ERP)와 연결되는 유일한 통로로 동작합니다.
JS-HUB는 이카운트 정보를 그대로 전달만 하는 중계기가 아닙니다. 이카운트가 제공하지 않는 거래처별 차등단가 해석 · 거래처 정보 관리 · 예외단가/프로모션 같은 오버라이드는 JS-HUB가 직접 소유 · 관리하며, 이카운트는 기본 단가 · 재고의 원천이자 확정 주문이 반영되는 대상으로 사용됩니다.
- 단가 · 재고 동기화
- 거래처 원장 관리
- 유효단가 해석
- 오버라이드(예외단가 · 프로모션 · 수량할인 · 세일)
- 발주 반영 · 발주 취소
- 소비처(진승몰 · 진승B2B · 통합 인증) 연동 API
- 거래처 정보의 이카운트 되쓰기
- 오버라이드 세부 관리 화면
- 진승몰(JS-MALL) 연동 세부
- 확장 조회 API
사업 목표
여러 커머스 서비스가 각자 이카운트에 접속해 가격 · 재고를 확인하면, 서비스마다 값이 어긋나거나 관리 부담이 커집니다. JS-HUB는 이 접점을 하나로 모아 "어디서 확인해도 같은 가격, 같은 재고"를 보장하고, 거래처마다 다르게 적용되는 차등단가를 정확하고 일관되게 계산하는 것을 목표로 합니다.
시스템 경계
진승몰(JS-MALL) · 진승B2B · 통합 인증(SSO)은 이카운트에 직접 접속하지 않고, JS-HUB API를 통해서만 가격 · 재고 · 거래처 정보를 주고받습니다. 이카운트 접속 정보는 JS-HUB만 보관합니다.
| 데이터 | 관리 주체 | 비고 |
|---|---|---|
| 상품 판매가(기본가 · 거래처 등급별 단가) | 이카운트 | JS-HUB가 주기적으로 받아 보관 |
| 재고 수량 | 이카운트 | JS-HUB가 주기적으로 받아 보관 + 주문 예약 시 즉시 반영 |
| 거래처 정보(사업자 · 배송지 · 가격그룹 · 거래조건) | JS-HUB | 이카운트가 거래처별 조회를 제공하지 않아 JS-HUB가 직접 관리 |
| 오버라이드(예외단가 · 프로모션 · 수량할인 · 세일) | JS-HUB | 이카운트에는 없는 개념 |
| 유효단가(최종 판매가) | JS-HUB | 계산 결과 |
| 주문 · 매출 기록 | 이카운트 | JS-HUB가 확정 주문을 반영 |
단가 · 재고 연동
단가와 재고는 JS-HUB가 자체적으로 저작하지 않고, 이카운트에서 주기적으로 받아와 보관한 뒤 소비 서비스에 제공합니다.
이카운트의 상품별 판매가(기본가 및 거래처 가격그룹별 단가)를 주기적으로 가져와 최신 상태로 보관합니다.
이카운트 재고를 주기적으로 가져와 보관하고, 주문이 예약되는 즉시 보관된 재고에서 차감하여 여러 서비스에서 동시에 발생하는 주문이 서로 중복 판매되지 않도록 합니다. 소비자 화면의 재고 확인은 이 보관된 재고를 기준으로 응답합니다.
이카운트 확인은 실시간 조회가 아니라 "최근 확인된 값을 빠르게 제공"하는 방식으로 동작합니다. 확인 주기는 이카운트 시스템의 처리 여력을 고려해 관리하며, 재고는 짧은 주기로 자주 재확인하고 상품 판매가는 이보다 느슨한 주기로 확인합니다(세부 설계는 개발설계 산출물 참고).
거래처 원장
이카운트는 거래처별 정보 조회 기능을 제공하지 않으므로, 거래처의 존재 여부 · 사업자 정보 · 배송지 · 가격그룹 · 거래조건은 JS-HUB가 직접 관리하는 정본(canonical) 원장으로 둡니다.
거래처의 존재 여부 · 사업자 정보 · 배송지 · 가격그룹 · 거래조건을 JS-HUB가 직접 관리합니다. 진승B2B 등 소비 서비스는 이 정보를 조회만 하며, 등록 · 수정은 JS-HUB의 관리 화면에서 이뤄집니다.
통합 인증(SSO)에는 로그인에 필요한 최소 정보(거래처 소속 · 가격그룹)만 동기화되고, 상세 거래처 정보는 JS-HUB가 보관합니다.
유효단가 해석
같은 상품이라도 거래처 · 시점 · 주문 수량에 따라 최종 적용 가격(유효단가)이 달라질 수 있습니다. JS-HUB는 아래 규칙 순서로 하나의 최종 가격을 계산합니다.
거래처별 예외단가 · 기간 프로모션(할인) · 수량 구간 할인 · 카테고리/전체 세일 4가지 방식의 가격 조정을 지원합니다. v1은 기본 골격을 제공하고, 세부 관리 화면과 복수 프로모션 충돌 규칙은 후속 단계에서 정의합니다.
발주 반영 · 취소
소비 서비스에서 확정된 주문을 JS-HUB가 이카운트에 반영하고, 취소가 발생했을 때도 JS-HUB를 통해 일관되게 처리합니다.
진승B2B 등에서 확정된 주문을 JS-HUB가 이카운트에 매출 · 재고차감으로 반영합니다. 이카운트에 대한 쓰기는 이 시점에만 발생합니다.
확정 주문의 취소는 JS-HUB를 통해 한 번에 처리합니다 — 이카운트 반영 취소, 재고 원복, 주문 상태 갱신, 소비 서비스 알림까지 하나로 묶어 취소 후 상태가 서로 어긋나지 않게 합니다.
소비처 연동
진승몰(JS-MALL) · 진승B2B · 통합 인증(SSO)이 JS-HUB의 API를 통해 가격 · 재고 · 거래처 정보를 조회합니다.
가격 · 재고 · 거래처 조회 인터페이스를 제공합니다. 재고는 "구매 가능 / 품절" 여부로 안내하며, 구체적 재고 수량은 노출하지 않습니다.
시스템 구성
JS-HUB는 별도의 구매자 화면이 없는 연동 · 관리 계층입니다.
제외 범위
아래 항목은 v1 범위에서 제외하며, 후속 단계에서 정의합니다.
확정 대기 항목
아래 항목은 현시점에서 확정되지 않았으며, 후속 검토를 통해 확정합니다. 가격 · 재고 확인 주기는 설계 단계에서 확정되어 개발설계 산출물 문서로 이관되었습니다.