From 19396f1745fe7645c7c2b59e17d7224cfe2d9630 Mon Sep 17 00:00:00 2001 From: king Date: Tue, 29 Sep 2026 16:54:10 +0900 Subject: [PATCH] =?UTF-8?q?feat(performance):=20=EC=B9=B4=ED=8E=9824=20?= =?UTF-8?q?=EB=A7=88=EC=BC=93=20=EC=97=B0=EB=8F=99=20=EC=A3=BC=EB=AC=B8?= =?UTF-8?q?=EC=9D=84=20=ED=95=B4=EB=8B=B9=20=EC=87=BC=ED=95=91=EB=AA=B0=20?= =?UTF-8?q?=EC=97=B4=EB=A1=9C=20=EC=A7=91=EA=B3=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 카페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 --- app/modules/performance/adapters/base.py | 6 ++ app/modules/performance/adapters/cafe24.py | 68 ++++++++++++---- app/modules/performance/dashboard.py | 4 + app/modules/performance/db.py | 31 +++++--- app/modules/performance/sync.py | 7 +- .../templates/performance/index.html | 2 +- .../templates/performance/settings.html | 3 +- .../performance/tests/test_performance.py | 78 +++++++++++-------- app/static/performance.js | 8 +- docs/PERFORMANCE_MODULE.md | 10 ++- 10 files changed, 156 insertions(+), 61 deletions(-) diff --git a/app/modules/performance/adapters/base.py b/app/modules/performance/adapters/base.py index a7e6328..3f90796 100644 --- a/app/modules/performance/adapters/base.py +++ b/app/modules/performance/adapters/base.py @@ -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 = "" # 설정 화면 안내 문구 # ── 설정 ────────────────────────────────────────────── diff --git a/app/modules/performance/adapters/cafe24.py b/app/modules/performance/adapters/cafe24.py index 257f9c4..1a63621 100644 --- a/app/modules/performance/adapters/cafe24.py +++ b/app/modules/performance/adapters/cafe24.py @@ -13,9 +13,13 @@ 실제 환불액(actual_refund_amount). 환불코드가 R 로 시작하면 반품, 그 밖은 취소. - 수집 기간을 통째로 다시 받는다(replace_range) — 결제·환불 모두 기간 안 날짜로 조회되므로 그 기간의 카페24 실데이터를 지우고 새로 넣는다. 규칙이 바뀌거나 주문이 사라져도 이중 집계 없음. - - 자체몰 주문만(market_id 가 self/빈값). 카페24 로 연동돼 들어온 다른 마켓(스마트스토어·쿠팡 등) - 주문은 해당 쇼핑몰 어댑터와 이중 집계되지 않게 제외(환불도 원 주문의 market_id 로 판단). - 네이버페이 결제(order_place_id=NCHECKOUT)는 자체몰 주문이라 포함. + - 자체몰 주문(market_id 가 self/빈값)은 카페24 열. 카페24 마켓 통합관리로 들어온 다른 마켓 주문 + (스마트스토어·쿠팡 등)은 MARKET_MAP 으로 해당 쇼핑몰 열에 넣는다(환불도 원 주문으로 판단). + MARKET_MAP 에 없는 마켓은 카페24 열 — 전체 합계는 항상 카페24 일별 매출내역과 같다. + 네이버페이 결제(order_place_id=NCHECKOUT)는 자체몰 주문이라 카페24 열. + 카페24 가 만든 사건은 모두 외부 사건 ID 앞에 "c24:" — 다시 받을 때 이것만 골라 교체하므로 + 해당 쇼핑몰을 나중에 직접 연동해도 그 데이터는 건드리지 않는다(단, 같은 주문을 양쪽에서 받지 않게 + 직접 연동을 켜는 쇼핑몰은 MARKET_MAP 에서 빼야 한다). - 한 호출 검색기간 3개월 미만 → 60일씩 나눠 요청. orders limit ≤ 1000, refunds limit ≤ 500, offset ≤ 15000. - 개인정보(구매자 이름·주소·연락처·계좌)는 저장하지 않는다 — raw 에는 금액·상태 필드만. - 할인 항목 구성·마켓 주문 포함 여부는 `reconcile()`(설정 화면 "카페24 매출 대조")로 카페24 화면과 @@ -45,6 +49,33 @@ LOOKUP_BATCH = 100 MAX_OFFSET = 15000 CHUNK_DAYS = 60 SELF_MARKETS = {"", "self", None} +EVENT_PREFIX = "c24:" + +# 카페24 마켓 통합관리가 가져온 주문의 market_id(또는 order_place_id) → 우리 쇼핑몰 열. +# 여기 없는 마켓(예: 옥션·인터파크)은 카페24 열에 남긴다 — 전체 합계는 항상 카페24 화면과 같다. +# 실제 값은 설정 → "카페24 매출 대조"의 마켓별 표(market_id / 주문경로 / 반영 열)로 확인해 보탠다. +MARKET_MAP: dict[str, str] = { + "shopn": "naver", "smartstore": "naver", "storefarm": "naver", "naver": "naver", + "coupang": "coupang", + "sk11st": "elevenst", "11st": "elevenst", "elevenst": "elevenst", + "gmarket": "gmarket", + "lotteon": "lotteon", "lotte": "lotteon", + "gsshop": "gsshop", "gs": "gsshop", + "kakao": "kakao", "kakaotalkstore": "kakao", "talkstore": "kakao", "kakaostyle": "kakao", + "ohouse": "ohouse", "todayhouse": "ohouse", "bucketplace": "ohouse", + "toss": "toss", "tossshopping": "toss", +} + + +def target_code(market_id: Any, order_place_id: Any = None) -> str: + """이 주문을 집계할 쇼핑몰 열. 자체몰·모르는 마켓은 카페24.""" + if is_self_market(market_id): + return "cafe24" + for key in (market_id, order_place_id): + code = MARKET_MAP.get(str(key or "").strip().lower()) + if code: + return code + return "cafe24" # 결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰 (initial_order_amount 의 필드) DISCOUNT_FIELDS = ("membership_discount_amount", "set_product_discount_amount", "app_discount_amount", @@ -104,6 +135,7 @@ class Cafe24Adapter(MarketplaceAdapter): auth_type = "shared" implemented = True replace_range = True + event_prefix = EVENT_PREFIX docs_url = "https://apidocs.cafe24.com/docs/admin/get-orders" note = ("카페24 상품관리에서 연결한 OAuth 토큰을 함께 씁니다(여기서 따로 입력하지 않음). " "주문 읽기 권한이 필요해 권한 추가 후 한 번 다시 연결해야 합니다.") @@ -198,8 +230,8 @@ class Cafe24Adapter(MarketplaceAdapter): {"start_date": s.isoformat(), "end_date": e.isoformat(), "date_type": "refund_date"}, REFUND_LIMIT) - def market_ids(self, ctx: AdapterContext, refunds: list[dict[str, Any]]) -> dict[str, Any]: - """환불의 원 주문 market_id — 주문일 60일 구간·100건씩 묶어 조회.""" + def market_ids(self, ctx: AdapterContext, refunds: list[dict[str, Any]]) -> dict[str, tuple[Any, Any]]: + """환불의 원 주문 (market_id, order_place_id) — 주문일 60일 구간·100건씩 묶어 조회. 못 찾으면 자체몰.""" pairs = sorted({(_day(r.get("order_date")) or date.min, str(r.get("order_id") or "")) for r in refunds if r.get("order_id")}) out: dict[str, Any] = {} @@ -212,7 +244,7 @@ class Cafe24Adapter(MarketplaceAdapter): params = {"order_id": ",".join(ids), "start_date": first.isoformat(), "end_date": group[-1][0].isoformat(), "date_type": "order_date", "limit": LOOKUP_BATCH} for o in self._get(ctx, "/admin/orders", params).get("orders") or []: - out[str(o.get("order_id"))] = o.get("market_id") + out[str(o.get("order_id"))] = (o.get("market_id"), o.get("order_place_id")) i += len(group) return out @@ -224,10 +256,12 @@ class Cafe24Adapter(MarketplaceAdapter): rows = [r for r in self.refunds(ctx, start, end) if str(r.get("status") or "T") == "T"] markets = self.market_ids(ctx, rows) for r in rows: - yield {**r, "_market_id": markets.get(str(r.get("order_id")), "self")} + mid, place = markets.get(str(r.get("order_id")), ("self", None)) + yield {**r, "_market_id": mid, "_order_place_id": place} def normalize_order(self, order: dict[str, Any]) -> list[SaleEvent]: - if not is_self_market(order.get("market_id")) or order.get("paid") != "T": + """결제 주문 → SALE. 자체몰은 카페24 열, 마켓 연동 주문은 해당 쇼핑몰 열(MARKET_MAP).""" + if order.get("paid") != "T": return [] pay_day = _day(order.get("payment_date")) if pay_day is None: @@ -236,8 +270,10 @@ class Cafe24Adapter(MarketplaceAdapter): names = [str(i.get("product_name") or "") for i in items if i.get("product_name")] name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else "" oid = str(order.get("order_id") or "") + target = target_code(order.get("market_id"), order.get("order_place_id")) return [SaleEvent( - event_type="SALE", external_event_id=f"{oid}-PAY", external_order_id=oid, + marketplace_code=target, + event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}-PAY", external_order_id=oid, order_date=_day(order.get("order_date")), payment_date=pay_day, event_date=pay_day, amount=max(0, order_total(order)), product_name=name, quantity=sum(int(i.get("quantity") or 0) for i in items), order_status="결제완료", @@ -247,16 +283,16 @@ class Cafe24Adapter(MarketplaceAdapter): )] def normalize_refund(self, refund: dict[str, Any]) -> list[SaleEvent]: - if not is_self_market(refund.get("_market_id")): - return [] + """환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다.""" day = _day(refund.get("refund_date")) code = str(refund.get("refund_code") or "") if day is None or not code: return [] amount = _won(refund.get("actual_refund_amount")) return [SaleEvent( + marketplace_code=target_code(refund.get("_market_id"), refund.get("_order_place_id")), event_type="RETURN" if code.upper().startswith("R") else "CANCEL", - external_event_id=code, external_order_id=str(refund.get("order_id") or ""), + external_event_id=f"{EVENT_PREFIX}{code}", external_order_id=str(refund.get("order_id") or ""), external_line_id=",".join(refund.get("order_item_code") or []), order_date=_day(refund.get("order_date")), event_date=day, amount=-amount, quantity=-int(refund.get("quantity") or 0), order_status="환불완료", @@ -287,7 +323,8 @@ class Cafe24Adapter(MarketplaceAdapter): if not is_self_market(o.get("market_id")): key = str(o.get("market_id")) bm = by_market.setdefault(key, {"market_id": key, "names": set(), "orders": 0, "total": 0, - "refund_count": 0, "refund_amount": 0}) + "refund_count": 0, "refund_amount": 0, + "target": target_code(o.get("market_id"), o.get("order_place_id"))}) bm["orders"] += 1 bm["total"] += order_total(o) for n in (o.get("order_place_name"), o.get("order_place_id")): @@ -305,14 +342,15 @@ class Cafe24Adapter(MarketplaceAdapter): refunds = {"self": {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0}, "market": {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0}} for r in rows: - mid = markets.get(str(r.get("order_id")), "self") + mid, place = markets.get(str(r.get("order_id")), ("self", None)) g = refunds["self" if is_self_market(mid) else "market"] g["count"] += 1 for k in ("actual_refund_amount", "used_points", "used_credits"): g[k] += _won(r.get(k)) if not is_self_market(mid): bm = by_market.setdefault(str(mid), {"market_id": str(mid), "names": set(), "orders": 0, "total": 0, - "refund_count": 0, "refund_amount": 0}) + "refund_count": 0, "refund_amount": 0, + "target": target_code(mid, place)}) bm["refund_count"] += 1 bm["refund_amount"] += _won(r.get("actual_refund_amount")) markets_out = sorted(({**v, "names": sorted(v["names"])} for v in by_market.values()), diff --git a/app/modules/performance/dashboard.py b/app/modules/performance/dashboard.py index e74b313..23bc798 100644 --- a/app/modules/performance/dashboard.py +++ b/app/modules/performance/dashboard.py @@ -157,9 +157,12 @@ def build_settings(store: Any, *, configured: Mapping[str, bool], key_info: Mapp key_versions_in_use: Mapping[int, int], sample_count: int) -> dict[str, Any]: from app.timezone import today_kst # noqa: WPS433 + from .adapters.cafe24 import MARKET_MAP # noqa: WPS433 + statuses = store.statuses() rates = store.rate_table() today = today_kst() + via_cafe24 = set(MARKET_MAP.values()) # 카페24 마켓 통합관리 경유로 매출이 들어오는 쇼핑몰 rows = [] by_code = {m["code"]: m for m in store.list_marketplaces()} for adapter in all_adapters(): @@ -178,6 +181,7 @@ def build_settings(store: Any, *, configured: Mapping[str, bool], key_info: Mapp "auth_type": adapter.auth_type, "shared": adapter.uses_shared_integration, "implemented": adapter.implemented, "note": adapter.note, "docs_url": adapter.docs_url, "configured": configured.get(adapter.code, False), + "via_cafe24": adapter.code in via_cafe24, "status": st, "status_label": STATUS_LABELS.get(st, st), "last_test_at": st_row.get("last_test_at"), "last_test_ok": st_row.get("last_test_ok"), "last_sync_at": st_row.get("last_sync_at"), "last_success_sync_at": st_row.get("last_success_sync_at"), diff --git a/app/modules/performance/db.py b/app/modules/performance/db.py index 5c00b60..1a4180c 100644 --- a/app/modules/performance/db.py +++ b/app/modules/performance/db.py @@ -224,17 +224,28 @@ class PerformanceDBStore: cur.executemany(self._UPSERT_SQL, rows) return len(rows) - def replace_events(self, code: str, start: date, end: date, events: Iterable[dict[str, Any]]) -> int: - """기간(sales_date) 안 이 쇼핑몰 실데이터(is_sample 아님)를 지우고 새로 넣는다 — 한 트랜잭션. - 테스트 데이터는 건드리지 않는다. 실패하면 롤백되어 예전 데이터가 그대로 남는다.""" + def replace_events(self, code: str, start: date, end: date, events: Iterable[dict[str, Any]], + *, id_prefix: str = "") -> int: + """기간(sales_date) 안 이 어댑터가 만든 실데이터(is_sample 아님)를 지우고 새로 넣는다 — 한 트랜잭션. + + 지우는 대상: 이 쇼핑몰(code)의 행 + (id_prefix 가 있으면) 다른 쇼핑몰 열로 보냈던 이 어댑터의 행 + (external_event_id 가 id_prefix 로 시작). 다른 쇼핑몰의 직접 연동분·테스트 데이터는 건드리지 않는다. + 실패하면 롤백되어 예전 데이터가 그대로 남는다.""" rows = self._event_rows(code, events, False) with self._pool.connection() as conn: with conn.transaction(): - conn.execute( - "DELETE FROM perf_sales_events WHERE marketplace_code = %s AND is_sample = FALSE " - "AND sales_date BETWEEN %s AND %s", - (code, start, end), - ) + if id_prefix: + conn.execute( + "DELETE FROM perf_sales_events WHERE is_sample = FALSE AND sales_date BETWEEN %s AND %s " + "AND (marketplace_code = %s OR left(external_event_id, %s) = %s)", + (start, end, code, len(id_prefix), id_prefix), + ) + else: + conn.execute( + "DELETE FROM perf_sales_events WHERE marketplace_code = %s AND is_sample = FALSE " + "AND sales_date BETWEEN %s AND %s", + (code, start, end), + ) if rows: with conn.cursor() as cur: cur.executemany(self._UPSERT_SQL, rows) @@ -242,8 +253,10 @@ class PerformanceDBStore: @staticmethod def _event_rows(code: str, events: Iterable[dict[str, Any]], is_sample: bool) -> list[tuple]: + """행마다 집계할 쇼핑몰 = 사건의 marketplace_code(다른 쇼핑몰 대신 받은 주문), 없으면 code.""" return [ - (code, e["event_type"], e["external_event_id"], e["external_order_id"], e.get("external_line_id", ""), + (e.get("marketplace_code") or code, e["event_type"], e["external_event_id"], e["external_order_id"], + e.get("external_line_id", ""), e.get("order_date"), e.get("payment_date"), e["event_date"], e["sales_date"], e.get("product_name", ""), e.get("option_name", ""), int(e.get("quantity") or 0), int(e["amount"]), int(e.get("discount_amount") or 0), e.get("order_status", ""), diff --git a/app/modules/performance/sync.py b/app/modules/performance/sync.py index 0551445..e53e2c7 100644 --- a/app/modules/performance/sync.py +++ b/app/modules/performance/sync.py @@ -108,10 +108,15 @@ class SyncService: fetched, events = adapter.collect(ctx, start, end) known = ctx.credentials.known_secrets() rows = [event_row(ev, known) for ev in events] + # 다른 쇼핑몰 열로 보낸 사건 — 등록된 쇼핑몰이 아니면 이 쇼핑몰 열에 둔다(합계가 빠지지 않게). + registered = {m["code"] for m in self._store.list_marketplaces()} + for r in rows: + if r.get("marketplace_code") not in registered: + r["marketplace_code"] = code if adapter.replace_range: # 그 기간을 통째로 다시 받은 쇼핑몰 — 기간 안 예전 행을 지우고 새로 넣는다(한 트랜잭션). rows = [r for r in rows if start <= r["sales_date"] <= end] - upserted = self._store.replace_events(code, start, end, rows) + upserted = self._store.replace_events(code, start, end, rows, id_prefix=adapter.event_prefix) else: upserted = self._store.upsert_events(code, rows) self._store.finish_run(run_id, ok=True, fetched=fetched, upserted=upserted) diff --git a/app/modules/performance/templates/performance/index.html b/app/modules/performance/templates/performance/index.html index bb762d9..693e4b6 100644 --- a/app/modules/performance/templates/performance/index.html +++ b/app/modules/performance/templates/performance/index.html @@ -235,4 +235,4 @@ } | tojson }} {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/templates/performance/settings.html b/app/modules/performance/templates/performance/settings.html index 26bac50..34b114e 100644 --- a/app/modules/performance/templates/performance/settings.html +++ b/app/modules/performance/templates/performance/settings.html @@ -57,6 +57,7 @@ {% if r.shared %}공통 연동 {% elif r.configured %}설정완료 {% else %}미설정{% endif %} + {% if r.via_cafe24 %}카페24 경유{% endif %} {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/tests/test_performance.py b/app/modules/performance/tests/test_performance.py index 53c35da..70c9e5a 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -245,15 +245,18 @@ class FakeStore: def record_test(self, code, *, status, ok, error=""): self.status[code] = {"status": status, "ok": ok, "error": error, "test": True} - def replace_events(self, code, start, end, events): + def replace_events(self, code, start, end, events, *, id_prefix=""): + def mine(k, v): + return k[0] == code or (id_prefix and k[2].startswith(id_prefix)) self.events = {k: v for k, v in self.events.items() - if not (k[0] == code and not v["is_sample"] and start <= v["sales_date"] <= end)} + if not (mine(k, v) and not v["is_sample"] and start <= v["sales_date"] <= end)} return self.upsert_events(code, events) def upsert_events(self, code, events, *, is_sample=False): n = 0 for e in events: - self.events[(code, e["event_type"], e["external_event_id"])] = {**e, "is_sample": is_sample} + target = e.get("marketplace_code") or code + self.events[(target, e["event_type"], e["external_event_id"])] = {**e, "is_sample": is_sample} n += 1 return n @@ -426,38 +429,47 @@ class _FakeCafe24(__import__("app.modules.performance.adapters.cafe24", fromlist def test_cafe24_normalize_matches_daily_report(): from app.modules.performance.adapters.base import AdapterContext - from app.modules.performance.adapters.cafe24 import order_total + from app.modules.performance.adapters.cafe24 import order_total, target_code ctx = AdapterContext(code="cafe24", credentials=None) fake = _FakeCafe24( - [[_c24_order("A"), _c24_order("B", market="shopn"), _c24_order("C", paid="F")]], + [[_c24_order("A"), _c24_order("B", market="shopn"), _c24_order("C", paid="F"), + _c24_order("D", market="auction")]], [[_c24_refund("C20260929-01", "A", 12_610), _c24_refund("R20260929-02", "X", 20_000), _c24_refund("C20260929-03", "M", 9_000), _c24_refund("C20260929-04", "A", 5_000, status="F")]], lookup={"M": "shopn"}, ) fetched, events = fake.collect(ctx, date(2026, 9, 29), date(2026, 9, 29)) by = {(e.event_type, e.external_event_id): e for e in events} - # 결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰 (결제 당시 금액) - sale = by[("SALE", "A-PAY")] - assert sale.amount == 50_000 + 3_000 - 1_000 - 5_000 == 47_000 + # 결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰 (결제 당시 금액), 사건 ID 는 c24: 접두어 + sale = by[("SALE", "c24:A-PAY")] + assert sale.amount == 50_000 + 3_000 - 1_000 - 5_000 == 47_000 and sale.marketplace_code == "cafe24" assert sale.event_date == date(2026, 9, 29) and sale.quantity == 2 and sale.product_name == "상품1 외 1건" - assert not any(e.external_order_id in ("B", "C") and e.event_type == "SALE" for e in events) # 마켓·미결제 제외 - # 환불: 환불완료일, 실제 환불액, R→반품 / 그 밖→취소, 마켓 주문·미완료 환불 제외 - assert by[("CANCEL", "C20260929-01")].amount == -12_610 - assert by[("RETURN", "R20260929-02")].amount == -20_000 - assert ("CANCEL", "C20260929-03") not in by and ("CANCEL", "C20260929-04") not in by - assert by[("CANCEL", "C20260929-01")].event_date == date(2026, 9, 29) + # 마켓 연동 주문은 해당 쇼핑몰 열로, 연결표에 없는 마켓(옥션)은 카페24 열, 미결제는 제외 + assert by[("SALE", "c24:B-PAY")].marketplace_code == "naver" + assert by[("SALE", "c24:D-PAY")].marketplace_code == "cafe24" + assert ("SALE", "c24:C-PAY") not in by + # 환불: 환불완료일, 실제 환불액, R→반품 / 그 밖→취소, 원 주문의 마켓 열로, 미완료 환불 제외 + assert by[("CANCEL", "c24:C20260929-01")].amount == -12_610 + assert by[("CANCEL", "c24:C20260929-01")].marketplace_code == "cafe24" + assert by[("RETURN", "c24:R20260929-02")].amount == -20_000 + assert by[("CANCEL", "c24:C20260929-03")].marketplace_code == "naver" + assert ("CANCEL", "c24:C20260929-04") not in by + assert by[("CANCEL", "c24:C20260929-01")].event_date == date(2026, 9, 29) for e in events: assert "buyer_name" not in str(e.raw) and "1234567890" not in str(e.raw) # 개인정보 미저장 assert order_total({"initial_order_amount": {"order_price_amount": "1578300.00", "shipping_fee": "45500.00", "coupon_discount_price": "57000.00"}}) == 1_566_800 # 9/29 화면값 - # 대조: 자체몰/마켓 나눠 합산 + assert target_code("self") == "cafe24" and target_code("SK11ST") == "elevenst" + assert target_code("unknown", "coupang") == "coupang" and target_code("unknown") == "cafe24" + # 대조: 자체몰/마켓 나눠 합산 + 마켓별 반영 열 rec = fake.reconcile(ctx, date(2026, 9, 29)) assert rec["orders"]["self"]["orders"] == 1 and rec["orders"]["self"]["total"] == 47_000 - assert rec["orders"]["market"]["orders"] == 1 and rec["unpaid_orders"] == 1 + assert rec["orders"]["market"]["orders"] == 2 and rec["unpaid_orders"] == 1 assert rec["refunds"]["self"]["actual_refund_amount"] == 32_610 and rec["refunds"]["market"]["count"] == 1 - assert rec["by_market"] == [{"market_id": "shopn", "names": [], "orders": 1, "total": 47_000, - "refund_count": 1, "refund_amount": 9_000}] + bym = {b["market_id"]: b for b in rec["by_market"]} + assert bym["shopn"]["target"] == "naver" and bym["shopn"]["refund_amount"] == 9_000 + assert bym["auction"]["target"] == "cafe24" and bym["auction"]["orders"] == 1 # 60일 단위 분할 + 페이지 넘김(1000건이면 다음 페이지) page1 = [_c24_order(f"x-{i}") for i in range(1000)] fake2 = _FakeCafe24([page1, [_c24_order("y")]]) @@ -484,25 +496,29 @@ def test_cafe24_scope_and_replace_range(): raise AssertionError("주문 권한 없으면 인증 실패여야 합니다") real.shared_status = lambda c: {"connected": True, "scopes": "mall.read_product,mall.read_order"} real.authenticate(ctx) - # 기간 교체: 그 기간의 예전 실데이터(품목 단위 등)는 지우고, 테스트 데이터·기간 밖은 남긴다 + + def ev(eid, day, **kw): + return {"event_type": "SALE", "external_event_id": eid, "external_order_id": "o", + "event_date": day, "sales_date": day, "amount": 1, **kw} + + # 기간 교체: 기간 안 카페24 행(예전 품목 단위)·카페24 경유 네이버 행은 지우고, + # 네이버 직접 연동분·테스트 데이터·기간 밖은 남긴다 st = FakeStore() - st.upsert_events("cafe24", [{"event_type": "SALE", "external_event_id": "old-item-S", "external_order_id": "A", - "event_date": date(2026, 9, 29), "sales_date": date(2026, 9, 29), "amount": 1}]) - st.upsert_events("cafe24", [{"event_type": "SALE", "external_event_id": "outside", "external_order_id": "Z", - "event_date": date(2026, 9, 1), "sales_date": date(2026, 9, 1), "amount": 1}]) - st.upsert_events("cafe24", [{"event_type": "SALE", "external_event_id": "sample", "external_order_id": "S", - "event_date": date(2026, 9, 29), "sales_date": date(2026, 9, 29), "amount": 1}], - is_sample=True) - fake = _FakeCafe24([[_c24_order("A")]]) + d, out = date(2026, 9, 29), date(2026, 9, 1) + st.upsert_events("cafe24", [ev("old-item-S", d), ev("outside", out)]) + st.upsert_events("naver", [ev("c24:OLD-PAY", d), ev("direct-naver-1", d)]) + st.upsert_events("cafe24", [ev("sample", d)], is_sample=True) + fake = _FakeCafe24([[_c24_order("A"), _c24_order("B", market="shopn")]]) orig = syncmod.get_adapter syncmod.get_adapter = lambda c: fake try: - r = SyncService(st, CredentialService(st, lambda: ring())).sync_marketplace( - "cafe24", date(2026, 9, 29), date(2026, 9, 29)) + r = SyncService(st, CredentialService(st, lambda: ring())).sync_marketplace("cafe24", d, d) finally: syncmod.get_adapter = orig - ids = {k[2] for k in st.events if k[0] == "cafe24"} - assert r["ok"] and ids == {"A-PAY", "outside", "sample"}, ids + got = {(k[0], k[2]) for k in st.events} + assert r["ok"], r + assert got == {("cafe24", "c24:A-PAY"), ("naver", "c24:B-PAY"), ("cafe24", "outside"), + ("naver", "direct-naver-1"), ("cafe24", "sample")}, got def test_registry_and_event_validation(): diff --git a/app/static/performance.js b/app/static/performance.js index 9035fc8..62b8520 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -482,6 +482,8 @@ const r = await api("GET", "/performance/api/marketplaces/cafe24/reconcile?date=" + encodeURIComponent(day)); if (!r.ok) { out.innerHTML = '

' + esc((r.label ? r.label + " — " : "") + r.message) + "

"; return; } const s = r.orders.self, m = r.orders.market, rs = r.refunds.self, rm = r.refunds.market; + const MARKET_NAMES = {}; + root.querySelectorAll("tr[data-code]").forEach(function (tr) { MARKET_NAMES[tr.dataset.code] = tr.dataset.name; }); const disc = ["membership_discount_amount", "set_product_discount_amount", "app_discount_amount", "market_other_discount_amount", "shipping_fee_discount_amount"]; const coup = ["coupon_discount_price", "coupon_shipping_fee_amount"]; @@ -510,7 +512,7 @@ ["순매출(결제합계 − 환불합계)", s.total - rs.actual_refund_amount, m.total - rm.actual_refund_amount, "key"], ]); out.innerHTML = '" + + "" + rows.map(function (x) { const cls = x[3] === "key" ? ' class="perf-row-week"' : ""; const f = function (v) { return x[3] === "cnt" ? fmt(v) : won(v); }; @@ -520,9 +522,11 @@ ((r.by_market || []).length ? '

다른 마켓 연동 주문 — 마켓별

' + '
' + esc(r.date) + - "자체몰(실적 반영)다른 마켓 연동(제외)
자체몰(카페24 열)다른 마켓 연동(해당 쇼핑몰 열)
' + - "" + + '' + r.by_market.map(function (b) { + const col = MARKET_NAMES[b.target] || b.target; return '"; }).join("") + "
market_id주문경로주문수결제합계환불순매출
반영 열주문수결제합계환불순매출
' + esc(b.market_id) + "" + esc((b.names || []).join(", ")) + + "" + esc(col) + (b.target === "cafe24" ? ' (연결표 없음)' : "") + '' + fmt(b.orders) + '' + won(b.total) + '' + won(-b.refund_amount) + '' + won(b.total - b.refund_amount) + "
" diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index 727d81d..8ca3e34 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -49,7 +49,15 @@ - **기간 교체(`replace_range=True`)**: 결제·환불 모두 기간 안 날짜로 조회되므로 동기화 때 그 기간의 카페24 실데이터를 지우고 새로 넣는다(한 트랜잭션, 테스트 데이터 제외). 규칙이 바뀌어도 예전 행이 남지 않는다 → 규칙을 고친 뒤에는 같은 기간을 [과거 매출 가져오기]로 다시 받으면 된다. -- **자체몰 주문만**(`market_id` = self/빈값). 환불은 원 주문을 100건씩 조회해 `market_id` 로 판단. 네이버페이는 자체몰 주문. +- **마켓 연동 주문은 해당 쇼핑몰 열로**: 자체몰(`market_id` = self/빈값)은 카페24 열. 카페24 마켓 통합관리가 가져온 + 다른 마켓 주문은 `MARKET_MAP`(market_id 또는 order_place_id → 우리 쇼핑몰 코드)으로 네이버·쿠팡·11번가 등 열에 넣는다 + (`SaleEvent.marketplace_code`). 연결표에 없는 마켓은 카페24 열 — **전체 합계는 항상 카페24 일별 매출내역과 같다** + (9/28 대조로 자체몰+마켓 합계가 모든 줄에서 일치 확인). 환불은 원 주문을 100건씩 조회해 같은 열로. 네이버페이는 자체몰. +- 카페24 가 만든 사건 ID 는 모두 `c24:` 접두어(`event_prefix`) — 다시 받을 때 카페24 열 + 다른 열의 `c24:` 행만 교체해 + 그 쇼핑몰의 **직접 연동분은 건드리지 않는다**. 어떤 쇼핑몰을 직접 API 로 연동하면 같은 주문을 두 번 받지 않도록 그 마켓을 + `MARKET_MAP` 에서 빼야 한다. 설정 화면 API 설정 칸의 "카페24 경유" 표시 = 카페24 수집 때 함께 반영되는 쇼핑몰. +- 실제 market_id 값은 "카페24 매출 대조"의 마켓별 표(market_id / 주문경로 / 반영 열)로 확인하고, "(연결표 없음)"으로 나오는 + 마켓이 우리 쇼핑몰이면 `MARKET_MAP` 에 추가한다. - 60일 단위 분할(한 호출 3개월 미만), orders limit 1000 / refunds limit 500 페이지. 개인정보는 저장하지 않는다. - **카페24 매출 대조**(설정 화면, `GET /api/marketplaces/cafe24/reconcile?date=`): 그날 결제 주문·환불을 카페24 화면 열 순서대로 (주문수·품목수·상품구매금액·배송비·할인·쿠폰·결제합계·환불합계·순매출) 자체몰/다른 마켓으로 나눠 합산. 저장하지 않음.