fix(카페24): 옵션 팝업에서 추가한 옵션값이 저장 후 사라지는 버그
- 원인: 카페24 PUT options 는 옵션값 추가를 지원하지 않음(문서). 끝에 덧붙여 보내면 오류 없이 무시되는데 화면은 "반영했습니다"로 표시하고 다시 읽으면 사라짐 - 기존 옵션에 새 행이 있으면 「저장」이 확인창을 거쳐 옵션 재생성(DELETE → POST → 자체코드·추가금액·진열/판매·썸네일 재반영)으로 저장. 품목코드는 새로 부여됨 - 서버 build_update_options_request: 옵션값 개수 증가를 400 으로 거부(재생성 안내), 덧붙이기 경로(allow_append·wait_for_variants·added) 제거 - 테스트·문서 갱신, cafe24-options.js 캐시 버전 올림 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -20,6 +20,8 @@
|
||||
|
||||
## 규칙
|
||||
|
||||
- **카페24 PUT options 는 옵션값 추가를 오류 없이 무시한다** — 기존 옵션에 행 추가는 「옵션 재생성」(DELETE → POST, 품목코드 새로 부여)으로만. 저장 버튼이 새 행을 보면 재생성 확인창으로 넘긴다.
|
||||
|
||||
- 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지.
|
||||
- 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력.
|
||||
- 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지).
|
||||
|
||||
@@ -482,19 +482,11 @@ def options_update(
|
||||
try:
|
||||
body = store.build_update_options_request(
|
||||
original, edited, option_list_type=str(payload.get("option_list_type") or ""),
|
||||
allow_append=True,
|
||||
)
|
||||
except ValueError as exc:
|
||||
raise HTTPException(status_code=400, detail=str(exc)) from exc
|
||||
if loaded["option"]["option_preset_code"]:
|
||||
body["option_preset_code"] = loaded["option"]["option_preset_code"]
|
||||
# 뒤에 덧붙인 옵션값 — 카페24가 받아들이면 품목을 자동 생성한다(재시도 조회).
|
||||
added_texts = [
|
||||
v["option_text"]
|
||||
for o, n in zip(body["original_options"], body["options"])
|
||||
for v in n["option_value"][len(o["option_value"]):]
|
||||
]
|
||||
added = len(added_texts)
|
||||
|
||||
try:
|
||||
updated = products.update_options(api.client, product_no, body)
|
||||
@@ -508,7 +500,7 @@ def options_update(
|
||||
record_error = _save_snapshot_safe(
|
||||
st, product_no, "options",
|
||||
_options_snapshot(updated, befores=[loaded["raw_option"], loaded["effective_option"]],
|
||||
osec=loaded["options_section"], recent=added_texts),
|
||||
osec=loaded["options_section"], recent=[]),
|
||||
)
|
||||
# 이름 바꾸기 표(수정 전 → 수정 후) — 위치로 짝지어진다(build_update_options_request).
|
||||
rename: dict[tuple[str, str], tuple[str, str]] = {}
|
||||
@@ -541,29 +533,15 @@ def options_update(
|
||||
summary = "; ".join(
|
||||
f"{o['option_name']}: " + ", ".join(v["option_text"] for v in o["option_value"])
|
||||
for o in body["options"]
|
||||
) + (f" (+{added} 추가)" if added else "")
|
||||
|
||||
fresh: list[dict[str, Any]] | None = None
|
||||
if added:
|
||||
# 새 옵션값의 품목코드를 받아 돌려준다 — 화면이 자체코드/추가금액을 이어서 PUT 한다.
|
||||
# 늦게 나타나는 품목은 pending 으로 표시된다(_annotate).
|
||||
_osec, vsec = _snapshot_sections(st, product_no)
|
||||
fresh = _patch_variants(
|
||||
vsec, products.wait_for_variants(api.client, product_no, len(loaded["raw_variants"]) + added)
|
||||
)
|
||||
)
|
||||
writes.audit_safe(st, actor=actor, action="update_options", product_no=product_no,
|
||||
result="SUCCESS", detail=summary[:900])
|
||||
logger.info("카페24 상품 %s 옵션 수정 (%s)", product_no, actor)
|
||||
|
||||
shown_option, shown_variants = _annotate(
|
||||
updated, fresh if fresh is not None else renamed_variants, added_texts
|
||||
)
|
||||
out: dict[str, Any] = {"ok": True, "option": _options_view(shown_option),
|
||||
"variants": [_variant_view(v) for v in shown_variants],
|
||||
"record_warning": record_error}
|
||||
if added:
|
||||
out["added"] = added
|
||||
return out
|
||||
shown_option, shown_variants = _annotate(updated, renamed_variants, [])
|
||||
return {"ok": True, "option": _options_view(shown_option),
|
||||
"variants": [_variant_view(v) for v in shown_variants],
|
||||
"record_warning": record_error}
|
||||
|
||||
|
||||
@product_info_router.delete("/products/{product_no}/options")
|
||||
|
||||
@@ -973,16 +973,15 @@ def build_update_options_request(
|
||||
edited: list[dict],
|
||||
*,
|
||||
option_list_type: str = "",
|
||||
allow_append: bool = False,
|
||||
) -> dict:
|
||||
"""옵션명/옵션값(이름·이미지·색상·표시방식) 수정 요청.
|
||||
|
||||
카페24 PUT options 는 `original_options`(수정 전) 와 `options`(수정 후) 를
|
||||
**위치**로 짝지어 이름을 바꾼다. 그래서
|
||||
- 옵션값을 **뒤에 덧붙이는** 것(`allow_append`)만 허용한다 — 앞쪽 위치는 그대로라
|
||||
기존 이름이 밀리지 않는다(카페24가 추가를 거부하면 그 오류가 그대로 올라온다).
|
||||
- 옵션값 **삭제**(개수 감소)는 거부한다 — 중간을 빼면 뒤 값들이 한 칸씩 당겨져
|
||||
엉뚱한 품목의 이름이 바뀐다. 정리는 옵션 재생성(삭제 후 생성)으로 한다.
|
||||
**위치**로 짝지어 이름을 바꾼다. 옵션값 개수는 바꿀 수 없다:
|
||||
- **추가**: 카페24 문서상 PUT 은 옵션 항목 추가를 지원하지 않는다 — 실물에서
|
||||
덧붙여 보내도 오류 없이 무시되어 "저장했는데 사라짐"이 됐다(2026-11-06).
|
||||
추가는 옵션 재생성(삭제 후 POST)으로 한다.
|
||||
- **삭제**: 중간을 빼면 뒤 값들이 한 칸씩 당겨져 엉뚱한 품목의 이름이 바뀐다.
|
||||
original: GET 응답의 options 그대로. edited: 화면에서 보낸 같은 모양의 목록.
|
||||
"""
|
||||
if len(original) != len(edited):
|
||||
@@ -997,10 +996,10 @@ def build_update_options_request(
|
||||
f"옵션 「{o.get('option_name')}」 의 옵션값을 줄일 수 없습니다. "
|
||||
"옵션값 삭제는 카페24 API 가 지원하지 않습니다 — 옵션 재생성으로 정리하세요."
|
||||
)
|
||||
if len(e_vals) > len(o_vals) and not allow_append:
|
||||
if len(e_vals) > len(o_vals):
|
||||
raise ValueError(
|
||||
f"옵션 「{o.get('option_name')}」 의 옵션값 개수가 카페24와 다릅니다. "
|
||||
"다시 읽은 뒤 수정하세요."
|
||||
f"옵션 「{o.get('option_name')}」 에 옵션값을 추가할 수 없습니다. "
|
||||
"카페24 API 는 기존 옵션에 옵션값 추가를 지원하지 않습니다 — 「옵션 재생성」으로 추가하세요."
|
||||
)
|
||||
name = str(e.get("option_name") or "").strip()
|
||||
if not name:
|
||||
@@ -1036,17 +1035,6 @@ def build_update_options_request(
|
||||
n_item[key] = value
|
||||
orig_entry["option_value"].append(o_item)
|
||||
new_entry["option_value"].append(n_item)
|
||||
# 덧붙이는 새 옵션값 — 수정 전 목록에는 없고 수정 후 목록 끝에만 있다.
|
||||
for ev in e_vals[len(o_vals):]:
|
||||
text = str(ev.get("option_text") or "").strip()
|
||||
if not text:
|
||||
raise ValueError("추가할 옵션값 이름은 비울 수 없습니다.")
|
||||
n_item = {"option_text": text}
|
||||
for key in ("option_image_file", "option_link_image", "option_color"):
|
||||
value = str(ev.get(key) or "").strip()
|
||||
if value:
|
||||
n_item[key] = value
|
||||
new_entry["option_value"].append(n_item)
|
||||
orig_out.append(orig_entry)
|
||||
new_out.append(new_entry)
|
||||
request: dict = {"original_options": orig_out, "options": new_out}
|
||||
|
||||
@@ -128,7 +128,7 @@
|
||||
{% endblock %}
|
||||
|
||||
{% block scripts %}
|
||||
<script src="/static/cafe24-options.js?v=20261020a"></script>
|
||||
<script src="/static/cafe24-options.js?v=20261106a"></script>
|
||||
<script>
|
||||
(function () {
|
||||
var pane = document.getElementById("cf24-editor-pane");
|
||||
|
||||
@@ -1261,21 +1261,18 @@ def test_build_update_options_request_rejects_count_mismatch():
|
||||
pass
|
||||
else:
|
||||
raise AssertionError(edited)
|
||||
# 덧붙이기는 allow_append 일 때만
|
||||
# 덧붙이기 거부 — 카페24 PUT 은 옵션값 추가를 무시한다(저장 후 사라짐). 재생성으로 안내.
|
||||
more = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2", "option_image_file": "https://d/2.png"}]}]
|
||||
try:
|
||||
store.build_update_options_request(original, more)
|
||||
except ValueError:
|
||||
pass
|
||||
except ValueError as exc:
|
||||
assert "옵션 재생성" in str(exc)
|
||||
else:
|
||||
raise AssertionError("append without flag accepted")
|
||||
body = store.build_update_options_request(original, more, allow_append=True)
|
||||
assert body["original_options"][0]["option_value"] == [{"option_text": "1"}]
|
||||
assert body["options"][0]["option_value"] == [{"option_text": "1"}, {"option_text": "2", "option_image_file": "https://d/2.png"}]
|
||||
# 줄이기는 allow_append 여도 거부 (위치 짝맞춤으로 이름이 밀린다)
|
||||
raise AssertionError("append accepted")
|
||||
# 줄이기도 거부 (위치 짝맞춤으로 이름이 밀린다)
|
||||
two = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2"}]}]
|
||||
try:
|
||||
store.build_update_options_request(two, original, allow_append=True)
|
||||
store.build_update_options_request(two, original)
|
||||
except ValueError:
|
||||
pass
|
||||
else:
|
||||
|
||||
Reference in New Issue
Block a user