fix(cafe24): 대표이미지 적용 안 됨 + 옵션 썸네일 "없음" 오표시

- 대표이미지: NNEditor 업로드 경로를 PUT detail_image 에 넣던 방식은 카페24가
  반영하지 않았다. 문서의 전용 API POST /admin/products/{no}/images 에
  base64 data URI + image_upload_type=A 로 등록하고, 응답의 새 경로 4개로
  화면·스냅샷을 맞춘다(응답에 updated_date 가 없어 스냅샷 시각은 등록 시각).
- 옵션 썸네일: 카페24는 option_link_image 등을 "/web/product/big/…" 상대경로로
  준다. 그대로 src 에 넣어 우리 도메인에서 404 → "없음"으로 보였다. 옵션 GET 에
  image_base(쇼핑몰 주소)를 내려 붙여 그리고, 후보(버튼→연결→품목 이미지)가
  깨지면 다음 후보로 넘어간다. 카페24로 되보내는 hidden 값은 원본 그대로.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-28 00:33:17 +09:00
parent 81cd0ed0e9
commit e0dc818eab
7 changed files with 147 additions and 34 deletions
+15 -5
View File
@@ -64,7 +64,7 @@ app/modules/cafe24/ ← 상품관리 모듈
| `POST /cafe24/products/{product_no}/status` | 진열/판매 토글 (JSON: `{field, value}` → 적용 후 상태) | `cafe24` |
| `POST /cafe24/products/{product_no}/name` | 상품명 변경 (JSON: `{name}` → 적용된 이름). 이전 이름은 감사로그 `rename_product` | `cafe24` |
| `POST /cafe24/products/{product_no}/basic` | 상품명·판매가·공급가·소비자가 (JSON, 바뀐 것만 PUT). 감사로그 `update_basic` | `cafe24` |
| `POST /cafe24/products/{product_no}/image` | 대표 이미지 교체 (multipart `file`) — 업로드 후 PUT `detail_image` + `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` |
| `POST /cafe24/products/{product_no}/options` | 옵션 생성 (`{option_name, values, display_type}`) — 조합형, 품목 자동 생성 | `cafe24` |
| `PUT /cafe24/products/{product_no}/options` | 옵션명·옵션값 이름/썸네일/표시방식 수정 + 옵션값 끝에 덧붙이기 (`{options:[...], option_list_type}` → 덧붙였으면 `added` 와 새 품목 포함) | `cafe24` |
@@ -440,9 +440,18 @@ cafe24_oauth_tokens 저장
- **이미지 업로드**: `POST /admin/products/images` body `{"requests":[{"image":"<base64>"}]}`
→ `{"images":[{"path":"https://{domain}/web/upload/NNEditor/…"}]}`. 1장 10MB, 1호출 30MB,
1회 20장. 상품 대표이미지는 그 경로를 `PUT /admin/products/{no}` 의 `detail_image` 에
넣고 `image_upload_type: "A"`(대표이미지등록 — 목록/작은목록/축소를 카페24가 리사이징).
`B` 는 네 이미지를 각각 지정, `C` 는 웹FTP.
1회 20장. 이 경로는 상세설명 에디터·옵션 썸네일용이다.
- **대표이미지**: `POST /admin/products/{no}/images` body `{"shop_no":1,"request":{
"image_upload_type":"A","detail_image":"data:image/png;base64,…"}}` → `{"image":{detail_image,
list_image, tiny_image, small_image}}`(새 `/web/product/big|medium|tiny|small/…` 경로).
A(대표이미지등록)면 목록/작은목록/축소를 카페24가 리사이징, B 는 네 이미지를 각각 지정.
⚠️ 예전 방식(위 NNEditor 경로를 `PUT /admin/products/{no}` 의 `detail_image` 에 넣기)은
**대표이미지가 바뀌지 않았다**(실물, 2026-09-28 — "업로드했는데 적용 안 됨"). 이 응답엔
`updated_date` 가 없어 스냅샷 시각은 등록 시각(KST now)으로 남긴다.
- **이미지 경로는 상대경로로 올 수 있다**: `option_link_image` 등은 `/web/product/big/…` 처럼
도메인 없이 저장·응답된다(문서 예제). 화면은 옵션 GET 응답의 `image_base`(=쇼핑몰 주소
`shop_base`)를 붙여 그리고, 카페24에 되보내는 hidden 값은 받은 그대로 둔다. 예전에 이걸
"경로는 있는데 파일이 없다"로 오인해 "없음"으로 표시했다.
- **가격**: `price`(판매가) · `supply_price`(공급가, 문서상 "참조 목적") · `retail_price`
(소비자가). 문자열 `"11000.00"` 형식으로 보낸다(`store.parse_price`). 쇼핑몰 설정의
"판매가 계산 기준"이 상품가(B)면 `price` 대신 `price_excluding_tax` 를 써야 한다는 문서
@@ -463,7 +472,8 @@ cafe24_oauth_tokens 저장
- "옵션별 상품 이름" 은 옵션값(`option_text`)이고, "옵션별 썸네일" 은 `option_image_file`
(+ `option_link_image` 에도 같은 경로) 이며,
화면의 옵션값 썸네일은 **`option_image_file` → `option_link_image` → 그 옵션값을 가진
품목의 `image`** 순으로 있는 것을 보여준다.
품목의 `image`** 순으로 있는 것을 보여주고, 불러오기에 실패하면 다음 후보로 넘어간다
(`cf24ThumbFallback`). 전부 실패해야 "없음".
- **통합 목록**(`app/static/cafe24-options.js`): 옵션이 1개(옵션명 하나)인 상품은 옵션값과
품목이 1:1 이므로 한 행에 드래그핸들 · 썸네일 · 옵션값 이름 · 품목코드(클릭 복사) ·
자체 품목코드 · 추가금액 · 진열 · 판매를 두고 「저장」 한 번에 옵션 PUT(이름/썸네일/