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:
@@ -35,7 +35,7 @@ Claude Code는 이 저장소에서 작업을 시작하기 전에 **반드시 아
|
|||||||
- 휴가 관리 (`app/modules/vacation/`, `vacation_db`) — 월간 달력(구글식 bar)/연차·반차 신청/승인 워크플로/공휴일·연차 설정. 권한키 `vacation`·`vacation_approver`
|
- 휴가 관리 (`app/modules/vacation/`, `vacation_db`) — 월간 달력(구글식 bar)/연차·반차 신청/승인 워크플로/공휴일·연차 설정. 권한키 `vacation`·`vacation_approver`
|
||||||
- 말레이시아 창고 재고관리 (`app/modules/malaysia/`, `malaysia_stock_db`) — 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트→낱개 자동 분해), 현재고 현황. 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`). 상품은 `itemcode_db` 읽기 전용. 권한키 `malaysia`
|
- 말레이시아 창고 재고관리 (`app/modules/malaysia/`, `malaysia_stock_db`) — 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트→낱개 자동 분해), 현재고 현황. 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`). 상품은 `itemcode_db` 읽기 전용. 권한키 `malaysia`
|
||||||
- 말레이시아 배송 (`app/modules/dispatch/`, `dispatch_db`) — TikTok·Shopee 출고관리. 플랫폼별 데이터 엑셀 업로드(TikTok=03_TikTok_Order_Export.xlsx, Shopee=Packing List.Doorstep Delivery.xlsx) → 1상자=1카드 출고 작업 리스트·SKU 피킹 요약·Kagayaku 전달표 자동 생성. 1상자 묶음 기준 Package ID > Tracking ID > Order ID, 같은 상자 같은 SKU 합산. 작업 상태 토글(`dispatch_logs` 기록). 받는 사람 이름/전화/주소는 상자 단위로 저장(작업 카드 표시 + 출고 엑셀 생성용 — 개인정보). 배치 다운로드 zip 에 업로드 원본 + 취합 출고 엑셀(`YYYY.MM.DD(Ddd)_tictoc|shopee.xlsx`) 포함. 엑셀은 openpyxl 파싱/생성. 권한키 `dispatch`. 상세는 `docs/DISPATCH_MODULE.md`
|
- 말레이시아 배송 (`app/modules/dispatch/`, `dispatch_db`) — TikTok·Shopee 출고관리. 플랫폼별 데이터 엑셀 업로드(TikTok=03_TikTok_Order_Export.xlsx, Shopee=Packing List.Doorstep Delivery.xlsx) → 1상자=1카드 출고 작업 리스트·SKU 피킹 요약·Kagayaku 전달표 자동 생성. 1상자 묶음 기준 Package ID > Tracking ID > Order ID, 같은 상자 같은 SKU 합산. 작업 상태 토글(`dispatch_logs` 기록). 받는 사람 이름/전화/주소는 상자 단위로 저장(작업 카드 표시 + 출고 엑셀 생성용 — 개인정보). 배치 다운로드 zip 에 업로드 원본 + 취합 출고 엑셀(`YYYY.MM.DD(Ddd)_tictoc|shopee.xlsx`) 포함. 엑셀은 openpyxl 파싱/생성. 권한키 `dispatch`. 상세는 `docs/DISPATCH_MODULE.md`
|
||||||
- 카페24 상품관리 (`app/modules/cafe24/`, `cafe24_db`) — 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·버전 이력. 3분할 화면(목록 | HTML 편집기 | 상품 정보 패널). 정보 패널(`routes_product_info.py`, `_side.html`)에서 상품명·판매가·공급가·소비자가, 대표이미지(업로드 → `POST /admin/products/images` → PUT `detail_image`+`image_upload_type=A`), 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매)을 수정. 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). **카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전 값을 돌려준다(읽기 지연)** — 우리 캐시 문제가 아니다. 그래서 "마지막 쓰기가 권위": 상세설명은 카페24 값이 최근 revision 중 하나와 같으면 지연으로 보고 마지막 MANUAL/SCHEDULED 를 표시·지문 기준으로 쓰고(`store.resolve_description`), 스칼라(상품명·가격·이미지·진열/판매)는 PUT 응답 스냅샷(`cafe24_products.last_write_snapshot`, 마이그레이션 004)과 GET 의 `updated_date` 를 비교해 덮어씌운다(`store.overlay_recent_write`). 유예시간 `CAFE24_READ_LAG_GRACE_MIN`(기본 360분). 쓰기 후 화면은 PUT 응답으로 그리고 다시 GET 하지 않는다. 예약은 DB 저장 + 별도 worker(`app/modules/cafe24/worker.py`, compose 서비스 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다. 권한키 `cafe24`(연결/해제는 admin 전용). 상세는 `docs/CAFE24_MODULE.md`
|
- 카페24 상품관리 (`app/modules/cafe24/`, `cafe24_db`) — 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·버전 이력. 3분할 화면(목록 | HTML 편집기 | 상품 정보 패널). 정보 패널(`routes_product_info.py`, `_side.html`)에서 상품명·판매가·공급가·소비자가, 대표이미지(`POST /admin/products/{no}/images` 에 base64 data URI + `image_upload_type=A` — NNEditor 업로드 경로를 PUT `detail_image` 에 넣는 방식은 적용 안 됨), 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매)을 수정. 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). **카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전 값을 돌려준다(읽기 지연)** — 우리 캐시 문제가 아니다. 그래서 "마지막 쓰기가 권위": 상세설명은 카페24 값이 최근 revision 중 하나와 같으면 지연으로 보고 마지막 MANUAL/SCHEDULED 를 표시·지문 기준으로 쓰고(`store.resolve_description`), 스칼라(상품명·가격·이미지·진열/판매)는 PUT 응답 스냅샷(`cafe24_products.last_write_snapshot`, 마이그레이션 004)과 GET 의 `updated_date` 를 비교해 덮어씌운다(`store.overlay_recent_write`). 유예시간 `CAFE24_READ_LAG_GRACE_MIN`(기본 360분). 쓰기 후 화면은 PUT 응답으로 그리고 다시 GET 하지 않는다. 예약은 DB 저장 + 별도 worker(`app/modules/cafe24/worker.py`, compose 서비스 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다. 권한키 `cafe24`(연결/해제는 admin 전용). 상세는 `docs/CAFE24_MODULE.md`
|
||||||
- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·프로젝트 색상(아사나 16색)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 작업(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/project/trash`). 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 말풍선은 전부 아사나식 공용 말풍선(`.pj-hovertip`) — 새 기능도 `title=`/`data-tip=` 만 달고 별도 툴팁 구현 금지. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 작업 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md`
|
- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·프로젝트 색상(아사나 16색)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 작업(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/project/trash`). 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 말풍선은 전부 아사나식 공용 말풍선(`.pj-hovertip`) — 새 기능도 `title=`/`data-tip=` 만 달고 별도 툴팁 구현 금지. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 작업 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md`
|
||||||
|
|
||||||
상세는 `docs/PROJECT_OVERVIEW.md`.
|
상세는 `docs/PROJECT_OVERVIEW.md`.
|
||||||
|
|||||||
@@ -346,9 +346,48 @@ def upload_image_bytes(client: Cafe24Client, data: bytes) -> str:
|
|||||||
return paths[0] if paths else ""
|
return paths[0] if paths else ""
|
||||||
|
|
||||||
|
|
||||||
def set_main_image(client: Cafe24Client, product_no: int, image_path: str) -> dict[str, Any]:
|
def set_main_image(
|
||||||
"""대표이미지 교체 — 목록/작은목록/축소 이미지는 카페24가 리사이징(A 타입)."""
|
client: Cafe24Client,
|
||||||
return update_product(client, product_no, detail_image=image_path, image_upload_type="A")
|
product_no: int,
|
||||||
|
data: bytes,
|
||||||
|
*,
|
||||||
|
content_type: str = "image/jpeg",
|
||||||
|
shop_no: int = 1,
|
||||||
|
) -> dict[str, str]:
|
||||||
|
"""대표이미지 교체 — POST /admin/products/{no}/images (상품 이미지 등록).
|
||||||
|
|
||||||
|
body `{"shop_no":1,"request":{"image_upload_type":"A","detail_image":"data:<mime>;base64,…"}}`
|
||||||
|
→ `{"image":{detail_image, list_image, tiny_image, small_image}}` (새 /web/product/… 경로).
|
||||||
|
A(대표이미지등록)면 카페24가 상세이미지를 리사이징해 목록/작은목록/축소에도 넣는다.
|
||||||
|
|
||||||
|
⚠️ `/admin/products/images`(상세설명 에디터용, /web/upload/NNEditor/…) 로 올린 경로를
|
||||||
|
`PUT /admin/products/{no}` 의 detail_image 에 넣는 방식은 대표이미지가 바뀌지 않았다
|
||||||
|
(실물 — "업로드했는데 적용 안 됨"). 대표이미지는 반드시 이 전용 API 로 등록한다.
|
||||||
|
"""
|
||||||
|
import base64 # noqa: WPS433
|
||||||
|
|
||||||
|
if not data:
|
||||||
|
return {}
|
||||||
|
no = int(product_no)
|
||||||
|
b64 = base64.b64encode(data).decode("ascii")
|
||||||
|
payload = {
|
||||||
|
"shop_no": int(shop_no),
|
||||||
|
"request": {
|
||||||
|
"image_upload_type": "A",
|
||||||
|
"detail_image": f"data:{content_type or 'image/jpeg'};base64,{b64}",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
response = client.post(f"/admin/products/{no}/images", json=payload, product_no=no, timeout=UPLOAD_TIMEOUT)
|
||||||
|
image = response.get("image")
|
||||||
|
if isinstance(image, list): # 문서는 dict — 목록으로 올 때도 첫 건을 쓴다
|
||||||
|
image = image[0] if image else {}
|
||||||
|
if not isinstance(image, dict):
|
||||||
|
return {}
|
||||||
|
return {
|
||||||
|
key: str(image.get(key) or "")
|
||||||
|
for key in ("detail_image", "list_image", "tiny_image", "small_image")
|
||||||
|
if image.get(key)
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
# ════════════════════════════════════════════════════════════
|
# ════════════════════════════════════════════════════════════
|
||||||
|
|||||||
@@ -29,6 +29,7 @@ from typing import Any
|
|||||||
from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile
|
from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile
|
||||||
|
|
||||||
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
|
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
|
||||||
|
from app.timezone import now_kst
|
||||||
|
|
||||||
from . import store
|
from . import store
|
||||||
from .common import read_lag_grace_minutes, require_store
|
from .common import read_lag_grace_minutes, require_store
|
||||||
@@ -155,10 +156,13 @@ def product_image(
|
|||||||
product_no: int,
|
product_no: int,
|
||||||
file: UploadFile = File(...),
|
file: UploadFile = File(...),
|
||||||
) -> dict[str, Any]:
|
) -> dict[str, Any]:
|
||||||
"""대표 이미지 교체. 업로드(/products/images) → PUT detail_image(A 타입).
|
"""대표 이미지 교체 — POST /products/{no}/images (A 타입, base64 직접 등록).
|
||||||
|
|
||||||
A(대표이미지등록) 타입이면 목록/작은목록/축소 이미지는 카페24가 리사이징한다.
|
A(대표이미지등록) 타입이면 목록/작은목록/축소 이미지는 카페24가 리사이징한다.
|
||||||
이전 이미지 경로는 감사로그에 남긴다(되돌리려면 그 경로를 다시 넣는다).
|
응답의 새 경로 4개로 화면을 그리고 스냅샷에 남긴다(GET 은 한동안 예전 이미지).
|
||||||
|
이 응답엔 updated_date 가 없어 스냅샷 시각은 지금으로 둔다 — 그보다 이전 레코드를
|
||||||
|
돌려주는 GET 은 지연으로 보고 새 이미지를 덮어씌운다(store.overlay_recent_write).
|
||||||
|
이전 이미지 경로는 감사로그에 남긴다.
|
||||||
"""
|
"""
|
||||||
st, user = require_store(request)
|
st, user = require_store(request)
|
||||||
actor = str(user.get("email") or "")
|
actor = str(user.get("email") or "")
|
||||||
@@ -169,25 +173,26 @@ def product_image(
|
|||||||
current, _ = load_product(st, api, product_no)
|
current, _ = load_product(st, api, product_no)
|
||||||
except Cafe24Error as exc:
|
except Cafe24Error as exc:
|
||||||
raise _http_from_cafe24(exc) from exc
|
raise _http_from_cafe24(exc) from exc
|
||||||
|
if not current:
|
||||||
|
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
|
||||||
before = str(current.get("detail_image") or "")
|
before = str(current.get("detail_image") or "")
|
||||||
|
|
||||||
try:
|
try:
|
||||||
path = products.upload_image_bytes(api.client, data)
|
images = products.set_main_image(
|
||||||
if not path:
|
api.client, product_no, data, content_type=(file.content_type or "").lower()
|
||||||
raise Cafe24Error("카페24가 업로드 경로를 돌려주지 않았습니다.")
|
)
|
||||||
updated = products.set_main_image(api.client, product_no, path)
|
if not images.get("detail_image"):
|
||||||
|
raise Cafe24Error("카페24가 등록된 이미지 경로를 돌려주지 않았습니다.")
|
||||||
except Cafe24Error as exc:
|
except Cafe24Error as exc:
|
||||||
st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
|
st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
|
||||||
result="FAIL", detail=f"업로드/적용 실패: {exc}")
|
result="FAIL", detail=f"등록 실패: {exc}")
|
||||||
logger.warning("카페24 상품 %s 대표이미지 변경 실패: %s", product_no, exc)
|
logger.warning("카페24 상품 %s 대표이미지 변경 실패: %s", product_no, exc)
|
||||||
raise _http_from_cafe24(exc) from exc
|
raise _http_from_cafe24(exc) from exc
|
||||||
|
|
||||||
remember_write(st, product_no, updated if isinstance(updated, dict) else {})
|
merged = {**current, **images, "updated_date": now_kst().isoformat(timespec="seconds")}
|
||||||
merged = {**current, **(updated if isinstance(updated, dict) else {})}
|
remember_write(st, product_no, merged)
|
||||||
if not merged.get("detail_image"):
|
|
||||||
merged["detail_image"] = path
|
|
||||||
st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
|
st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
|
||||||
result="SUCCESS", detail=f"'{before}' → '{merged.get('detail_image')}' (업로드 {path})")
|
result="SUCCESS", detail=f"'{before}' → '{images['detail_image']}'")
|
||||||
logger.info("카페24 상품 %s 대표이미지 변경 (%s)", product_no, actor)
|
logger.info("카페24 상품 %s 대표이미지 변경 (%s)", product_no, actor)
|
||||||
return {"ok": True, "product": _scalar_view(merged)}
|
return {"ok": True, "product": _scalar_view(merged)}
|
||||||
|
|
||||||
@@ -294,8 +299,10 @@ def options_get(request: Request, product_no: int) -> dict[str, Any]:
|
|||||||
loaded = _load_options_and_variants(st, api, product_no)
|
loaded = _load_options_and_variants(st, api, product_no)
|
||||||
except Cafe24Error as exc:
|
except Cafe24Error as exc:
|
||||||
raise _http_from_cafe24(exc) from exc
|
raise _http_from_cafe24(exc) from exc
|
||||||
|
# image_base: 카페24가 "/web/product/…" 상대경로로 준 썸네일을 화면이 쇼핑몰 주소에
|
||||||
|
# 붙여 그리기 위한 값(그대로 src 에 넣으면 우리 도메인에서 찾다가 깨진다).
|
||||||
return {"ok": True, "option": loaded["option"], "variants": loaded["variants"],
|
return {"ok": True, "option": loaded["option"], "variants": loaded["variants"],
|
||||||
"display_types": store.OPTION_DISPLAY_LABELS}
|
"display_types": store.OPTION_DISPLAY_LABELS, "image_base": api.config.shop_base}
|
||||||
|
|
||||||
|
|
||||||
@product_info_router.post("/products/{product_no}/options")
|
@product_info_router.post("/products/{product_no}/options")
|
||||||
|
|||||||
@@ -125,7 +125,7 @@
|
|||||||
{% endblock %}
|
{% endblock %}
|
||||||
|
|
||||||
{% block scripts %}
|
{% block scripts %}
|
||||||
<script src="/static/cafe24-options.js?v=20260919b"></script>
|
<script src="/static/cafe24-options.js?v=20260928a"></script>
|
||||||
<script>
|
<script>
|
||||||
(function () {
|
(function () {
|
||||||
var pane = document.getElementById("cf24-editor-pane");
|
var pane = document.getElementById("cf24-editor-pane");
|
||||||
|
|||||||
@@ -1193,6 +1193,34 @@ def test_upload_images_and_variants_wrappers():
|
|||||||
assert client.calls[-1][0] == "DELETE"
|
assert client.calls[-1][0] == "DELETE"
|
||||||
|
|
||||||
|
|
||||||
|
def test_set_main_image_uses_product_images_endpoint():
|
||||||
|
"""대표이미지는 POST /products/{no}/images 에 data URI 로 A 타입 등록 — 새 경로 4개를 돌려준다."""
|
||||||
|
client = _RouteClient({
|
||||||
|
"POST /admin/products/13/images": {"image": {
|
||||||
|
"shop_no": 1, "product_no": 13,
|
||||||
|
"detail_image": "https://d/web/product/big/x.png",
|
||||||
|
"list_image": "https://d/web/product/medium/x.png",
|
||||||
|
"tiny_image": "https://d/web/product/tiny/x.png",
|
||||||
|
"small_image": "https://d/web/product/small/x.png",
|
||||||
|
}},
|
||||||
|
})
|
||||||
|
out = products.set_main_image(client, 13, b"\x89PNG", content_type="image/png")
|
||||||
|
assert out == {
|
||||||
|
"detail_image": "https://d/web/product/big/x.png",
|
||||||
|
"list_image": "https://d/web/product/medium/x.png",
|
||||||
|
"tiny_image": "https://d/web/product/tiny/x.png",
|
||||||
|
"small_image": "https://d/web/product/small/x.png",
|
||||||
|
}
|
||||||
|
method, path, body = client.calls[-1]
|
||||||
|
assert (method, path) == ("POST", "/admin/products/13/images")
|
||||||
|
assert body["shop_no"] == 1
|
||||||
|
assert body["request"]["image_upload_type"] == "A"
|
||||||
|
assert body["request"]["detail_image"].startswith("data:image/png;base64,")
|
||||||
|
# 상품 PUT(detail_image 경로 넣기)은 더 이상 쓰지 않는다
|
||||||
|
assert not [c for c in client.calls if c[0] == "PUT"]
|
||||||
|
assert products.set_main_image(client, 13, b"") == {}
|
||||||
|
|
||||||
|
|
||||||
def _run_all():
|
def _run_all():
|
||||||
fns = [v for k, v in sorted(globals().items()) if k.startswith("test_") and callable(v)]
|
fns = [v for k, v in sorted(globals().items()) if k.startswith("test_") and callable(v)]
|
||||||
for fn in fns:
|
for fn in fns:
|
||||||
|
|||||||
@@ -28,6 +28,18 @@
|
|||||||
|
|
||||||
var DEFAULT_TYPE = "S";
|
var DEFAULT_TYPE = "S";
|
||||||
|
|
||||||
|
// 썸네일 <img> onerror — data-fallback(줄바꿈 구분)의 다음 후보로, 없으면 "없음".
|
||||||
|
window.cf24ThumbFallback = function (img) {
|
||||||
|
var rest = (img.getAttribute("data-fallback") || "").split("\n").filter(Boolean);
|
||||||
|
if (rest.length) {
|
||||||
|
img.setAttribute("data-fallback", rest.slice(1).join("\n"));
|
||||||
|
img.src = rest[0];
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
img.onerror = null;
|
||||||
|
img.outerHTML = '<div class="cf24-opt-thumb-empty">없음</div>';
|
||||||
|
};
|
||||||
|
|
||||||
window.cf24SetupOptions = function (ctx) {
|
window.cf24SetupOptions = function (ctx) {
|
||||||
var root = ctx.root, no = ctx.productNo, modal = ctx.modal;
|
var root = ctx.root, no = ctx.productNo, modal = ctx.modal;
|
||||||
var apiJson = ctx.apiJson, esc = ctx.escHtml, setMsg = ctx.setMsg;
|
var apiJson = ctx.apiJson, esc = ctx.escHtml, setMsg = ctx.setMsg;
|
||||||
@@ -38,7 +50,7 @@
|
|||||||
var count = root.querySelector("#cf24-options-count");
|
var count = root.querySelector("#cf24-options-count");
|
||||||
if (!openBtn || !body) return;
|
if (!openBtn || !body) return;
|
||||||
|
|
||||||
var state = { option: null, variants: [], displayTypes: {}, orphans: [] };
|
var state = { option: null, variants: [], displayTypes: {}, orphans: [], imageBase: "" };
|
||||||
|
|
||||||
openBtn.addEventListener("click", function () {
|
openBtn.addEventListener("click", function () {
|
||||||
var nameEl = document.getElementById("cf24-name-text");
|
var nameEl = document.getElementById("cf24-name-text");
|
||||||
@@ -53,6 +65,7 @@
|
|||||||
state.option = data.option;
|
state.option = data.option;
|
||||||
state.variants = data.variants || [];
|
state.variants = data.variants || [];
|
||||||
state.displayTypes = data.display_types || {};
|
state.displayTypes = data.display_types || {};
|
||||||
|
state.imageBase = data.image_base || "";
|
||||||
render();
|
render();
|
||||||
})
|
})
|
||||||
.catch(function (err) {
|
.catch(function (err) {
|
||||||
@@ -139,13 +152,29 @@
|
|||||||
return "";
|
return "";
|
||||||
}
|
}
|
||||||
|
|
||||||
// 카페24가 경로는 주지만 파일이 없는 경우가 있다(깨진 그림) — 실패하면 "없음"으로 바꾼다.
|
// 카페24 이미지 경로는 "/web/product/big/…" 처럼 **상대경로**로 오기도 한다(옵션 연결
|
||||||
|
// 이미지 등). 그대로 src 에 넣으면 우리 도메인에서 찾다가 깨진다 — 쇼핑몰 주소를 붙인다.
|
||||||
|
// hidden 값(카페24에 다시 보내는 값)은 받은 그대로 둔다.
|
||||||
|
function imageUrl(path) {
|
||||||
|
path = String(path || "").trim();
|
||||||
|
if (!path) return "";
|
||||||
|
if (path.indexOf("//") === 0) return "https:" + path;
|
||||||
|
if (path.charAt(0) === "/") return state.imageBase ? state.imageBase + path : "";
|
||||||
|
return path;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 후보(버튼 이미지 → 연결 이미지 → 품목 image) 중 첫 번째를 보여주고, 깨지면 다음
|
||||||
|
// 후보로 넘어간다(cf24ThumbFallback). 전부 실패하면 "없음".
|
||||||
var THUMB_EMPTY = '<div class="cf24-opt-thumb-empty">없음</div>';
|
var THUMB_EMPTY = '<div class="cf24-opt-thumb-empty">없음</div>';
|
||||||
function thumbHtml(src, title) {
|
function thumbHtml(candidates, title) {
|
||||||
return src
|
var urls = [];
|
||||||
? '<img class="cf24-opt-thumb" src="' + esc(src) + '" alt="" title="' + esc(title || "") +
|
(Array.isArray(candidates) ? candidates : [candidates]).forEach(function (c) {
|
||||||
'" onerror="this.outerHTML=\'' + THUMB_EMPTY.replace(/"/g, """) + '\'" />'
|
var u = imageUrl(c);
|
||||||
: THUMB_EMPTY;
|
if (u && urls.indexOf(u) < 0) urls.push(u);
|
||||||
|
});
|
||||||
|
if (!urls.length) return THUMB_EMPTY;
|
||||||
|
return '<img class="cf24-opt-thumb" src="' + esc(urls[0]) + '" alt="" title="' + esc(title || "") +
|
||||||
|
'" data-fallback="' + esc(urls.slice(1).join("\n")) + '" onerror="cf24ThumbFallback(this)" />';
|
||||||
}
|
}
|
||||||
|
|
||||||
// 썸네일 파일 선택 → 업로드 → hidden 두 개(option_image_file, option_link_image)에 경로
|
// 썸네일 파일 선택 → 업로드 → hidden 두 개(option_image_file, option_link_image)에 경로
|
||||||
@@ -220,8 +249,8 @@
|
|||||||
var v = r.value || { option_text: "", option_image_file: "", option_link_image: "", option_color: "" };
|
var v = r.value || { option_text: "", option_image_file: "", option_link_image: "", option_color: "" };
|
||||||
var variant = r.variant;
|
var variant = r.variant;
|
||||||
var isNewRow = r.index == null;
|
var isNewRow = r.index == null;
|
||||||
var thumbSrc = v.option_image_file || v.option_link_image ||
|
var thumbSrc = [v.option_image_file, v.option_link_image,
|
||||||
(state.option && state.option.has_option ? variantImageFor(state.option.options[0].option_name, v.option_text) : "");
|
state.option && state.option.has_option ? variantImageFor(state.option.options[0].option_name, v.option_text) : ""];
|
||||||
var code = variant ? variant.variant_code : "";
|
var code = variant ? variant.variant_code : "";
|
||||||
// data-index: options 응답 안 위치(옵션 PUT 짝맞춤용, 새 행은 빈 값) / data-pos: 처음 그린 순서(순서 변경 판정용)
|
// data-index: options 응답 안 위치(옵션 PUT 짝맞춤용, 새 행은 빈 값) / data-pos: 처음 그린 순서(순서 변경 판정용)
|
||||||
return '<tr class="cf24-u-row' + (isNewRow ? " is-new" : "") + '" data-index="' + (isNewRow ? "" : r.index) + '" data-pos="' + (position == null ? "" : position) + '" data-code="' + esc(code) + '">' +
|
return '<tr class="cf24-u-row' + (isNewRow ? " is-new" : "") + '" data-index="' + (isNewRow ? "" : r.index) + '" data-pos="' + (position == null ? "" : position) + '" data-code="' + esc(code) + '">' +
|
||||||
@@ -801,7 +830,7 @@
|
|||||||
'<label class="cf24-side-field"><span>옵션명</span><input type="text" name="option_name" value="' + esc(o.option_name) + '" /></label>' +
|
'<label class="cf24-side-field"><span>옵션명</span><input type="text" name="option_name" value="' + esc(o.option_name) + '" /></label>' +
|
||||||
'<label class="cf24-side-field cf24-side-field-type"><span>표시방식</span>' + typeSelect(o.option_display_type || DEFAULT_TYPE, "option_display_type") + "</label></div>";
|
'<label class="cf24-side-field cf24-side-field-type"><span>표시방식</span>' + typeSelect(o.option_display_type || DEFAULT_TYPE, "option_display_type") + "</label></div>";
|
||||||
o.option_value.forEach(function (v, vi) {
|
o.option_value.forEach(function (v, vi) {
|
||||||
var src = v.option_image_file || v.option_link_image || variantImageFor(o.option_name, v.option_text);
|
var src = [v.option_image_file, v.option_link_image, variantImageFor(o.option_name, v.option_text)];
|
||||||
html += '<div class="cf24-opt-value" data-value="' + vi + '"><span class="cf24-opt-thumb-slot">' + thumbHtml(src) + "</span>" +
|
html += '<div class="cf24-opt-value" data-value="' + vi + '"><span class="cf24-opt-thumb-slot">' + thumbHtml(src) + "</span>" +
|
||||||
'<input type="text" name="option_text" value="' + esc(v.option_text) + '" placeholder="옵션값 이름" />' +
|
'<input type="text" name="option_text" value="' + esc(v.option_text) + '" placeholder="옵션값 이름" />' +
|
||||||
'<input type="hidden" name="option_image_file" value="' + esc(v.option_image_file) + '" />' +
|
'<input type="hidden" name="option_image_file" value="' + esc(v.option_image_file) + '" />' +
|
||||||
@@ -822,7 +851,7 @@
|
|||||||
variants.forEach(function (v) {
|
variants.forEach(function (v) {
|
||||||
var label = v.options.map(function (o) { return o.value; }).join(" / ") || v.variant_code;
|
var label = v.options.map(function (o) { return o.value; }).join(" / ") || v.variant_code;
|
||||||
html += '<tr class="cf24-v-item" data-code="' + esc(v.variant_code) + '">' +
|
html += '<tr class="cf24-v-item" data-code="' + esc(v.variant_code) + '">' +
|
||||||
'<td class="cf24-v-imgcol">' + (v.image ? '<img class="cf24-v-img" src="' + esc(v.image) + '" alt="" />' : '<span class="cf24-v-img cf24-v-img-empty"></span>') + "</td>" +
|
'<td class="cf24-v-imgcol">' + (imageUrl(v.image) ? '<img class="cf24-v-img" src="' + esc(imageUrl(v.image)) + '" alt="" />' : '<span class="cf24-v-img cf24-v-img-empty"></span>') + "</td>" +
|
||||||
'<td class="cf24-v-name" title="' + esc(label) + '">' + esc(label) + "</td>" +
|
'<td class="cf24-v-name" title="' + esc(label) + '">' + esc(label) + "</td>" +
|
||||||
'<td class="cf24-v-syscode"><button type="button" class="cf24-v-copy" data-copy-text="' + esc(v.variant_code) + '">' + esc(v.variant_code) + "</button></td>" +
|
'<td class="cf24-v-syscode"><button type="button" class="cf24-v-copy" data-copy-text="' + esc(v.variant_code) + '">' + esc(v.variant_code) + "</button></td>" +
|
||||||
'<td class="cf24-v-code"><input type="text" name="custom_variant_code" maxlength="40" value="' + esc(v.custom_variant_code) + '" /></td>' +
|
'<td class="cf24-v-code"><input type="text" name="custom_variant_code" maxlength="40" value="' + esc(v.custom_variant_code) + '" /></td>' +
|
||||||
|
|||||||
+15
-5
@@ -64,7 +64,7 @@ app/modules/cafe24/ ← 상품관리 모듈
|
|||||||
| `POST /cafe24/products/{product_no}/status` | 진열/판매 토글 (JSON: `{field, value}` → 적용 후 상태) | `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}/name` | 상품명 변경 (JSON: `{name}` → 적용된 이름). 이전 이름은 감사로그 `rename_product` | `cafe24` |
|
||||||
| `POST /cafe24/products/{product_no}/basic` | 상품명·판매가·공급가·소비자가 (JSON, 바뀐 것만 PUT). 감사로그 `update_basic` | `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` |
|
| `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}` → 덧붙였으면 `added` 와 새 품목 포함) | `cafe24` |
|
||||||
@@ -440,9 +440,18 @@ cafe24_oauth_tokens 저장
|
|||||||
|
|
||||||
- **이미지 업로드**: `POST /admin/products/images` body `{"requests":[{"image":"<base64>"}]}`
|
- **이미지 업로드**: `POST /admin/products/images` body `{"requests":[{"image":"<base64>"}]}`
|
||||||
→ `{"images":[{"path":"https://{domain}/web/upload/NNEditor/…"}]}`. 1장 10MB, 1호출 30MB,
|
→ `{"images":[{"path":"https://{domain}/web/upload/NNEditor/…"}]}`. 1장 10MB, 1호출 30MB,
|
||||||
1회 20장. 상품 대표이미지는 그 경로를 `PUT /admin/products/{no}` 의 `detail_image` 에
|
1회 20장. 이 경로는 상세설명 에디터·옵션 썸네일용이다.
|
||||||
넣고 `image_upload_type: "A"`(대표이미지등록 — 목록/작은목록/축소를 카페24가 리사이징).
|
- **대표이미지**: `POST /admin/products/{no}/images` body `{"shop_no":1,"request":{
|
||||||
`B` 는 네 이미지를 각각 지정, `C` 는 웹FTP.
|
"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`
|
- **가격**: `price`(판매가) · `supply_price`(공급가, 문서상 "참조 목적") · `retail_price`
|
||||||
(소비자가). 문자열 `"11000.00"` 형식으로 보낸다(`store.parse_price`). 쇼핑몰 설정의
|
(소비자가). 문자열 `"11000.00"` 형식으로 보낸다(`store.parse_price`). 쇼핑몰 설정의
|
||||||
"판매가 계산 기준"이 상품가(B)면 `price` 대신 `price_excluding_tax` 를 써야 한다는 문서
|
"판매가 계산 기준"이 상품가(B)면 `price` 대신 `price_excluding_tax` 를 써야 한다는 문서
|
||||||
@@ -463,7 +472,8 @@ cafe24_oauth_tokens 저장
|
|||||||
- "옵션별 상품 이름" 은 옵션값(`option_text`)이고, "옵션별 썸네일" 은 `option_image_file`
|
- "옵션별 상품 이름" 은 옵션값(`option_text`)이고, "옵션별 썸네일" 은 `option_image_file`
|
||||||
(+ `option_link_image` 에도 같은 경로) 이며,
|
(+ `option_link_image` 에도 같은 경로) 이며,
|
||||||
화면의 옵션값 썸네일은 **`option_image_file` → `option_link_image` → 그 옵션값을 가진
|
화면의 옵션값 썸네일은 **`option_image_file` → `option_link_image` → 그 옵션값을 가진
|
||||||
품목의 `image`** 순으로 있는 것을 보여준다.
|
품목의 `image`** 순으로 있는 것을 보여주고, 불러오기에 실패하면 다음 후보로 넘어간다
|
||||||
|
(`cf24ThumbFallback`). 전부 실패해야 "없음".
|
||||||
- **통합 목록**(`app/static/cafe24-options.js`): 옵션이 1개(옵션명 하나)인 상품은 옵션값과
|
- **통합 목록**(`app/static/cafe24-options.js`): 옵션이 1개(옵션명 하나)인 상품은 옵션값과
|
||||||
품목이 1:1 이므로 한 행에 드래그핸들 · 썸네일 · 옵션값 이름 · 품목코드(클릭 복사) ·
|
품목이 1:1 이므로 한 행에 드래그핸들 · 썸네일 · 옵션값 이름 · 품목코드(클릭 복사) ·
|
||||||
자체 품목코드 · 추가금액 · 진열 · 판매를 두고 「저장」 한 번에 옵션 PUT(이름/썸네일/
|
자체 품목코드 · 추가금액 · 진열 · 판매를 두고 「저장」 한 번에 옵션 PUT(이름/썸네일/
|
||||||
|
|||||||
Reference in New Issue
Block a user