Merge branch 'feat/cafe24-option-add-rebuild'

This commit is contained in:
2026-11-06 16:45:37 +09:00
8 changed files with 48 additions and 99 deletions
+2
View File
@@ -20,6 +20,8 @@
## 규칙 ## 규칙
- **카페24 PUT options 는 옵션값 추가를 오류 없이 무시한다** — 기존 옵션에 행 추가는 「옵션 재생성」(DELETE → POST, 품목코드 새로 부여)으로만. 저장 버튼이 새 행을 보면 재생성 확인창으로 넘긴다.
- 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. - 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지.
- 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. - 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력.
- 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). - 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지).
+6 -28
View File
@@ -482,19 +482,11 @@ def options_update(
try: try:
body = store.build_update_options_request( body = store.build_update_options_request(
original, edited, option_list_type=str(payload.get("option_list_type") or ""), original, edited, option_list_type=str(payload.get("option_list_type") or ""),
allow_append=True,
) )
except ValueError as exc: except ValueError as exc:
raise HTTPException(status_code=400, detail=str(exc)) from exc raise HTTPException(status_code=400, detail=str(exc)) from exc
if loaded["option"]["option_preset_code"]: if loaded["option"]["option_preset_code"]:
body["option_preset_code"] = 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: try:
updated = products.update_options(api.client, product_no, body) updated = products.update_options(api.client, product_no, body)
@@ -508,7 +500,7 @@ def options_update(
record_error = _save_snapshot_safe( record_error = _save_snapshot_safe(
st, product_no, "options", st, product_no, "options",
_options_snapshot(updated, befores=[loaded["raw_option"], loaded["effective_option"]], _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). # 이름 바꾸기 표(수정 전 → 수정 후) — 위치로 짝지어진다(build_update_options_request).
rename: dict[tuple[str, str], tuple[str, str]] = {} rename: dict[tuple[str, str], tuple[str, str]] = {}
@@ -541,29 +533,15 @@ def options_update(
summary = "; ".join( summary = "; ".join(
f"{o['option_name']}: " + ", ".join(v["option_text"] for v in o["option_value"]) f"{o['option_name']}: " + ", ".join(v["option_text"] for v in o["option_value"])
for o in body["options"] 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, writes.audit_safe(st, actor=actor, action="update_options", product_no=product_no,
result="SUCCESS", detail=summary[:900]) result="SUCCESS", detail=summary[:900])
logger.info("카페24 상품 %s 옵션 수정 (%s)", product_no, actor) logger.info("카페24 상품 %s 옵션 수정 (%s)", product_no, actor)
shown_option, shown_variants = _annotate( shown_option, shown_variants = _annotate(updated, renamed_variants, [])
updated, fresh if fresh is not None else renamed_variants, added_texts return {"ok": True, "option": _options_view(shown_option),
) "variants": [_variant_view(v) for v in shown_variants],
out: dict[str, Any] = {"ok": True, "option": _options_view(shown_option), "record_warning": record_error}
"variants": [_variant_view(v) for v in shown_variants],
"record_warning": record_error}
if added:
out["added"] = added
return out
@product_info_router.delete("/products/{product_no}/options") @product_info_router.delete("/products/{product_no}/options")
+8 -20
View File
@@ -973,16 +973,15 @@ def build_update_options_request(
edited: list[dict], edited: list[dict],
*, *,
option_list_type: str = "", option_list_type: str = "",
allow_append: bool = False,
) -> dict: ) -> dict:
"""옵션명/옵션값(이름·이미지·색상·표시방식) 수정 요청. """옵션명/옵션값(이름·이미지·색상·표시방식) 수정 요청.
카페24 PUT options 는 `original_options`(수정 전) 와 `options`(수정 후) 를 카페24 PUT options 는 `original_options`(수정 전) 와 `options`(수정 후) 를
**위치**로 짝지어 이름을 바꾼다. 그래서 **위치**로 짝지어 이름을 바꾼다. 옵션값 개수는 바꿀 수 없다:
- 옵션값을 **뒤에 덧붙이는** 것(`allow_append`)만 허용한다 — 앞쪽 위치는 그대로라 - **추가**: 카페24 문서상 PUT 은 옵션 항목 추가를 지원하지 않는다 — 실물에서
기존 이름이 밀리지 않는다(카페24가 추가를 거부하면 그 오류가 그대로 올라온다). 덧붙여 보내도 오류 없이 무시되어 "저장했는데 사라짐"이 됐다(2026-11-06).
- 옵션값 **삭제**(개수 감소)는 거부한다 — 중간을 빼면 뒤 값들이 한 칸씩 당겨져 추가는 옵션 재생성(삭제 후 POST)으로 한다.
엉뚱한 품목의 이름이 바뀐다. 정리는 옵션 재생성(삭제 후 생성)으로 한다. - **삭제**: 중간을 빼면 뒤 값들이 한 칸씩 당겨져 엉뚱한 품목의 이름이 바뀐다.
original: GET 응답의 options 그대로. edited: 화면에서 보낸 같은 모양의 목록. original: GET 응답의 options 그대로. edited: 화면에서 보낸 같은 모양의 목록.
""" """
if len(original) != len(edited): if len(original) != len(edited):
@@ -997,10 +996,10 @@ def build_update_options_request(
f"옵션 「{o.get('option_name')}」 의 옵션값을 줄일 수 없습니다. " f"옵션 「{o.get('option_name')}」 의 옵션값을 줄일 수 없습니다. "
"옵션값 삭제는 카페24 API 가 지원하지 않습니다 — 옵션 재생성으로 정리하세요." "옵션값 삭제는 카페24 API 가 지원하지 않습니다 — 옵션 재생성으로 정리하세요."
) )
if len(e_vals) > len(o_vals) and not allow_append: if len(e_vals) > len(o_vals):
raise ValueError( raise ValueError(
f"옵션 「{o.get('option_name')}」 의 옵션값 개수가 카페24와 다릅니다. " f"옵션 「{o.get('option_name')}」 에 옵션값을 추가할 수 없습니다. "
"다시 읽은 뒤 수정하세요." "카페24 API 는 기존 옵션에 옵션값 추가를 지원하지 않습니다 — 「옵션 재생성」으로 추가하세요."
) )
name = str(e.get("option_name") or "").strip() name = str(e.get("option_name") or "").strip()
if not name: if not name:
@@ -1036,17 +1035,6 @@ def build_update_options_request(
n_item[key] = value n_item[key] = value
orig_entry["option_value"].append(o_item) orig_entry["option_value"].append(o_item)
new_entry["option_value"].append(n_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) orig_out.append(orig_entry)
new_out.append(new_entry) new_out.append(new_entry)
request: dict = {"original_options": orig_out, "options": new_out} request: dict = {"original_options": orig_out, "options": new_out}
@@ -128,7 +128,7 @@
{% endblock %} {% endblock %}
{% block scripts %} {% block scripts %}
<script src="/static/cafe24-options.js?v=20261020a"></script> <script src="/static/cafe24-options.js?v=20261106a"></script>
<script> <script>
(function () { (function () {
var pane = document.getElementById("cf24-editor-pane"); var pane = document.getElementById("cf24-editor-pane");
+6 -9
View File
@@ -1261,21 +1261,18 @@ def test_build_update_options_request_rejects_count_mismatch():
pass pass
else: else:
raise AssertionError(edited) 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"}]}] more = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2", "option_image_file": "https://d/2.png"}]}]
try: try:
store.build_update_options_request(original, more) store.build_update_options_request(original, more)
except ValueError: except ValueError as exc:
pass assert "옵션 재생성" in str(exc)
else: else:
raise AssertionError("append without flag accepted") raise AssertionError("append 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 여도 거부 (위치 짝맞춤으로 이름이 밀린다)
two = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2"}]}] two = [{"option_name": "A", "option_value": [{"option_text": "1"}, {"option_text": "2"}]}]
try: try:
store.build_update_options_request(two, original, allow_append=True) store.build_update_options_request(two, original)
except ValueError: except ValueError:
pass pass
else: else:
+13 -24
View File
@@ -7,9 +7,9 @@
옵션이 없는 상품: 행을 자유롭게 추가/삭제해 두고 저장하면 옵션 생성(POST options, 옵션이 없는 상품: 행을 자유롭게 추가/삭제해 두고 저장하면 옵션 생성(POST options,
카페24가 품목을 자동 생성) → 부여된 품목코드를 받아 → 자체코드/추가금액을 품목에 카페24가 품목을 자동 생성) → 부여된 품목코드를 받아 → 자체코드/추가금액을 품목에
PUT → 썸네일이 있으면 옵션 PUT. 저장 뒤 다시 읽어 품목코드가 바로 보인다. PUT → 썸네일이 있으면 옵션 PUT. 저장 뒤 다시 읽어 품목코드가 바로 보인다.
품목 추가: 「+ 행 추가」로 넣은 행은 저장 시 옵션값을 **뒤에 덧붙여** PUT 한다 품목 추가: 카페24 PUT options 는 옵션값 추가를 지원하지 않는다(덧붙여 보내면 오류 없이
(앞쪽 위치는 그대로라 기존 이름이 밀리지 않는다). 카페24가 품목을 자동 생성하면 무시되어 저장 후 사라졌다 — 2026-11-06). 「+ 행 추가」·불러오기로 넣은 새 행이 있으면
그 코드로 자체코드/추가금액을 이어서 PUT 한다. 거부하면 오류를 그대로 보여준다. 「저장」이 확인창을 거쳐 「옵션 재생성」으로 반영한다(품목코드 새로 부여).
품목 삭제: 행의 ✕ → DELETE /variants/{code} (문서에 있는 유일한 제거 수단). 옵션값 품목 삭제: 행의 ✕ → DELETE /variants/{code} (문서에 있는 유일한 제거 수단). 옵션값
자체는 남을 수 있어(품목 없는 옵션값) 하단에 따로 보여주고, 정리는 「옵션 재생성」 자체는 남을 수 있어(품목 없는 옵션값) 하단에 따로 보여주고, 정리는 「옵션 재생성」
(전체 삭제 → 현재 행으로 다시 생성 → 코드/금액/썸네일 재반영, 품목코드가 바뀜)으로. (전체 삭제 → 현재 행으로 다시 생성 → 코드/금액/썸네일 재반영, 품목코드가 바뀜)으로.
@@ -417,7 +417,7 @@
html += '<p class="cf24-side-note cf24-u-note">' + html += '<p class="cf24-side-note cf24-u-note">' +
(isNew (isNew
? "저장하면 옵션(조합형)을 만들고 카페24가 품목을 자동 생성합니다. 부여된 품목코드를 받아 자체 품목코드·추가금액·썸네일까지 함께 반영합니다." ? "저장하면 옵션(조합형)을 만들고 카페24가 품목을 자동 생성합니다. 부여된 품목코드를 받아 자체 품목코드·추가금액·썸네일까지 함께 반영합니다."
: "「+ 행 추가」한 값은 저장 시 옵션값 끝에 덧붙여 품목을 만듭니다. ✕ 는 품목을 바로 삭제합니다. " + : "「+ 행 추가」한 값은 카페24 API 가 옵션값 추가를 지원하지 않아 저장 시 「옵션 재생성」으로 반영합니다(품목코드 새로 부여). ✕ 는 품목을 바로 삭제합니다. " +
(canDrag ? "행을 드래그하면 품목 진열순서로 저장됩니다. " : "") + (canDrag ? "행을 드래그하면 품목 진열순서로 저장됩니다. " : "") +
"썸네일은 표시방식이 「미리보기(이미지)」일 때 쇼핑몰에 보입니다.") + "썸네일은 표시방식이 「미리보기(이미지)」일 때 쇼핑몰에 보입니다.") +
"</p>" + "</p>" +
@@ -780,6 +780,12 @@
function saveUnified(isNew, tbody, msg) { function saveUnified(isNew, tbody, msg) {
var rows = collectUnified(tbody); var rows = collectUnified(tbody);
// 카페24 PUT options 는 옵션값 추가를 지원하지 않는다(덧붙여 보내면 오류 없이 무시 → 저장 후 사라짐).
// 새 행이 있으면 유일한 방법인 옵션 재생성(삭제 후 다시 등록)으로 넘긴다.
if (!isNew && rows.some(function (r) { return r.isNew; })) {
rebuildFlow(tbody, msg, "카페24 API 는 기존 옵션에 옵션값 추가를 지원하지 않아, 추가한 행을 저장하려면 옵션을 재생성해야 합니다.\n\n");
return;
}
var problem = validateNames(rows); var problem = validateNames(rows);
if (problem) { window.erpAlert(problem); return; } if (problem) { window.erpAlert(problem); return; }
var optName = body.querySelector('[name="option_name"]').value.trim(); var optName = body.querySelector('[name="option_name"]').value.trim();
@@ -803,11 +809,6 @@
if (r.text !== ov.option_text || r.image !== (ov.option_image_file || "") || r.link !== (ov.option_link_image || "")) optionsChanged = true; if (r.text !== ov.option_text || r.image !== (ov.option_image_file || "") || r.link !== (ov.option_link_image || "")) optionsChanged = true;
return { option_text: r.text, option_image_file: r.image, option_link_image: r.link, option_color: ov.option_color || "" }; return { option_text: r.text, option_image_file: r.image, option_link_image: r.link, option_color: ov.option_color || "" };
}); });
var newRows = rows.filter(function (r) { return r.isNew; });
newRows.forEach(function (r) {
edited.push({ option_text: r.text, option_image_file: r.image, option_link_image: r.link, option_color: "" });
optionsChanged = true;
});
var orderChanged = tbody.classList.contains("is-order-dirty"); var orderChanged = tbody.classList.contains("is-order-dirty");
var patches = []; var patches = [];
rows.forEach(function (r) { rows.forEach(function (r) {
@@ -818,7 +819,7 @@
if (!optionsChanged && !patches.length) { setMsg(msg, "바뀐 값이 없습니다.", ""); return; } if (!optionsChanged && !patches.length) { setMsg(msg, "바뀐 값이 없습니다.", ""); return; }
var lines = []; var lines = [];
if (optionsChanged) lines.push("옵션명·옵션값 이름/썸네일/표시방식" + (newRows.length ? " (+ 옵션값 " + newRows.length + "개 추가 → 품목 생성)" : "")); if (optionsChanged) lines.push("옵션명·옵션값 이름/썸네일/표시방식");
if (patches.length) lines.push("품목 " + patches.length + "건 (자체코드·추가금액·진열/판매" + (orderChanged ? "·순서" : "") + ")"); if (patches.length) lines.push("품목 " + patches.length + "건 (자체코드·추가금액·진열/판매" + (orderChanged ? "·순서" : "") + ")");
window.erpConfirm("카페24에 바로 반영합니다. 계속할까요?\n\n- " + lines.join("\n- ")).then(function (ok) { window.erpConfirm("카페24에 바로 반영합니다. 계속할까요?\n\n- " + lines.join("\n- ")).then(function (ok) {
if (!ok) return; if (!ok) return;
@@ -833,18 +834,6 @@
}).then(function (data) { }).then(function (data) {
state.option = data.option; state.option = data.option;
if (data.variants) state.variants = data.variants; if (data.variants) state.variants = data.variants;
if (newRows.length) {
// 새 품목코드를 이름으로 짝지어 자체코드·추가금액·진열/판매 패치를 만든다
var map = codesByValue(state.variants);
var missing = 0;
newRows.forEach(function (r) {
var code = map[norm(r.text)];
if (!code) { missing++; return; }
var p = newRowPatch(r, code);
if (p) patches.push(p);
});
if (missing) setMsg(msg, "옵션값은 추가됐지만 품목 " + missing + "건은 카페24 품목 조회가 늦어 자체코드/추가금액을 넣지 못했습니다 — 저장 후 다시 시도하세요.", "is-err");
}
}); });
}); });
} }
@@ -930,7 +919,7 @@
} }
// 옵션 재생성 — 전체 삭제 후 현재 행(이름·코드·금액·진열/판매·썸네일)으로 다시 만든다. // 옵션 재생성 — 전체 삭제 후 현재 행(이름·코드·금액·진열/판매·썸네일)으로 다시 만든다.
function rebuildFlow(tbody, msg) { function rebuildFlow(tbody, msg, intro) {
var rows = collectUnified(tbody); var rows = collectUnified(tbody);
var problem = validateNames(rows.map(function (r) { return { text: r.text, isNew: false }; })); var problem = validateNames(rows.map(function (r) { return { text: r.text, isNew: false }; }));
if (problem) { window.erpAlert(problem); return; } if (problem) { window.erpAlert(problem); return; }
@@ -939,7 +928,7 @@
if (!optName) { window.erpAlert("옵션명을 입력하세요."); return; } if (!optName) { window.erpAlert("옵션명을 입력하세요."); return; }
var saveBtn = body.querySelector("#cf24-u-save"); var saveBtn = body.querySelector("#cf24-u-save");
var orphanNote = state.orphans.length ? "\n- 품목 없는 옵션값 " + state.orphans.length + "개는 사라집니다." : ""; var orphanNote = state.orphans.length ? "\n- 품목 없는 옵션값 " + state.orphans.length + "개는 사라집니다." : "";
window.erpConfirm("옵션을 전부 지우고 현재 " + rows.length + "행으로 다시 만듭니다.\n\n- 모든 품목코드가 새로 부여됩니다(주문 이력·외부 연동이 품목코드를 참조하면 영향).\n- 재고 수량은 초기화될 수 있습니다." + orphanNote + "\n\n되돌릴 수 없습니다. 계속할까요?") window.erpConfirm((intro || "") + "옵션을 전부 지우고 현재 " + rows.length + "행으로 다시 만듭니다.\n\n- 모든 품목코드가 새로 부여됩니다(주문 이력·외부 연동이 품목코드를 참조하면 영향).\n- 재고 수량은 초기화될 수 있습니다." + orphanNote + "\n\n되돌릴 수 없습니다. 계속할까요?")
.then(function (ok) { if (ok) createFromRows(rows, optName, optType, saveBtn, msg, true); }); .then(function (ok) { if (ok) createFromRows(rows, optName, optType, saveBtn, msg, true); });
} }
+6 -6
View File
@@ -67,7 +67,7 @@ app/modules/cafe24/ ← 상품관리 모듈
| `POST /cafe24/products/{product_no}/image` | 대표 이미지 교체 (multipart `file`) — `POST /admin/products/{no}/images`(base64 data URI, `image_upload_type=A`). 감사로그 `set_main_image` | `cafe24` | | `POST /cafe24/products/{product_no}/image` | 대표 이미지 교체 (multipart `file`) — `POST /admin/products/{no}/images`(base64 data URI, `image_upload_type=A`). 감사로그 `set_main_image` | `cafe24` |
| `GET /cafe24/products/{product_no}/options` | 옵션 + 품목 조회 (JSON, 읽기 지연 보정 포함) | `cafe24` | | `GET /cafe24/products/{product_no}/options` | 옵션 + 품목 조회 (JSON, 읽기 지연 보정 포함) | `cafe24` |
| `POST /cafe24/products/{product_no}/options` | 옵션 생성 (`{option_name, values, display_type}`) — 조합형, 품목 자동 생성 | `cafe24` | | `POST /cafe24/products/{product_no}/options` | 옵션 생성 (`{option_name, values, display_type}`) — 조합형, 품목 자동 생성 | `cafe24` |
| `PUT /cafe24/products/{product_no}/options` | 옵션명·옵션값 이름/썸네일/표시방식 수정 + 옵션값 끝에 덧붙이기 (`{options:[...], option_list_type}` → 덧붙였으면 `added` 와 새 품목 포함) | `cafe24` | | `PUT /cafe24/products/{product_no}/options` | 옵션명·옵션값 이름/썸네일/표시방식 수정 (`{options:[...], option_list_type}`; 옵션값 개수 변경은 400 — 추가는 재생성) | `cafe24` |
| `DELETE /cafe24/products/{product_no}/options` | 옵션 삭제 — **품목도 함께 삭제**(화면 확인창) | `cafe24` | | `DELETE /cafe24/products/{product_no}/options` | 옵션 삭제 — **품목도 함께 삭제**(화면 확인창) | `cafe24` |
| `POST /cafe24/products/{product_no}/options/image` | 옵션값 썸네일 업로드만 (multipart → `{path}`) | `cafe24` | | `POST /cafe24/products/{product_no}/options/image` | 옵션값 썸네일 업로드만 (multipart → `{path}`) | `cafe24` |
| `PUT /cafe24/products/{product_no}/variants` | 품목 자체코드·추가금액·진열·판매·진열순서 일괄 수정 (`{rows:[...]}`, 바뀐 행만) | `cafe24` | | `PUT /cafe24/products/{product_no}/variants` | 품목 자체코드·추가금액·진열·판매·진열순서 일괄 수정 (`{rows:[...]}`, 바뀐 행만) | `cafe24` |
@@ -494,11 +494,11 @@ cafe24_oauth_tokens 저장
- **옵션값 불러오기**: 텍스트(탭 또는 두 칸 이상 공백 구분 — 이름 · 판매가 · 추가금액 · - **옵션값 불러오기**: 텍스트(탭 또는 두 칸 이상 공백 구분 — 이름 · 판매가 · 추가금액 ·
자체코드, 판매가는 무시, 추가금액 「-」는 0)를 붙여넣어 행에 채운다. 옵션이 있는 상품은 자체코드, 판매가는 무시, 추가금액 「-」는 0)를 붙여넣어 행에 채운다. 옵션이 있는 상품은
이름(공백 무시)으로 짝을 찾아 자체코드/추가금액만 채우고, 없는 이름은 새 행으로 추가한다. 이름(공백 무시)으로 짝을 찾아 자체코드/추가금액만 채우고, 없는 이름은 새 행으로 추가한다.
- **품목 추가**(「+ 행 추가」): 저장 시 옵션값을 **끝에 덧붙여** PUT options 한다 - **품목 추가**(「+ 행 추가」·불러오기의 새 행): 카페24 PUT options 는 옵션값 추가를
(`build_update_options_request(allow_append=True)`). 앞쪽 위치는 그대로라 기존 이름이 지원하지 않는다(문서 "옵션 항목 추가/삭제 불가"). 실물에서 끝에 덧붙여 PUT 하면 **오류 없이
밀리지 않는다. 카페24가 받아들이면 품목을 자동 생성하므로 `wait_for_variants` 로 새 무시**되어 "저장했는데 사라짐" 버그가 났다(2026-11-06). 그래서 새 행이 있으면 「저장」이
코드를 받아 자체코드·추가금액·진열/판매를 이어서 PUT 한다. 거부하면 그 오류가 화면에 뜬다 확인창을 거쳐 **아래 옵션 재생성**으로 반영한다(품목코드 새로 부여). 서버
(문서상 "옵션 항목 추가/삭제 불가" 문구가 있어 실물 확인 필요 — 안 되면 아래 재생성). `build_update_options_request` 도 개수 증가를 400 으로 거부한다.
- **품목 삭제**(행의 ✕): `DELETE /admin/products/{no}/variants/{code}`(문서에 있는 유일한 - **품목 삭제**(행의 ✕): `DELETE /admin/products/{no}/variants/{code}`(문서에 있는 유일한
제거 수단). 옵션값 이름은 남을 수 있다 → 화면 하단 "품목이 없는 옵션값" 안내. 카페24 GET 제거 수단). 옵션값 이름은 남을 수 있다 → 화면 하단 "품목이 없는 옵션값" 안내. 카페24 GET
이 한동안 삭제된 품목을 계속 돌려주므로 스냅샷에 `{"_deleted": true}` 를 남겨 걸러낸다. 이 한동안 삭제된 품목을 계속 돌려주므로 스냅샷에 `{"_deleted": true}` 를 남겨 걸러낸다.
+6 -11
View File
@@ -519,20 +519,15 @@ def test_route_10_rename_with_lagging_variants_keeps_rows():
assert created["variants"] assert created["variants"]
def test_route_08_appended_value_pending_until_variant_appears(): def test_route_08_append_value_rejected_before_put():
# 카페24 PUT 은 옵션값 추가를 오류 없이 무시한다 — "저장했는데 사라짐" 대신 400 으로 재생성 안내.
no, cafe = _new_product() no, cafe = _new_product()
_create_options(no, ["A"]) _create_options(no, ["A"])
cafe.hidden_variants = 99 # 새 품목이 한동안 안 보인다 puts = len([c for c in cafe.calls if c[0] == "PUT"])
resp = req("PUT", f"/cafe24/products/{no}/options", json={"options": [{ resp = req("PUT", f"/cafe24/products/{no}/options", json={"options": [{
"option_name": "구성", "option_value": [{"option_text": "A"}, {"option_text": "B"}]}]}).json() "option_name": "구성", "option_value": [{"option_text": "A"}, {"option_text": "B"}]}]})
values = resp["option"]["options"][0]["option_value"] assert resp.status_code == 400 and "옵션 재생성" in resp.text, resp.text
assert values[1]["option_text"] == "B" and values[1]["pending"] is True assert len([c for c in cafe.calls if c[0] == "PUT"]) == puts
got = req("GET", f"/cafe24/products/{no}/options").json()
assert got["option"]["options"][0]["option_value"][1]["pending"] is True
cafe.hidden_variants = 0
got = req("GET", f"/cafe24/products/{no}/options").json()
assert got["option"]["options"][0]["option_value"][1]["pending"] is False
assert len(got["variants"]) == 2
def test_route_11_deleted_variant_stays_hidden(): def test_route_11_deleted_variant_stays_hidden():