feat(카페24): 대표 이미지(썸네일) 예약 교체

- 편집기 아래 「예약 적용」 폼에 대표 이미지 파일 칸 — 고르면 그 시각에 교체
  (상세페이지·진열·판매와 한 예약에 같이 걸 수 있음, 이미지만도 가능)
- 마이그레이션 006: 예약 image_type/image_name + cafe24_schedule_images(BYTEA, CASCADE),
  "할 일 없는 예약" CHECK 에 이미지 포함
- worker: 이미지 먼저 set_main_image(즉시 교체와 같은 A 타입) → 스냅샷 → 상세페이지·진열/판매
- 예약 목록 「적용 내용」에 대표이미지 표시 + 미리보기 썸네일(GET /cafe24/schedules/{id}/image)
- 이미지 없는 예약 INSERT 는 006 컬럼을 안 써서 마이그레이션 전에도 기존 예약 등록 유지
- 테스트(경로·검증·worker 순서)·문서 갱신, cafe24.css 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-09 16:38:05 +09:00
parent 36834c65b2
commit 6822329ff2
17 changed files with 286 additions and 45 deletions
+37 -8
View File
@@ -1,8 +1,9 @@
"""카페24 예약관리 — 지정 시각에 상세페이지·진열/판매를 자동 적용.
"""카페24 예약관리 — 지정 시각에 대표 이미지·상세페이지·진열/판매를 자동 적용.
되돌리기(자동 복원)는 쓰지 않는다. 예약은 "그 시각에 이 내용을 적용" 하나뿐이다.
한 예약에서 세 가지를 각각 고를 수 있다.
한 예약에서 네 가지를 각각 고를 수 있다.
대표 이미지 고른 파일로 그 시각에 교체 (파일은 DB 보관 — 마이그레이션 006)
상세페이지 HTML 편집기에 있는 내용을 그 시각에 적용 (안 고르면 HTML 은 그대로)
진열 진열 / 미진열 / 변경 없음
판매 판매 / 중지 / 변경 없음
@@ -19,13 +20,14 @@ from __future__ import annotations
import logging
from fastapi import APIRouter, Form, Request
from fastapi.responses import HTMLResponse, RedirectResponse
from fastapi import APIRouter, File, Form, HTTPException, Request, UploadFile
from fastapi.responses import HTMLResponse, RedirectResponse, Response
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, load_config, products
from . import store, writes
from .common import base_ctx, guard
from .routes_product_info import _read_image
from .routes_products import _no_store, load_product
logger = logging.getLogger("cafe24.schedules")
@@ -53,6 +55,7 @@ def schedules_page(request: Request) -> HTMLResponse:
has_html=bool(row.get("has_html")),
set_display=row.get("set_display"),
set_selling=row.get("set_selling"),
has_image=bool(row.get("image_type")),
),
"editable": store.is_editable(row.get("status") or ""),
"needs_review": row.get("status") == store.STATUS_NEEDS_REVIEW,
@@ -63,7 +66,7 @@ def schedules_page(request: Request) -> HTMLResponse:
ctx.update(
{
"page_title": "카페24 — 예약관리",
"page_subtitle": "지정 시각에 상세페이지·진열/판매 자동 적용",
"page_subtitle": "지정 시각에 대표 이미지·상세페이지·진열/판매 자동 적용",
"rows": rows,
"pending": sum(1 for r in rows if r["status"] == store.STATUS_PENDING),
"review": sum(1 for r in rows if r["needs_review"]),
@@ -85,12 +88,14 @@ def schedule_create(
set_selling: str = Form(""),
memo: str = Form(""),
list_query: str = Form(""),
image: UploadFile | None = File(None),
):
"""편집기에서 예약을 등록한다.
HTML 을 적용하는 예약이면 지금 편집기 내용을 DRAFT revision 으로 저장해 고정한다.
단건 적용과 같은 다듬기(URL 인코딩 → 소스 정리)를 거치므로, 예약이 실행됐을 때
저장되는 값이 화면에서 본 것과 같다.
대표 이미지 파일을 고르면 파일을 DB 에 보관했다가 그 시각에 교체한다(마이그레이션 006).
"""
checked = guard(request)
if not isinstance(checked, tuple):
@@ -105,9 +110,16 @@ def schedule_create(
display_flag = store.parse_tristate(set_display)
selling_flag = store.parse_tristate(set_selling)
if not want_html and display_flag is None and selling_flag is None:
image_data = b""
if image is not None and image.filename: # 파일을 안 고르면 브라우저가 이름 없는 빈 파트를 보낸다
try:
image_data = _read_image(image)
except HTTPException as exc:
return RedirectResponse(url=f"{back}&err={exc.detail}", status_code=303)
if not want_html and display_flag is None and selling_flag is None and not image_data:
return RedirectResponse(
url=f"{back}&err=예약할 내용을 하나 이상 선택하세요(상세페이지 / 진열 / 판매).",
url=f"{back}&err=예약할 내용을 하나 이상 선택하세요(대표 이미지 / 상세페이지 / 진열 / 판매).",
status_code=303,
)
@@ -146,9 +158,12 @@ def schedule_create(
set_selling=selling_flag,
memo=memo,
created_by=actor,
image=image_data or None,
image_type=(image.content_type or "").lower() if image_data and image else "",
image_name=(image.filename or "") if image_data and image else "",
)
detail = store.describe_schedule_action(
has_html=want_html, set_display=display_flag, set_selling=selling_flag
has_html=want_html, set_display=display_flag, set_selling=selling_flag, has_image=bool(image_data)
)
st.log_audit(
actor=actor, action="schedule_create", product_no=product_no,
@@ -179,6 +194,20 @@ def schedule_cancel(request: Request, schedule_id: int):
)
@schedules_router.get("/schedules/{schedule_id}/image")
def schedule_image(request: Request, schedule_id: int):
"""예약해 둔 대표 이미지 미리보기(목록 썸네일)."""
checked = guard(request)
if not isinstance(checked, tuple):
return checked
st, _user = checked
row = st.get_schedule(schedule_id)
data = st.get_schedule_image(schedule_id) if row.get("image_type") else b""
if not data:
return Response(status_code=404)
return Response(content=data, media_type=str(row["image_type"]), headers={"Cache-Control": "private, max-age=3600"})
@schedules_router.get("/schedules/preview/{product_no}")
def schedule_current_flags(request: Request, product_no: int) -> dict:
"""예약 폼의 기본값을 위해 현재 진열/판매 상태를 알려준다(JSON, 읽기 전용)."""