-- cafe24_db 마이그레이션 004 — 쓰기 직후 스냅샷 (카페24 읽기 지연 보정)
--
-- 카페24 관리자 API 는 PUT 직후 한동안 GET 에서 예전 값을 돌려준다.
-- PUT 응답의 상품 값(상품명·가격·이미지·진열/판매·updated_date)을 여기 남겨,
-- GET 의 updated_date 가 스냅샷보다 이전이면 스냅샷으로 화면을 덮어씌운다.
-- 상세설명(HTML)은 cafe24_product_revisions 가 담당하므로 넣지 않는다.
--
-- 적용:
--   docker exec -i postgres-db psql -U postgres -d cafe24_db < scripts/sql/cafe24_db_004_write_snapshot.sql
-- 멱등 — 여러 번 실행해도 안전.

ALTER TABLE cafe24_products
    ADD COLUMN IF NOT EXISTS last_write_snapshot JSONB,
    ADD COLUMN IF NOT EXISTS last_written_at     TIMESTAMPTZ;

COMMENT ON COLUMN cafe24_products.last_write_snapshot IS
    '카페24 PUT 응답 상품 값(상품명·가격·이미지·진열/판매·updated_date). 읽기 지연 보정용';
COMMENT ON COLUMN cafe24_products.last_written_at IS
    '마지막으로 카페24에 쓴 시각. 유예시간(CAFE24_READ_LAG_GRACE_MIN) 판정용';