두 분석 교차검증 + QA 실데이터 + 프로토타입 v13 반영 · 기존 10섹션 기획문서 갱신본
📦 이 문서는 「상품 등록」(퍼즈3) 기준입니다. 「단가 업데이트」는 퍼즈2로 분리 → 단가 업데이트 기획 · 단가 프로토타입 참조.
1. 개요·목표
현황: 상품 등록/관리/수정을 MD가 전담 (공급사가 공문·엑셀로 제각각 전달 → MD가 옮겨 적음).
목표: 공급사 셀프 등록 + MD 검수 구조로 전환. 1순위 효과 = "MD 타이핑 제거".
퍼즈 구성: 단가 업데이트 = 퍼즈2(별도 문서 — 매일·매주 반복이라 우선). 이 문서 = 상품 등록(퍼즈3).
핵심 문제: ① 공급사가 내부 히어로코드를 알지 못해 MD가 수작업 매핑 ② 상품 사진을 MD가 외부 소싱.
구현 성격(미팅 2026-06-26): 신규 구축이 아니라 기존 어드민 위 얇은 레이어 — 화면·로직 재사용 + 로그인 공급사 스코프·컨펌 대기 큐·메뉴만 신설. 단가는 공급가(net)만 공급사 입력, 판매가(마진·세금·배송) 계산은 기존 플랫폼 로직 그대로.
가치 하한: 매칭 자동화가 목표치에 못 미쳐도, 입력을 공급사로 이관하는 것만으로 효과가 있으며 매칭은 부가적이다.
2. 서비스 흐름
[공급사] 로그인(본인 공급사 스코핑)
└ 단건 등록 ─ 상품명 입력 → 기존 상품 매칭 검색
└ 엑셀 등록 ─ 1,000줄 업로드 → 줄마다 자동 매칭
│
▼ "초안" 제출
[MD] 검수 대기(제출 건 단위) → 상품별 검토
└ 수정 · 히어로코드 연결/발급 · 승인 / 수정 후 승인 / 반려(사유) / 보류
│
▼
[확정] 승인 → 앱 노출(가격비교) · 반려 → 공급사 수정 후 재제출
"필수"는 최종 저장(확정) 기준이지 공급사 입력 기준이 아님 → 공급사 제출 = 초안, 내부값은 MD 승인 때 채워짐.
3. 역할·화면
역할
화면
공급사
「공급사 상품 관리」 메뉴 하나, 본인 상품만. 등록 상품(목록·검색·필터·[수정]·[단가]) / 등록 이력(제출 건). 승인완료 상품도 단가·재고·품절·공급사명·옵션을 변경요청(→MD 컨펌)으로 수정. 그룹ID·히어로코드·마진율·MFC노출 등 운영 정책·타사 상품은 비노출.
MD
상품 관리 하위 「공급사 등록 상품 검수」 메뉴(신설). 전 공급사 제출 건을 단위로 검수.
4. 등록 방식
단건 등록
상품명 입력 → 비슷한 기존 상품 후보 표시(미리보기=앱 상품 화면). 선택 시 히어로코드·카테고리·중량·대표 사진 자동 적용 → 공급사는 가격만.
맞는 게 없으면 신규(전체 필드+사진 필수) 제출.
중복 가드: 같은 히어로코드/상품명을 이미 등록(요청)했으면 확인.
엑셀 등록 (대량)
업로드 → 줄마다 자동 매칭 → 버킷: 🟢자동 / 🟡확인(후보 선택) / 🔴신규 / ⛔오류(단위 없음·필수 누락 → 등록 제외).
🔴신규/일치없음 → [정보 입력]으로 이미지·상세 보완(엑셀에 못 담는 이미지는 여기/Zip).
재업로드 레버리지: 첫 확정 시 (공급사+상품코드) ↔ 히어로코드 기억 → 다음엔 가격·재고만 갱신(검수 거의 0).
5. 히어로코드 매칭 정책
매칭은 "제안", 최종 코드는 MD가 확정. 공급사 선택/시스템 추천은 후보이며 최종 결정은 아니다.
공급사가 매칭 후 상품명·카테고리·중량을 수정하면 매칭 자동 해제 → 신규로 접수 → MD가 (같은 상품이면 기존 코드 연결 / 다르면 신규 발급).
매칭 신호 = 이름 + 중량 + 원산지 + 카테고리(다필드). 이름만으론 부족(실측 top-1 ≈75%, +중량 ≈86%).
본질적 모호 ≈16%(예: 삼치 12종)는 매처만으로 풀기 어려움 = 정보 문제 → 식별자 표준화로만 축소(§9).
성능: 단건 매칭 실시간(인덱스 조회, 데이터 커도 ms), 대량 1,000건 수 초. 연산 속도는 병목으로 보기 어렵다.
6. 데이터·예외 정책
항목
정책
중량/단위
단위 포함 입력. 단위 없는 숫자 → 검수 필요 플래그. 소수점은 마침표, 불필요한 0 제거(1.0KG→1KG).
이미지
매칭 시 대표 사진 상속 / 신규는 업로드 필수. 사진 없는 마스터는 이미지 보충 대상(§8).
그룹/히어로코드
공급사는 입력하지 않음(숨김). 신규는 MD 발급, 기존은 MD 연결.
중복
같은 히어로코드/상품명 재등록 시 확인. (정식은 매칭 신뢰도 기반)
오류 행
엑셀 단위 없음·필수 누락·그룹ID 오류 → 등록 제외, 수정 후 재업로드.
마스터 품질
테스트·복제·오분류(예: 단감 그룹에 사과) 다수 → 정제 선행(매칭 정확도 전제).
7. 승인 워크플로우
공급사 제출 → 검수 대기(제출 건 단위 큐). "수상한 것만"(이미지 없음·매칭 안 됨·중량 이상) 우선.
MD 처리: 승인 / 수정 후 승인(필드 직접 수정) / 반려(사유) / 보류. 위험 플래그 없는 건 일괄 승인.
반려 → 공급사에 사유 노출 → 수정 후 재제출 → 다시 큐.
승인완료 상품 정보 변경 = 변경 요청: 상품명·카테고리·중량·원산지·옵션 등 정보 수정 → 스냅샷 diff → MD 컨펌 후 반영(자동 반영 없음). (단가·재고·품절은 퍼즈2)
모든 처리는 이력(누가·언제·무엇·전→후)으로 기록.
7-2. 단가 업데이트 퍼즈2로 분리
단가·품절 업데이트(공급사 셀프 + MD 승인)는 퍼즈2 별도 문서로 분리됨 → 단가 업데이트 기획 · 프로토타입. 이 문서(상품 등록)는 퍼즈3.
8. 이미지 정책 (3중)
실측: 실상품 마스터의 약 절반만 실제 사진 보유 → 한 방법으로 안 끝남.
상속 — 매칭+마스터 사진 있으면 자동(약 절반 커버)
공급사 업로드 필수 — 마스터에 사진 없는 나머지 절반
마스터 백필 — 사진 없는 마스터 일회성 보충
9. 카테고리별 전략
구분
전략
가공식품
바코드(GTIN)로 정확 매칭 v2/v3 — 단 현재 바코드 필드 없음 → 필드 신설+GS1/제조사 백필 선행(우리가 채움, 공급사 입력 아님).
신선·수산
바코드 없음 → 이름+중량+원산지+규격+등급 다필드 복합 식별 + 사람 선택. 순수 자동확정 금지.