Commerce Scout → shop.starium.site 실판매 연동 — 완료 보고

결과: 12/12 Done Criteria PASS

발주확정(commerce_draft_orders.status='ordered') 상품이 shop.starium.site에서 실제 구매 가능한 shop_products로 자동 등록되는 양방향 파이프라인 구축. 임시/우회 없이 기존 스키마·인증 훅 재사용.

아키텍처

[paperclip] scout-auto-approve(02:30 자동) ┐
[paperclip] ceo decide(수동 발주확정)       ┼ registerToShop() → POST /api/v1/internal/commerce-import
[paperclip] backfill-shop(일괄)             ┘   X-Internal-Api-Key
                                                ▼
[hospital] shop-api CommerceImport(InternalApiGuard)
  ensureScoutShop(스타365 셀렉트) → USD×1350 KRW → 이미지(naver실사진→Pexels) self-host
  → shop_products upsert by source_product_id (idempotent) → is_imported=true, is_active=true
이미지 서빙: /api/v1/commerce-image/:id (확장자없는 라우트 = nginx '*.jpg→web' 정규식 우회)

검증 (정량)

• 인증: 키없음/오류 403, 정상키 통과
• 등록: 38 imported(백필33+자동5) + seed15 = 53, is_imported 38/38 active+이미지
• 멱등: 재import = update(중복0)
• 가격: USD×1350 KRW (예 $32.74→₩44,200)
• 구매: 장바구니 담기 → /login redirect (시드와 동일 실 구매흐름)
• 이미지: /api/v1/commerce-image/* 200 image/jpeg, 외부의존 0
• 자동경로: scout-auto-approve 실행 → 5건 ordered+WRS+shop등록(created) 확인
• 회귀: seed 15 정상 노출
• 테스트가드: 테스트더미 5건 제외 + 정규식 차단

변경 파일

• shop-api(신규): commerce-import.{service,controller,module}.ts, commerce-image.controller.ts
• shop-api(패치): app.module.ts, main.ts(/api/v1/uploads static), ecosystem.config.js(INTERNAL_API_KEY/PEXELS/USD_KRW_RATE)
• paperclip(신규): register-to-shop.mjs, backfill-shop.mjs
• paperclip(패치): scout-auto-approve.mjs(배선), scout-auto-sourcer.mjs(naver image 캡처), ceo/server.mjs(decide 배선)

잔여/후속

• Gemini 독립평가 무료쿼터 초과(검증불가) → 정량 DC로 대체
• 일부 백필 상품 가격이 낮음(scout USD 추정 정확도 — 소스 데이터 품질 별개 과제)