재고 이지어드민 연동 (입출고 동기화)

-- ==========================================================
-- [MD-14] 이지어드민(늘품) 재고 연동 — 대사 스테이징
-- MD-01(stock_entry)·MD-03(DC 작업 코드 매핑) 선행. 우리 재고가 메인.
-- 파일/API 미확정 → 어댑터만 교체, 아래 스테이징 테이블로 수렴.
-- ==========================================================

-- 마감 대사 회차 (운영요일 16:05~17:00, 지연 시 18시 재체크)
CREATE TABLE ez_sync_batch (
  id            BIGSERIAL   PRIMARY KEY,
  sync_date     DATE        NOT NULL,               -- 마감 운영일
  run_seq       INT         NOT NULL DEFAULT 1,     -- 1=16:05 대사, 2=18:00 재체크
  method        VARCHAR     NOT NULL,               -- 'api' | 'file' (연동방식 미확정)
  source_ref    TEXT,                               -- 수신 파일명 / API 응답ID
  status        VARCHAR     NOT NULL DEFAULT 'received',
                                                    -- received/matched/mismatch/applied/manual/delayed
  total_lines   INT         NOT NULL DEFAULT 0,
  mismatch_lines INT        NOT NULL DEFAULT 0,     -- 상이+미매핑 건수 (수기 조정 대상)
  started_at    TIMESTAMPTZ NOT NULL DEFAULT now(),
  finished_at   TIMESTAMPTZ,
  created_by    VARCHAR     NOT NULL DEFAULT 'batch',
  UNIQUE (sync_date, run_seq)                       -- 하루 회차 유일
);

-- 이지어드민이 찍은 변동/실재고 라인 (수신 원본 + 대사 결과)
CREATE TABLE ez_sync_line (
  id            BIGSERIAL   PRIMARY KEY,
  batch_id      BIGINT      NOT NULL REFERENCES ez_sync_batch(id),
  dc_work_code  VARCHAR     NOT NULL,               -- 이지어드민(늘품) DC 작업 코드 (MD-03)
  hero_code     VARCHAR     REFERENCES product(hero_code),      -- 매핑 결과, 미매핑 NULL
  center_code   VARCHAR     REFERENCES center(center_code),
  change_type   VARCHAR     NOT NULL,               -- 'loss'(분실) | 'adjust'(조정) | 'actual'(실재고)
  ez_qty        INT         NOT NULL,               -- 이지 값 (분실 -1 등 / 실재고=절대치)
  admin_qty_before INT,                             -- 대사시점 어드민 잔여(stock_balance)
  diff_qty      INT,                                -- 반영할 ± (실재고=ez-admin, 분실/조정=ez_qty)
  match_status  VARCHAR     NOT NULL DEFAULT 'unmatched',
                                                    -- unmatched/matched/mismatch/applied/manual
  applied_entry_id BIGINT   REFERENCES stock_entry(id),  -- 반영 결과 로그(멱등 성공 시 1건)
  idempotency_key VARCHAR   NOT NULL,               -- 중복 반영 방지: 같은 변동 재수신 차단
  memo          TEXT,
  created_at    TIMESTAMPTZ NOT NULL DEFAULT now(),
  UNIQUE (idempotency_key)                          -- 멱등: 18시 재체크가 다시 밀어도 1건
);
CREATE INDEX ON ez_sync_line (batch_id, match_status);
CREATE INDEX ON ez_sync_line (hero_code, center_code);

-- MD-01 stock_entry.source 에 신규 출처값 'ez_sync' 사용 (스키마 변경 없음, 값만 추가)
-- 반영 규칙: 실재고(actual)도 원장 보존 → 절대치 덮어쓰기 금지,
--            change_qty = (ez_qty - admin_qty_before) 로 append.
-- 반영 트랜잭션: SELECT pg_advisory_xact_lock(hash(hero_code,center_code)) 로
--            주문 차감과 직렬화(동시 차감 꼬임 방지) 후 stock_entry INSERT + balance 재계산.

-- MD-03 선행: supplier_product 에 dc_work_code 컬럼(빈값 허용, 1 DC ↔ 여러 히어로) 존재 가정.
-- ALTER TABLE supplier_product ADD COLUMN dc_work_code VARCHAR;  -- (MD-03 소관)