From 614332a1e6895e35c1038c388348a6331ef1cefb Mon Sep 17 00:00:00 2001 From: king Date: Tue, 29 Sep 2026 21:36:32 +0900 Subject: [PATCH] =?UTF-8?q?feat(performance):=20=EC=B9=B4=ED=8E=9824=20?= =?UTF-8?q?=EC=9D=BC=EB=B3=84=20=EB=A7=A4=EC=B6=9C=EB=82=B4=EC=97=AD=20?= =?UTF-8?q?=EB=B6=99=EC=97=AC=EB=84=A3=EA=B8=B0=EB=A1=9C=20=EB=82=A0?= =?UTF-8?q?=EC=A7=9C=EB=B3=84=20=ED=95=9C=20=EB=B2=88=EC=97=90=20=EB=B9=84?= =?UTF-8?q?=EA=B5=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 카페24 화면과 몇몇 날짜만 안 맞는데 어느 날·어느 쪽(결제/환불)인지, 저장값이 예전 규칙이라서인지 규칙 자체가 틀린 건지 구분할 방법이 없었다. - GET /performance/api/marketplaces/{code}/daily-check?from=&to=&live=1 (관리자, 62일) db = 저장된 날짜별 결제합계·결제 건수·환불합계(c24: 사건 전체 = 카페24 화면 범위) live = 지금 API·현재 규칙으로 다시 계산(adapter.collect, 저장 안 함) - 설정 → 카페24 매출 대조 카드에 "일별 한 번에 비교": 카페24 표 붙여넣기 → 날짜별 차이(저장값/API), 판정(일치 / 다시 가져오면 해결 / 규칙 차이(결제·환불)), [다시 가져오기] 버튼, 날짜 클릭 시 그날 상세 대조 - 테스트 추가 Co-Authored-By: Claude Opus 5.5 --- app/modules/performance/db.py | 19 ++++ app/modules/performance/router.py | 18 +++ app/modules/performance/sync.py | 33 ++++++ .../templates/performance/index.html | 4 +- .../templates/performance/settings.html | 16 ++- .../performance/tests/test_performance.py | 42 +++++++ app/static/performance.css | 5 + app/static/performance.js | 104 ++++++++++++++++++ docs/PERFORMANCE_MODULE.md | 4 + 9 files changed, 241 insertions(+), 4 deletions(-) diff --git a/app/modules/performance/db.py b/app/modules/performance/db.py index 1a4180c..5ae6763 100644 --- a/app/modules/performance/db.py +++ b/app/modules/performance/db.py @@ -292,6 +292,25 @@ class PerformanceDBStore: ).fetchall() return {(r["sales_date"], r["marketplace_code"]): int(r["amount"] or 0) for r in rows} + def daily_breakdown(self, code: str, start: date, end: date, *, id_prefix: str = "") -> list[dict[str, Any]]: + """쇼핑몰 화면(일별 매출내역) 대조용 — 날짜별 결제(SALE 합·건수)·환불(그 밖, 양수)·마지막 수집 시각. + id_prefix 가 있으면 이 어댑터가 다른 쇼핑몰 열로 보낸 사건까지 합친다(카페24 화면 합계와 같은 범위).""" + where = "(marketplace_code = %s OR left(external_event_id, %s) = %s)" if id_prefix else "marketplace_code = %s" + params: tuple = (code, len(id_prefix), id_prefix) if id_prefix else (code,) + with self._pool.connection() as conn: + rows = conn.execute( + "SELECT sales_date, " + " COALESCE(SUM(amount) FILTER (WHERE event_type = 'SALE'), 0)::BIGINT AS paid, " + " COUNT(*) FILTER (WHERE event_type = 'SALE')::INT AS orders, " + " COALESCE(-SUM(amount) FILTER (WHERE event_type <> 'SALE'), 0)::BIGINT AS refund, " + " MAX(synced_at) AS synced_at " + f"FROM perf_sales_events WHERE is_sample = FALSE AND sales_date BETWEEN %s AND %s AND {where} " + "GROUP BY sales_date ORDER BY sales_date", + (start, end, *params), + ).fetchall() + return [{"date": r["sales_date"].isoformat(), "paid": int(r["paid"]), "orders": int(r["orders"]), + "refund": int(r["refund"]), "synced_at": _iso(r["synced_at"])} for r in rows] + def list_events(self, code: str, start: date, end: date, *, limit: int = 500) -> list[dict[str, Any]]: """금액 클릭 상세(Drill-down). raw_data 는 보내지 않는다.""" with self._pool.connection() as conn: diff --git a/app/modules/performance/router.py b/app/modules/performance/router.py index 83f5bb6..e7e408c 100644 --- a/app/modules/performance/router.py +++ b/app/modules/performance/router.py @@ -11,6 +11,7 @@ JSON API — 관리자 POST /performance/api/marketplaces/{code}/rates 수수료율(적용 시작일) DELETE /performance/api/marketplaces/{code}/rates/{id} GET /performance/api/marketplaces/{code}/credentials 입력칸 + 저장 여부(비밀 원문 없음) + GET /performance/api/marketplaces/{code}/daily-check 일별 매출 비교(저장값 + 지금 API 값) PUT /performance/api/marketplaces/{code}/credentials 저장(암호화) POST /performance/api/marketplaces/{code}/test 연결 테스트(저장값 또는 새 입력값) POST /performance/api/sample-data 테스트 데이터 생성/삭제 @@ -36,6 +37,7 @@ from .adapters.registry import all_adapters, get_adapter router = APIRouter(prefix="/performance", tags=["performance"]) MAX_EVENT_DAYS = 31 +MAX_CHECK_DAYS = 62 # 쇼핑몰 화면 일별 비교(카페24 일별 매출내역 붙여넣기) MAX_BACKFILL_DAYS = 366 MAX_USER_SYNC_DAYS = 92 # 관리자가 아니어도 가져올 수 있는 기간(이번달·직접선택 짧은 기간) @@ -286,6 +288,22 @@ def api_reconcile(request: Request, code: str, date_: str = Query(..., alias="da return JSONResponse(sync.reconcile(code, day, user=user["email"])) +@router.get("/api/marketplaces/{code}/daily-check") +def api_daily_check(request: Request, code: str, from_: str = Query(..., alias="from"), to: str | None = None, + live: bool = False) -> JSONResponse: + """쇼핑몰 화면 일별 매출과 날짜별 비교 — 저장값(db) + live=1 이면 지금 API 로 다시 계산한 값(저장 안 함).""" + store, user = common.require_store(request, admin=True) + _code_or_404(store, code) + start = _parse_date(from_) + end = _parse_date(to) or start + if end < start: + start, end = end, start + if (end - start).days + 1 > MAX_CHECK_DAYS: + raise HTTPException(status_code=400, detail=f"일별 비교는 {MAX_CHECK_DAYS}일 이내만 가능합니다.") + _, sync = common.services(request, store) + return JSONResponse(sync.daily_check(code, start, end, live=live, user=user["email"])) + + @router.post("/api/sample-data") def api_sample_data(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse: store, _ = common.require_store(request, admin=True) diff --git a/app/modules/performance/sync.py b/app/modules/performance/sync.py index e53e2c7..b0c1792 100644 --- a/app/modules/performance/sync.py +++ b/app/modules/performance/sync.py @@ -152,6 +152,39 @@ class SyncService: status, message = self._failure(exc, ctx) return {"ok": False, "status": status, "label": STATUS_LABELS.get(status, status), "message": message} + def daily_check(self, code: str, start: date, end: date, *, live: bool = False, user: str = "") -> dict[str, Any]: + """쇼핑몰 화면 일별 매출과 날짜별로 맞춰 보는 용도. DB 는 바꾸지 않는다. + db = 지금 저장된 값(날짜별 결제·환불·결제 건수) + live = live=True 일 때 지금 API·현재 규칙으로 다시 계산한 값(매출 업데이트와 같은 계산, 저장 안 함). + db 만 틀리고 live 가 맞으면 → 예전에 받은 뒤 규칙·주문이 바뀐 것(다시 가져오면 해결).""" + adapter = get_adapter(code) + if adapter is None: + return {"ok": False, "message": "알 수 없는 쇼핑몰입니다."} + prefix = adapter.event_prefix if adapter.replace_range else "" + out: dict[str, Any] = {"ok": True, "db": self._store.daily_breakdown(code, start, end, id_prefix=prefix)} + if not live: + return out + ctx = None + try: + ctx = self._ctx(adapter, user=user) + _, events = adapter.collect(ctx, start, end) + except Exception as exc: # noqa: BLE001 + status, message = self._failure(exc, ctx) + return {**out, "live_error": f"{STATUS_LABELS.get(status, status)} — {message}"} + days: dict[str, dict[str, Any]] = {} + for ev in events: + d = sales_date_for(ev) + if not (start <= d <= end): + continue + row = days.setdefault(d.isoformat(), {"date": d.isoformat(), "paid": 0, "orders": 0, "refund": 0}) + if ev.event_type == "SALE": + row["paid"] += ev.amount + row["orders"] += 1 + else: + row["refund"] -= ev.amount + out["live"] = sorted(days.values(), key=lambda r: r["date"]) + return out + # ── 테스트(모의) 데이터 ──────────────────────────────── def generate_samples(self, start: date, end: date, codes: list[str]) -> int: from .adapters import mock # noqa: WPS433 diff --git a/app/modules/performance/templates/performance/index.html b/app/modules/performance/templates/performance/index.html index b66215f..4e803cd 100644 --- a/app/modules/performance/templates/performance/index.html +++ b/app/modules/performance/templates/performance/index.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {%- macro won(v) -%} {%- if v is none -%} @@ -239,4 +239,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 5664b04..cd9c2e9 100644 --- a/app/modules/performance/templates/performance/settings.html +++ b/app/modules/performance/templates/performance/settings.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {%- macro when(v) -%}{{ (v or '')[:16] | replace('T', ' ') or '—' }}{%- endmacro -%} @@ -125,6 +125,18 @@
+ +

일별 한 번에 비교

+

카페24 일별 매출내역 표를 그대로 복사해 붙여 넣으면 날짜마다 결제합계·환불합계를 저장된 값과 비교합니다. + [API 값도 계산]을 켜면 지금 규칙으로 카페24에서 다시 계산한 값(저장 안 함)도 함께 보여 줘, 저장값만 틀린 날(다시 가져오면 해결)과 + 규칙이 틀린 날을 나눠 볼 수 있습니다. 날짜를 누르면 위 대조를 그날로 엽니다.

+ +
+ + +
+
@@ -143,4 +155,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 915eeb9..d8f7a8a 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -252,6 +252,22 @@ class FakeStore: if not (mine(k, v) and not v["is_sample"] and start <= v["sales_date"] <= end)} return self.upsert_events(code, events) + def daily_breakdown(self, code, start, end, *, id_prefix=""): + days = {} + for (c, _, eid), v in self.events.items(): + if v["is_sample"] or not (start <= v["sales_date"] <= end): + continue + if not (c == code or (id_prefix and eid.startswith(id_prefix))): + continue + r = days.setdefault(v["sales_date"].isoformat(), {"date": v["sales_date"].isoformat(), "paid": 0, + "orders": 0, "refund": 0, "synced_at": None}) + if v["event_type"] == "SALE": + r["paid"] += v["amount"] + r["orders"] += 1 + else: + r["refund"] -= v["amount"] + return sorted(days.values(), key=lambda r: r["date"]) + def upsert_events(self, code, events, *, is_sample=False): n = 0 for e in events: @@ -634,6 +650,32 @@ def test_cafe24_scope_and_replace_range(): ("naver", "direct-naver-1"), ("cafe24", "sample")}, got +def test_daily_check_db_vs_live(): + """일별 비교: 저장값(카페24 경유 다른 마켓 열 포함) + 지금 API 값(저장 안 함).""" + import app.modules.performance.sync as syncmod + + st = FakeStore() + d = date(2026, 9, 29) + ev = lambda eid, t, amt, **kw: {"event_type": t, "external_event_id": eid, "external_order_id": "o", + "event_date": d, "sales_date": d, "amount": amt, **kw} + st.upsert_events("cafe24", [ev("c24:A-PAY", "SALE", 40_000), ev("c24:R1", "CANCEL", -5_000)]) + st.upsert_events("naver", [ev("c24:B-PAY", "SALE", 10_000), ev("direct-1", "SALE", 99_999)]) + fake = _FakeCafe24([[_c24_order("A"), _c24_order("B", market="shopn"), _c24_order("C")]], + [[_c24_refund("C20260929-01", "A", 7_000)]]) + orig = syncmod.get_adapter + syncmod.get_adapter = lambda c: fake + try: + svc = SyncService(st, CredentialService(st, lambda: ring())) + only_db = svc.daily_check("cafe24", d, d) + both = svc.daily_check("cafe24", d, d, live=True) + finally: + syncmod.get_adapter = orig + assert "live" not in only_db + assert both["db"] == [{"date": "2026-09-29", "paid": 50_000, "orders": 2, "refund": 5_000, "synced_at": None}] + assert both["live"] == [{"date": "2026-09-29", "paid": 3 * 47_000, "orders": 3, "refund": 7_000}] + assert len(st.events) == 4 # 저장값은 바뀌지 않음 + + def test_registry_and_event_validation(): codes = [a.code for a in all_adapters()] assert len(codes) == len(set(codes)) == 10 diff --git a/app/static/performance.css b/app/static/performance.css index d30ba31..2bf3cfb 100644 --- a/app/static/performance.css +++ b/app/static/performance.css @@ -210,3 +210,8 @@ td.is-link:hover { background: #eef2ff; text-decoration: underline; } } .perf-table tr.perf-row-match > *{background:#e7f6ec;font-weight:600} +.perf-paste { width: 100%; min-height: 96px; font-family: ui-monospace, Consolas, monospace; font-size: 12px; white-space: pre; resize: vertical; box-sizing: border-box; } +.perf-table tr.perf-row-diff > * { background: #fff7f5; } +.perf-diff-bad { color: var(--perf-down); font-weight: 600; } +.perf-diff-ok { color: #0f8a3a; } +.perf-link { background: none; border: 0; padding: 0; color: inherit; font: inherit; text-decoration: underline dotted; cursor: pointer; } diff --git a/app/static/performance.js b/app/static/performance.js index ecf11f6..13e1d8a 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -663,6 +663,110 @@ } finally { recon.disabled = false; } }); + // ── 일별 한 번에 비교 — 카페24 일별 매출내역 붙여넣기 ↔ 저장값 ↔ 지금 API 값 ── + // 붙여넣은 한 줄: "2026-09-29(화) 주문수 품목수 … 결제합계 환불합계 순매출" — 뒤의 세 숫자와 첫 숫자(주문수)만 쓴다. + function parseDaily(text) { + const out = {}; + String(text || "").split(/\r?\n/).forEach(function (line) { + const m = line.match(/(\d{4})[-./](\d{2})[-./](\d{2})/); + if (!m) return; + const nums = (line.slice(m.index + m[0].length).match(/-?\d[\d,]*/g) || []) + .map(function (x) { return parseInt(x.replace(/,/g, ""), 10); }); + if (nums.length < 3) return; + const n = nums.length; + out[m[1] + "-" + m[2] + "-" + m[3]] = { orders: n >= 13 ? nums[0] : null, paid: nums[n - 3], refund: nums[n - 2], net: nums[n - 1] }; + }); + return out; + } + const dailyBtn = document.getElementById("perf-daily-check"); + if (dailyBtn) dailyBtn.addEventListener("click", async function () { + const out = document.getElementById("perf-daily-result"); + const shop = parseDaily(document.getElementById("perf-daily-paste").value); + const dates = Object.keys(shop).sort(); + if (!dates.length) { out.innerHTML = '

날짜가 있는 줄을 찾지 못했습니다. 카페24 일별 매출내역 표를 복사해 붙여 넣으세요.

'; return; } + const live = document.getElementById("perf-daily-live").checked; + dailyBtn.disabled = true; + out.innerHTML = '

' + (live ? "저장값과 카페24 API 값을 계산하는 중… (기간이 길면 1~2분)" : "저장값을 불러오는 중…") + "

"; + try { + const from = dates[0], to = dates[dates.length - 1]; + const r = await api("GET", "/performance/api/marketplaces/cafe24/daily-check?from=" + from + "&to=" + to + (live ? "&live=1" : "")); + if (!r.ok) { out.innerHTML = '

' + esc(r.message) + "

"; return; } + const byDate = function (rows) { const o = {}; (rows || []).forEach(function (x) { o[x.date] = x; }); return o; }; + const db = byDate(r.db), lv = r.live ? byDate(r.live) : null; + const zero = { paid: 0, refund: 0, orders: 0 }; + const diff = function (ours, theirs) { + const d = ours - theirs; + return d === 0 ? '✓' : '' + (d > 0 ? "+" : "") + fmt(d) + ""; + }; + const todayIso = today(); + let bad = 0, stale = 0, rule = 0; + const sum = { cp: 0, cr: 0, dp: 0, dr: 0, lp: 0, lr: 0 }; + const body = dates.slice().reverse().map(function (d) { + const c = shop[d], x = db[d] || zero, l = lv ? (lv[d] || zero) : null; + sum.cp += c.paid; sum.cr += c.refund; sum.dp += x.paid; sum.dr += x.refund; + if (l) { sum.lp += l.paid; sum.lr += l.refund; } + const dbOk = x.paid === c.paid && x.refund === c.refund; + const liveOk = l && l.paid === c.paid && l.refund === c.refund; + let verdict; + if (dbOk) verdict = '일치'; + else if (l && liveOk) { verdict = '다시 가져오면 해결'; stale++; } + else if (l) { + const what = [l.paid !== c.paid ? "결제" : "", l.refund !== c.refund ? "환불" : ""].filter(Boolean).join("·"); + verdict = '규칙 차이(' + what + ")"; rule++; + } else verdict = '차이'; + if (!dbOk) bad++; + const wd = "일월화수목금토"[new Date(d + "T00:00:00").getDay()]; + return "" + (d === todayIso ? ' 오늘·집계 중' : "") + "" + + '' + (c.orders == null ? "–" : fmt(c.orders)) + ' / ' + fmt(x.orders) + (l ? " / " + fmt(l.orders) : "") + "" + + '' + won(c.paid) + '' + diff(x.paid, c.paid) + "" + (l ? '' + diff(l.paid, c.paid) + "" : "") + + '' + won(c.refund) + '' + diff(x.refund, c.refund) + "" + (l ? '' + diff(l.refund, c.refund) + "" : "") + + "" + verdict + (x.synced_at ? '
저장 ' + esc(String(x.synced_at).slice(5, 16).replace("T", " ")) + "
" : "") + ""; + }).join(""); + const head = '날짜주문수 카페24 / 저장' + (lv ? " / API" : "") + "" + + "결제합계(카페24)저장값 차이" + (lv ? "API 차이" : "") + + "환불합계(카페24)저장값 차이" + (lv ? "API 차이" : "") + '판정'; + const foot = '합계' + won(sum.cp) + '' + + diff(sum.dp, sum.cp) + "" + (lv ? '' + diff(sum.lp, sum.cp) + "" : "") + '' + won(sum.cr) + + '' + diff(sum.dr, sum.cr) + "" + (lv ? '' + diff(sum.lr, sum.cr) + "" : "") + ""; + const summary = bad + ? "저장값이 다른 날 " + bad + "일" + (lv ? " — 다시 가져오면 해결 " + stale + "일, 규칙 차이 " + rule + "일" : " — [API 값도 계산]을 켜고 다시 비교하면 원인을 나눠 볼 수 있습니다") + : "모든 날짜가 일치합니다."; + out.innerHTML = '

' + esc(summary) + + (r.live_error ? "
API 계산 실패: " + esc(r.live_error) : "") + "

" + + (stale ? '
" : "") + + '' + head + "" + body + "" + foot + "
" + + '

차이 = 우리 값 − 카페24 값. 저장값은 카페24 열과 카페24 경유 다른 마켓 열을 합친 금액(카페24 화면과 같은 범위)입니다.

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

' + esc(err.message) + "

"; + } finally { dailyBtn.disabled = false; } + }); + const dailyOut = document.getElementById("perf-daily-result"); + if (dailyOut) dailyOut.addEventListener("click", async function (e) { + const dayBtn = e.target.closest("[data-recon-day]"); + if (dayBtn && recon) { + document.getElementById("perf-recon-date").value = dayBtn.dataset.reconDay; + recon.click(); + recon.scrollIntoView({ behavior: "smooth", block: "center" }); + return; + } + const rs = e.target.closest("#perf-daily-resync"); + if (!rs) return; + if (!(await confirmMsg(rs.dataset.from + " ~ " + rs.dataset.to + " 카페24 매출을 지금 규칙으로 다시 가져옵니다."))) return; + rs.disabled = true; + rs.textContent = "가져오는 중…"; + try { + const res = await api("POST", "/performance/api/sync", { from: rs.dataset.from, to: rs.dataset.to, codes: ["cafe24"] }); + const r0 = (res.results || [])[0]; + if (r0 && !r0.ok) throw new Error((r0.label || r0.status) + ": " + (r0.message || "")); + dailyBtn.click(); + } catch (err) { + alertMsg("다시 가져오기 실패: " + err.message); + rs.disabled = false; + } + }); + // ── 과거 매출 가져오기(기간 지정 수집, 관리자) ── const backfill = document.getElementById("perf-backfill"); if (backfill) backfill.addEventListener("click", async function () { diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index db2e070..0da9a2b 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -67,6 +67,10 @@ - **카페24 매출 대조**(설정 화면, `GET /api/marketplaces/cafe24/reconcile?date=`): 그날 결제 주문·환불을 카페24 화면 열 순서대로 (주문수·품목수·상품구매금액·배송비·할인·쿠폰·결제합계·환불합계·순매출) 자체몰/다른 마켓으로 나눠 합산. 저장하지 않음. 카페24 화면과 다른 줄이 있으면 할인 항목 구성·마켓 포함 여부를 이 결과로 조정한다. +- **일별 한 번에 비교**(같은 카드, `GET /api/marketplaces/{code}/daily-check?from=&to=&live=1`, 최대 62일): 카페24 일별 + 매출내역 표를 붙여 넣으면(날짜 + 뒤 세 숫자 = 결제합계·환불합계·순매출, 첫 숫자 = 주문수) 날짜마다 저장값(`c24:` 사건 전체, + 다른 마켓 열 포함)과 지금 API·현재 규칙으로 다시 계산한 값(`adapter.collect`, 저장 안 함)을 비교한다. + 저장값만 틀림 → 예전 규칙으로 받은 것([다시 가져오기] 버튼), API 값도 틀림 → 규칙 차이(결제/환불) → 날짜 클릭으로 그날 대조. ### 연동 단계 체크리스트(쇼핑몰마다)