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에서 다시 계산한 값(저장 안 함)도 함께 보여 줘, 저장값만 틀린 날(다시 가져오면 해결)과 + 규칙이 틀린 날을 나눠 볼 수 있습니다. 날짜를 누르면 위 대조를 그날로 엽니다.
+ +날짜가 있는 줄을 찾지 못했습니다. 카페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 "' + esc(summary) +
+ (r.live_error ? "
API 계산 실패: " + esc(r.live_error) : "") + "
차이 = 우리 값 − 카페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 값도 틀림 → 규칙 차이(결제/환불) → 날짜 클릭으로 그날 대조. ### 연동 단계 체크리스트(쇼핑몰마다)