공급사 상품 등록 — 조건값 자동매칭 데이터 모델

공급사가 상품을 등록하지만, 그 상품이 이미 판매중인 상품인지 신규인지 공급사는 알 수 없습니다. v13은 히어로코드 단건 매칭으로 "같은 상품인지"를 확인하고, 매칭 결과를 자동통과/확인필요/신규/오류로 나눈 뒤 MD 검수(보류·반려·승인·수정후승인)로 넘겼습니다. 문제는 매칭 정확도와 분기 수였습니다.

진입 · 화면 분리 · 권한 분기

공급사 화면과 MD(어드민) 화면은 완전히 별개입니다. 데모용 토글이 아니라 로그인 권한(공급사 / MD)에 따라 서버가 자동으로 다른 화면을 내려줍니다. 프로토타입에서는 두 화면을 각각 보여주지만, 실제로는 권한 자동 분기입니다.

공급사 상품 리스트 — 기존 product/manage와 동일 구성

공급사가 로그인하면 해당 공급사의 모든 상품이 리스트로 노출됩니다(자기 상품만, WHERE seller_id = 로그인공급사). 상품 노출·구분(컬럼)은 기존 공급사 상품 관리 리스트와 동일하게 맞춥니다.

동일 컬럼 구성은 기존 리스트 화면 기준(가정)이며, 실제 product/manage의 컬럼·집계 쿼리와 대조가 필요합니다(🟠 실측 없음).

-- 단위 enum (양식 픽스 · 변환/분기 기준) 🟠 목록은 확정 필요
CREATE TYPE unit_kind AS ENUM ('ML','L','G','KG','EA');
-- 용량계(ML,L)·중량계(G,KG)·수량계(EA). L↔ML, KG↔G 만 상호변환 가능.
CREATE TYPE storage_kind AS ENUM ('ROOM','COLD','FROZEN');  -- 상온/냉장/냉동
CREATE TYPE match_state AS ENUM ('auto','check','new','error');

-- 업로드 요청 배치 (엑셀 1파일 / 수기 1건)
CREATE TABLE seller_product_request (
  id           BIGINT PRIMARY KEY,
  seller_id    BIGINT NOT NULL,                 -- 공급사(히어로)
  source       VARCHAR(8) NOT NULL DEFAULT 'excel', -- excel/manual
  file_name    VARCHAR(255),
  total_rows   INT DEFAULT 0,
  matched_rows INT DEFAULT 0,                  -- 🆕 진행률 = matched_rows/total_rows (비동기 배치)
  status       VARCHAR(12) NOT NULL DEFAULT 'queued', -- 🆕 queued/matching/matched/confirmed (비동기 잡)
  created_by   BIGINT,
  created_at   TIMESTAMP DEFAULT now(),
  matched_at   TIMESTAMP                          -- 🆕 배치 완료 시각(완료 알림 트리거)
);

-- 요청 항목 (엑셀 1행 = 1건) · 조건값 + 매칭 결과 스냅샷
CREATE TABLE seller_product_request_item (
  id              BIGINT PRIMARY KEY,
  request_id      BIGINT NOT NULL REFERENCES seller_product_request(id),
  row_no          INT,                          -- 엑셀 원본 행번호(오류 표시용)
  -- ── 매칭 조건값(양식 필수) ──────────────────────────────
  group_prod_name VARCHAR(200),                -- 🆕 그룹 상품명(예: '감귤(10~11과),1kg,국산')
  product_name    VARCHAR(200) NOT NULL,        -- 🆕 조건값: 상품명(예: 감귤)
  volume_value    NUMERIC(12,3),                -- 🆕 조건값: 중량 수치(예: 1)
  volume_unit     unit_kind,                    -- 🆕 조건값: 단위(KG 등, 픽스). NULL=오류
  storage_type    storage_kind,                 -- 🆕 조건값: 보관(냉장/냉동/상온)
  pack_qty        INT,                          -- 🆕 조건값: 개수(입수)
  norm_key        VARCHAR(300),                -- 🆕 정규화 매칭키(§4). 검색 인덱스
  matched_group_code VARCHAR(20) REFERENCES product_group(group_code), -- auto/check 확정시
  match_state     match_state NOT NULL DEFAULT 'new',
  error_code      VARCHAR(24),                 -- unit_missing/required_missing/bad_group 등
  -- ── 공급사 입력(매칭돼도 이 3개만 항목이 보유) ──────────
  net_supply_price   NUMERIC(12,2),             -- 🆕⭐ net공급가(예: 400) — 공급사 필수 입력
  dist_product_code  VARCHAR(64),               -- 🆕 유통사 상품코드 — 공급사 입력
  dist_product_name  VARCHAR(200),              -- 🆕 유통사 상품명 — 공급사 입력
  -- ── 신규(match_state='new')일 때만 직접 입력 ────────────
  new_payload     JSONB,                        -- 🆕 신규행 나머지 양식값(과세·분류·원산지·브랜드·등급·배송유형·외부적재·최소주문·라벨수량단위 …) 🟠
  image_url       VARCHAR(300),                -- 신규(new)일 때만 직접 업로드(매칭 시 그룹 이미지 승계)
  created_at      TIMESTAMP DEFAULT now()
);
-- 매칭 성공 항목의 과세·중량·분류·원산지·브랜드·등급·배송유형 등은 컬럼 복제 대신
-- matched_group_code 조인으로 product_group에서 조회(=자동채움 승계). 스냅샷 저장 여부는 🟠(§6).

-- 매칭 후보 (🟡 check 상태에서만 N행) · 자동확정(auto)은 미저장/미노출
CREATE TABLE seller_product_request_match_candidate (
  id            BIGINT PRIMARY KEY,
  item_id       BIGINT NOT NULL REFERENCES seller_product_request_item(id),
  group_code    VARCHAR(20) NOT NULL REFERENCES product_group(group_code),
  match_score   NUMERIC(5,2),               -- 일치 조건 수/가중 점수
  matched_fields JSONB,                      -- {name:true,volume:true,storage:false,...}
  rank          INT
);

🟠 미정 — enum 목록(개수 단위·묶음 단위 추가 여부)·norm_key 문자열 규칙·match_score 산식은 §4·§9에서 다룹니다. FK는 product_group.group_code가 실제 PK/유니크라는 가정 위에 있습니다.

1. 조건값 추출·정규화 — 각 행에서 상품명·용량/중량·단위·보관·개수를 뽑아 표준형으로. 단위 변환(L→ML, KG→G), 상품명 트림/소문자/공백·특수문자 정리, 보관상태 enum 매핑. 결과를 norm_key로 합성.
2. 그룹 검색(좁은 후보) — "요쿠르트 전체"가 아니라 조건을 다 걸어 product_group을 조회. 예: 상품명 유사 AND volume=1000ML AND storage=COLD. 조건이 다 걸리면 후보가 몇 개 안 나옴.
3. 후보 수로 분기 — 아래 규칙. 임계(어떤 조건이 몇 개 일치해야 자동인가)는 🟠 미정.

매칭 성공 시 자동채움(승계) — 핵심

공급사가 단건 등록할 때 필수값을 입력하거나 상단 검색에 입력하면 시스템이 동일 그룹 상품을 추천합니다(§4 조건값 검색과 같은 로직). 추천을 선택하면 이미지·카테고리·중량·보관·원산지·브랜드·등급·배송유형 등 나머지 값이 그룹에서 그대로 채워지고, 공급사는 아래 3개만 입력합니다.

필수 열 (실제 양식)

선택 열 (실제 양식)

예시행: 감귤(10~11과),1kg,국산 / 감귤 / 면세 / 냉장 / 1KG / net 400 / D-1 / 국내산 / 배송 MFC ·   단감(4~5과),1kg,국산 / net 700 / 배송 허브.

대량 업로드 = 비동기 배치 매칭 (🟠 검토 필요)

1. 업로드·접수 — 파일 저장 + seller_product_request(status=queued, total_rows) 생성 후 즉시 응답(요청 id 반환). 전건 매칭을 기다리지 않음.
2. 비동기 매칭 워커 — 잡큐가 배치를 집어 status=matching. 행을 청크로 조건값 검색·분기(§4)하며 matched_rows를 증가 → 진행률 = matched_rows/total_rows.
3. 완료 알림 — 전건 끝나면 status=matched + matched_at. 공급사/MD에 완료 알림(결과는 나중에 확인). 화면은 진행률 폴링 또는 푸시.
4. 결과 확인·검수 — 상태별(🟡check·🔴new·⛔error) 목록 조회. 오류행만 재업로드.

파싱·매칭은 배치 단위. 행별 error_code로 오류행만 재업로드. 양식은 오더히어로가 배포하므로 열 순서·헤더 표준화 가능. 동기 즉시 로딩은 지양(🟠 §9).

1. 매칭 결과 분기 — match_state ∈ {auto, check→확정}이고 matched_group_code가 정해지면 이미지 승계 대상.
2. 그룹 이미지 조회 — product_image WHERE group_code = matched_group_code ORDER BY sort. 메인/서브를 그룹에서 가져옴. 공급사가 이미지를 안 올려도 됨.
3. 승계 방식 — 하위(공급사 상품/히어로)는 그룹 이미지를 참조 또는 복사. 그룹 선택 시 하위는 자동으로 들어옴. 참조 vs 복사 정책 🟠 미정.
4. 신규(매칭 0)만 직접 — match_state='new'이면 그룹이 없으므로 이미지 직접 업로드 또는 Zip 일괄. 신규 그룹 생성 시 그 이미지가 그룹 대표가 됨.

항목 상태(match_state)

배치 상태(request.status) — 비동기

업로드는 queued로 즉시 응답, 워커가 matching으로 배치 처리하며 matched_rows/total_rows 진행률 노출, 완료 시 matched + 알림(§5).

인덱스(초안)

마이그레이션 순서

1. 선행 — 그룹 조건값 정규화(관건). product_group에 조건값이 정규화 컬럼으로 없으면(상품명 문자열에만 섞여 있으면) 이 매칭은 성립하지 않음. 용량·단위·보관을 컬럼으로 추출·백필하는 마이그레이션이 먼저. 실측으로 존재 여부 확인 필요(현재 가정).
2. enum 생성 — unit_kind·storage_kind·match_state. 목록 확정(🟠) 후.
3. 신규 3테이블 — request · item · match_candidate. FK는 product_group.group_code 유니크 전제.
4. 인덱스 — 위 표. 대용량 백필 뒤 CONCURRENTLY.
5. 양식 배포 — 픽스된 엑셀 템플릿 공급사 배포(열·단위 표준).