From 4cd349c3a19a54364119995a79e26c160a314850 Mon Sep 17 00:00:00 2001 From: king Date: Tue, 10 Nov 2026 15:15:32 +0900 Subject: [PATCH] =?UTF-8?q?feat(=EC=B9=B4=ED=8E=9824):=20=ED=92=88?= =?UTF-8?q?=EB=AA=A9=20=EC=A7=84=EC=97=B4=C2=B7=ED=8C=90=EB=A7=A4=EB=A5=BC?= =?UTF-8?q?=20=EB=AA=A8=EB=93=A0=20=EB=A9=80=ED=8B=B0=EC=87=BC=ED=95=91?= =?UTF-8?q?=EB=AA=B0=EC=97=90=20=EA=B0=99=EC=9D=B4=20=EB=B0=98=EC=98=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 옵션/품목 팝업 저장 시 기본몰(1)에 반영된 행의 진열·판매만 CAFE24_SHOP_NOS(예 1,2,3)의 다른 쇼핑몰에도 같은 값으로 PUT - 추가금액(통화 다름)·자체코드·순서는 기본몰만 - 다른 쇼핑몰 실패는 응답 shop_failed·감사 기록·화면 경고(기본몰 반영 유지) - 쇼핑몰 목록 API 는 mall.read_store 권한이 필요해 번호를 환경변수로 받음 Co-Authored-By: Claude Opus 5.5 --- .env.example | 5 ++++ app/integrations/cafe24/products.py | 4 ++-- app/modules/cafe24/CLAUDE.md | 1 + app/modules/cafe24/common.py | 9 +++++++ app/modules/cafe24/routes_product_info.py | 21 +++++++++++++++- app/modules/cafe24/store.py | 9 +++++++ .../cafe24/templates/cafe24/products.html | 2 +- app/modules/cafe24/tests/fakes.py | 2 ++ app/modules/cafe24/tests/test_cafe24.py | 5 ++++ app/static/cafe24-options.js | 9 +++++-- docs/CAFE24_MODULE.md | 6 +++++ tests/test_cafe24_db.py | 24 +++++++++++++++++++ 12 files changed, 91 insertions(+), 6 deletions(-) diff --git a/.env.example b/.env.example index 62b5bd6..5e44917 100644 --- a/.env.example +++ b/.env.example @@ -126,6 +126,11 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/ # 미설정 시 카페24 기본 도메인(https://.cafe24.com)으로 대체된다. # CAFE24_SHOP_URL=https://www.miras.co.kr # +# 멀티쇼핑몰 번호(쉼표). 옵션/품목 팝업에서 바꾼 품목 진열·판매를 이 쇼핑몰 모두에 같은 값으로 +# 보낸다(추가금액·자체코드는 기본몰 1 만). 번호는 카페24 관리자 → 멀티쇼핑몰 관리에서 확인. +# 미설정 시 1(기본몰)만. +# CAFE24_SHOP_NOS=1,2,3 +# # 카페24 읽기 지연 유예시간(분). 카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전 # 값을 돌려준다. 이 시간 안에 우리가 쓴 값이 있으면, GET 이 그 이전 값을 돌려줘도 # 마지막 쓰기(revision·스냅샷)를 화면·적용 기준으로 삼는다. 지나면 카페24 값을 믿는다. diff --git a/app/integrations/cafe24/products.py b/app/integrations/cafe24/products.py index 29bd14c..992bafa 100644 --- a/app/integrations/cafe24/products.py +++ b/app/integrations/cafe24/products.py @@ -486,7 +486,7 @@ VARIANT_UNKNOWN = "unknown" # 요청이 도달했을 수 있으나 응답을 def update_variants( - client: Cafe24Client, product_no: int, requests: list[dict[str, Any]] + client: Cafe24Client, product_no: int, requests: list[dict[str, Any]], *, shop_no: int = 1 ) -> list[dict[str, Any]]: """여러 품목 부분 수정 — **행별 결과**를 돌려준다(요청 순서 그대로). @@ -506,7 +506,7 @@ def update_variants( continue try: payload = client.put( - f"/admin/products/{no}/variants", json={"shop_no": 1, "requests": chunk}, product_no=no + f"/admin/products/{no}/variants", json={"shop_no": int(shop_no), "requests": chunk}, product_no=no ) except Cafe24Error as exc: status = VARIANT_UNKNOWN if getattr(exc, "maybe_applied", False) else VARIANT_FAILED diff --git a/app/modules/cafe24/CLAUDE.md b/app/modules/cafe24/CLAUDE.md index 4b39811..6055895 100644 --- a/app/modules/cafe24/CLAUDE.md +++ b/app/modules/cafe24/CLAUDE.md @@ -12,6 +12,7 @@ - HTML 편집기에서 `` 태그에 마우스를 올리면 태그를 오렌지색으로 칠하고 화면 오른쪽에 폭 500px·창 높이로 파일명과 미리보기(상대 경로는 `CAFE24_SHOP_URL` 루트 기준, 색칠 한도 `HL_LIMIT` 초과 소스는 미동작). - HTML 편집기에서 커서가 `` 태그 안 어디에 있든 Ctrl+↑/↓ 로 `src` 파일명(`.jpg`/`.gif`/`.png`) 번호 변경. 없음 → `_2` → `_3` …, 이미 `_숫자` 면 다음 숫자부터. 내릴 때는 원래 번호(없었으면 원래 이름) 아래로 안 감 — 다른 편집이 끼거나 다른 이미지로 옮기면 그때 번호가 새 원래 번호. - 정보 패널(`routes_product_info.py`, `_side.html`)에서 상품명·판매가·공급가·소비자가, 대표이미지, 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매) 수정. + 품목 진열·판매는 `CAFE24_SHOP_NOS`(예 1,2,3)의 모든 멀티쇼핑몰에 같은 값으로 보냄(추가금액 등은 기본몰만). - 대표이미지는 `POST /admin/products/{no}/images` 에 base64 data URI + `image_upload_type=A`. NNEditor 업로드 경로를 PUT `detail_image` 에 넣는 방식은 적용 안 됨. - 옵션/품목 팝업 「판매 가격」 열: 기본 정보 판매가 + 추가금액을 보여주고, 입력하면 추가금액을 역산(`cafe24-options.js` `bindSalePrice`). 저장되는 값은 추가금액뿐. diff --git a/app/modules/cafe24/common.py b/app/modules/cafe24/common.py index 6835980..4dc553b 100644 --- a/app/modules/cafe24/common.py +++ b/app/modules/cafe24/common.py @@ -42,6 +42,15 @@ def read_lag_grace_minutes() -> int: return store.parse_grace_minutes(os.getenv("CAFE24_READ_LAG_GRACE_MIN")) +def shop_nos() -> list[int]: + """품목 진열·판매를 함께 맞출 멀티쇼핑몰 번호. `CAFE24_SHOP_NOS`(예: 1,2,3), 기본 [1].""" + import os # noqa: WPS433 + + from . import store # noqa: WPS433 + + return store.parse_shop_nos(os.getenv("CAFE24_SHOP_NOS")) + + def require_user(request: Request) -> dict[str, Any]: from app.main import get_current_user_record # noqa: WPS433 from app.store import has_module # noqa: WPS433 diff --git a/app/modules/cafe24/routes_product_info.py b/app/modules/cafe24/routes_product_info.py index 0de5b00..56766fb 100644 --- a/app/modules/cafe24/routes_product_info.py +++ b/app/modules/cafe24/routes_product_info.py @@ -37,7 +37,7 @@ from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products from app.timezone import now_kst from . import store, writes -from .common import read_lag_grace_minutes, require_store +from .common import read_lag_grace_minutes, require_store, shop_nos from .routes_products import load_product, locked_json, remember_write logger = logging.getLogger("cafe24.product_info") @@ -636,6 +636,7 @@ def variants_update( "failed": {code: 사유}, "unknown": {code: 사유}} 100건 묶음 중 일부가 실패해도 성공한 행은 성공으로 기록·표시한다(화면이 그 행을 다시 보내지 않게). 하나도 반영되지 않았으면 502. + 진열·판매는 `CAFE24_SHOP_NOS` 의 다른 쇼핑몰에도 같은 값으로 보낸다 — 실패는 "shop_failed". """ st, user = require_store(request) actor = str(user.get("email") or "") @@ -673,9 +674,26 @@ def variants_update( failed[code] = result["error"] record_error = _save_snapshot_safe(st, product_no, "variants", by_code) if by_code else "" + # 멀티쇼핑몰: 진열·판매는 쇼핑몰마다 따로라 기본몰(1)에 반영된 행의 진열·판매만 + # 다른 쇼핑몰에도 똑같이 보낸다. 추가금액(통화가 다름)·자체코드·순서는 보내지 않는다. + flags = [ + {"variant_code": code, **{k: sent[code][k] for k in ("display", "selling") if k in sent[code]}} + for code in by_code if {"display", "selling"} & set(sent.get(code) or {}) + ] + shop_failed: dict[str, str] = {} + for shop in (shop_nos()[1:] if flags else []): + bad = [r for r in products.update_variants(api.client, product_no, flags, shop_no=shop) + if r["status"] != products.VARIANT_OK] + if bad: + shop_failed[str(shop)] = f"{len(bad)}건 — {bad[0]['error']}" + detail = "; ".join( f"{code}: " + ", ".join(f"{k}={v}" for k, v in patch.items()) for code, patch in by_code.items() ) + if flags and len(shop_nos()) > 1: + detail = f"[진열·판매 쇼핑몰 {','.join(map(str, shop_nos()))}] " + detail + if shop_failed: + detail += " / 다른 쇼핑몰 실패: " + "; ".join(f"{s}번 {e}" for s, e in shop_failed.items()) if failed or unknown: detail = (f"성공 {len(by_code)} / 실패 {len(failed)} / 결과 모름 {len(unknown)} — " + detail) first = next(iter({**failed, **unknown}.values()), "") @@ -696,5 +714,6 @@ def variants_update( "updated": {code: _variant_view({"variant_code": code, **patch}) for code, patch in by_code.items()}, "failed": failed, "unknown": unknown, + "shop_failed": shop_failed, "record_warning": record_error, } diff --git a/app/modules/cafe24/store.py b/app/modules/cafe24/store.py index 768bf23..7380c0e 100644 --- a/app/modules/cafe24/store.py +++ b/app/modules/cafe24/store.py @@ -506,6 +506,15 @@ WRITE_REVISION_TYPES: tuple[str, ...] = (REVISION_MANUAL, REVISION_SCHEDULED, RE DEFAULT_READ_LAG_GRACE_MIN = 360 +def parse_shop_nos(value: object) -> list[int]: + """`CAFE24_SHOP_NOS`("1,2,3") → [1, 2, 3]. 기본 쇼핑몰 1 은 항상 맨 앞, 잘못된 값은 버린다.""" + out = [1] + for part in str(value or "").replace(" ", "").split(","): + if part.isdigit() and int(part) > 0 and int(part) not in out: + out.append(int(part)) + return out + + def parse_grace_minutes(value: object, default: int = DEFAULT_READ_LAG_GRACE_MIN) -> int: try: minutes = int(str(value or "").strip()) diff --git a/app/modules/cafe24/templates/cafe24/products.html b/app/modules/cafe24/templates/cafe24/products.html index 531897f..aa4bc3a 100644 --- a/app/modules/cafe24/templates/cafe24/products.html +++ b/app/modules/cafe24/templates/cafe24/products.html @@ -130,7 +130,7 @@ {% endblock %} {% block scripts %} - +