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
+31 -17
View File
@@ -819,27 +819,41 @@ class Cafe24Store:
set_selling: bool | None,
memo: str = "",
created_by: str = "",
image: bytes | None = None,
image_type: str = "",
image_name: str = "",
) -> int:
"""예약 등록. image 가 있으면 파일을 cafe24_schedule_images 에 같은 트랜잭션으로 남긴다(006).
이미지 없는 예약은 006 컬럼을 쓰지 않는다 — 마이그레이션 전에도 기존 예약 등록이 깨지지 않게.
"""
cols = ["product_no", "scheduled_at", "revision_id", "set_display", "set_selling", "memo", "created_by"]
vals: list[Any] = [int(product_no), scheduled_at, revision_id, set_display, set_selling,
(memo or "")[:500], created_by or ""]
if image:
cols += ["image_type", "image_name"]
vals += [image_type, (image_name or "")[:200]]
with self._pool.connection() as conn:
with conn.transaction():
row = conn.execute(
f"INSERT INTO cafe24_product_schedules ({', '.join(cols)}) " # noqa: S608 — 고정 컬럼명만
f"VALUES ({', '.join(['%s'] * len(cols))}) RETURNING id",
vals,
).fetchone()
if row and image:
conn.execute(
"INSERT INTO cafe24_schedule_images (schedule_id, data) VALUES (%s, %s)",
(row["id"], image),
)
return int(row["id"]) if row else 0
def get_schedule_image(self, schedule_id: int) -> bytes:
"""예약 대표 이미지 파일. 없으면 b""."""
with self._pool.connection() as conn:
row = conn.execute(
"""
INSERT INTO cafe24_product_schedules
(product_no, scheduled_at, revision_id, set_display, set_selling,
memo, created_by)
VALUES (%s,%s,%s,%s,%s,%s,%s)
RETURNING id
""",
(
int(product_no),
scheduled_at,
revision_id,
set_display,
set_selling,
(memo or "")[:500],
created_by or "",
),
"SELECT data FROM cafe24_schedule_images WHERE schedule_id = %s", (int(schedule_id),)
).fetchone()
return int(row["id"]) if row else 0
return bytes(row["data"]) if row else b""
def list_schedules(self, *, limit: int = 200) -> list[dict[str, Any]]:
"""예약 목록. 대기 중인 것을 먼저, 그다음 최근 처리 순."""