diff --git a/CLAUDE.md b/CLAUDE.md index 1f61236..2ded344 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -35,7 +35,7 @@ Claude Code는 이 저장소에서 작업을 시작하기 전에 **반드시 아 - 휴가 관리 (`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/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` 상세는 `docs/PROJECT_OVERVIEW.md`. diff --git a/app/integrations/cafe24/products.py b/app/integrations/cafe24/products.py index 98fd8af..21849e8 100644 --- a/app/integrations/cafe24/products.py +++ b/app/integrations/cafe24/products.py @@ -346,9 +346,48 @@ def upload_image_bytes(client: Cafe24Client, data: bytes) -> str: return paths[0] if paths else "" -def set_main_image(client: Cafe24Client, product_no: int, image_path: str) -> dict[str, Any]: - """대표이미지 교체 — 목록/작은목록/축소 이미지는 카페24가 리사이징(A 타입).""" - return update_product(client, product_no, detail_image=image_path, image_upload_type="A") +def set_main_image( + client: Cafe24Client, + 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:;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) + } # ════════════════════════════════════════════════════════════ diff --git a/app/modules/cafe24/routes_product_info.py b/app/modules/cafe24/routes_product_info.py index d86535a..d67988c 100644 --- a/app/modules/cafe24/routes_product_info.py +++ b/app/modules/cafe24/routes_product_info.py @@ -29,6 +29,7 @@ from typing import Any from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products +from app.timezone import now_kst from . import store from .common import read_lag_grace_minutes, require_store @@ -155,10 +156,13 @@ def product_image( product_no: int, file: UploadFile = File(...), ) -> dict[str, Any]: - """대표 이미지 교체. 업로드(/products/images) → PUT detail_image(A 타입). + """대표 이미지 교체 — POST /products/{no}/images (A 타입, base64 직접 등록). A(대표이미지등록) 타입이면 목록/작은목록/축소 이미지는 카페24가 리사이징한다. - 이전 이미지 경로는 감사로그에 남긴다(되돌리려면 그 경로를 다시 넣는다). + 응답의 새 경로 4개로 화면을 그리고 스냅샷에 남긴다(GET 은 한동안 예전 이미지). + 이 응답엔 updated_date 가 없어 스냅샷 시각은 지금으로 둔다 — 그보다 이전 레코드를 + 돌려주는 GET 은 지연으로 보고 새 이미지를 덮어씌운다(store.overlay_recent_write). + 이전 이미지 경로는 감사로그에 남긴다. """ st, user = require_store(request) actor = str(user.get("email") or "") @@ -169,25 +173,26 @@ def product_image( current, _ = load_product(st, api, product_no) except Cafe24Error as 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 "") try: - path = products.upload_image_bytes(api.client, data) - if not path: - raise Cafe24Error("카페24가 업로드 경로를 돌려주지 않았습니다.") - updated = products.set_main_image(api.client, product_no, path) + images = products.set_main_image( + api.client, product_no, data, content_type=(file.content_type or "").lower() + ) + if not images.get("detail_image"): + raise Cafe24Error("카페24가 등록된 이미지 경로를 돌려주지 않았습니다.") except Cafe24Error as exc: 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) raise _http_from_cafe24(exc) from exc - remember_write(st, product_no, updated if isinstance(updated, dict) else {}) - merged = {**current, **(updated if isinstance(updated, dict) else {})} - if not merged.get("detail_image"): - merged["detail_image"] = path + merged = {**current, **images, "updated_date": now_kst().isoformat(timespec="seconds")} + remember_write(st, product_no, merged) 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) 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) except Cafe24Error as exc: raise _http_from_cafe24(exc) from exc + # image_base: 카페24가 "/web/product/…" 상대경로로 준 썸네일을 화면이 쇼핑몰 주소에 + # 붙여 그리기 위한 값(그대로 src 에 넣으면 우리 도메인에서 찾다가 깨진다). 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") diff --git a/app/modules/cafe24/templates/cafe24/products.html b/app/modules/cafe24/templates/cafe24/products.html index 9bc19d0..c888aa8 100644 --- a/app/modules/cafe24/templates/cafe24/products.html +++ b/app/modules/cafe24/templates/cafe24/products.html @@ -125,7 +125,7 @@ {% endblock %} {% block scripts %} - +