From f63f82d64297cfd4839a06a284b27889d335fb2d Mon Sep 17 00:00:00 2001 From: king Date: Tue, 29 Sep 2026 16:59:16 +0900 Subject: [PATCH] =?UTF-8?q?fix(performance):=20=EC=B9=B4=ED=8E=9824=20mark?= =?UTF-8?q?et=5Fid=20=EC=9D=98=20=EC=9E=90=EC=B2=B4=EB=AA=B0=20=EC=B1=84?= =?UTF-8?q?=EB=84=90(=EB=AA=A8=EB=B0=94=EC=9D=BC=EC=9B=B9=C2=B7=EB=84=A4?= =?UTF-8?q?=EC=9D=B4=EB=B2=84=ED=8E=98=EC=9D=B4=C2=B7=ED=86=A1=EC=B2=B4?= =?UTF-8?q?=ED=81=AC=EC=95=84=EC=9B=83)=EC=9D=84=20=EC=9E=90=EC=B2=B4?= =?UTF-8?q?=EB=AA=B0=EB=A1=9C=20=EB=B6=84=EB=A5=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 실데이터 대조 결과 "다른 마켓 연동"으로 보이던 주문은 mobile(모바일웹)·NCHECKOUT(네이버페이)· KAKAOPAY(톡체크아웃) — 모두 카페24 자체몰 주문. 금액은 이미 카페24 열이었지만 대조 표시가 오해를 불렀다. - SELF_CHANNELS 로 자체몰 채널 명시, channel_kind(self/market/unknown) - MARKET_MAP 에서 결제수단과 헷갈리는 일반 이름(naver, kakao 등) 제거 - 매출 대조: "카페24 열 / 다른 쇼핑몰 열" + "주문 채널별" 표(자체몰 채널/외부 마켓/알 수 없는 채널) Co-Authored-By: Claude Opus 5.5 --- app/modules/performance/adapters/cafe24.py | 101 +++++++++++------- .../templates/performance/index.html | 2 +- .../templates/performance/settings.html | 2 +- .../performance/tests/test_performance.py | 22 ++-- app/static/performance.js | 16 +-- docs/PERFORMANCE_MODULE.md | 6 +- 6 files changed, 92 insertions(+), 57 deletions(-) diff --git a/app/modules/performance/adapters/cafe24.py b/app/modules/performance/adapters/cafe24.py index 1a63621..e6c2f71 100644 --- a/app/modules/performance/adapters/cafe24.py +++ b/app/modules/performance/adapters/cafe24.py @@ -48,34 +48,51 @@ REFUND_LIMIT = 500 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 / 주문경로 / 반영 열)로 확인해 보탠다. +# 카페24 자체몰 주문 채널 — market_id 는 외부 마켓만이 아니라 주문 채널·간편결제도 담는다 +# (실데이터 확인 2026-09-30: mobile=모바일웹, NCHECKOUT=네이버페이, KAKAOPAY=톡체크아웃). +# 이 주문들은 카페24 자체몰 매출이다. 비교는 소문자로. +SELF_CHANNELS: dict[str, str] = { + "": "자체몰", "self": "자체몰(PC)", "cafe24": "자체몰", "mobile": "모바일웹", "mobile_d": "모바일앱", + "ncheckout": "네이버페이", "kakaopay": "톡체크아웃", +} + +# 카페24 마켓 통합관리가 가져온 외부 마켓 주문의 market_id(또는 order_place_id) → 우리 쇼핑몰 열. +# 여기에도 SELF_CHANNELS 에도 없는 채널은 "알 수 없는 채널"로 카페24 열에 남긴다 — 전체 합계는 항상 +# 카페24 화면과 같다. 결제수단(네이버페이·카카오페이)과 헷갈릴 수 있는 일반 이름(naver, kakao)은 넣지 않는다. +# 실제 값은 설정 → "카페24 매출 대조"의 주문 채널별 표로 확인해 보탠다. MARKET_MAP: dict[str, str] = { - "shopn": "naver", "smartstore": "naver", "storefarm": "naver", "naver": "naver", + "shopn": "naver", "smartstore": "naver", "storefarm": "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", + "lotteon": "lotteon", + "gsshop": "gsshop", + "kakaotalkstore": "kakao", "talkstore": "kakao", "kakaostyle": "kakao", "ohouse": "ohouse", "todayhouse": "ohouse", "bucketplace": "ohouse", - "toss": "toss", "tossshopping": "toss", + "tossshopping": "toss", } +def _key(value: Any) -> str: + return str(value or "").strip().lower() + + +def channel_kind(market_id: Any, order_place_id: Any = None) -> str: + """self(자체몰 채널) / market(외부 마켓, 해당 쇼핑몰 열) / unknown(모르는 채널 → 카페24 열).""" + if market_id is None or _key(market_id) in SELF_CHANNELS: + return "self" + if _key(market_id) in MARKET_MAP or _key(order_place_id) in MARKET_MAP: + return "market" + return "unknown" + + def target_code(market_id: Any, order_place_id: Any = None) -> str: - """이 주문을 집계할 쇼핑몰 열. 자체몰·모르는 마켓은 카페24.""" - if is_self_market(market_id): + """이 주문을 집계할 쇼핑몰 열. 자체몰 채널·모르는 채널은 카페24.""" + if channel_kind(market_id, order_place_id) != "market": 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" + return MARKET_MAP.get(_key(market_id)) or MARKET_MAP[_key(order_place_id)] # 결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰 (initial_order_amount 의 필드) DISCOUNT_FIELDS = ("membership_discount_amount", "set_product_discount_amount", "app_discount_amount", @@ -118,7 +135,8 @@ def order_total(order: dict[str, Any]) -> int: def is_self_market(market_id: Any) -> bool: - return market_id in SELF_MARKETS + """카페24 자체몰 채널(PC·모바일·네이버페이·톡체크아웃 등)인가.""" + return channel_kind(market_id) == "self" def _chunks(start: date, end: date) -> Iterable[tuple[date, date]]: @@ -306,31 +324,37 @@ class Cafe24Adapter(MarketplaceAdapter): def reconcile(self, ctx: AdapterContext, day: date) -> dict[str, Any]: """그날 결제 주문·환불을 항목별로 합산 — 카페24 일별 매출내역과 비교해 규칙을 확정하는 용도. - 자체몰/다른 마켓을 나눠 합산한다. 개인정보는 담지 않는다. + groups["self"] = 카페24 열(자체몰 채널 + 알 수 없는 채널), groups["market"] = 다른 쇼핑몰 열로 가는 + 외부 마켓 주문. by_channel = 주문 채널(market_id)별 내역. 개인정보는 담지 않는다. """ self.authenticate(ctx) def empty() -> dict[str, int]: return {"orders": 0, "items": 0, "lines": 0, **{k: 0 for k in AMOUNT_FIELDS}, "total": 0} + def channel(mid: Any, place: Any) -> dict[str, Any]: + key = "" if mid is None else str(mid) + kind = channel_kind(mid, place) + return by_channel.setdefault(key, { + "market_id": key or "(없음)", "label": SELF_CHANNELS.get(_key(mid), ""), "names": set(), + "kind": kind, "target": target_code(mid, place), + "orders": 0, "total": 0, "refund_count": 0, "refund_amount": 0, + }) + groups = {"self": empty(), "market": empty()} - by_market: dict[str, dict[str, Any]] = {} # 다른 마켓 연동 주문 — market_id 별 + by_channel: dict[str, dict[str, Any]] = {} unpaid = 0 for o in self.paid_orders(ctx, day, day): if o.get("paid") != "T": unpaid += 1 continue - 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, - "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")): - if n: - bm["names"].add(str(n)) - g = groups["self" if is_self_market(o.get("market_id")) else "market"] + ch = channel(o.get("market_id"), o.get("order_place_id")) + ch["orders"] += 1 + ch["total"] += order_total(o) + for n in (o.get("order_place_name"), o.get("order_place_id")): + if n: + ch["names"].add(str(n)) + g = groups["self" if ch["target"] == "cafe24" else "market"] g["orders"] += 1 g["items"] += sum(int(i.get("quantity") or 0) for i in o.get("items") or []) g["lines"] += len(o.get("items") or []) @@ -343,19 +367,16 @@ class Cafe24Adapter(MarketplaceAdapter): "market": {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0}} for r in rows: mid, place = markets.get(str(r.get("order_id")), ("self", None)) - g = refunds["self" if is_self_market(mid) else "market"] + ch = channel(mid, place) + g = refunds["self" if ch["target"] == "cafe24" 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, - "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()), - key=lambda v: v["total"], reverse=True) + ch["refund_count"] += 1 + ch["refund_amount"] += _won(r.get("actual_refund_amount")) + channels_out = sorted(({**v, "names": sorted(v["names"])} for v in by_channel.values()), + key=lambda v: v["total"], reverse=True) return {"date": day.isoformat(), "orders": groups, "refunds": refunds, "unpaid_orders": unpaid, - "by_market": markets_out, + "by_channel": channels_out, "formula": "결제합계 = 상품구매금액 + 배송비 − 할인(" + ", ".join(DISCOUNT_FIELDS) + ") − 쿠폰(" + ", ".join(COUPON_FIELDS) + ")"} diff --git a/app/modules/performance/templates/performance/index.html b/app/modules/performance/templates/performance/index.html index 693e4b6..aa7df32 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 34b114e..bec4221 100644 --- a/app/modules/performance/templates/performance/settings.html +++ b/app/modules/performance/templates/performance/settings.html @@ -143,4 +143,4 @@ {% 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 70c9e5a..4bc9d5d 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -434,7 +434,8 @@ def test_cafe24_normalize_matches_daily_report(): ctx = AdapterContext(code="cafe24", credentials=None) fake = _FakeCafe24( [[_c24_order("A"), _c24_order("B", market="shopn"), _c24_order("C", paid="F"), - _c24_order("D", market="auction")]], + _c24_order("D", market="auction"), _c24_order("E", market="NCHECKOUT"), + _c24_order("F", market="KAKAOPAY"), _c24_order("G", market="mobile")]], [[_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"}, @@ -448,6 +449,9 @@ def test_cafe24_normalize_matches_daily_report(): # 마켓 연동 주문은 해당 쇼핑몰 열로, 연결표에 없는 마켓(옥션)은 카페24 열, 미결제는 제외 assert by[("SALE", "c24:B-PAY")].marketplace_code == "naver" assert by[("SALE", "c24:D-PAY")].marketplace_code == "cafe24" + # 네이버페이·톡체크아웃·모바일웹은 카페24 자체몰 주문(실데이터 확인) — 네이버/카카오 열로 가면 안 된다 + for oid in ("E", "F", "G"): + assert by[("SALE", f"c24:{oid}-PAY")].marketplace_code == "cafe24", oid assert ("SALE", "c24:C-PAY") not in by # 환불: 환불완료일, 실제 환불액, R→반품 / 그 밖→취소, 원 주문의 마켓 열로, 미완료 환불 제외 assert by[("CANCEL", "c24:C20260929-01")].amount == -12_610 @@ -462,14 +466,18 @@ def test_cafe24_normalize_matches_daily_report(): "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" - # 대조: 자체몰/마켓 나눠 합산 + 마켓별 반영 열 + assert target_code("NCHECKOUT", "NCHECKOUT") == "cafe24" and target_code("KAKAOPAY") == "cafe24" + assert target_code("naver") == "cafe24" and target_code("kakao") == "cafe24" # 결제수단과 헷갈리는 일반 이름 X + # 대조: 카페24 열(자체몰 채널+모르는 채널)/다른 쇼핑몰 열 + 주문 채널별 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"] == 2 and rec["unpaid_orders"] == 1 + assert rec["orders"]["self"]["orders"] == 5 and rec["orders"]["self"]["total"] == 5 * 47_000 # A,D,E,F,G + assert rec["orders"]["market"]["orders"] == 1 and rec["unpaid_orders"] == 1 # B(스마트스토어) assert rec["refunds"]["self"]["actual_refund_amount"] == 32_610 and rec["refunds"]["market"]["count"] == 1 - 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 + ch = {b["market_id"]: b for b in rec["by_channel"]} + assert ch["shopn"]["kind"] == "market" and ch["shopn"]["target"] == "naver" and ch["shopn"]["refund_amount"] == 9_000 + assert ch["auction"]["kind"] == "unknown" and ch["auction"]["target"] == "cafe24" + assert ch["NCHECKOUT"]["kind"] == "self" and ch["NCHECKOUT"]["label"] == "네이버페이" + assert ch["KAKAOPAY"]["label"] == "톡체크아웃" and ch["mobile"]["label"] == "모바일웹" # 60일 단위 분할 + 페이지 넘김(1000건이면 다음 페이지) page1 = [_c24_order(f"x-{i}") for i in range(1000)] fake2 = _FakeCafe24([page1, [_c24_order("y")]]) diff --git a/app/static/performance.js b/app/static/performance.js index 62b8520..b1dc828 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -512,27 +512,29 @@ ["순매출(결제합계 − 환불합계)", 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); }; return ""; }).join("") + "
' + esc(r.date) + - "자체몰(카페24 열)다른 마켓 연동(해당 쇼핑몰 열)
카페24 열(자체몰 채널)다른 쇼핑몰 열(외부 마켓)
' + esc(x[0]) + '' + f(x[1]) + '' + f(x[2]) + "
" + - ((r.by_market || []).length - ? '

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

' + + ((r.by_channel || []).length + ? '

주문 채널별

' + '' + - '' + - r.by_market.map(function (b) { + '' + + r.by_channel.map(function (b) { const col = MARKET_NAMES[b.target] || b.target; + const kind = b.kind === "self" ? "자체몰 채널" + (b.label ? "(" + b.label + ")" : "") + : b.kind === "market" ? "외부 마켓" : '알 수 없는 채널'; return '"; }).join("") + "
market_id주문경로반영 열주문수결제합계환불순매출
구분반영 열주문수결제합계환불순매출
' + esc(b.market_id) + "" + esc((b.names || []).join(", ")) + - "" + esc(col) + (b.target === "cafe24" ? ' (연결표 없음)' : "") + + "" + (b.kind === "unknown" ? kind : esc(kind)) + "" + esc(col) + '' + fmt(b.orders) + '' + won(b.total) + '' + won(-b.refund_amount) + '' + won(b.total - b.refund_amount) + "
" : "") + '

' + esc(r.formula) + ". 미결제 주문 " + fmt(r.unpaid_orders) + - "건 제외. 카페24 화면과 다른 줄이 있으면 알려 주세요 — 규칙을 맞추겠습니다.

"; + "건 제외. \"알 수 없는 채널\"은 카페24 열에 넣습니다 — 외부 마켓이면 어느 쇼핑몰인지 알려 주세요.

"; } catch (err) { out.innerHTML = '

' + esc(err.message) + "

"; } finally { recon.disabled = false; } diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index 8ca3e34..3f5751b 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -49,7 +49,11 @@ - **기간 교체(`replace_range=True`)**: 결제·환불 모두 기간 안 날짜로 조회되므로 동기화 때 그 기간의 카페24 실데이터를 지우고 새로 넣는다(한 트랜잭션, 테스트 데이터 제외). 규칙이 바뀌어도 예전 행이 남지 않는다 → 규칙을 고친 뒤에는 같은 기간을 [과거 매출 가져오기]로 다시 받으면 된다. -- **마켓 연동 주문은 해당 쇼핑몰 열로**: 자체몰(`market_id` = self/빈값)은 카페24 열. 카페24 마켓 통합관리가 가져온 +- **주의 — `market_id` 는 외부 마켓만이 아니라 자체몰 주문 채널·간편결제도 담는다**(실데이터 확인 2026-09-30: + `mobile`=모바일웹, `NCHECKOUT`=네이버페이, `KAKAOPAY`=톡체크아웃). 이들은 `SELF_CHANNELS` 로 카페24 열. + 대조 도구의 "주문 채널별" 표가 채널마다 자체몰 채널 / 외부 마켓 / 알 수 없는 채널(→ 카페24 열)을 보여 준다. + `MARKET_MAP` 에는 결제수단과 헷갈릴 수 있는 일반 이름(naver, kakao)을 넣지 않는다. +- **마켓 연동 주문은 해당 쇼핑몰 열로**: 자체몰 채널은 카페24 열. 카페24 마켓 통합관리가 가져온 다른 마켓 주문은 `MARKET_MAP`(market_id 또는 order_place_id → 우리 쇼핑몰 코드)으로 네이버·쿠팡·11번가 등 열에 넣는다 (`SaleEvent.marketplace_code`). 연결표에 없는 마켓은 카페24 열 — **전체 합계는 항상 카페24 일별 매출내역과 같다** (9/28 대조로 자체몰+마켓 합계가 모든 줄에서 일치 확인). 환불은 원 주문을 100건씩 조회해 같은 열로. 네이버페이는 자체몰.