부록 설계 질문 목록
이커머스 OMS를 설계하면서 판단이 갈린 지점을 질문으로 모았다. 질문 번호는 설계 과정에서 쓴 번호를 그대로 따른다. Q6-2a(무엇을 비교하는가)는 Q6-2에 합쳤다. 답은 접어 두었으니 먼저 스스로 판단해 보고 펼쳐서 비교한다. 각 결정의 근거와 트레이드오프는 연결된 설계 문서에 있다.
- 1단계 요구사항 정리: Q1 ~ Q9
- 미룬 비기능 요구: Q10 ~ Q15
- 3단계 상위 설계: Q16 ~ Q21
1단계 기능 요구
Q1. 주문은 어디서 들어오나요?
자사몰 하나뿐인가, 외부 오픈마켓 여러 곳에서도 들어오는가? 들어온다면 OMS가 받는 방식은 푸시(웹훅)인가, 풀(주기적 조회)인가?
답과 결론
- 답: 쇼피파이, 메르카도리브레, 카페24, 틱톡샵 네 곳이다. 채널마다 주문 형식이 다르다. 기본은 웹훅이다.
- 결론: 채널별 어댑터가 채널 주문을 OMS 공통 주문 모델로 변환한다. 웹훅만 믿으면 유실, 중복, 순서 역전이 생긴다. → 주문 수집
Q2. 주문이 거치는 상태를 처음부터 끝까지 적고, 어디까지가 OMS의 책임인지 정해 주세요.
결제 승인을 OMS가 직접 하는가, 결과만 받는가? 배송 추적도 OMS가 하는가?
답과 결론
- 답: 주문 접수 → 결제 완료 → 배송 준비중 → 배송 중 → 배송완료 또는 구매확정. 책임 범위는 답하지 않았다.
- 보완 1: 채널이 결제를 받으므로 결제는 OMS의 책임이 아니다. OMS의 첫 상태는 결제가 끝난 주문의 수집이다.
- 보완 2: 창고가 여러 곳이므로 "배송 준비중"을 재고 할당 → 출고 지시 → 출고 완료로 쪼갠다. 취소 가능 여부가 이 경계에서 갈린다.
- 보완 3: 부분 취소를 허용하므로 상태는 주문이 아니라 라인 단위로 둔다.
- 보완 4: 배송완료와 구매확정은 둘 중 하나가 아니라 순서다.
- 결론: OMS의 책임 경계, 주문 상태
Q3. 재고의 원천은 어디인가요?
OMS가 재고 수량을 직접 들고 있는가, WMS가 원천이고 OMS는 받아 보기만 하는가? 출고 창고는 몇 곳인가?
답과 결론
- 답: 재고의 원천은 WMS다. 창고는 최대 3곳이다.
- 결론: 같은 재고를 채널 4곳이 동시에 판다는 점이 설계의 핵심 쟁점이 된다. → Q7
Q4. 취소·반품·교환은 이번 범위에 넣을까요?
넣는다면 부분 취소도 허용하는가? 출고 이후 취소는 어떻게 처리하는가?
답과 결론
- 답: 넣는다. 부분 취소도 허용한다. 출고 이후 취소는 도메인 지식이 부족해 답하지 못했다.
- 결론: 출고 지시 전에는 바로 취소, 출고 지시 후 출고 전에는 출고 중지 요청(실패 가능), 출고 후에는 반품으로 전환한다. 환불은 채널이 실행한다. → 취소와 반품
Q5. OMS를 쓰는 주체는 누구인가요?
고객의 주문 조회, 운영자 백오피스, 외부 시스템(마켓·창고·택배사) API 중 어디까지 지원하는가?
답과 결론
- 답: 고객의 주문 조회와 운영자 백오피스.
- 보완: OMS는 채널에도 결과를 되돌려 보내야 한다. 송장번호를 채널에 등록해야 고객이 채널에서 배송을 조회할 수 있다.
Q6. 웹훅 유실은 어떻게 메울까요?
(a) 유실을 감수한다, (b) 주기적으로 채널 API를 조회해 보정한다, (c) 다른 방법.
답과 결론
- 답: 메르카도리브레는 1시간 동안 8회 재시도한다고 하지만, (b)로 두 겹을 둔다.
- 결론: 웹훅은 빠른 경로, 폴링은 보정 경로다. 대신 같은 주문이 여러 번 도착하는 것이 기본 전제가 된다. 재시도 정책은 공식 문서로 확인해야 한다. → 웹훅과 폴링의 두 겹 수집
Q6-1. 중복은 무엇으로 판정하나요?
채널이 다르면 주문번호가 겹칠 수 있다.
답과 결론
- 답: 채널과 주문번호에 함께 유니크 제약을 건다.
- 보완: 한 채널에 판매자 계정(스토어)이 여러 개일 수 있으므로 키는
(채널, 스토어, 채널 주문번호)다.
Q6-2. 이미 있는 주문이 상태가 바뀐 채로 다시 들어오면 어떻게 하나요?
오래된 정보가 새 정보를 덮어쓰지 않게 하려면 무엇을 비교해야 하는가?
답과 결론
Q6-2b. 채널이 준 원본과 OMS의 주문을 한 테이블에 둘까요, 나눌까요?
채널 데이터로 주문 전체를 덮어쓰면 OMS가 만든 정보(할당한 창고, 출고 지시 여부, 송장번호)가 지워질 수 있다.
답과 결론
- 결론: 나눈다. 채널 원본 이력과 OMS 주문을 따로 둔다. → 저장 구조
Q6-3. 폴링은 얼마나 자주, 어떤 범위를 조회하나요?
폴링 주기는 웹훅이 유실됐을 때 수집이 늦어지는 최악의 시간이다. 너무 자주 돌리면 채널 API의 호출 한도에 걸린다.
답과 결론
- 답: 30초마다 조회한다. 범위는 답하지 못했다.
- 보완: 30초면 스토어 하나당 하루 2,880회다. "최근 30초"만 조회하면 시계 차이와 채널 반영 지연 때문에 경계의 주문이 빠질 수 있다.
- 정리: 처리한 주문 중 가장 큰
channel_updated_at을 워터마크로 두고,워터마크 - 10분부터 겹쳐서 조회한다. 겹쳐 들어온 주문은 멱등성 덕분에 결과가 같다. 웹훅이 평소 지연을 책임지므로 폴링은 5분 주기로 늘린다. - 짚을 점: 비싼 지연은 주문 생성이 아니라 취소다. 그래서 출고 지시 직전에 채널 상태를 한 번 더 확인한다.
- 결론: 폴링 조회 범위, 출고 지시 직전 재확인
Q7. 채널별 판매 가능 수량은 누가, 어떻게 정하나요?
실재고 10개를 채널 4곳에서 동시에 판다. (a) 모든 채널에 같은 수량, (b) 채널별로 나눠 배정, (c) 같은 수량에서 안전 재고를 빼고 알린다.
Q7-1. 세 방식에서 각각 어떤 사고가 나나요?
- 답: (a)는 무조건 초과 판매, (b)와 (c)는 기회 손실.
- 보완: (a)는 무조건이 아니라 재고가 바닥에 가까울 때 동기화 전에 여러 채널에서 팔리면 초과 판매가 난다. (c)는 초과 판매 확률을 줄이는 대신 안전 재고만큼 기회 손실을 지불하는 절충이고, 가장 흔한 방식이다.
Q7-2. 한 채널에서 팔린 뒤 나머지 채널 수량이 바뀌기까지 무슨 일이 생기나요?
- 답: 무조건 오버셀이 난다.
- 보완: 동기화 시간 동안 팔린 양이 남은 수량보다 많을 때만 난다. 그래서
안전 재고 ≈ 판매 속도 × 동기화 시간으로 계산할 수 있다.
Q7-3. 채널에 알려 줄 판매 가능 수량은 어떻게 계산하나요?
- 답: 예약(할당) 수량을 뺀 재고를 OMS가 계산해서 알린다. 정답.
- 결론:
WMS 가용 재고 − OMS 할당 수량 − 안전 재고→ 판매 가능 수량
Q7-4. 출고 순간 WMS 재고 차감과 할당 해제 중 하나가 먼저 반영되면?
- 답 1: 거래액이 우선이고 리드타임이 짧으면 초과 판매를, 아니면 보수적으로 기회 손실을 택한다. 기본은 기회 손실 쪽이다.
- 답 2: 트랜잭션 순서대로 되는 것 아닌가.
- 보완: 두 값은 서로 다른 시스템에 있어 한 트랜잭션으로 묶을 수 없다. OMS가 WMS 재고 사본을 들고, 출고 완료 이벤트를 받으면 한 트랜잭션에서 사본과 할당을 함께 줄인다. 출고 전에 찍힌 스냅샷이 늦게 오면 생성 시각을 비교해 버린다.
- 결론: 출고 순간의 경계
Q7-5. 안전 재고는 어떻게 정하나요?
- 답: 상품별 판매 속도로 계산한다.
- 보완: 판매 이력이 없는 신상품과 프로모션 상품을 위해 최솟값을 둔다.
max(최소값, 판매 속도 × 동기화 시간)→ 안전 재고
Q7-6. 그래도 초과 판매가 나면 어떻게 하나요?
- 답: 정책 결정의 문제다.
- 보완: 맞다. 정책은 사업이 정하고, 설계에서는 가정으로 명시하고 넘어간다. 다만 정책과 상관없이 시스템은 감지 시점, 보관 상태(
할당 보류), 출고 기한 타이머, 결정 주체를 갖춰야 한다. → 초과 판매가 났을 때
Q8. 재고 할당 시 창고 3곳 중 어디를 고를까요?
Q8-1. 가장 가까운 창고인가, 재고가 가장 많은 창고인가?
- 답: 둘 다 좋은 선택지라 고민된다.
- 결론: 둘을 순서대로 쓴다. 한 창고에서 다 채울 수 있는 곳 중 가장 가까운 곳 → 없으면 분할 출고 건수가 가장 적은 조합 → 거리가 같으면 재고가 많은 곳. → 창고 선택
Q8-2. 한 창고에서 다 채울 수 없으면 분할 출고를 허용하나요?
- 답: 허용한다.
Q9. 취소·반품 기본안으로 확정할까요?
답
- 답: 확정한다.
미룬 비기능 요구
2026-10-26, 질문이 한 번에 너무 많아 비기능 요구는 우선 제외했다. 답하지 않은 질문이다. → 미룬 것: 비기능 요구
- Q10. 하루 주문은 몇 건인가? 채널별 비중과 주문당 라인 수는?
- Q11. 피크는 평소의 몇 배인가? 블랙프라이데이와 라이브 방송 중 어느 쪽이 더 위험한가?
- Q12. 상품(SKU)은 몇 개이고 재고는 얼마나 자주 바뀌는가?
- Q13. 주문 수집, 취소 반영, 재고 동기화는 각각 몇 초 안에 끝나야 하는가?
- Q14. OMS가 10분 동안 죽으면 무슨 일이 생기는가? 다시 살아나면 무엇부터 처리하는가?
- Q15. 주문, 채널 원본 이력, 감사·결제 기록은 각각 얼마나 보관하는가? 어느 나라 법을 따르는가?
3단계 상위 설계
Q16. 웹훅을 받으면 바로 처리할까요, 받아 두고 나중에 처리할까요?
채널은 정해진 시간 안에 성공 응답이 없으면 재시도한다. 그런데 주문 처리에는 변환, 저장, 할당, 재고 재계산, 채널 갱신까지 할 일이 많다.
답과 결론
- 답: 비동기로 한다. 오픈마켓은 빠른 응답을 요구한다. 인박스에 쌓아 두고 변환해서 주문에 넣는다. 배송 도착일 보장에 따라 달라질 수 있다.
- 결론: 인박스 패턴이다. 폴링과 WMS 이벤트도 같은 인박스에 넣고, 인박스가 채널 원본 이력을 겸한다. → 인박스 패턴
Q17. 같은 주문의 "생성"과 "취소"를 컨슈머 두 대가 동시에 처리하면?
답과 결론
- 답: Kafka 또는 SNS·SQS를 쓴다고 가정한다.
- 보완: 큐를 쓴다고 저절로 풀리지 않는다. 다른 파티션에 들어가면 여전히 동시에 처리된다.
- 결론: 주문 키로 묶어 같은 주문은 한 번에 하나씩 처리한다. 컨슈머는 서버가 아니라 컨슈머 인스턴스 단위이고, 컨슈머 안에서 스레드 풀로 넘기면 순서가 다시 깨진다. 최소 한 번 전달이라 멱등성은 여전히 필요하다. → 같은 주문은 한 번에 하나씩
Q17-1. 같은 주문의 메시지를 항상 같은 파티션에 넣으려면 키를 무엇으로 하나요?
- 정리:
(채널, 스토어, 채널 주문번호). Kafka는 파티션 키, SQS FIFO는 메시지 그룹 ID로 쓴다. OMS 내부 주문 ID는 웹훅이 처음 도착할 때 아직 없어서 쓸 수 없다.
멱등키는 OMS가 만들어서 WMS로 주는 건가요? (사용자 질문)
- 결론: 키는 세 가지로 나뉜다. 주문 키(채널이 준 값, 순서용), 수신 메시지 ID(보낸 쪽이 준 값, 중복 수신용), 출고 지시 ID(OMS가 만듦, WMS 명령의 멱등키). 출고 지시 ID는 아웃박스에 저장할 때 한 번만 만든다. → 세 가지 키
3PL WMS가 멱등키를 지원하지 않으면 어떻게 하나요?
- 결론: 외부 참조번호 필드를 멱등키처럼 쓰고, 결과를 모르는 실패만 조회 후 재전송하고, 주기적으로 대사하고, 필요하면 운영자에게 넘긴다. → WMS가 멱등키를 지원하지 않을 때
Q18. 다른 주문 두 개가 마지막 재고 1개를 동시에 할당하면?
주문 키로 묶는 방법이 여기서 왜 통하지 않는지도 생각한다.
답과 결론
- 답: 분산 락을 쓴다.
- 보완: 동작은 하지만 시스템이 하나 늘고, 락 만료 문제가 있다. 부딪히는 대상이 주문이 아니라 SKU라서 주문 키로는 못 막고, SKU로 파티션을 나누면 여러 상품 주문과 인기 상품 쏠림 문제가 생긴다.
- 결론: 판단을 UPDATE 조건에 넣어 DB가 판단하게 한다. 지켜야 할 데이터가 DB 한 곳에 있으면 락도 그 DB에서 건다. → 다른 주문이 같은 재고를 다툴 때
Q18-1. 주문 하나에 상품 A, B가 있는데 A만 할당되고 B는 재고가 없으면?
- 답: B는 다른 WMS와 통신해 재고가 있는 곳을 찾는다. 끝내 없으면 A만 정상 결제되게 한다.
- 보완: 다른 창고 재고는 OMS DB의 재고 사본에서 찾는다. 할당 도중 WMS를 호출하면 느려지고 경쟁 조건이 돌아온다. 결제는 채널이 주문 전체로 끝냈으므로 "A만 결제"는 없고, B를 부분 취소하고 환불을 요청한다.
- 정리: 락 없이 계획 → 한 트랜잭션에서 조건부 UPDATE로 실행 → 충돌하면 롤백하고 재계획. A는 커밋하고 먼저 출고, B는
할당 보류. UPDATE는(SKU, 창고)순서로 정렬해 교착 상태를 막는다. → 상품이 여러 개인 주문
Q19. 멱등키가 없는 WMS에서 결과를 모를 때, 중복 출고와 출고 누락 중 어느 쪽이 더 나쁜가요?
답과 결론
- 답: 출고 누락이 더 나쁘다.
- 이유: 누락은 아무도 모르게 조용히 일어나 출고 기한 초과나 고객 문의로 드러나고, 중복은 대사나 재고 동기화로 흔적이 남는다.
- 결론: 결과를 모르면 조회 후 재전송하고, 대사로 중복을 피킹 전에 잡는다. 고가 상품이면 판단이 뒤집힐 수 있다. → WMS가 멱등키를 지원하지 않을 때
Q20. 판매 가능 수량이 바뀔 때마다 채널 4곳에 바로 보내면 호출 한도에 막힌다. 어떻게 할까요?
1초에 10건씩 팔리는 상품 하나로만 1초에 40번을 호출한다(가정).
답과 결론
- 답: 실시간이 아니라 주기적으로 보낸다.
- 보완: 모든 상품을 주기마다 보내면 낭비다. 바뀐 상품만
(SKU, 채널)별 최신 값으로 모아 두었다가 보낸다(병합). 품절에 가까우면 즉시 보내고, 채널별 속도 제한기를 거친다. - 결론: 바뀐 것만 모아 최신 값 하나로 보낸다
Q21. 전송 주기 N초는 몇 초로 할까요?
N을 늘리면 호출은 줄지만 동기화 시간이 늘어 안전 재고가 커진다.
답과 결론
- 답: 수량이 많으면 덜 자주, 몇 개 없으면 빠르게 보낸다.
- 보완: 수량보다
남은 수량 ÷ 판매 속도, 즉 소진 예상 시간으로 판단한다. 100개 남아도 1초에 10개씩 팔리면 10초 뒤 품절이다. - 결론: 소진 예상 시간에 따라 즉시 · 30초 · 5분(가정). → 소진 예상 시간에 따라 주기를 다르게
다음에 이어 갈 질문
- 고객 주문 조회와 운영자 백오피스의 API
- 주문·라인·출고·재고 데이터 모델
- 4단계: 한 상품에 몰리는 할당, 채널 API 호출 한도