공급사 발주·배송 관리

개요

공급사가 주문 시점에 자동 분리된 발주(PO)를 받아 처리하는 순방향 워크플로우를 담당. 발주 접수 → 출고(운송장) → 배송중 → 배송완료의 흐름을 분할출고·합배송·엑셀 일괄처리까지 받쳐 설계했다.

---

왜 이 설계가 필요했는가 (Problem)

---

테이블 설계 — PO 계층 + 배송 레코드

ERD (핵심 관계)

발주 배송 — 출고 레코드 핵심

PO 라인 — 취소 3트랙 (귀책 분리)

---

상태 머신 — 발주 처리 흐름

---

핵심 설계 결정

1. 주문라인 1:1 분할출고 매칭 — 출고 할당기

// 출고 할당 — 주문라인 잔여를 앞에서부터 순회하며 출고량만큼 차감
for (주문라인, 잔여) in 주문라인별 잔여(오름차순):
    if 잔여 ≥ 출고량:
        잔여 −= 출고량
        return 주문라인  // 이 출고 레코드가 매핑될 주문라인
return 없음  // 잔여 정보 없음(마이너스 PO·레거시) → best-effort

2. 합배송 운송장 자동 전파

-- 대표 1건 운송장 입력 → 같은 번들키 형제에 동일 운송장 확장
SELECT 배송 ID FROM 발주 배송
 WHERE 번들키 = :번들키
   AND 배송 상태 = '준비' AND 삭제 아님

3. 운송장 엑셀 일괄출고

// 업로드: 관리번호(A열)에서 배송 ID 추출 → 소유·상태·택배사 검증 → 일괄 출고
배송 ID = 관리번호 앞부분의 숫자 (정규식 ^(\d+))
// 검증: '준비'가 아니면 "이미 출고", 택배사가 이미 있으면 "이미 운송장 등록" → 중복 차단

4. PO 라인 부분취소 — 단가 내림차순 환불 최대화

-- 후보 정렬: 단가(결제금액 / 수량) 내림차순 → 동일단가 FIFO
UPDATE 주문라인
   SET 공급사 취소수량 = 공급사 취소수량 + :취소수량
 WHERE … AND (고객사 취소 + 공급사 취소 + :취소수량) ≤ 주문수량  -- 경쟁 update 가드
-- 갱신 행 수가 0 이면 동시성 충돌 의심 예외 (낙관적 동시성 방어)

5. 직배송 안전망

직배송 시작():  // 운송장 없이 배송중 전환
    배송 상태 = 배송중
    출고 시각 = 지금
// 엑셀 출고: 직배송 라인이면 "직배송 상품은 운송장 입력 대상이 아닙니다" 예외
// 배송리스트 조회: 배송 유형이 직배송인 건 제외
// 배송 유형 변경은 '신규 발주' 라인만 허용 (접수 후엔 배송 레코드가 생겨 고정)

6. 배송완료 단일화 — 공통 완료 처리기

배송완료(라인 목록, 처리자):
  1) 발주 배송 → 배송완료
  2) PO라인 배송·라인 상태 → 배송완료
  3) 입고검수 생성 (구매사의 자동 입고 설정에 따라 검수완료/검수대기)
  4) PO라인 검수 상태 집계
  5) PO 헤더 + 주문 상태 동기화
// 입고수량 = 주문수량 − 취소 − 미출고 ≤ 0 이면 입고검수 생성·알림 skip

7. 배송추적 배치

---

설계가 만든 결과 (Result)

검증 결과

공통 모듈의 PO라인 엔티티 테스트 · 8/8 통과 (property 4종 · 총 32,000 케이스)

거절 시 무변경을 명시적으로 잠갔다

랜덤 시퀀스가 성공·거절 경로를 함께 덮는다

거절 경로를 별도 테스트로 빼지 않고 한 시퀀스 안에서 섞어 검증한다. 랜덤 취소 시퀀스를 걸으며 각 단계마다 —

→ 실제 운영에서 벌어지는 순서(부분취소가 여러 번 오다가 한계 초과)를 그대로 재현한다.

주문라인 1:1 분할출고 매칭 — 불변식 검증

그 밖에 검증한 계약

이 검증이 말하지 않는 것