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 = '| ' + esc(r.date) +
- " | 자체몰(카페24 열) | 다른 마켓 연동(해당 쇼핑몰 열) |
" +
+ "카페24 열(자체몰 채널) | 다른 쇼핑몰 열(외부 마켓) | " +
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 "| ' + esc(x[0]) +
' | ' + f(x[1]) + ' | ' + f(x[2]) + " |
";
}).join("") + "
" +
- ((r.by_market || []).length
- ? '다른 마켓 연동 주문 — 마켓별
' +
+ ((r.by_channel || []).length
+ ? '주문 채널별
' +
'| market_id | 주문경로 | ' +
- '반영 열 | 주문수 | 결제합계 | 환불 | 순매출 |
' +
- 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 '| ' + 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) + " |
";
}).join("") + "
"
: "") +
'";
+ "건 제외. \"알 수 없는 채널\"은 카페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건씩 조회해 같은 열로. 네이버페이는 자체몰.