조건별 판매 옵션 — 이벤트 엔진 흡수

MD가 요청한 것은 “히어로 단품 판매가를 업장·업종·지역 대상으로 다르게 세팅”입니다(버기). 이는 오늘 배포된 이벤트 상품 관리의 세그먼트 타겟팅과 대부분 겹칩니다. 별도 엔진을 새로 짜면 소스가 이원화되므로, 미스틱 제안대로 이미 개발된 이벤트 엔진 위에 얹습니다(진입점 통합 = 안정성).

조건 축 → 세그먼트 매핑

이벤트 유형

값 · 기간

🆕 쿠폰 · 프라이싱 최종가 정책 08/13 회의 핵심

이벤트 판매가는 이미 상품 마진을 태워 정한 값입니다. 위에 쿠폰·VIP프라이싱·사이렌(신규회원가)·영업 개별가가 겹치면 실결제가 원가·시장가 밑으로 빠질 수 있습니다(바이럴·경쟁사 노출 리스크). 그래서 기본은 추가 할인을 막아 이 판매가를 최종·최상위가로 고정합니다.

상태 머신

승인 완료 시 노출. 기간 지정=예정→진행중→종료 자동. 상시=승인 후 always 유지, 수량 소진 또는 수동 중단으로 종료.

-- 조건별 판매(이벤트) 마스터
CREATE TABLE event_sale (
  id                BIGINT PRIMARY KEY,
  name              VARCHAR(120) NOT NULL,
  type              VARCHAR(1)  NOT NULL DEFAULT 'A',   -- A:판매가할인, B:결합(다음)
  value_mode        VARCHAR(3)  NOT NULL DEFAULT 'amt', -- 🆕 amt:정액, pct:정률
  value             NUMERIC(12,2),                       -- 정액=원, 정률=%
  period_mode       VARCHAR(6)  NOT NULL DEFAULT 'range',-- 🆕 range/always(상시)
  start_at          TIMESTAMP,
  end_at            TIMESTAMP,                             -- always면 NULL
  per_store_limit   INT,                                   -- 업장당 구매 한도
  total_qty         INT,                                   -- 총 판매 수량
  auto_end_soldout  BOOLEAN DEFAULT TRUE,
  budget_cap        NUMERIC(14,0),                        -- 자사부담 예산 상한
  coupon_allowed    BOOLEAN NOT NULL DEFAULT FALSE,  -- 🆕 08/13: 기본 제외
  pricing_included  BOOLEAN NOT NULL DEFAULT FALSE,  -- 🆕 VIP/사이렌/영업가 기본 제외
  status            VARCHAR(12) NOT NULL DEFAULT 'draft',
  approved_by       BIGINT,  approved_at TIMESTAMP,
  created_by        BIGINT,  created_at  TIMESTAMP DEFAULT now()
);

-- 대상 상품 · 이벤트 판매가 (단품 기준, 1:N)
CREATE TABLE event_sale_product (
  id             BIGINT PRIMARY KEY,
  event_sale_id  BIGINT NOT NULL REFERENCES event_sale(id),
  hero_code      VARCHAR(20) NOT NULL,     -- 단품
  group_code     VARCHAR(20),               -- 같은 상품의 공급사 그룹(식별)
  base_price     NUMERIC(12,2),             -- 현재 판매가 스냅샷
  event_price    NUMERIC(12,2),             -- 계산·저장된 이벤트가
  supplier_id    BIGINT                     -- 히어로의 공급사(참고, hero에 종속)
);

-- 🆕 수량(볼륨) 구간
CREATE TABLE event_sale_volume_tier (
  id            BIGINT PRIMARY KEY,
  event_sale_id BIGINT NOT NULL REFERENCES event_sale(id),
  min_qty       INT NOT NULL,          -- N개 이상
  discount_rate NUMERIC(5,2) NOT NULL  -- 추가 할인율 %
);

-- 타겟 세그먼트 (1:N, seg_type별)
CREATE TABLE event_sale_segment (
  id             BIGINT PRIMARY KEY,
  event_sale_id  BIGINT NOT NULL REFERENCES event_sale(id),
  seg_type       VARCHAR(10) NOT NULL,    -- all/customer/biz/center
  segment_ref_id BIGINT,                    -- 세그먼트 관리 FK(불러오기)
  value_json     JSONB                      -- cust:[store_id] / biz:{first,sub[]} / center:[id]
);

event_sale_combo_item(Type B 결합)은 다음 차수라 생략. 노출 조회 시 coupon_allowed=false면 장바구니·결제 단계에서 쿠폰/프라이싱 스택을 차단.

1. 상품·유형 선택 — 단품 검색 → Type A · 정액/정률 · 기간(지정/상시).
2. 조건 설정 — 대상 공급사 · 수량 구간 · 타겟 세그먼트(업종/업장/지역).
3. 정책 확인 — 쿠폰/프라이싱 제외(기본) · 예산 상한 · 겹침 경고 확인.
4. 승인 요청 → 승인 완료 시 타겟 업장에 최종가로 노출.

화면 나란히 (Before / After)

BEFORE 원본 이벤트 목업 v3.0

유형 · 기간(지정만) · 대상상품 · 계산 · 예산시뮬 · 미리보기 · 타겟 세그먼트.

AFTER 그룹3 흡수판

＋ ②🆕정률 ③🆕상시 ④🆕적용 마진율 ⑤🆕수량 구간 ⑦🆕최종가 정책 · 앱 “🔒 최종가”.

왼쪽=원본, 오른쪽=흡수판. 오른쪽에만 있는 ②③④⑤⑦(보라 🆕)이 이번 추가분입니다. 번호는 프로토 우측 설명 패널과 동일.

A. 원본 그대로 재사용 vs 🆕 흡수판 추가

B. 그룹3(MD-05·06·07·08) 요구 → 어디에 어떻게 녹였나

노출 · 가격 적용 순서 (앱 조회 시)

1. 대상 상품 매칭 — event_sale_product의 hero_code(단품) 기준 후보 산출. 공급사는 히어로에 종속.
2. 세그먼트 교집합 — 업장이 타겟 세그먼트(고객/업종/센터)에 속하는지 + 공급사 매칭 센터 ∩ 타겟 센터 교집합 확인.
3. 기간·상태 필터 — status ∈ {진행중, 상시} 이고 기간 내(상시는 무기한).
4. 가격 계산 — 정액=value / 정률=base×(1−value/100). 수량 구간이 켜져 있으면 담은 수량으로 tier 매칭해 추가 할인 가산.
5. 겹침 해소 — 같은 상품에 복수 이벤트가 걸리면 최저가 선택.
6. 추가 할인 차단 — coupon_allowed=false/pricing_included=false면 장바구니·결제 단계에서 쿠폰·VIP프라이싱·사이렌·영업개별가 스택을 제외(최종가 고정).

승인 · 권한 · 상태 전이

인덱스 · 마이그레이션 · 롤아웃

• 인덱스 — event_sale(status, start_at, end_at) · event_sale_product(hero_code, supplier_id) · event_sale_segment(event_sale_id, seg_type). 앱 조회는 hero_code→활성 이벤트 역인덱스가 핵심.
• 마이그레이션 — 신규 테이블만 추가(기존 스키마 무변경). 이벤트 엔진(PLD-548) 위 확장이라 파괴적 마이그레이션 없음.
• 롤아웃 — 이번 차수 Type A만. 겹침=최저가·정책 기본 제외로 배포 → 데이터 관찰 후 Type B(결합)·조건축 세그먼트 완전 통합은 다음 플래닝.
• API 개요 — 목록/상세/생성/수정/승인/중단 + 앱 노출조회(hero_code·업장 컨텍스트 → 적용가·정책 플래그).

• 월 구매량별 조건은 다음 차수로 미뤄도 되는지(현재 수량=단건 볼륨).
• 권역(센터 묶음) 정의 기준 — MFC 과도기 반영.
• 공급사 협의 범위 — DC 매입 상품 한정 여부.
• 쿠폰 토글 = 쿠폰 1개 vs 쿠폰·프라이싱 2개 (현재 2개).

검수 결과 — 배포 시 이펙트 (DB 실측 반영)