장바구니 품절·미노출 대응 (사장님 앱)

QA 장바구니 실화면. 담긴 2건 모두 정상 상태라 품절 UI는 이 캡처에 없음(프로모션 팝업이 덮인 채 캡처). 하단은 무료배송 바 + [주문하기].

사장님은 여러 날에 걸쳐 장바구니를 유지한다. 그 사이 공급사·어드민이 상품을 품절 처리하거나(sold_out), 장기 품절로 돌리거나(long_term_sold_out), 노출을 내리면(use_yn) 담긴 상품을 그대로 주문할 수 없다.

현재 앱이 실제로 하는 일 실측

장바구니 스토어는 주문 페이로드를 만들 때 품절 항목을 건너뛴다. 화면(CartView)도 주문 요청 직전에 같은 필터를 한 번 더 건다. 어느 쪽도 "N건이 빠졌다"는 안내를 하지 않는다.

// Cart 스토어 — 주문 페이로드 생성 computed
for(let e of t.cartProductList){
  if(e.soldOut||!f.value.some(t=>t.heroCode===e.heroCode))continue;
  …
  a={heroCode:e.heroCode,groupId:e.groupId??null,name:e.name, … ,parentHeroCode:e.parentHeroCode??null,issue:e.issue??null}

// CartView — [주문하기] 요청 본문
e.cartProductList.filter(e=>W.value.some(t=>t.heroCode===e.heroCode)&&!e.soldOut)

Cart.E6ostIJO.js · CartView.B4gMTDcs.js (QA 번들, 2026-09-03)

상태 3종 판정 조건 (정정표)

아닌 컬럼 — 초안이 헷갈린 것

컬럼 존재·타입·기본값 = app-db 스키마 실측 / 의미 = 스테이지 어드민 화면 대조(상위 세션, 2026-09-03)

배지 우선순위 (한 상품에 여러 상태가 겹칠 때)

품절 > 장기품절 > 미노출 — 권고 권고. 대표 배지 하나만 보이고 나머지는 카드 안 보조 문구. 대안: 장기품절을 대표로 올리는 안(정보량은 많지만 "지금 못 산다"는 신호는 품절이 더 직관적) — 결정되면 프로토 1줄 수정.

대체 추천 규칙

• 1순위: 같은 group_id의 판매 가능 히어로(use_yn='Y' ∧ sold_out=false ∧ long_term_sold_out=false)를 가격 오름차순 상위 3건. 자기 자신 제외.
• 2순위 폴백 🟠: group_id가 NULL이거나 그룹 안에 대체재가 0건이면 카테고리 기준(category1/2/3 중 어느 레벨까지 — 미정 U-4).
• 추천 없음: 둘 다 없으면 배지만 노출, 추천 카드 생략. (선택) 로그에 recommended_codes=[]로 남겨 그룹핑 품질 피드백.
• 「담기」는 추가만: 기존 POST /cart/add. 원본 품절 상품은 자동 삭제하지 않는다.

결제 전 바텀시트

• [주문하기] 시 선택된 항목 중 품절·장기품절 N건 → "제외하고 주문", 미노출 N건 → 확인 후 포함 여부 🟠. 버튼: [제외하고 주문] [돌아가기].
• 판정에 필요한 데이터(선택 여부·soldOut·추가 필드 2개)는 이미 클라이언트에 있다 → 시트는 서버 왕복 없이 띄울 수 있고, 기존 POST /cart/validate는 그 뒤에 그대로 탄다 추론(코드 흐름 기반).
• 원본은 장바구니에 남긴다(재입고 알림 → 재담기 경로 유지).

요약 밴드를 탭하면 해당 카드로 스크롤. 추천 카드의 「담기」는 즉시 /cart/add, 원본은 그대로. 단계 5의 시트는 단계 6의 기존 [주문하기] 핸들러(fi) 앞에 끼워 넣는 위치다.

프로토는 기획 산출물이며 실제 앱 토큰이 아니다. 우측 설명 패널의 번호 핀이 개발 항목. 「대체 담기」·「주문하기」는 동작한다. 별도 창: md-g5-26-app.pages.dev ↗

기존 member_cart — 장바구니

기존 seller_product — 판정 소스 (PK hero_product_code)

기존 seller_product_sold_out_log — 품절 상태 변경 이력 (재사용)

컬럼: id · hero_product_code · main_product_name · group_id(NN) · seller_id · change_type · sold_out · created_by(기본 'auto') · created_at. 인덱스는 created_at뿐, FK 없음.

재사용 방식: 배치안(U-1)일 때 "마지막 배치 이후 품절 상태가 바뀐 히어로" 감지 소스로 쓸 수 있다(created_at 인덱스 활용). 단 미노출(use_yn) 변경은 이 로그에 남지 않는다 — 배치안을 고르면 use_yn 변경 감지를 따로 설계해야 한다. 실시간안이면 이 로그는 어드민 "대응 로그" 화면의 원천 표시(왜 품절됐나)로만 쓴다 추론.

신규·선택 member_cart_alert — 노출·추천·전환 로그

현재 스키마에 없다(member_cart% 테이블은 member_cart뿐). 배지·추천의 성과 추적과 중복 억제에만 필요하므로 1차 출시에서 빼도 기능은 성립한다.

① 장바구니 조회 응답 — 필드 2개 추가

기존 GET /cart(목록) · GET /cart/data?heroCodes=(선택 항목 재계산, 진입 시 항상 재조회)의 cartProductList[] 아이템에:

기존 soldOut 분기(오버레이·비활성·페이로드 제외)는 그대로 두고, 새 필드로 배지 문구와 시트 분류만 나눈다. 장기품절은 sold_out과 별개 컬럼이므로 "장기품절인데 soldOut=false"인 조합이 데이터상 가능하다 — 그 경우도 주문 불가로 다뤄야 하면 프론트 필터를 soldOut || longTermSoldOut으로 넓힌다 추론·확인 필요.

② 대체 추천 API (신규)

예시: GET /recommend/cart/substitute?heroCodes=A,B,C → 히어로별 [{heroCode, name, price, seller, arrivalDate, …}] 최대 3건. 판정식은 02의 추천 규칙 그대로(같은 group_id ∧ 판매 가능 ∧ 자기 제외 ∧ 가격 오름차순 ∧ LIMIT 3). 응답 카드 필드는 기존 인터스티셜(/recommend/order/product)의 상품 카드 스키마를 그대로 쓰면 프론트 재사용이 쉽다 권고. 장바구니 진입 시 문제 상품이 있을 때만 호출(0건이면 호출 안 함).

③ 반영 시점 🟠 U-1

④ 결제 전 검증 훅

[주문하기] 핸들러 순서: 시트(신규) → /recommend/order/product → (인터스티셜) → POST /cart/validate → 주문서. 시트는 클라이언트 데이터만으로 뜨고, 서버 validate가 미노출·품절을 이중으로 막을지는 U-2(미노출 결제 허용)에 따라 정한다.