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
@@ -0,0 +1,54 @@
-- =====================================================================
-- cafe24_db 006 — 예약에 대표 이미지 교체 추가 (2026-11-09)
-- =====================================================================
-- 멱등(idempotent): 여러 번 실행해도 안전. DROP TABLE/TRUNCATE 없음.
--
-- 실행:
-- docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d cafe24_db \
-- < scripts/sql/cafe24_db_006_schedule_image.sql
--
-- 배경:
-- 지정 시각에 상품 대표 이미지(썸네일)를 교체하는 예약. 등록 때 올린 파일을
-- 그 시각까지 보관해야 하므로 바이트를 DB 에 둔다(worker 는 web 과 다른
-- 컨테이너라 로컬 파일을 공유하지 않는다). 예약 목록(s.*)이 무거워지지 않게
-- 바이트는 별도 테이블에 둔다.
-- cafe24_product_schedules.image_type = '' → 이미지 교체 없음
-- 'image/png' 등 → 그 시각에 교체
--
-- 롤백(이미지 예약을 쓰지 않을 때만):
-- ALTER TABLE cafe24_product_schedules DROP CONSTRAINT chk_cafe24_schedule_has_action;
-- ALTER TABLE cafe24_product_schedules ADD CONSTRAINT chk_cafe24_schedule_has_action CHECK (
-- revision_id IS NOT NULL OR set_display IS NOT NULL OR set_selling IS NOT NULL);
-- DROP TABLE cafe24_schedule_images;
-- ALTER TABLE cafe24_product_schedules DROP COLUMN image_type, DROP COLUMN image_name;
-- =====================================================================
\set ON_ERROR_STOP on
ALTER TABLE cafe24_product_schedules
ADD COLUMN IF NOT EXISTS image_type TEXT NOT NULL DEFAULT '',
ADD COLUMN IF NOT EXISTS image_name TEXT NOT NULL DEFAULT '';
COMMENT ON COLUMN cafe24_product_schedules.image_type IS
'예약 시각에 교체할 대표 이미지의 형식(image/png 등). 빈 값이면 이미지 교체 없음';
COMMENT ON COLUMN cafe24_product_schedules.image_name IS
'등록 때 올린 대표 이미지 파일명(표시용)';
CREATE TABLE IF NOT EXISTS cafe24_schedule_images (
schedule_id BIGINT PRIMARY KEY REFERENCES cafe24_product_schedules(id) ON DELETE CASCADE,
data BYTEA NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
COMMENT ON TABLE cafe24_schedule_images IS '예약 대표 이미지 파일(10MB 이하)';
-- 아무것도 하지 않는 예약은 만들 수 없게 한다 — 이미지 교체도 "할 일"로 센다.
ALTER TABLE cafe24_product_schedules
DROP CONSTRAINT IF EXISTS chk_cafe24_schedule_has_action;
ALTER TABLE cafe24_product_schedules
ADD CONSTRAINT chk_cafe24_schedule_has_action CHECK (
revision_id IS NOT NULL OR set_display IS NOT NULL OR set_selling IS NOT NULL OR image_type <> ''
);
GRANT SELECT, INSERT, UPDATE, DELETE ON cafe24_schedule_images TO cafe24_app;
SELECT 'cafe24_db 006 applied' AS status;