1단계 요구사항 정리
여러 판매 채널의 주문을 한곳에 모아 재고를 할당하고, 출고·취소·반품까지 관리하는 가상의 이커머스 OMS(Order Management System)를 설계한다. 특정 회사의 시스템과 무관하며, 실무 근거가 없는 값은 모두 가정으로 표시한다.
이 문서는 설계 진행 순서의 1단계 중 기능 요구를 문답으로 하나씩 정한 결과다. 비기능 요구(규모, 지연시간, 보관 기간)는 미뤘고, 이유와 남은 질문은 미룬 것에 적었다.
1. OMS의 책임 경계
| 구분 | OMS의 책임 | OMS의 책임이 아님 |
|---|---|---|
| 결제 | 결제 결과를 받아 기록한다 | 결제 승인. 채널이 결제를 받고 OMS에는 결제된 주문이 들어온다 |
| 재고 | 채널별 판매 가능 수량을 계산하고 할당 수량을 관리한다 | 실재고 관리. 재고의 원천은 WMS다 |
| 출고 | 창고를 고르고 WMS에 출고를 지시한다 | 피킹·포장·실제 출고 |
| 환불 | 환불 요청과 결과를 기록한다 | 환불 실행. 채널이 실행한다 |
| 배송 | 송장번호를 받아 채널에 등록한다 | 배송 추적 |
사용자와 연동 대상
- 채널 4곳: 쇼피파이, 메르카도리브레, 카페24, 틱톡샵. 채널마다 주문 형식이 다르다.
- WMS: 창고 최대 3곳.
- 고객: 주문 조회.
- 운영자: 백오피스에서 주문 조회, 할당 보류 처리, 취소·반품 처리.
2. 주문 수집
채널마다 주문 형식이 다르므로 채널별 어댑터가 채널 주문을 OMS 공통 주문 모델로 변환한다.
웹훅과 폴링의 두 겹 수집
| 웹훅 | 폴링 | |
|---|---|---|
| 역할 | 빠른 경로: 평소의 수집 지연을 줄인다 | 보정 경로: 웹훅이 유실된 주문을 메운다 |
| 주기 | 채널이 보낼 때 | 5분 (가정) |
채널도 웹훅을 재시도한다. 예를 들어 메르카도리브레는 1시간 동안 8회 재시도한다고 알려져 있다(공식 문서로 확인 필요). 하지만 그 시간 내내 OMS가 장애였거나 채널이 재시도를 포기하면 주문이 들어오지 않으므로, 폴링으로 한 겹 더 감싼다.
두 겹으로 수집하면 같은 주문이 여러 번 도착하는 것이 기본 전제가 된다. 그래서 아래 세 가지 장치를 둔다.
- 중복 판정:
(채널, 스토어, 채널 주문번호)에 유니크 제약을 건다. 한 채널에 판매자 계정(스토어)이 여러 개일 수 있으므로 스토어를 키에 포함한다. - 오래된 정보가 새 정보를 덮어쓰지 않게 한다. 아래 7 공통 원칙을 따른다.
- 빠짐없는 폴링 조회: 워터마크와 겹침 구간을 쓴다.
저장 구조
- 채널 원본 이력: append-only로 쌓는다. 행마다 원본 데이터, 채널 변경 시각(
channel_updated_at), 수신 시각, 수신 경로(웹훅/폴링)를 남긴다. - OMS 주문: 현재 상태만 들고 있다. 들어온 데이터의
channel_updated_at이 마지막으로 반영한 값보다 새로울 때만 갱신한다(조건부 갱신).
채널이 준 정보와 OMS가 만든 정보(할당한 창고, 출고 지시 여부, 송장번호)를 나눠 두어야 채널 데이터를 반영할 때 OMS가 만든 정보가 지워지지 않는다.
폴링 조회 범위
- 워터마크는 OMS 서버 시각이 아니라 처리한 주문 중 가장 큰
channel_updated_at값으로 기록한다. OMS와 채널의 시계 차이에 영향을 받지 않는다. - 다음 조회는
워터마크 - 10분(겹침 구간, 가정)부터 시작한다. 채널 쪽 반영이 늦은 주문도 다음 조회에서 잡힌다. - 겹쳐서 다시 들어온 주문은 유니크 키와 조건부 갱신 덕분에 결과가 같다. 멱등성이 있어야 겹침 조회가 안전하다.
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 할당 | 판매 가능 | 결과 |
|---|---|---|---|---|
| 출고 전 | 10 | 1 | 9 | 정상 |
| WMS 재고 | 9 | 1 | 8 | 같은 1개를 두 번 뺀다. 기회 손실 |
| OMS 할당 | 10 | 0 | 10 | 나간 1개를 빼지 않는다. 초과 판매 |
| 출고 후 | 9 | 0 | 9 | 정상 |
틀린다면 기회 손실 쪽으로 틀리게 한다. 오픈마켓은 품절 취소에 판매자 페널티를 주고, 기회 손실은 출고 중간 몇 초 동안 1개를 덜 보여 주는 정도라 비용이 작다. 거래액이 우선이고 입고 리드타임이 짧은 사업이라면 반대 선택도 가능하다.
OMS가 WMS 재고의 사본을 들고, 출고 완료 이벤트를 받으면 한 트랜잭션에서 사본과 할당을 함께 줄인다. 두 값이 같은 DB에 있으므로 OMS 안에서는 중간 상태가 생기지 않는다.
남는 함정은 주기적인 재고 동기화다. 출고 전에 찍힌 WMS 스냅샷("10개")이 출고 이벤트를 처리한 뒤 늦게 도착해 사본을 덮어쓰면 초과 판매가 난다. 스냅샷의 생성 시각이 마지막으로 반영한 출고 이벤트보다 오래됐으면 버린다.
5. 할당과 출고
창고 선택 (가정)
- 주문 전체를 한 창고에서 채울 수 있는 창고 중 고객과 가장 가까운 창고를 고른다.
- 그런 창고가 없으면 분할 출고 건수가 가장 적은 조합을 고르고, 그중 가까운 쪽을 고른다.
- 거리가 같으면 재고가 많은 창고를 고른다. 한 창고만 먼저 바닥나지 않게 한다.
분할 출고를 허용한다. 주문 하나에 출고·송장이 여러 건 생기므로 출고 단위를 주문과 별도로 관리한다.
초과 판매가 났을 때
어떻게 처리할지는 사업 정책이지만, 정책이 무엇이든 시스템은 다음을 갖춘다.
- 감지 시점: 재고 할당이 실패하는 순간 드러난다. 주문은 이미 채널에서 결제가 끝난 상태다.
- 보관 상태: 할당 실패 주문은
할당 보류상태에 둔다. - 기한: 채널마다 출고 기한이 있고 넘기면 페널티가 붙으므로, 보류 주문에 기한 타이머를 둔다.
- 결정 주체: 자동 처리와 운영자 판단의 경계를 정한다.
기본 정책(가정): 할당 실패 → 할당 보류 → 다른 창고로 자동 재할당 → 실패 시 운영자 알림 → 출고 기한 전까지 운영자가 취소 또는 대기 결정
출고 지시 직전 재확인
취소가 늦게 수집되면 출고 지시가 먼저 나가고, 출고 중지 요청이나 반품이라는 비싼 경로로 빠진다. 수집 지연을 0으로 만들 수 없으므로 되돌리기 어려운 출고 지시 직전에 채널 API로 주문 상태를 한 번 더 확인한다.
채널로 결과 전달
송장번호를 채널에 등록한다. 그래야 고객이 채널에서 배송을 조회할 수 있다.
6. 취소와 반품
부분 취소를 허용한다. 처리 방식은 취소 시점에 따라 나뉜다.
| 시점 | 처리 | 재고 |
|---|---|---|
| 출고 지시 전 | 바로 취소한다 | 할당을 해제한다 |
| 출고 지시 후 ~ 출고 전 | WMS에 출고 중지를 요청한다. 이미 포장됐으면 실패할 수 있다 | 중지에 성공하면 할당을 해제한다 |
| 출고 후 | 취소할 수 없으므로 반품으로 전환한다 (회수 → 검수 → 환불) | 검수 결과에 따라 재입고하거나 폐기한다 |
환불은 채널이 실행하고 OMS는 요청과 결과를 기록한다.
7. 공통 원칙
도착 순서는 최신 순서가 아니다. 이 설계에서 같은 문제가 두 번 나왔다.
- 주문 수집: 늦게 처리된 폴링 결과("결제 완료")가 먼저 들어온 웹훅("취소됨")을 덮어쓰면 취소된 주문이 출고된다.
- 재고 동기화: 늦게 도착한 출고 전 스냅샷이 출고 이벤트 반영 결과를 덮어쓰면 초과 판매가 난다.
해결책도 같다. 데이터를 만든 쪽의 변경 시각이나 버전을 함께 받고, 마지막으로 반영한 값보다 새로울 때만 반영한다. 같은 데이터가 여러 번 와도 결과가 같도록(멱등성) 만들면 재시도와 겹침 조회를 안심하고 쓸 수 있다.
가정한 값과 확인할 것
| 항목 | 값 | 근거 |
|---|---|---|
| 폴링 주기 | 5분 | 웹훅이 평소 지연을 책임지므로 유실 보정용으로 충분하다고 가정 |
| 폴링 겹침 구간 | 10분 | 채널 쪽 반영 지연을 흡수한다고 가정 |
| 안전 재고 최소값 | 1개 | 가정 |
| 창고 수 | 최대 3곳 | 가정 |
| 창고 선택 규칙 | 단일 창고 → 최소 분할 → 거리 → 재고 | 가정 |
| 초과 판매 정책 | 자동 재할당 후 운영자 결정 | 사업 정책. 가정 |
- [ ] 각 채널의 웹훅 재시도 정책(메르카도리브레의 1시간 8회 포함)을 공식 문서로 확인한다.
- [ ] 각 채널 API의 호출 한도를 확인하고 폴링·재고 갱신 호출량이 그 안에 드는지 계산한다.
미룬 것: 비기능 요구
2026-10-26, 비기능 요구(규모, 피크 배수, 지연시간, 가용성, 보관 기간)는 우선 제외하고 기능 설계에 집중하기로 했다. 2단계 개략 계산은 이 값들이 있어야 하므로 함께 미룬다. 나중에 정할 질문은 다음과 같다.
- 하루 주문 수, 채널별 비중, 주문당 라인 수
- 피크 배수. 블랙프라이데이처럼 하루 종일 몰리는 경우와 라이브 방송처럼 몇 분 안에 한 상품으로 몰리는 경우를 구분한다.
- SKU 수와 재고 변경 빈도. 판매 가능 수량이 바뀔 때마다 채널 4곳에 재고 갱신 API를 호출하므로 주문 수보다 먼저 한계에 닿을 수 있다.
- 주문 수집, 취소 반영, 재고 동기화 각각의 지연 목표. 재고 동기화 시간은 안전 재고 식에 그대로 들어간다.
- OMS 장애 중에도 채널은 주문을 계속 받는다. 허용할 수 있는 장애 시간과 복구 후 처리 순서
- 주문, 채널 원본 이력, 감사·결제 기록 각각의 보관 기간과 어느 나라 법을 따를지