sppurt 0.0.0-stage → 0.5.9

package/README.md

@@ -1,3 +1,110 @@
-# Temporary Holding Version
+# Sppurt
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+커머스 운영 자동화 CLI — Cafe24, Coupang, SmartStore, Shopify 통합 관리
+
+## 설치
+
+```bash
+npm install -g sppurt
+```
+
+기존 `shopport` 패키지에서 옮길 때는 `npm uninstall -g shopport` 후 설치하세요. `sppt` 명령은 그대로 유지되며 `~/.shopport`의 기존 데이터는 첫 실행 때 `~/.sppurt`로 복사됩니다.
+
+또는 npx로 바로 실행:
+
+```bash
+npx sppt --help
+```
+
+## 빠른 시작
+
+```bash
+# 1. 채널 credentials 설정
+sppt init
+
+# 2. 연결 상태 확인
+sppt status
+
+# 3. 채널별 기능 비교
+sppt cap
+```
+
+## 명령어
+
+### 설정
+
+| 명령어 | 설명 |
+|--------|------|
+| `init` | 대화형 채널 설정 |
+| `config list` | 현재 설정 확인 |
+| `config get <channel>` | 채널 설정 조회 |
+| `config set <channel> <key> <value>` | 설정 변경 |
+| `config remove <channel>` | 채널 삭제 |
+
+### 상품
+
+| 명령어 | 설명 |
+|--------|------|
+| `product list <channel>` | 상품 목록 |
+| `product get <channel> <id>` | 상품 상세 |
+| `product register <channel> --file <path>` | JSON으로 상품 등록 |
+| `product update <channel> <id> --file <path>` | 상품 수정 |
+| `product delete <channel> <id>` | 상품 삭제 |
+
+### 주문
+
+| 명령어 | 설명 |
+|--------|------|
+| `order list <channel> [--days N]` | 최근 주문 (기본 7일) |
+| `order get <channel> <id>` | 주문 상세 |
+| `order confirm <channel> <id>` | 주문 확인 |
+| `order cancel <channel> <id>` | 주문 취소 |
+
+### 송장
+
+```bash
+sppt invoice register <channel> <orderId> <carrier> <trackingNumber>
+```
+
+택배사 코드: `cj`, `hanjin`, `lotte`, `post`, `logen` (또는 채널별 원래 코드)
+
+### 재고
+
+| 명령어 | 설명 |
+|--------|------|
+| `inventory sync <channel> <productId> <qty>` | 재고 업데이트 |
+| `inventory plan <totalStock> [sku]` | 재고 분배 시뮬레이션 |
+
+### 기타
+
+| 명령어 | 설명 |
+|--------|------|
+| `status` | 전체 채널 상태 |
+| `cap [channel]` | API 기능 현황 |
+| `rate-test` | Rate limiter 테스트 |
+
+## 채널별 특이사항
+
+| 채널 | 점수 | 주의사항 |
+|------|------|----------|
+| Shopify | 92/100 | GraphQL, delta 재고, 80+ 웹훅 |
+| Cafe24 | 79/100 | 2 req/s 제한, 절대값 재고 |
+| Coupang | 54/100 | 180일 키 만료, 웹훅 없음, 050번호만 |
+| SmartStore | 44/100 | 웹훅 없음, 재고 API 없음, 24시간 윈도우 |
+
+## 설정 저장 위치
+
+- 파일: `~/.sppurt/config.json`
+- 환경변수 우선: `CAFE24_MALL_ID`, `COUPANG_VENDOR_ID` 등
+
+## MCP 서버 모드
+
+AI 에이전트 연동이 필요한 경우 MCP 서버로도 실행 가능:
+
+```bash
+sppt-mcp  # 또는 node dist/index.js
+```
+
+## 라이선스
+
+MIT