feat(performance): 카페24 마켓 연동 주문을 해당 쇼핑몰 열로 집계

- 카페24 마켓 통합관리가 가져온 주문(market_id ≠ self)을 MARKET_MAP 으로 네이버·쿠팡·11번가 등 열에
  (SaleEvent.marketplace_code). 연결표에 없는 마켓은 카페24 열 — 전체 합계는 카페24 일별 매출내역과 같음
- 환불도 원 주문의 마켓으로 같은 열에
- 카페24 사건 ID 에 c24: 접두어, 기간 교체는 카페24 열 + 다른 열의 c24: 행만 — 직접 연동분은 보존
- 매출 대조 마켓별 표에 "반영 열", 설정 화면에 "카페24 경유" 표시

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-29 16:54:10 +09:00
parent 4cb37688ed
commit 19396f1745
10 changed files with 156 additions and 61 deletions
+6
View File
@@ -105,6 +105,9 @@ class SaleEvent:
discount_amount: int = 0
order_status: str = ""
raw: dict[str, Any] = field(default_factory=dict)
# 어느 쇼핑몰 열로 집계할지 — None 이면 이 어댑터의 쇼핑몰. 다른 쇼핑몰 주문을 대신 받아 오는
# 연동(예: 카페24 마켓 통합관리가 가져온 스마트스토어 주문)은 해당 쇼핑몰 코드를 넣는다.
marketplace_code: str | None = None
def validate(self) -> None:
if self.event_type not in EVENT_TYPES:
@@ -148,6 +151,9 @@ class MarketplaceAdapter(ABC):
# 쇼핑몰 API 가 "기간 안 결제·환불"을 빠짐없이 돌려줄 때만 켠다 — 규칙이 바뀌거나
# 주문이 사라져도 예전 행이 남지 않는다. False 면 같은 사건 ID 만 덮어쓴다(upsert).
replace_range: bool = False
# replace_range 일 때 이 어댑터가 만든 사건을 가려내는 외부 사건 ID 접두어. 다른 쇼핑몰 열로 보낸
# 사건(marketplace_code 지정)도 이 접두어로 찾아 함께 교체한다 — 그 쇼핑몰의 직접 연동분은 건드리지 않음.
event_prefix: str = ""
note: str = "" # 설정 화면 안내 문구
# ── 설정 ──────────────────────────────────────────────