Skip to content

1단계 요구사항 정리 ​

여러 판매 채널의 주문을 한곳에 모아 재고를 할당하고, 출고·취소·반품까지 관리하는 가상의 이커머스 OMS(Order Management System)를 설계한다. 특정 회사의 시스템과 무관하며, 실무 근거가 없는 값은 모두 가정으로 표시한다.

이 문서는 설계 진행 순서의 1단계 중 기능 요구를 문답으로 하나씩 정한 결과다. 비기능 요구(규모, 지연시간, 보관 기간)는 미뤘고, 이유와 남은 질문은 미룬 것에 적었다.

1. OMS의 책임 경계 ​

구분OMS의 책임OMS의 책임이 아님
결제결제 결과를 받아 기록한다결제 승인. 채널이 결제를 받고 OMS에는 결제된 주문이 들어온다
재고채널별 판매 가능 수량을 계산하고 할당 수량을 관리한다실재고 관리. 재고의 원천은 WMS다
출고창고를 고르고 WMS에 출고를 지시한다피킹·포장·실제 출고
환불환불 요청과 결과를 기록한다환불 실행. 채널이 실행한다
배송송장번호를 받아 채널에 등록한다배송 추적

사용자와 연동 대상

  • 채널 4곳: 쇼피파이, 메르카도리브레, 카페24, 틱톡샵. 채널마다 주문 형식이 다르다.
  • WMS: 창고 최대 3곳.
  • 고객: 주문 조회.
  • 운영자: 백오피스에서 주문 조회, 할당 보류 처리, 취소·반품 처리.

2. 주문 수집 ​

채널마다 주문 형식이 다르므로 채널별 어댑터가 채널 주문을 OMS 공통 주문 모델로 변환한다.

웹훅과 폴링의 두 겹 수집 ​

웹훅폴링
역할빠른 경로: 평소의 수집 지연을 줄인다보정 경로: 웹훅이 유실된 주문을 메운다
주기채널이 보낼 때5분 (가정)

채널도 웹훅을 재시도한다. 예를 들어 메르카도리브레는 1시간 동안 8회 재시도한다고 알려져 있다(공식 문서로 확인 필요). 하지만 그 시간 내내 OMS가 장애였거나 채널이 재시도를 포기하면 주문이 들어오지 않으므로, 폴링으로 한 겹 더 감싼다.

두 겹으로 수집하면 같은 주문이 여러 번 도착하는 것이 기본 전제가 된다. 그래서 아래 세 가지 장치를 둔다.

  1. 중복 판정: (채널, 스토어, 채널 주문번호)에 유니크 제약을 건다. 한 채널에 판매자 계정(스토어)이 여러 개일 수 있으므로 스토어를 키에 포함한다.
  2. 오래된 정보가 새 정보를 덮어쓰지 않게 한다. 아래 7 공통 원칙을 따른다.
  3. 빠짐없는 폴링 조회: 워터마크와 겹침 구간을 쓴다.

저장 구조 ​

  • 채널 원본 이력: append-only로 쌓는다. 행마다 원본 데이터, 채널 변경 시각(channel_updated_at), 수신 시각, 수신 경로(웹훅/폴링)를 남긴다.
  • OMS 주문: 현재 상태만 들고 있다. 들어온 데이터의 channel_updated_at이 마지막으로 반영한 값보다 새로울 때만 갱신한다(조건부 갱신).

채널이 준 정보와 OMS가 만든 정보(할당한 창고, 출고 지시 여부, 송장번호)를 나눠 두어야 채널 데이터를 반영할 때 OMS가 만든 정보가 지워지지 않는다.

폴링 조회 범위 ​

  1. 워터마크는 OMS 서버 시각이 아니라 처리한 주문 중 가장 큰 channel_updated_at 값으로 기록한다. OMS와 채널의 시계 차이에 영향을 받지 않는다.
  2. 다음 조회는 워터마크 - 10분(겹침 구간, 가정)부터 시작한다. 채널 쪽 반영이 늦은 주문도 다음 조회에서 잡힌다.
  3. 겹쳐서 다시 들어온 주문은 유니크 키와 조건부 갱신 덕분에 결과가 같다. 멱등성이 있어야 겹침 조회가 안전하다.
  4. channel_updated_at 오름차순으로 조회하고, 한 페이지를 다 처리한 뒤에만 워터마크를 옮긴다.

3. 주문 상태 ​

부분 취소를 허용하므로 상태는 주문이 아니라 주문 상품(라인) 단위로 관리한다. 주문 하나에 "취소됨" 라인과 "배송 중" 라인이 함께 있을 수 있다. 주문 전체 상태는 라인 상태를 모아 계산한다.

라인 상태의미다음 상태
수집됨채널에서 결제가 끝난 주문이 들어왔다할당됨, 할당 보류, 취소됨
할당됨창고와 재고를 정했다출고 지시됨, 취소됨
할당 보류재고가 없어 할당에 실패했다할당됨, 취소됨
출고 지시됨WMS에 출고를 지시했다출고 완료, 취소됨(출고 중지 성공 시)
출고 완료송장이 발급되고 배송이 시작됐다배송 완료, 반품 요청
배송 완료고객이 받았다구매 확정, 반품 요청
구매 확정배송 완료 후 일정 기간이 지났거나 고객이 확정했다없음
취소됨출고 전에 취소됐다없음

상태 전이 가드: "취소됨"에서 "수집됨"으로 되돌아가는 것처럼 뒤로 가는 전이는 시각과 상관없이 막는다. 채널이 준 시각이 틀릴 때를 대비한 두 번째 방어선이다.

4. 재고 ​

판매 가능 수량 ​

같은 재고를 채널 4곳이 동시에 팔기 때문에, OMS가 계산한 판매 가능 수량을 각 채널에 알린다.

판매 가능 수량 = WMS 가용 재고 (창고 3곳 합) − OMS 할당 수량 (아직 출고 안 됨) − 안전 재고

할당 수량은 WMS가 모르는 값이므로 OMS가 들고 계산한다.

방식장점사고
모든 채널에 같은 수량기회 손실이 없다재고가 바닥에 가까울 때 동기화 전에 여러 채널에서 팔리면 초과 판매
채널별로 나눠 배정채널 간 초과 판매가 없다한 채널은 품절인데 다른 채널에 재고가 남는 기회 손실, 배정량을 다시 나누는 운영 부담
같은 수량 − 안전 재고 (선택)동기화 중 판매를 안전 재고가 흡수한다동기화 중 판매가 안전 재고를 넘을 때만 초과 판매. 대신 안전 재고만큼 기회 손실

안전 재고 ​

동기화 시간은 채널 → OMS 웹훅 도착 → OMS 재고 계산 → 채널 재고 갱신 API 호출(호출 한도로 대기 가능) → 채널 화면 반영의 합이다. 이 시간 동안 팔릴 양만큼 남겨 둔다.

안전 재고 = max(최소값, 상품별 판매 속도 × 동기화 시간)
  • 최소값은 1개(가정)다. 판매 이력이 없는 신상품이나 프로모션으로 판매가 갑자기 몰리는 상품은 판매 속도가 0에 가깝게 계산되기 때문이다.
  • 예: 분당 6개 팔리는 상품의 동기화 시간이 30초면 안전 재고는 약 3개다(가정).

출고 순간의 경계 ​

출고되면 WMS 재고가 1 줄고 OMS 할당도 1 줄어야 한다. 출고 전후의 판매 가능 수량은 같아야 하지만, 두 값은 서로 다른 시스템에 있어 동시에 반영되지 않는다.

먼저 반영된 쪽WMS 재고OMS 할당판매 가능결과
출고 전1019정상
WMS 재고918같은 1개를 두 번 뺀다. 기회 손실
OMS 할당10010나간 1개를 빼지 않는다. 초과 판매
출고 후909정상

틀린다면 기회 손실 쪽으로 틀리게 한다. 오픈마켓은 품절 취소에 판매자 페널티를 주고, 기회 손실은 출고 중간 몇 초 동안 1개를 덜 보여 주는 정도라 비용이 작다. 거래액이 우선이고 입고 리드타임이 짧은 사업이라면 반대 선택도 가능하다.

OMS가 WMS 재고의 사본을 들고, 출고 완료 이벤트를 받으면 한 트랜잭션에서 사본과 할당을 함께 줄인다. 두 값이 같은 DB에 있으므로 OMS 안에서는 중간 상태가 생기지 않는다.

남는 함정은 주기적인 재고 동기화다. 출고 전에 찍힌 WMS 스냅샷("10개")이 출고 이벤트를 처리한 뒤 늦게 도착해 사본을 덮어쓰면 초과 판매가 난다. 스냅샷의 생성 시각이 마지막으로 반영한 출고 이벤트보다 오래됐으면 버린다.

5. 할당과 출고 ​

창고 선택 (가정) ​

  1. 주문 전체를 한 창고에서 채울 수 있는 창고 중 고객과 가장 가까운 창고를 고른다.
  2. 그런 창고가 없으면 분할 출고 건수가 가장 적은 조합을 고르고, 그중 가까운 쪽을 고른다.
  3. 거리가 같으면 재고가 많은 창고를 고른다. 한 창고만 먼저 바닥나지 않게 한다.

분할 출고를 허용한다. 주문 하나에 출고·송장이 여러 건 생기므로 출고 단위를 주문과 별도로 관리한다.

초과 판매가 났을 때 ​

어떻게 처리할지는 사업 정책이지만, 정책이 무엇이든 시스템은 다음을 갖춘다.

  1. 감지 시점: 재고 할당이 실패하는 순간 드러난다. 주문은 이미 채널에서 결제가 끝난 상태다.
  2. 보관 상태: 할당 실패 주문은 할당 보류 상태에 둔다.
  3. 기한: 채널마다 출고 기한이 있고 넘기면 페널티가 붙으므로, 보류 주문에 기한 타이머를 둔다.
  4. 결정 주체: 자동 처리와 운영자 판단의 경계를 정한다.

기본 정책(가정): 할당 실패 → 할당 보류 → 다른 창고로 자동 재할당 → 실패 시 운영자 알림 → 출고 기한 전까지 운영자가 취소 또는 대기 결정

출고 지시 직전 재확인 ​

취소가 늦게 수집되면 출고 지시가 먼저 나가고, 출고 중지 요청이나 반품이라는 비싼 경로로 빠진다. 수집 지연을 0으로 만들 수 없으므로 되돌리기 어려운 출고 지시 직전에 채널 API로 주문 상태를 한 번 더 확인한다.

채널로 결과 전달 ​

송장번호를 채널에 등록한다. 그래야 고객이 채널에서 배송을 조회할 수 있다.

6. 취소와 반품 ​

부분 취소를 허용한다. 처리 방식은 취소 시점에 따라 나뉜다.

시점처리재고
출고 지시 전바로 취소한다할당을 해제한다
출고 지시 후 ~ 출고 전WMS에 출고 중지를 요청한다. 이미 포장됐으면 실패할 수 있다중지에 성공하면 할당을 해제한다
출고 후취소할 수 없으므로 반품으로 전환한다 (회수 → 검수 → 환불)검수 결과에 따라 재입고하거나 폐기한다

환불은 채널이 실행하고 OMS는 요청과 결과를 기록한다.

7. 공통 원칙 ​

도착 순서는 최신 순서가 아니다. 이 설계에서 같은 문제가 두 번 나왔다.

  • 주문 수집: 늦게 처리된 폴링 결과("결제 완료")가 먼저 들어온 웹훅("취소됨")을 덮어쓰면 취소된 주문이 출고된다.
  • 재고 동기화: 늦게 도착한 출고 전 스냅샷이 출고 이벤트 반영 결과를 덮어쓰면 초과 판매가 난다.

해결책도 같다. 데이터를 만든 쪽의 변경 시각이나 버전을 함께 받고, 마지막으로 반영한 값보다 새로울 때만 반영한다. 같은 데이터가 여러 번 와도 결과가 같도록(멱등성) 만들면 재시도와 겹침 조회를 안심하고 쓸 수 있다.

가정한 값과 확인할 것 ​

항목값근거
폴링 주기5분웹훅이 평소 지연을 책임지므로 유실 보정용으로 충분하다고 가정
폴링 겹침 구간10분채널 쪽 반영 지연을 흡수한다고 가정
안전 재고 최소값1개가정
창고 수최대 3곳가정
창고 선택 규칙단일 창고 → 최소 분할 → 거리 → 재고가정
초과 판매 정책자동 재할당 후 운영자 결정사업 정책. 가정
  • [ ] 각 채널의 웹훅 재시도 정책(메르카도리브레의 1시간 8회 포함)을 공식 문서로 확인한다.
  • [ ] 각 채널 API의 호출 한도를 확인하고 폴링·재고 갱신 호출량이 그 안에 드는지 계산한다.

미룬 것: 비기능 요구 ​

2026-10-26, 비기능 요구(규모, 피크 배수, 지연시간, 가용성, 보관 기간)는 우선 제외하고 기능 설계에 집중하기로 했다. 2단계 개략 계산은 이 값들이 있어야 하므로 함께 미룬다. 나중에 정할 질문은 다음과 같다.

  • 하루 주문 수, 채널별 비중, 주문당 라인 수
  • 피크 배수. 블랙프라이데이처럼 하루 종일 몰리는 경우와 라이브 방송처럼 몇 분 안에 한 상품으로 몰리는 경우를 구분한다.
  • SKU 수와 재고 변경 빈도. 판매 가능 수량이 바뀔 때마다 채널 4곳에 재고 갱신 API를 호출하므로 주문 수보다 먼저 한계에 닿을 수 있다.
  • 주문 수집, 취소 반영, 재고 동기화 각각의 지연 목표. 재고 동기화 시간은 안전 재고 식에 그대로 들어간다.
  • OMS 장애 중에도 채널은 주문을 계속 받는다. 허용할 수 있는 장애 시간과 복구 후 처리 순서
  • 주문, 채널 원본 이력, 감사·결제 기록 각각의 보관 기간과 어느 나라 법을 따를지

다음 문서 ​

3단계 상위 설계