sppurt 0.0.0-stage → 0.6.0

package/dist/dashboard-ui/favicons/fallback.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><g fill="none" stroke="#94a3b8" stroke-width="2"><circle cx="16" cy="16" r="13"/><ellipse cx="16" cy="16" rx="6" ry="13"/><path d="M3 16h26M6 8h20M6 24h20"/></g></svg>

package/dist/dashboard-ui/favicons/sources.json

@@ -0,0 +1,170 @@
+{
+	"29cm.co.kr": {
+		"filename": "29cm.co.kr.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=29cm.co.kr&sz=64"
+	},
+	"aliexpress.com": {
+		"filename": "aliexpress.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=aliexpress.com&sz=64"
+	},
+	"amazon.com": {
+		"filename": "amazon.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=amazon.com&sz=64"
+	},
+	"apify.com": {
+		"filename": "apify.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=apify.com&sz=64"
+	},
+	"argo.camp": {
+		"filename": "argo.camp.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=argo.camp&sz=64"
+	},
+	"boxhero.io": {
+		"filename": "boxhero.io.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=boxhero.io&sz=64"
+	},
+	"bronte.co.kr": {
+		"filename": "bronte.co.kr.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=bronte.co.kr&sz=64"
+	},
+	"cafe24.com": {
+		"filename": "cafe24.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=cafe24.com&sz=64"
+	},
+	"cjdropshipping.com": {
+		"filename": "cjdropshipping.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=cjdropshipping.com&sz=64"
+	},
+	"claude.ai": {
+		"filename": "claude.ai.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=claude.ai&sz=64"
+	},
+	"coupang.com": {
+		"filename": "coupang.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=coupang.com&sz=64"
+	},
+	"datalab.naver.com": {
+		"filename": "datalab.naver.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=datalab.naver.com&sz=64"
+	},
+	"domeggook.com": {
+		"filename": "domeggook.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=domeggook.com&sz=64"
+	},
+	"domeme.com": {
+		"filename": "domeme.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=domeme.com&sz=64"
+	},
+	"domeme.domeggook.com": {
+		"filename": "domeme.domeggook.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=domeme.domeggook.com&sz=64"
+	},
+	"ecount.com": {
+		"filename": "ecount.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=ecount.com&sz=64"
+	},
+	"ezadmin.co.kr": {
+		"filename": "ezadmin.co.kr.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=ezadmin.co.kr&sz=64"
+	},
+	"hwahae.com": {
+		"filename": "hwahae.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=hwahae.com&sz=64"
+	},
+	"ksystem.co.kr": {
+		"filename": "ksystem.co.kr.png",
+		"source_url": "https://www.ksystem.co.kr/wp-content/uploads/2023/01/cropped-favicon-32x32.png"
+	},
+	"kurly.com": {
+		"filename": "kurly.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=kurly.com&sz=64"
+	},
+	"mail.google.com": {
+		"filename": "mail.google.com.ico",
+		"source_url": "https://ssl.gstatic.com/ui/v1/icons/mail/rfr/gmail.ico"
+	},
+	"meta.com": {
+		"filename": "meta.com.jpg",
+		"source_url": "https://www.google.com/s2/favicons?domain=meta.com&sz=64"
+	},
+	"musinsa.com": {
+		"filename": "musinsa.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=musinsa.com&sz=64"
+	},
+	"oliveyoung.co.kr": {
+		"filename": "oliveyoung.co.kr.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=oliveyoung.co.kr&sz=64"
+	},
+	"onewms.co.kr": {
+		"filename": "onewms.co.kr.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=onewms.co.kr&sz=64"
+	},
+	"openai.com": {
+		"filename": "openai.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=openai.com&sz=64"
+	},
+	"openclaw.ai": {
+		"filename": "openclaw.ai.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=openclaw.ai&sz=64"
+	},
+	"plto.com": {
+		"filename": "plto.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=plto.com&sz=64"
+	},
+	"poomgo.co.kr": {
+		"filename": "poomgo.co.kr.ico",
+		"source_url": "https://poomgo.com/icon.png?139a61f35e18c2b8"
+	},
+	"qoo10.jp": {
+		"filename": "qoo10.jp.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=qoo10.jp&sz=64"
+	},
+	"sabangnet.co.kr": {
+		"filename": "sabangnet.co.kr.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=sabangnet.co.kr&sz=64"
+	},
+	"say-go.co.kr": {
+		"filename": "say-go.co.kr.png",
+		"source_url": "https://say-go.co.kr/img/favicon.png"
+	},
+	"searchad.naver.com": {
+		"filename": "searchad.naver.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=searchad.naver.com&sz=64"
+	},
+	"shopify.com": {
+		"filename": "shopify.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=shopify.com&sz=64"
+	},
+	"shopping.naver.com": {
+		"filename": "shopping.naver.com.ico",
+		"source_url": "https://shopv.pstatic.net/web/r/20261002154536/_next/static/ico/favicon_shopping.ico"
+	},
+	"smartstore.naver.com": {
+		"filename": "smartstore.ico",
+		"source_url": "https://smartstore.naver.com/favicon.ico"
+	},
+	"specialoffer.co.kr": {
+		"filename": "specialoffer.co.kr.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=specialoffer.co.kr&sz=64"
+	},
+	"ssfshop.com": {
+		"filename": "ssfshop.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=ssfshop.com&sz=64"
+	},
+	"toss.im": {
+		"filename": "toss.im.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=toss.im&sz=64"
+	},
+	"wconcept.co.kr": {
+		"filename": "wconcept.co.kr.ico",
+		"source_url": "https://static.wconcept.co.kr/favicon.ico"
+	},
+	"wehago.com": {
+		"filename": "wehago.com.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=wehago.com&sz=64"
+	},
+	"zigzag.kr": {
+		"filename": "zigzag.kr.png",
+		"source_url": "https://www.google.com/s2/favicons?domain=zigzag.kr&sz=64"
+	}
+}

package/dist/dashboard-ui/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="ko">
+  <head>
+    <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-idYPQJpm.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DDMobcDz.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/skills/README.md

@@ -0,0 +1,104 @@
+# Sppurt Skills
+
+> Claude Code가 읽고 실행하는 커머스 운영 워크플로우 스킬
+
+## 설치
+
+### 자동 설치 (npm 설치 시 자동 등록)
+
+```bash
+npm install -g sppurt
+```
+
+설치 완료 후 `~/.claude/skills/`에 스킬이 자동 등록됩니다.
+
+### 수동 등록
+
+```bash
+sppt setup-skills           # 스킬 등록
+sppt setup-skills uninstall # 스킬 제거
+```
+
+## 스킬 목록
+
+### 도움말
+
+| 스킬 | 설명 |
+|---|---|
+| `/sppt` | Sppurt 전체 도움말 + 스킬 목록 |
+| `/sppurt` | Sppurt 브랜드 도움말 + CLI 스킬 목록 |
+| `/shopport` | `/sppt`와 동일 (별칭) |
+
+### 주문
+
+| 스킬 | 설명 |
+|---|---|
+| `/sppt-order-collect` | 멀티채널 주문 한번에 모아보기 |
+| `/sppt-order-fulfill` | 주문 확인 → 소싱 발주 → 송장 등록 |
+
+### 소싱
+
+| 스킬 | 설명 |
+|---|---|
+| `/sppt-source-to-register` | 소싱 검색 → 마진 계산 → 판매 채널 등록 |
+| `/sppt-waterfall-source` | 3개 소싱채널 워터폴 가격 비교 |
+
+### 상품
+
+| 스킬 | 설명 |
+|---|---|
+| `/sppt-product-sync` | 소싱→판매 배치 상품 동기화 |
+| `/sppt-product-parse` | 상품명 → SKU/카테고리/제품라인 해체 |
+
+### 재고
+
+| 스킬 | 설명 |
+|---|---|
+| `/sppt-inventory-sync` | 멀티채널 재고 분배 + 동기화 |
+
+### 가격/정산
+
+| 스킬 | 설명 |
+|---|---|
+| `/sppt-price-monitor` | 소싱가 변동 감지 → 마진 체크 → 판매가 조정 |
+| `/sppt-settlement-report` | 정산 현황 조회 + 수익 요약 |
+| `/sppt-cost-calc` | 원가/마진/수수료 계산 |
+
+### 리서치
+
+| 스킬 | 설명 |
+|---|---|
+| `/sppt-trend-research` | 트렌드 키워드 리서치 |
+
+### 운영
+
+| 스킬 | 설명 |
+|---|---|
+| `/sppt-dashboard` | 운영 대시보드 띄우기 |
+| `/sppt-status-check` | 전채널 연결 + 건강 체크 |
+
+## 전제 조건
+
+- `sppt` CLI 설치 (`npm install -g sppurt`)
+- 최소 1개 판매 채널 + 1개 소싱 채널 설정 (`sppt init`)
+
+## 스킬 구조
+
+각 스킬은 `SKILL.md` 마크다운 파일 하나로 구성됩니다.
+YAML frontmatter에 `name`, `description`, `triggers`, `allowed-tools`가 정의되어 있으며,
+Claude Code가 `~/.claude/skills/`에서 자동으로 발견하여 슬래시 커맨드로 사용할 수 있습니다.
+
+```
+~/.claude/skills/
+├── sppt/SKILL.md              → /sppt
+├── shopport/SKILL.md          → /shopport (legacy alias)
+├── sppurt/SKILL.md            → /sppurt
+├── sppt-order-collect/SKILL.md → /sppt-order-collect
+├── sppt-order-fulfill/SKILL.md → /sppt-order-fulfill
+└── ...
+```
+
+## 지원 채널
+
+- **판매**: cafe24, coupang, smartstore, shopify
+- **소싱**: domemae (위탁), domeggook (사입), specialoffer, cjdropshipping

package/dist/skills/cost-calc/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: sppt-cost-calc
+description: |
+  원가/마진/수수료/실수령액 계산 워크플로우.
+  Use when asked to "마진 계산", "원가 분석", "이거 팔면 얼마 남아", "수수료 계산".
+---
+
+# cost-calc
+
+상품의 원가/마진/수수료/실수령액을 계산하는 워크플로우.
+
+## When to use
+
+- "이 상품 팔면 얼마 남아?", "마진 계산해줘", "원가 분석해줘"
+- 소싱 상품 등록 전 수익성 판단
+- 채널별 수수료 비교
+
+## Steps
+
+### 1. 소싱가 확인
+
+소싱 채널에서 도매가를 확인합니다:
+
+```bash
+sppt source detail <sourceChannel> <productId>
+```
+
+### 2. 채널별 수수료 확인
+
+```bash
+sppt settlement fee list
+```
+
+채널별 수수료율:
+| 채널 | 기본 수수료 |
+|---|---|
+| cafe24 | 3.3% (PG 수수료) |
+| coupang | 10.8% (카테고리별 상이) |
+| smartstore | 5.5% (카테고리별 상이) |
+| shopify | 2.9% + $0.30 (결제 수수료) |
+
+### 3. 마진 계산
+
+```bash
+sppt settlement calc <channel> <orderId> --amount <판매가>
+```
+
+또는 직접 계산:
+
+```bash
+sppt cost estimate --source-price <도매가> --selling-price <판매가> --channel <채널> --shipping <배송비>
+```
+
+계산 공식:
+```
+실수령액 = 판매가 - 수수료 - 배송비
+마진 = 실수령액 - 도매가
+마진율 = 마진 / 판매가 × 100
+```
+
+### 4. 채널별 비교
+
+여러 채널에 같은 상품을 판매할 때 채널별 수익 비교:
+
+```
+💰 수익 비교 (도매가 8,500원, 판매가 15,900원)
+────────────────────────────────────────
+채널          수수료     배송비    실수령    마진    마진율
+cafe24         525    3,000   12,375   3,875   24.4%
+coupang      1,717    0       14,183   5,683   35.7%
+smartstore     875    3,000   12,025   3,525   22.2%
+────────────────────────────────────────
+```
+
+### 5. 적정 판매가 역산
+
+목표 마진율로 판매가를 역산합니다:
+
+```
+목표 마진 30% → 판매가 = (도매가 + 배송비) / (1 - 수수료율 - 목표마진율)
+```
+
+### 6. 원가 등록 → 대시보드 마진 추적
+
+계산 결과가 만족스러우면, 원가를 등록하여 대시보드에서 지속적으로 마진율을 추적할 수 있습니다:
+
+```bash
+# 매입단가 + 부대비용 등록
+sppt cost set SKU-001 --purchase 8500 --shipping 3000 --packaging 500
+
+# 등록 확인
+sppt cost list
+```
+
+등록 후 대시보드 정산 페이지에서 채널별 마진율·공헌이익이 자동 계산됩니다.
+원가 등록·관리에 대한 자세한 안내는 `/sppt-cost-register` 스킬을 참고하세요.
+
+## Notes
+
+- 쿠팡은 로켓배송/판매자배송에 따라 수수료 체계가 다릅니다
+- 배송비 포함/별도 정책에 따라 마진이 크게 달라집니다
+- 환율 변동 (CJ Dropshipping 등 해외 소싱) 고려 필요
+- 수수료 규칙은 `sppt settlement fee set`으로 커스터마이즈 가능
+- 원가를 등록하지 않으면 대시보드 마진율이 표시되지 않습니다 — `sppt cost set`으로 등록

package/dist/skills/cost-calc/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "원가/마진 계산"
+  short_description: "원가·마진·수수료·실수령액 계산"
+  brand_color: "#2563EB"
+  default_prompt: "$sppt-cost-calc 이 상품 마진 계산해줘"
+
+policy:
+  allow_implicit_invocation: true

package/dist/skills/cost-register/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: sppt-cost-register
+description: |
+  SKU 원가 등록·관리 워크플로우.
+  Use when asked to "원가 등록", "원가 입력", "매입단가 설정", "변동비 등록", "원가 일괄 등록".
+---
+
+# cost-register
+
+SKU별 원가(매입단가·택배비·포장재비·풀필먼트비)를 등록하고 관리하는 워크플로우.
+등록된 원가는 클라우드에 자동 동기화되어 대시보드 마진율 계산에 반영됩니다.
+
+## When to use
+
+- "원가 등록해줘", "매입단가 입력하고 싶어"
+- "마진율이 안 나와" → 원가 미등록 상태일 때
+- 대시보드에서 "원가 등록 필요" 안내를 본 경우
+- 소싱 완료 후 원가 확정, 기존 상품 원가 업데이트
+
+## Steps
+
+### 1. 현재 등록 상태 확인
+
+```bash
+sppt cost list
+```
+
+등록된 원가가 없으면 "저장된 원가 정보가 없습니다." 출력.
+
+### 2. 등록할 SKU 파악
+
+주문 데이터에서 활성 SKU 목록을 뽑아 원가 미등록 건을 확인:
+
+```bash
+sppt report --by sku
+```
+
+이 목록과 `sppt cost list` 결과를 대조하여 미등록 SKU를 식별합니다.
+
+### 3. 단건 등록
+
+```bash
+sppt cost set <skuId> --purchase <매입단가>
+```
+
+**전체 옵션:**
+
+| 옵션 | 설명 | 예시 |
+|---|---|---|
+| `--purchase <원>` | 매입단가 (필수) | `--purchase 5000` |
+| `--shipping <원>` | 건당 택배비 | `--shipping 3000` |
+| `--packaging <원>` | 포장재비 | `--packaging 500` |
+| `--fulfillment <원>` | 풀필먼트 출고비 | `--fulfillment 1200` |
+| `--name <상품명>` | SKU 이름 | `--name "기본 티셔츠"` |
+| `--channel <채널>` | 채널 한정 원가 (없으면 공통) | `--channel coupang` |
+| `--note <메모>` | 비고 | `--note "23년 2차 계약단가"` |
+
+**예시:**
+```bash
+sppt cost set SKU-001 --purchase 5000 --shipping 3000 --packaging 500 --name "기본 티셔츠"
+```
+
+→ 총 변동비 = 매입 5,000 + 택배 3,000 + 포장 500 = **8,500원**
+
+### 4. 일괄 등록
+
+여러 SKU를 연속으로 등록할 때는 사용자에게 SKU별 매입단가를 확인하면서 순차 등록합니다:
+
+```bash
+# SKU 목록 확인 후 하나씩
+sppt cost set SKU-001 --purchase 5000 --shipping 3000
+sppt cost set SKU-002 --purchase 8500 --shipping 3000
+sppt cost set SKU-003 --purchase 12000 --shipping 0 --fulfillment 1200
+```
+
+채널별로 원가가 다른 경우 `--channel`로 분리 등록:
+```bash
+sppt cost set SKU-001 --purchase 5000 --channel coupang
+sppt cost set SKU-001 --purchase 4500 --channel smartstore
+```
+
+### 5. 등록 확인
+
+```bash
+sppt cost list
+sppt cost show <skuId>
+```
+
+### 6. 대시보드 반영 확인
+
+원가 등록 후 대시보드에서 마진율이 표시되는지 확인:
+
+```bash
+sppt dashboard
+```
+
+정산 페이지의 "원가 · 마진" 카드에 마진율과 원가 커버리지(%)가 표시됩니다.
+
+## 원가 수정·삭제
+
+```bash
+# 수정 — 같은 SKU로 다시 set하면 덮어쓰기
+sppt cost set SKU-001 --purchase 5500 --shipping 3000
+
+# 삭제
+sppt cost remove SKU-001
+sppt cost remove SKU-001 --channel coupang   # 채널 한정 원가만 삭제
+```
+
+## Notes
+
+- 등록 즉시 클라우드 DB에 자동 동기화 (로그인 상태일 때)
+- `--channel` 미지정 시 "공통" 원가로 저장 — 모든 채널에 적용
+- 채널별 원가가 있으면 공통보다 우선 적용
+- 총 변동비 = 매입단가 + 택배비 + 포장재비 + 풀필먼트비 + 기타비용
+- 마진율 = (실수령 - 총변동비) / 실수령 × 100