shopport 0.5.5 → 0.5.7

package/dist/dashboard-ui/index.html

@@ -4,8 +4,8 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>shopport</title>
-    <script type="module" crossorigin src="/assets/index-4URhos3v.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-emtGk1pQ.css">
+    <script type="module" crossorigin src="/assets/index-CEBCsPnn.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index--f3qOCFU.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/skills/product-parse/SKILL.md

@@ -1,130 +1,128 @@
 ---
 name: sppt-product-parse
 description: |
-  주문 상품명을 SKU/카테고리/제품라인으로 해체하고, 채널옵션→SKU 매핑까지 완료하는 워크플로우.
+  주문 상품명을 CatalogProduct/SourceOffering 기준으로 분류하고, 후보 검토 후 채널옵션 매핑까지 완료하는 워크플로우.
   Use when asked to "상품명 분석", "SKU별 정리", "미매핑 상품 확인", "매핑 설정".
 ---
 
 # product-parse
 
-주문 데이터의 상품명 → SKU 카탈로그 구축 → 채널옵션 매핑까지의 전체 워크플로우.
+주문 데이터의 상품명 → SourceOffering → CatalogProduct 분류 미리보기 → 후보 검토·적용까지의
+워크플로우. 클라우드 카탈로그의 권위는 현대 CatalogProduct API에 있으며, 레거시
+`ProductCatalogEntry` 파일 임포트나 `/api/sync/products` 쓰기는 사용하지 않습니다.
 
 ## When to use
 
-- 주문 임포트 후 상품 카탈로그를 구축하고 싶을 때
-- 미매핑 상품이 있는지 확인하고 싶을 때
-- 채널 옵션별 수량/세트 구성을 설정하고 싶을 때
+- 주문 임포트 후 미매핑 SourceOffering을 확인하고 싶을 때
+- 상품명을 CatalogProduct 후보로 분류하고 싶을 때
+- 후보를 검토하고 승인된 분류를 적용하고 싶을 때
+- 채널 옵션의 현재 CatalogProduct 매핑을 확인하고 싶을 때
 
 ## Prerequisites
 
 - 주문 데이터가 임포트되어 있어야 함 (`sppt import <file>` 또는 API 동기화)
+- 클라우드 인증이 되어 있어야 함 (`sppt auth login` 또는 agent token)
 
 ## Steps
 
-### 1. 상태 확인
+### 1. 미매핑 상태 확인
 
 ```bash
 sppt product unmapped
 ```
 
-미매핑 상품명이 몇 건인지 확인. 전부 매핑되어 있으면 Step 7로 건너뜁니다.
+미매핑 SourceOffering의 채널, 상품명, 옵션명, raw SKU를 확인합니다. 전부 매핑되어 있으면
+분류 실행을 만들지 않고 종료합니다.
 
-### 2. 분류 규칙 확인
+### 2. 분류 기준 확인
+
+로컬 규칙 파일이 있으면 먼저 읽습니다.
 
 ```bash
-sppt product rules
+sppt product rules --local
 ```
 
-- **규칙이 있으면**: 내용을 읽고 이해합니다.
-- **규칙이 없으면**: 사용자에게 "상품 분류 규칙이 있나요?" 질문 → 없으면 상품명에서 자체 판단.
-
-규칙 파일에 다음이 포함되면 카탈로그 + 매핑 모두 정확해집니다:
+규칙 파일에 다음이 포함되면 후보 검토가 정확해집니다.
 
-1. **카테고리/라인 분류**: 키워드 → 카테고리/라인 매핑
-2. **SKU 체계**: SKU 코드 생성 규칙
-3. **세트 구성**: 세트 SKU의 단품 구성 (예: `CKRS-SET2 = CKRS-WASH × 1 + CKRS-LOTN × 1`)
-4. **수량 옵션 패턴**: 옵션명 → 수량 (예: `"2set" → ×2`)
+1. 카테고리·제품라인 분류 기준
+2. 상품명 정규화·동의어 규칙
+3. 세트 구성과 수량 옵션 패턴
+4. raw SKU와 기존 CatalogProduct option의 대응 규칙
 
-규칙 저장: Write 툴로 `/tmp/product-rules.md` 작성 → `sppt product rules set /tmp/product-rules.md`
+분류 실행 자체는 서버의 CatalogProduct/SourceOffering 규칙과 revision 검증을 따릅니다.
 
-### 3. 상품명 해체
+### 3. 분류 미리보기 생성
 
-미매핑 상품명을 분류 규칙에 따라 해체합니다.
-
-- **규칙 우선**: `product-rules.md` 규칙을 최우선 적용
-- **MECE**: 모든 상품이 하나의 카테고리에 정확히 배정
-- **모호한 경우**: 자의적 분류 대신 사용자에게 질문
+```bash
+sppt product parse
+```
 
-### 4. 결과 저장
+출력된 실행 ID를 기록합니다. 이 명령은 CatalogProduct를 즉시 만들거나 기존 매핑을 바꾸지
+않고, 미매핑 SourceOffering을 대상으로 `preview` classification run만 생성합니다.
 
-엔트리 배열을 `/tmp/product-catalog-entries.json`에 저장 후 임포트:
+### 4. 후보 확인
 
 ```bash
-sppt product catalog import /tmp/product-catalog-entries.json
-```
-
-```json
-[
-  {
-    "sku": "AB-MC20",
-    "brand": "알텐바흐",
-    "productLine": "316Ti",
-    "category": "냄비",
-    "productName": "멀티쿠커 편수",
-    "option": "20cm",
-    "rawNames": ["[알텐바흐] 316Ti 올인원 멀티쿠커 편수 20cm"],
-    "confidence": "llm"
-  }
-]
+sppt product parse status <runId> --json
 ```
 
-### 5. 검증
+각 결과의 source 상품명·옵션·raw SKU와 후보의 `candidateKind`, 제안 상품명, 대상 option,
+신뢰도를 확인합니다.
 
-`sppt product catalog`로 저장 확인 → `sppt product unmapped`로 미매핑 0건 확인.
+- `existing_option`: 기존 CatalogProduct option으로 연결할 후보
+- `new_catalog_product`: 새 CatalogProduct로 만들 후보
+- `pending` 후보만 검토 대상입니다.
+- 이름·SKU·옵션이 모호하면 자의적으로 승인하지 말고 사용자에게 질문합니다.
 
-### 6. 채널옵션 → SKU 매핑 (enrichment)
+### 5. 후보 검토
 
-카탈로그 구축 후, 채널 옵션별 SKU 구성(수량, 세트 분해)을 매핑합니다.
+확실한 후보만 승인하고, 잘못된 후보는 거절하거나 판단을 보류합니다.
 
 ```bash
-sppt product mapping --json    # pending 매핑 목록 확인 (전부 confirmed면 완료)
+sppt product parse accept <runId> <candidateId>
+sppt product parse reject <runId> <candidateId> --reason "상품명이 다름"
+sppt product parse defer <runId> <candidateId> --reason "사용자 확인 필요"
 ```
 
-규칙 파일의 세트 구성/수량 패턴을 참고하여 각 항목의 SKU 구성을 설정:
+하나의 결과에서 후보를 승인하면 다른 후보는 서버가 자동으로 거절합니다.
+
+### 6. 승인 후보 적용
+
+사용자에게 승인 대상과 결과를 보여주고 확인받은 뒤 실행합니다.
 
 ```bash
-sppt product mapping --edit 1 --skus "CKRS-LOTN:2"                                    # 단품 2개
-sppt product mapping --edit 2 --skus "CKRS-WASH:3:component,CKRS-LOTN:3:component"    # 세트 × 3
+sppt product parse apply <runId>
 ```
 
-설정 후 `sppt product mapping --json`으로 결과 검증 → 사용자 승인 → `sppt product mapping --confirm all`.
-`--confirm` 시 경고가 출력되면 즉시 중단하고 사용자에게 보고.
-확정 완료 후 `sppt product mapping --confirmed`로 전체 확정 매핑 + 구성품 조회 가능.
+적용은 CatalogProduct 생성·수정과 SourceOffering 매핑을 현대 API의 멱등성·mapping revision
+검증 아래 처리합니다. 적용 후 다음으로 재확인합니다.
 
-#### 타입 선택 기준
+```bash
+sppt product unmapped
+sppt product catalog
+```
 
-`--skus` 형식: `SKU:수량[:타입[:정가]]` — 타입 생략 시 primary.
+### 7. 채널옵션 매핑 확인
 
-| 타입 | 용도 | 매출 배분 |
-|------|------|-----------|
-| primary | 단품 (구성품 1개일 때) | 매출 100% |
-| component | 세트 구성품 (2개 이상) | 정가 비율 or 균등 배분 |
-| gift | 사은품 | 매출 0원, 수량만 집계 |
-| packaging | 포장재 | 매출 0원, 수량만 집계 |
-| sample | 샘플 | 매출 0원, 수량만 집계 |
+세트 구성, 수량, BOM, 매출 배분처럼 상품 option 구성이 필요한 경우에는 Product Catalog
+대시보드의 계보·매핑 화면에서 확인·수정합니다. 레거시 `sppt product mapping --confirm`으로
+현대 CatalogProduct 매핑을 확정하지 않습니다.
 
-세트 구성품이 2개 이상이고 정가(`listPrice`)를 설정하면 정가 비율로 매출 배분, 미설정 시 균등(1/N) 배분.
+## 로컬 호환 임포트
 
-#### 판단 원칙
+실험용 로컬 카탈로그 파일을 검증하는 경우에만 아래 명령을 사용할 수 있습니다.
+
+```bash
+sppt product parse --local --file mapping.csv
+```
 
-1. **수량 추출**: "2개"/"2set"/"2ea"/"2개입" → ×2. 단독 숫자는 모호 → 사용자 확인
-2. **세트 분해**: 규칙에 구성 정보가 있으면 구성품 SKU로 분해 (타입: component)
-3. **포장 옵션**: SKU 구성에 영향 없음 (포장재 SKU가 있으면 packaging 타입으로 추가)
-4. **모호한 경우**: 사용자에게 질문 (자의적 판단 금지)
-5. **대량 매핑**: 20개 이상이면 패턴별 그룹핑 후 일괄 처리
+이 경로는 `~/.shopport` 로컬 파일만 변경하며 클라우드 CatalogProduct를 변경하지 않습니다.
+클라우드 상품 분류에는 사용하지 않습니다.
 
-## Tips
+## 판단 원칙
 
-- 규칙 파일은 자연어로 자유롭게 작성. 이 스킬이 읽고 해석합니다.
-- 매핑된 상품명은 캐시되어 다음에는 자동 적용됩니다.
-- 새 상품 추가 시 `sppt product unmapped`로 확인 후 추가 해체.
+1. raw SKU가 있으면 이름보다 SKU·option identity를 우선 확인합니다.
+2. "2개", "2set", "2ea", "2개입"은 수량 후보로 해석하되 세트 구성은 규칙과 함께 확인합니다.
+3. 기존 상품과 신규 상품을 구분할 근거가 없으면 승인하지 않습니다.
+4. 후보 적용 전 반드시 사용자에게 승인 목록을 보여줍니다.
+5. 적용 후 미매핑이 남으면 남은 SourceOffering만 대상으로 다시 실행합니다.

package/dist/skills/sppt/SKILL.md

@@ -91,7 +91,8 @@ sppt crm cafe24 customers  # cafe24 회원목록 조회
 - `sppt product catalog [--local]` — 상품 카탈로그 브라우징
 - `sppt product unmapped [--local]` — 미매핑 상품 목록
 - `sppt product rules [set <file>] [--local]` — 분류 규칙 조회/설정
-- `sppt product parse [--file <mapping.csv>]` — 매핑 파일에서 카탈로그 파싱
+- `sppt product parse` — CatalogProduct 분류 미리보기·후보 검토·적용
+- `sppt product parse --local --file <mapping.csv>` — 로컬 호환 카탈로그 임포트
 - `sppt product mapping [--edit N] [--confirm N|all] [--confirmed] [--json]` — SKU 매핑 관리
 - `sppt product candidates` — 매핑 후보 조회
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shopport",
-	"version": "0.5.5",
+	"version": "0.5.7",
 	"description": "커머스 운영 자동화 CLI — Cafe24, Coupang, SmartStore, Shopify 통합 관리",
 	"type": "module",
 	"bin": {