공급사 상품 등록 — 기획 문서 v2

0. 개요 · 배경 — 왜 자동 매칭인가

문제의 뿌리는 "공급사는 자기 상품이 오더히어로에 이미 있는지 모른다"는 것.

공급사는 자기가 파는 상품을 오더히어로에 등록한다. 그런데 그 상품이 오더히어로에 이미 등록돼 판매 중인 상품인지, 완전히 새로운 상품인지 공급사는 알 수 없다. 같은 "요쿠르트 1000ml 냉장"을 A 공급사가 이미 올려놨어도, B 공급사는 그걸 모른 채 또 올린다.

그대로 두면 같은 상품이 중복 등록되거나, MD가 검수할 때마다 "이거 우리한테 이미 있는 거 아닌가?"를 수동으로 하나하나 찾아야 한다. 1,000줄짜리 엑셀을 올리면 그 수고가 1,000번 반복된다.

이번 v2가 겨냥하는 것

• 매칭을 앞단으로. 확실히 같은 상품은 사람 손이 닿기 전에 자동으로 붙인다.
• 사람이 볼 양을 줄인다. 자동 매칭이 걸러낸 나머지 — 후보가 여럿인 것, 아예 새 것, 양식 오류 — 만 MD 앞에 남긴다.
• 분기를 줄인다. v13의 복잡한 상태·검수 분기를 걷어내고 흐름을 단순화한다.

1. 사용자 · 역할 · 화면 분리

두 주체가 등장한다. 각자 하는 일과 보지 않아도 되는 일이 명확히 갈린다.

1-2. 두 화면은 완전히 분리 — 권한 자동 분기 피드백 ①

공급사 포털과 어드민(MD)은 데모 토글이 아니라 별개의 화면이다. 로그인 계정의 권한(공급사 / MD)에 따라 자동으로 분기되며, 한 사용자가 두 화면을 오가지 않는다.

1-3. 어드민 메뉴 위치 — 신규 메뉴 공존 피드백 ②③

어드민 상품 관리 아래에서, 기존 메뉴는 그대로 두고 이 프로젝트를 별도 메뉴로 추가한다. 둘은 공존한다(기존 메뉴 대체 아님).

1-4. 내부 식별자 — 공급사에게 숨김

MD만 다루는 자동/숨김 항목은 v2에서도 공급사에게 노출하지 않는다.

• 히어로코드 · MFC노출기준 · 총량피킹 · 검수필요여부 등 — 시스템이 매칭·확정 시 내부 처리.
• 공급사가 직접 입력하는 값은 net공급가 · 유통사 상품명 · 유통사 상품코드. 이 세 값만 공급사 몫이고, 나머지 상품 정보는 매칭 시 그룹 상품에서 자동으로 채워진다(§2-2 참조).

1·5. 공급사 포털 — 내 상품 리스트 피드백 ④⑤

공급사가 로그인하면 자기 공급사에 귀속된 모든 상품이 리스트로 먼저 뜬다(남의 상품은 안 보임).

리스트의 상품 노출·구분은 기존 공급사 상품 관리(product/manage)와 동일한 방식·컬럼을 따른다. 새 표 형식을 만들지 않고 이미 익숙한 리스트를 그대로 재사용한다.

리스트 컬럼 (기존 product/manage와 동일)

컬럼 목록은 회의 피드백 ⑤에서 지정된 그대로. 예시 행 값은 실제 엑셀 양식 예시(§실제 양식)에서 가져온 설명용이며 개발DB 실측 아님.

2. 핵심 정책 · 매칭 자동채움

v2의 뼈대. 매칭 · 자동채움 · 검색 · 양식/정규화 · 이미지 승계.

2-1. 매칭 = 조건값 기반 자동 매칭 중심 v2 핵심

매칭 키는 하나의 코드가 아니라 조건값 묶음이다.

• 조건을 다 걸면 검색 결과가 몇 개 안 나온다. 완전 일치 = 후보 1개 = 자동 매칭.
• ⭐ 자동 매칭된 건(후보 1개)은 후보를 사용자에게 노출하지 않고 내부에서 자동 확정한다. 어차피 MD가 나중에 수정하므로 문제없다.
• "확인 필요(후보군 여러 개)" = 조건이 완벽히 안 맞아 여러 개가 걸린 것. 즉 자동 통과보다 덜한 필터로 뽑은 후보군이다. 이때만 사람이 후보 중 고른다.

예시 — 1,000줄 업로드 시 대략: 자동 매칭 650 + 자동 통과 250 + 확인 필요(후보군) 나머지 + 신규(매칭 0) + 오류. (수치는 v13 예시 배분을 참고한 가정, 실측 아님)

2-2. 매칭되면 자동채움 — 공급사는 net·유통사명만 입력 v2 핵심 · 피드백 ⑦⑧

공급사가 등록할 때 필수값을 입력하거나 상단 검색창에 입력하면, 시스템이 동일 그룹 상품을 추천한다. 추천을 선택하면 대부분의 값이 그룹 상품에서 그대로 자동 채워진다 — 공급사가 다시 적을 필요가 없다.

추천/매칭이 하나도 없으면 → 🔴 신규 상품으로 넘어가 전체 값을 직접 입력한다(§3·§4).

2-3. 검색 = 그룹(그룹코드) 기반

후보를 뽑는 검색은 상품 전체가 아니라 "그룹이 만들어지는 데이터"를 기준으로 한다.

그룹 상품·그룹코드 중심으로 좁히면, 조건값 매칭과 자연스럽게 맞물려 후보가 1개(자동) 또는 소수(확인 필요)로 수렴한다.

2-4. 엑셀 업로드 — 양식 고정 · 정규화

• 업로드 양식은 실제 배포 양식(§실제 양식)을 그대로 쓴다 — 임의 컬럼을 만들지 않는다.
• 중량(예 1KG)·주문 배수 단위·상품단위·라벨용 엑셀 다운로드 수량 단위 등 단위성 필드를 양식에서 규정해 정규화. 단위/필수가 없거나 안 맞으면 ⛔ 오류로 걸러진다.
• 우리가 요청·배포하는 양식이므로 기존 엑셀 양식을 수정해도 된다.

2-5. 이미지 자동 승계

• 그룹에 이미 있는 상품이면 그룹 이미지를 자동으로 따온다. 공급사가 이미지를 안 올려도 된다.
• 그룹을 선택하면 하위 정보가 자동으로 들어온다(이미지 포함).
• 신규(매칭 0)일 때만 이미지를 직접 업로드하거나 Zip으로 일괄 제공한다.

2-6. 조건값 매칭 걸어보기 (예시)

공급사가 감귤 · 1KG · 냉장 · 국내산을 올렸다고 하자. 조건값을 순서대로 걸면:

조건을 다 걸어 1개로 수렴하면 자동, 다 걸었는데도 여럿이면 확인 필요. 이 표의 후보 수는 설명용 가정이다.

실제 엑셀 양식 (필수 · 선택) 피드백 ⑥ · 실측

등록 양식은 상품 등록 양식_필수,선택_260901.xlsx의 실제 필드로 고정한다. 아래는 그 실측 목록 — 임의 필드가 아니다.

필수 필드

선택 필드

3. 상태 판정

업로드된 각 줄은 아래 넷 중 하나로 판정된다. 사람이 손대는 건 🟡🔴⛔ 셋뿐.

4. 화면 흐름 — 단건 등록

공급사가 상품 하나를 등록할 때. 초안 → (자동 매칭) → 확정.

1. 공급사가 필수값 입력 · 또는 상단 검색
   그룹 상품명 · 중량 · 보관상태 · 원산지 등 필수값을 넣거나 상단 검색창에 입력한다.
2. 시스템이 동일 그룹 상품 추천
   입력한 조건값을 다 걸어 그룹코드 데이터에서 후보(추천)를 뽑는다.
3. 판정 분기
   🟢 후보 1개 자동 매칭 → net·유통사명만 공급사 입력, 나머지 값·이미지 자동채움(§2-2) → 내부 확정(후보 미노출)
   🟡 후보 여럿 "확인 필요" 화면 → 후보 중 하나 선택 → 선택 그룹으로 자동채움
   🔴 추천 0 신규 → 전체 정보 직접 입력 + 이미지 업로드
4. 확정
   🟢은 자동, 🟡🔴은 선택/입력 완료 후. 이후 MD가 필요 시 수정.

5. 화면 흐름 — 엑셀 일괄 등록 · 성능

1,000줄 대량 업로드. 자동으로 최대한 처리하고, 나머지만 사람 앞에 남긴다.

1. 엑셀 업로드
   단위 픽스된 우리 양식(용량 ML · 수량 EA 등). 이미지는 신규분만 별도/Zip.
2. 단위 정규화 · 검증
   단위 변환/분기. 단위 없음·필수 누락·그룹ID 오류는 여기서 ⛔ 오류로 떨어진다.
3. 줄별 자동 매칭
   조건값을 다 걸어 그룹 기반 후보 검색. 후보 1개 = 🟢 자동 확정(이미지 승계 포함).
4. 결과 배분
   🟢 자동 매칭 · 자동 통과 — 사람 안 봄 / 🟡 확인 필요(후보군) · 🔴 신규 · ⛔ 오류 — 사람이 봄
5. 사람 처리
   🟡 후보 선택 → 🔴 정보 입력/이미지 → ⛔ 양식 고쳐 재업로드.
6. 확정
   처리 끝난 줄부터 확정. MD 사후 수정 가능.

대량 매칭 성능 — 동기 즉시 로딩 지양 🟠 검토 필요

100~1,000건을 업로드하면서 전 건을 기존 그룹과 즉시 비교 매칭하면 로딩이 오래 걸려 화면이 멈춘다. 동기 즉시 처리는 지양한다.

예시 배분 (1,000줄, 가정)

수치는 v13 예시(자동통과 650 / 확인 250 / 신규 92 / 오류 8)를 참고한 가정이며 개발DB·운영 실측이 아니다.

6. 정책 · 예외

6·5. 구현 관점 · 데이터 가정 가정

스키마 실측 없이(개발DB 금지) 요구사항으로부터 세운 가정. 확정 아님 — 착수 전 검증 필요.

7. v13 → v2 변경점

회의(음성) 결론으로 무엇이 바뀌었나. 가장 큰 변화는 매칭을 앞단으로 뺀 것.

8. 미정 항목 조사 필요

문서에 미정으로 남긴다. 확정 없이는 구현 스펙이 못 나오는 것들.

9. 오픈 이슈

• 차단 M-6 product_group 조건값 컬럼 실존(P0)과 M-1 그룹 생성 로직이 먼저 정리돼야 조건값 매칭·자동채움·이미지 승계 스펙이 확정된다. 선행 조사 1순위 · 개발DB 실측 없음.
• 결정 엑셀 대량 매칭 성능 방식(M-5) — 서버 비동기 배치 + 진행률 + 완료 알림 방향은 잡혔으나 배치 주기·건수 상한·부분 결과 노출이 미정.
• 결정 자동 매칭 임계값(M-2) — 운영 데이터로 자동/후보 비율을 시뮬레이션해 정하는 게 안전하나, 개발DB라 실측은 이 문서 범위 밖.
• 결정 자동 확정 오매칭 시 되돌리는 흐름 — MD 사후 수정으로 충분한지, 별도 롤백 UI가 필요한지.
• 결정 엑셀 양식 개정안 확정 — 단위 컬럼 픽스·필수 컬럼 목록·그룹ID 표기 규칙을 공급사에 배포할 최종 양식으로.
• 진행 이미지 Zip 업로드 규격(파일명↔행 매핑 규칙)은 신규분에만 필요 — 기존 v13 방식 승계 여부 확인.