From da63b933026d0e4a161a9753e524a5c9699f9c75 Mon Sep 17 00:00:00 2001 From: king Date: Wed, 30 Sep 2026 15:06:25 +0900 Subject: [PATCH] =?UTF-8?q?feat(performance):=20=EB=A7=A4=EC=B6=9C=20?= =?UTF-8?q?=EC=97=85=EB=8D=B0=EC=9D=B4=ED=8A=B8=20=EC=B7=A8=EC=86=8C=20?= =?UTF-8?q?=EB=B2=84=ED=8A=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 진행 창 [업데이트 취소](시작한 사람·관리자) → POST /api/sync/jobs/{id}/cancel - 어댑터가 API 호출 직전마다 ctx.progress.check() — 취소면 Cancelled 로 멈추고 저장하지 않음(기존 매출 그대로), 차례가 안 온 쇼핑몰은 취소됨으로 건너뜀, 이미 끝난 쇼핑몰 결과는 유지 - 취소 실행은 perf_sync_runs failed + 업데이트 취소, 연결 상태는 바꾸지 않음 - 테스트 1개 추가(30개 통과), performance.js/css 캐시 버전, 문서 갱신 Co-Authored-By: Claude Opus 5.5 --- app/modules/performance/adapters/base.py | 12 ++++- app/modules/performance/adapters/cafe24.py | 1 + app/modules/performance/adapters/elevenst.py | 1 + app/modules/performance/adapters/gsshop.py | 1 + app/modules/performance/adapters/naver.py | 1 + app/modules/performance/jobs.py | 43 +++++++++++++---- app/modules/performance/router.py | 19 ++++++++ app/modules/performance/sync.py | 11 ++++- .../templates/performance/index.html | 4 +- .../templates/performance/settings.html | 4 +- .../performance/tests/test_performance.py | 45 +++++++++++++++++ app/static/performance.css | 5 ++ app/static/performance.js | 48 ++++++++++++++++--- docs/PERFORMANCE_MODULE.md | 4 ++ 14 files changed, 178 insertions(+), 21 deletions(-) diff --git a/app/modules/performance/adapters/base.py b/app/modules/performance/adapters/base.py index f9496ac..c4ebef5 100644 --- a/app/modules/performance/adapters/base.py +++ b/app/modules/performance/adapters/base.py @@ -32,6 +32,7 @@ STATUS_LABELS: dict[str, str] = { "not_implemented": "연동 준비 중", "unknown": "확인 전", "disabled": "사용 중지", # DB 에는 저장하지 않는 화면 전용 상태(쇼핑몰 사용 OFF) + "cancelled": "취소됨", # 화면 전용 — 매출 업데이트 창에서 [업데이트 취소](연결 상태는 바꾸지 않음) } EVENT_TYPES = ("SALE", "CANCEL", "RETURN", "ADJUST") @@ -68,6 +69,11 @@ class NotImplementedYet(AdapterError): status = "not_implemented" +class Cancelled(AdapterError): + """사용자가 매출 업데이트를 취소함 — 어댑터가 ctx.progress.check() 에서 받는다. 연결 오류가 아니다.""" + status = "cancelled" + + # ════════════════════════════════════════════════════════════ # 설정 입력칸 · 공통 매출 사건 # ════════════════════════════════════════════════════════════ @@ -135,7 +141,8 @@ class Progress: 객체(jobs.ShopProgress)로 바꿔 넣는다. 어댑터: 조회를 시작하기 전에 plan(전체 단계 수, 단위) → 단계 하나(하루·조회 구간)를 끝낼 때마다 - step(items=그 단계에서 받은 건수). 하다가 할 일이 늘면 add(늘어난 단계 수).""" + step(items=그 단계에서 받은 건수). 하다가 할 일이 늘면 add(늘어난 단계 수). + API 를 부르기 직전마다 check() — 사용자가 [업데이트 취소]를 눌렀으면 Cancelled 를 던져 거기서 멈춘다.""" def plan(self, total: int, unit: str = "단계") -> None: return None @@ -146,6 +153,9 @@ class Progress: def step(self, n: int = 1, *, items: int = 0) -> None: return None + def check(self) -> None: + return None + @dataclass class AdapterContext: diff --git a/app/modules/performance/adapters/cafe24.py b/app/modules/performance/adapters/cafe24.py index 5df8ad4..3c3d4b1 100644 --- a/app/modules/performance/adapters/cafe24.py +++ b/app/modules/performance/adapters/cafe24.py @@ -291,6 +291,7 @@ class Cafe24Adapter(MarketplaceAdapter): if offset > MAX_OFFSET: raise ApiError(f"카페24 조회 건수가 너무 많습니다({params.get('start_date')}~{params.get('end_date')}). " "기간을 줄여 다시 시도하세요.") + ctx.progress.check() # [업데이트 취소]면 여기서 멈춤 rows = self._get(ctx, path, {**params, "limit": limit, "offset": offset}).get(key) or [] yield from rows if len(rows) < limit: diff --git a/app/modules/performance/adapters/elevenst.py b/app/modules/performance/adapters/elevenst.py index a5936d5..9cb0d05 100644 --- a/app/modules/performance/adapters/elevenst.py +++ b/app/modules/performance/adapters/elevenst.py @@ -270,6 +270,7 @@ class ElevenstAdapter(MarketplaceAdapter): def _get(self, ctx: AdapterContext, path: str) -> bytes: import httpx # 지연 import + ctx.progress.check() # [업데이트 취소]면 여기서 멈춤 headers = {"openapikey": ctx.credentials.get("api_key").strip(), "Accept": "application/xml"} try: res = httpx.get(f"{HOST}{path}", headers=headers, timeout=ctx.timeout_sec) diff --git a/app/modules/performance/adapters/gsshop.py b/app/modules/performance/adapters/gsshop.py index 68a5a7e..f71ffdc 100644 --- a/app/modules/performance/adapters/gsshop.py +++ b/app/modules/performance/adapters/gsshop.py @@ -166,6 +166,7 @@ class GsshopAdapter(MarketplaceAdapter): from app.timezone import now_kst # noqa: WPS433 + ctx.progress.check() # [업데이트 취소]면 여기서 멈춤 sup, key = self._creds(ctx) key_bytes = dict(key_variants(key))[how[0]] headers = {"supCd": sup, "token": make_token(key_bytes, sup, now_kst(), how[1]), "Accept": "application/json"} diff --git a/app/modules/performance/adapters/naver.py b/app/modules/performance/adapters/naver.py index 92d4ef2..ab9f5b1 100644 --- a/app/modules/performance/adapters/naver.py +++ b/app/modules/performance/adapters/naver.py @@ -298,6 +298,7 @@ class NaverAdapter(MarketplaceAdapter): retried_auth = False for attempt in range(RETRY_429 + 1): + ctx.progress.check() # [업데이트 취소]면 여기서 멈춤 wait = CALL_INTERVAL_SEC - (time.monotonic() - self._last_call) if wait > 0: time.sleep(wait) diff --git a/app/modules/performance/jobs.py b/app/modules/performance/jobs.py index 1dda5be..267055e 100644 --- a/app/modules/performance/jobs.py +++ b/app/modules/performance/jobs.py @@ -6,6 +6,9 @@ 네이버 "일", 11번가·카페24 "구간"). - 웹 프로세스 하나(uvicorn 단일 워커) 기준 — 워커를 여러 개로 늘리면 진행 상황을 DB 로 옮겨야 한다. 서버를 다시 켜면 진행 중 작업 정보는 사라진다(수집 결과는 DB 에 이미 저장된 만큼 남음). +- [업데이트 취소]: SyncJob.cancel() → 각 쇼핑몰이 다음 API 호출 직전(ShopProgress.check)에 Cancelled 로 멈춘다. + 수집 중에 멈춘 쇼핑몰은 DB 에 아무것도 쓰지 않는다(저장은 수집이 끝난 뒤 한 트랜잭션). 저장 중이면 그 저장은 끝낸다. + 아직 차례가 안 온 쇼핑몰은 "취소됨"으로 건너뛴다. """ from __future__ import annotations @@ -16,7 +19,7 @@ import uuid from datetime import date from typing import Any -from .adapters.base import Progress +from .adapters.base import Cancelled, Progress MAX_JOBS = 20 _LOCK = threading.Lock() @@ -27,10 +30,10 @@ PASSIVE_STATUS = frozenset({"not_implemented", "not_configured"}) class ShopProgress(Progress): - """쇼핑몰 하나의 진행 상황. state: waiting → running → saving → done | error | skipped.""" + """쇼핑몰 하나의 진행 상황. state: waiting → running → saving → done | error | skipped | cancelled.""" - def __init__(self, code: str, name: str, *, active: bool = True) -> None: - self.code, self.name, self.active = code, name, active + def __init__(self, code: str, name: str, *, active: bool = True, job: "SyncJob | None" = None) -> None: + self.code, self.name, self.active, self.job = code, name, active, job self.state = "waiting" self.done = self.total = self.items = self.upserted = 0 self.unit = "단계" @@ -47,7 +50,16 @@ class ShopProgress(Progress): with self._lock: self.total += max(0, int(n)) + def check(self) -> None: + if self.cancel_requested and self.state == "running": + raise Cancelled("사용자가 업데이트를 취소했습니다.") + + @property + def cancel_requested(self) -> bool: + return bool(self.job is not None and self.job.cancel_requested) + def step(self, n: int = 1, *, items: int = 0) -> None: + self.check() with self._lock: self.done += max(0, int(n)) self.items += max(0, int(items)) @@ -77,6 +89,11 @@ class ShopProgress(Progress): self.active = False self.finished_at = time.time() + def cancelled(self) -> None: + with self._lock: + self.state, self.status, self.message = "cancelled", "cancelled", "취소됨" + self.finished_at = time.time() + def skip(self, message: str) -> None: with self._lock: self.state, self.status, self.message = "skipped", "running", message @@ -84,7 +101,7 @@ class ShopProgress(Progress): @property def finished(self) -> bool: - return self.state in ("done", "error", "skipped") + return self.state in ("done", "error", "skipped", "cancelled") def fraction(self) -> float: if self.finished: @@ -115,14 +132,22 @@ class SyncJob: self.shops: list[ShopProgress] = [] self.error = "" self.last_update_at: str | None = None + self.cancel_requested = False + self.cancelled_by = "" self._lock = threading.Lock() def set_targets(self, targets: list[tuple[str, str, bool]], start: date, end: date) -> dict[str, ShopProgress]: with self._lock: self.start, self.end = start, end - self.shops = [ShopProgress(code, name, active=active) for code, name, active in targets] + self.shops = [ShopProgress(code, name, active=active, job=self) for code, name, active in targets] return {s.code: s for s in self.shops} + def cancel(self, user: str = "") -> None: + """[업데이트 취소] — 돌고 있는 쇼핑몰은 다음 API 호출 직전에, 기다리는 쇼핑몰은 차례가 오면 멈춘다.""" + with self._lock: + if not self.finished_at and not self.cancel_requested: + self.cancel_requested, self.cancelled_by = True, user + def finish(self, *, error: str = "", last_update_at: str | None = None) -> None: with self._lock: self.error, self.last_update_at, self.finished_at = error, last_update_at, time.time() @@ -136,12 +161,14 @@ class SyncJob: shops = [s.snapshot() for s in self.shops] active = [s for s in shops if s["active"]] return { - "id": self.id, "finished": self.finished, "error": self.error, + "id": self.id, "finished": self.finished, "error": self.error, "user": self.user, + "cancel_requested": self.cancel_requested, "from": self.start.isoformat() if self.start else None, "to": self.end.isoformat() if self.end else None, "elapsed": round((self.finished_at or time.time()) - self.created_at, 1), "last_update_at": self.last_update_at, "shops": shops, "overall": { - "shops": len(active), "finished": sum(1 for s in active if s["state"] in ("done", "error", "skipped")), + "shops": len(active), + "finished": sum(1 for s in active if s["state"] in ("done", "error", "skipped", "cancelled")), "fraction": round(sum(s["fraction"] for s in active) / len(active), 4) if active else (1.0 if self.finished else 0.0), "items": sum(s["items"] for s in shops), "upserted": sum(s["upserted"] for s in shops), diff --git a/app/modules/performance/router.py b/app/modules/performance/router.py index 9a29687..f46ed9e 100644 --- a/app/modules/performance/router.py +++ b/app/modules/performance/router.py @@ -8,6 +8,7 @@ JSON API — 모듈 권한 background=true 면 백그라운드로 돌리고 작업 번호를 바로 돌려줌 GET /performance/api/sync/jobs/{id} 매출 업데이트 진행 상황(쇼핑몰별·전체 진행 막대) GET /performance/api/sync/current 지금 돌고 있는 업데이트(없으면 null) + POST /performance/api/sync/jobs/{id}/cancel 업데이트 취소(시작한 사람 또는 관리자) GET /performance/api/events 금액 클릭 상세(쇼핑몰+기간) JSON API — 관리자 PUT /performance/api/marketplaces/{code} 사용/매출 집계 여부 @@ -208,6 +209,24 @@ def api_sync_job(request: Request, job_id: str) -> JSONResponse: return JSONResponse({"job": job.snapshot()}) +@router.post("/api/sync/jobs/{job_id}/cancel") +def api_sync_cancel(request: Request, job_id: str) -> JSONResponse: + """[업데이트 취소] — 시작한 사람 또는 관리자. 돌고 있는 쇼핑몰은 다음 API 호출 직전에 멈추고(저장 전이면 DB 그대로), + 기다리는 쇼핑몰은 건너뛴다. 이미 저장이 끝난 쇼핑몰 결과는 그대로 남는다.""" + from app.store import is_admin # noqa: WPS433 + + from . import jobs # noqa: WPS433 + + _, user = common.require_store(request) + job = jobs.get_job(job_id) + if job is None: + raise HTTPException(status_code=404, detail="진행 상황을 찾을 수 없습니다(서버가 다시 시작됐을 수 있습니다).") + if job.user and job.user != user["email"] and not is_admin(user): + raise HTTPException(status_code=403, detail="업데이트를 시작한 사람이나 관리자만 취소할 수 있습니다.") + job.cancel(user["email"]) + return JSONResponse({"job": job.snapshot()}) + + @router.get("/api/sync/current") def api_sync_current(request: Request) -> JSONResponse: common.require_store(request) diff --git a/app/modules/performance/sync.py b/app/modules/performance/sync.py index f5de380..49a10a3 100644 --- a/app/modules/performance/sync.py +++ b/app/modules/performance/sync.py @@ -20,7 +20,7 @@ from typing import Any, Iterable from app.timezone import today_kst -from .adapters.base import STATUS_LABELS, AdapterContext, AdapterError, MarketplaceAdapter, SaleEvent +from .adapters.base import STATUS_LABELS, AdapterContext, AdapterError, Cancelled, MarketplaceAdapter, SaleEvent from .adapters.registry import all_adapters, get_adapter from .credentials import CredentialService from .security.crypto import CryptoConfigError, DecryptError @@ -102,6 +102,9 @@ class SyncService: if progress is not None: progress.fail(status="api_error", label=STATUS_LABELS["api_error"], message="알 수 없는 쇼핑몰입니다.") return {**result, "status": "api_error", "message": "알 수 없는 쇼핑몰입니다."} + if progress is not None and progress.cancel_requested: # [업데이트 취소] 뒤 차례가 온 쇼핑몰 + progress.cancelled() + return {**result, "cancelled": True, "status": "cancelled", "message": "취소됨"} run_id = self._store.start_run(code, trigger=trigger, range_from=start, range_to=end, user=user) if run_id is None: if progress is not None: @@ -136,6 +139,12 @@ class SyncService: progress.finish(upserted=upserted, message=f"{upserted}건 반영") return {**result, "ok": True, "status": "ok", "fetched": fetched, "upserted": upserted, "message": f"{upserted}건 반영"} + except Cancelled: + # 수집 중 취소 — 아직 아무것도 저장하지 않았다. 연결 상태(오류 표시)는 바꾸지 않는다. + self._store.finish_run(run_id, ok=False, error="업데이트 취소") + if progress is not None: + progress.cancelled() + return {**result, "cancelled": True, "status": "cancelled", "message": "취소됨"} except Exception as exc: # noqa: BLE001 — 한 쇼핑몰 실패가 전체를 멈추지 않게 status, message = self._failure(exc, ctx) logger.warning("performance sync %s failed: %s %s", code, status, message) diff --git a/app/modules/performance/templates/performance/index.html b/app/modules/performance/templates/performance/index.html index e401e05..464ea99 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 440c7bc..c940288 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 -%} @@ -177,4 +177,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 828c8fd..0bcdc9a 100644 --- a/app/modules/performance/tests/test_performance.py +++ b/app/modules/performance/tests/test_performance.py @@ -1340,6 +1340,51 @@ def test_gsshop_collect_sales(): assert rec["days"][1]["amount"] == -17000 and rec["days"][1]["claimed"] == 17000 +def test_sync_job_cancel(): + """[업데이트 취소]: 수집 중인 쇼핑몰은 다음 API 호출 직전에 멈추고 저장하지 않는다(기존 매출 그대로), + 차례가 안 온 쇼핑몰은 취소됨으로 건너뛴다. 연결 상태(오류)는 기록하지 않는다.""" + import bcrypt + import httpx + + from app.modules.performance import jobs + from app.modules.performance.adapters import naver as nv + + job = jobs.create_job(user="king@x", start=None, end=None) + days = [] + + def get(url, params=None, headers=None, timeout=None): + days.append(params["from"][:10]) + if len(days) == 2: + job.cancel("king@x") # 둘째 날을 받는 도중 취소 + rows = [_naver_item("A" + days[-1], "P" + days[-1], days[-1], 10000)] + return httpx.Response(200, json={"data": {"contents": rows, "pagination": {"hasNext": False}}}) + + st = FakeStore() + st.markets = [m for m in st.markets if m["code"] in ("naver", "gsshop")] + creds = CredentialService(st, lambda: ring()) + creds.save(next(a for a in all_adapters() if a.code == "naver"), + {"client_id": "app-id", "client_secret": bcrypt.gensalt(rounds=4).decode()}) + creds.save(next(a for a in all_adapters() if a.code == "gsshop"), + {"vendor_code": "1047142", "api_key": "0123456789abcdef0123456789ABCDEF"}) + st.events[("naver", "SALE", "naver:OLD")] = {"amount": 5000, "is_sample": False, "sales_date": date(2026, 9, 10)} + orig = (httpx.post, httpx.get, nv.CALL_INTERVAL_SEC) + httpx.post = lambda url, data=None, timeout=None, headers=None: httpx.Response(200, json={"access_token": "T", "expires_in": 10799}) + httpx.get, nv.CALL_INTERVAL_SEC = get, 0 + try: + res = SyncService(st, creds).sync_all(start=date(2026, 9, 9), end=date(2026, 9, 12), user="king@x", job=job) + finally: + httpx.post, httpx.get, nv.CALL_INTERVAL_SEC = orig + job.finish() + assert days == ["2026-09-09", "2026-09-10"] # 셋째 날은 부르지 않음 + assert [r.get("cancelled") for r in res] == [True, True] + snap = {s["code"]: s for s in job.snapshot()["shops"]} + assert snap["naver"]["state"] == "cancelled" and snap["gsshop"]["state"] == "cancelled" + assert list(st.events) == [("naver", "SALE", "naver:OLD")] # 저장 안 함 — 기존 매출 그대로 + assert "naver" not in st.status and "gsshop" not in st.status # 연결 상태 안 바뀜 + snapshot = job.snapshot() + assert snapshot["cancel_requested"] and snapshot["overall"]["finished"] == 2 and snapshot["overall"]["fraction"] == 1.0 + + if __name__ == "__main__": os.environ.pop("APP_ENCRYPTION_KEY", None) n = 0 diff --git a/app/static/performance.css b/app/static/performance.css index d54a598..2eb0fcf 100644 --- a/app/static/performance.css +++ b/app/static/performance.css @@ -260,3 +260,8 @@ td.is-link:hover { background: #eef2ff; text-decoration: underline; } .perf-prog-row.is-total .perf-prog-bar { height: 14px; } .perf-prog-row.is-total .perf-prog-pct { font-weight: 700; color: inherit; } @media (max-width: 560px) { .perf-prog-row { grid-template-columns: 1fr 44px; } .perf-prog-name { grid-column: 1 / -1; } .perf-prog-text { grid-column: 1 / -1; } } + +/* [업데이트 취소] — 창 아래 왼쪽, 빨간 글자. 끝나면 숨김 */ +.perf-prog-cancel { margin-right: auto; color: var(--perf-down); border-color: currentColor; } +.perf-prog-cancel[hidden] { display: none; } +.perf-prog-cancel:disabled { opacity: .6; cursor: default; } diff --git a/app/static/performance.js b/app/static/performance.js index a07a3dd..857d22e 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -79,7 +79,8 @@ // ── 매출 업데이트 진행 창 — 서버가 백그라운드로 수집(POST /api/sync background)하는 동안 // GET /api/sync/jobs/{id} 를 0.8초마다 불러 쇼핑몰별·전체 진행 막대를 그린다. // 창을 닫아도 수집은 서버에서 계속된다. 끝나면 resolve(마지막 상태), 호출 자체가 실패하면 reject. - const SHOP_STATE = { waiting: "대기", running: "수집 중", saving: "저장 중", done: "완료", error: "실패", skipped: "건너뜀" }; + const SHOP_STATE = { waiting: "대기", running: "수집 중", saving: "저장 중", done: "완료", error: "실패", skipped: "건너뜀", + cancelled: "취소됨" }; function fmtSec(sec) { sec = Math.max(0, Math.round(sec || 0)); return Math.floor(sec / 60) + ":" + String(sec % 60).padStart(2, "0"); @@ -100,6 +101,8 @@ if (s.state === "done") t += " · " + fmt(s.upserted) + "건 반영"; if (s.state === "error") t += " · " + (s.label ? s.label + " — " : "") + (s.message || ""); if (s.state === "skipped") t += " · " + (s.message || ""); + if (s.state === "cancelled") t += " · 저장하지 않음(기존 매출 그대로)"; + if (s.state === "running" && s.cancel_pending) t += " · 취소하는 중…"; let html = esc(t); if (s.elapsed && s.state !== "waiting") html += ' (' + fmtSec(s.elapsed) + ")"; return html; @@ -112,13 +115,16 @@ html += '

기간 ' + esc(job.from || "") + " ~ " + esc(job.to || "") + " · 경과 " + fmtSec(job.elapsed) + (job.finished ? "" : " · 창을 닫아도 서버에서 계속 진행됩니다") + "

"; html += active.map(function (s) { - const cls = s.state === "error" ? "is-error" : s.state === "done" ? "is-done" : s.state === "skipped" ? "is-skip" : ""; + const cls = s.state === "error" ? "is-error" : s.state === "done" ? "is-done" : + (s.state === "skipped" || s.state === "cancelled") ? "is-skip" : ""; + if (job.cancel_requested) s.cancel_pending = true; return progressRow(s.name, s.fraction, shopText(s), cls); }).join(""); html += progressRow("전체", o.fraction, - esc(fmt(o.finished) + "/" + fmt(o.shops) + " 쇼핑몰 완료" + + esc((job.cancel_requested ? (job.finished ? "업데이트 취소됨 · " : "취소하는 중 · ") : "") + + fmt(o.finished) + "/" + fmt(o.shops) + " 쇼핑몰 완료" + (o.items ? " · 받은 자료 " + fmt(o.items) + "건" : "") + (job.finished ? " · " + fmt(o.upserted) + "건 반영" : "")), - "is-total" + (job.finished ? " is-done" : "")); + "is-total" + (job.finished ? (job.cancel_requested ? " is-skip" : " is-done") : "")); if (passive.length) { html += '

건너뜀: ' + esc(passive.map(function (s) { return s.name + (s.label ? "(" + s.label + ")" : ""); @@ -133,13 +139,36 @@ const m = openModal(title || "매출 업데이트", { narrow: true, onClose: function () { closed = true; clearTimeout(timer); if (last) resolve(last); } }); m.card.classList.add("perf-prog-card"); m.body.innerHTML = '

업데이트를 시작하는 중…

'; + // [업데이트 취소] — 돌고 있는 쇼핑몰은 다음 API 호출 직전에 멈추고(저장 전이면 DB 그대로), + // 이미 저장이 끝난 쇼핑몰 결과는 남는다. 끝나면 숨긴다. + const cancelBtn = el("button", { type: "button", class: "erp-btn erp-btn-outline perf-prog-cancel", hidden: "hidden" }, "업데이트 취소"); const closeBtn = el("button", { type: "button", class: "erp-btn erp-btn-outline" }, "닫기"); closeBtn.addEventListener("click", m.close); + m.foot.appendChild(cancelBtn); m.foot.appendChild(closeBtn); + let jobId = null; + cancelBtn.addEventListener("click", async function () { + if (!jobId) return; + if (!(await confirmMsg("매출 업데이트를 취소할까요?\n수집 중인 쇼핑몰은 저장하지 않고 멈추고, 이미 끝난 쇼핑몰 결과는 그대로 남습니다."))) return; + cancelBtn.disabled = true; + cancelBtn.textContent = "취소하는 중…"; + try { + const r = await api("POST", "/performance/api/sync/jobs/" + encodeURIComponent(jobId) + "/cancel"); + last = r.job; + renderSyncJob(m.body, r.job, false); + } catch (err) { + cancelBtn.disabled = false; + cancelBtn.textContent = "업데이트 취소"; + alertMsg("취소 실패: " + err.message); + } + }); api("POST", "/performance/api/sync", Object.assign({ background: true }, payload)).then(function (res) { last = res.job; + jobId = res.job.id; const joined = res.joined; renderSyncJob(m.body, res.job, joined); + if (!res.job.finished) cancelBtn.hidden = false; + if (res.job.cancel_requested) { cancelBtn.disabled = true; cancelBtn.textContent = "취소하는 중…"; } async function poll() { if (closed) return; try { @@ -147,6 +176,7 @@ last = r.job; renderSyncJob(m.body, r.job, joined); if (r.job.finished) { + cancelBtn.hidden = true; closeBtn.textContent = "확인"; closeBtn.className = "erp-btn erp-btn-primary"; return; @@ -169,6 +199,7 @@ function jobResults(job) { return (job && job.shops || []).map(function (s) { return { code: s.code, name: s.name, ok: s.state === "done", skipped: s.state === "skipped", + cancelled: s.state === "cancelled", upserted: s.upserted, status: s.status, label: s.label, message: s.message, finished: s.state !== "waiting" && s.state !== "running" && s.state !== "saving" }; }); } @@ -232,11 +263,12 @@ const running = job && !job.finished; // 실패(빨강)는 인증 실패·API 오류처럼 손봐야 하는 것만. 인증정보를 아직 안 넣은 쇼핑몰(미설정)과 // 수집을 아직 만들지 않은 쇼핑몰(연동 준비 중)은 회색 한 줄로 이름만. - const ok = [], bad = [], pending = [], unset = [], busy = []; + const ok = [], bad = [], pending = [], unset = [], busy = [], cancelled = []; let changed = 0; (res.results || []).forEach(function (r) { const name = (data.names || {})[r.code] || r.name || r.code; - if (r.skipped) busy.push(name); + if (r.cancelled) cancelled.push(name); + else if (r.skipped) busy.push(name); else if (r.ok) { ok.push(name + " " + fmt(r.upserted) + "건"); changed += r.upserted; } else if (r.status === "not_implemented") pending.push(name); else if (r.status === "not_configured") unset.push(name); @@ -246,6 +278,7 @@ if (ok.length) parts.push("반영 " + esc(ok.join(", "))); if (bad.length) parts.push("실패 " + esc(bad.join(", "))); if (busy.length) parts.push("이미 진행 중 " + esc(busy.join(", "))); + if (cancelled.length) parts.push("취소됨(기존 매출 그대로) " + esc(cancelled.join(", "))); if (pending.length) parts.push('연동 준비 중: ' + esc(pending.join(", ")) + ""); if (unset.length) parts.push('인증정보 미설정: ' + esc(unset.join(", ")) + ""); if (running) parts.unshift("업데이트가 아직 진행 중입니다 — 끝나면 다시 [매출 업데이트]를 눌러 결과를 보세요"); @@ -1000,7 +1033,8 @@ if (job && !job.finished) rest.push("(아직 진행 중 — 창을 닫았습니다. 끝나면 대시보드에 반영됩니다)"); (res.results || []).forEach(function (r) { const name = names[r.code] || r.name || r.code; - if (r.ok) ok.push(name + " " + fmt(r.upserted) + "건"); + if (r.cancelled) rest.push(name + "(취소됨)"); + else if (r.ok) ok.push(name + " " + fmt(r.upserted) + "건"); else if (r.skipped) rest.push(name + "(이미 진행 중)"); else if (r.status === "not_implemented" || r.status === "not_configured") rest.push(name); else bad.push(name + "(" + (r.label || r.status) + ": " + (r.message || "") + ")"); diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index a48c264..2a14f8c 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -216,6 +216,10 @@ 상태: 대기 → 수집 중 n/전체 · 받은 자료 → 저장 중 → 완료 n건 반영 | 실패 | 건너뜀. 수집이 없거나 인증정보가 없는 쇼핑몰은 막대에서 빼고 "건너뜀" 한 줄(전체 진행률에 안 넣음). 전체 = 막대 쇼핑몰 진행률 평균. 이미 돌고 있는 업데이트가 있으면 새로 시작하지 않고 그 진행 상황을 보여 준다(`GET /api/sync/current`). 창을 닫아도 수집은 계속된다. +- **[업데이트 취소]**(진행 창 왼쪽 아래, 시작한 사람·관리자, `POST /api/sync/jobs/{id}/cancel`): 돌고 있는 쇼핑몰은 다음 API 호출 + 직전(`ctx.progress.check()` → `Cancelled`)에 멈추고 **저장하지 않는다**(저장은 수집이 끝난 뒤 한 트랜잭션이라 기존 매출 그대로), + 차례가 안 온 쇼핑몰은 "취소됨"으로 건너뛴다. 이미 저장이 끝난 쇼핑몰 결과는 남고, 저장 중이던 쇼핑몰은 그 저장을 끝낸다. + 취소된 실행은 `perf_sync_runs` 에 failed + "업데이트 취소", 연결 상태(`perf_connection_status`)는 바꾸지 않는다. - 카페24 **환불합계 규칙(확정, 2026-09-29 실데이터)**: 카페24 "일별 매출내역" 환불합계 = 환불 목록의 (실제 환불액 + 적립금·예치금 환불) + 환불 목록에 없는 취소·반품(네이버페이 등, 취소일 기준). 9/26 = 178,220 + 1,080 + 네이버페이 취소 96,500 = 275,800, 9/27 = 145,000 + 네이버페이 55,800 = 200,800 으로 일치. 대조 도구에 환불합계 후보(값 입력 시 일치 줄 강조)·환불 건별·