shopport 0.4.3 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +1 -1
- package/dist/dashboard-ui/assets/{index-ChYTl53S.js → index-CSE-Rlo8.js} +50 -50
- package/dist/dashboard-ui/index.html +1 -1
- package/dist/skills/order-collect/SKILL.md +21 -2
- package/dist/skills/shopport/SKILL.md +12 -12
- package/dist/skills/sppt/SKILL.md +3 -3
- package/package.json +1 -1
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
<meta charset="UTF-8" />
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
6
|
<title>shopport</title>
|
|
7
|
-
<script type="module" crossorigin src="/assets/index-
|
|
7
|
+
<script type="module" crossorigin src="/assets/index-CSE-Rlo8.js"></script>
|
|
8
8
|
<link rel="stylesheet" crossorigin href="/assets/index-CHodG6Rl.css">
|
|
9
9
|
</head>
|
|
10
10
|
<body>
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sppt-order-collect
|
|
3
3
|
description: |
|
|
4
|
-
멀티채널 주문을 한번에
|
|
5
|
-
Use when asked to "주문 모아줘", "전채널 주문 조회", "오늘 주문 몇 개야", "주문 동기화해줘".
|
|
4
|
+
멀티채널 주문을 한번에 모으거나 CSV/XLSX 파일로 내보내는 워크플로우.
|
|
5
|
+
Use when asked to "주문 모아줘", "전채널 주문 조회", "오늘 주문 몇 개야", "주문 동기화해줘", "주문 CSV로 뽑아줘".
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# order-collect
|
|
@@ -12,6 +12,7 @@ description: |
|
|
|
12
12
|
## When to use
|
|
13
13
|
|
|
14
14
|
- "오늘 주문 몇 개야?", "주문 모아줘", "전채널 주문 현황" 요청 시
|
|
15
|
+
- "최근 1개월 주문데이터 CSV로 뽑아줘", "지난달 주문 엑셀로 줘" 요청 시
|
|
15
16
|
- 매일 아침 주문 현황 파악할 때
|
|
16
17
|
- 멀티채널 주문을 한눈에 보고 싶을 때
|
|
17
18
|
- 정산/분석을 위해 주문 데이터를 처음 수집할 때
|
|
@@ -23,6 +24,22 @@ description: |
|
|
|
23
24
|
|
|
24
25
|
## Steps
|
|
25
26
|
|
|
27
|
+
### 0. 파일 내보내기 요청
|
|
28
|
+
|
|
29
|
+
사용자가 주문 파일을 요청하면 채널별 목록을 따로 출력하지 않고 아래 명령을 바로 실행합니다.
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
sppt order export all --period 30d --format csv
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
- "최근 1개월"은 `--period 30d`, "지난달"은 `--period last-month`로 해석합니다.
|
|
36
|
+
- 엑셀 파일을 명시하면 `--format xlsx`를 사용합니다.
|
|
37
|
+
- 기본 파일에는 수령인·전화번호·주소가 없습니다. 출고 목적으로 개인정보가 필요한 경우에만 `--include-pii`를 추가합니다.
|
|
38
|
+
- W컨셉·무신사는 브라우저 수집을 새로 실행하지 않고 이미 저장된 주문을 파일에 포함합니다. 완료 후 해당 채널의 마지막 성공 수집 시각을 함께 알립니다.
|
|
39
|
+
- 완료 후 파일 경로, 주문상품 행 수, 제외된 채널과 사유를 사용자에게 알립니다.
|
|
40
|
+
|
|
41
|
+
파일 요청이 아니면 아래 수집·요약 단계를 따릅니다.
|
|
42
|
+
|
|
26
43
|
### 1. 채널 상태 확인
|
|
27
44
|
|
|
28
45
|
```bash
|
|
@@ -63,6 +80,8 @@ sppt order list smartstore --days DAYS
|
|
|
63
80
|
sppt order list shopify --days DAYS
|
|
64
81
|
```
|
|
65
82
|
|
|
83
|
+
- W컨셉·무신사는 브라우저 수집 채널이라 `order list`로 직접 재수집하지 않습니다. 저장된 주문은 `order export all`에 포함됩니다.
|
|
84
|
+
|
|
66
85
|
사용자가 특정 기간을 명시적으로 요청했으면 그 기간을 우선합니다.
|
|
67
86
|
|
|
68
87
|
### 4. 통합 요약
|
|
@@ -15,6 +15,17 @@ description: |
|
|
|
15
15
|
sppt --help
|
|
16
16
|
```
|
|
17
17
|
|
|
18
|
+
## 에이전트 인증
|
|
19
|
+
|
|
20
|
+
브라우저를 열 수 없는 에이전트는 발급받은 원문 토큰을 표준 입력으로 등록한다.
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
printf %s "$SHOPPORT_AGENT_TOKEN" | sppt auth token set --stdin
|
|
24
|
+
sppt auth whoami
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
`sppt auth token remove`는 이 기기의 등록값만 지우며 서버 토큰을 폐기하지 않는다.
|
|
28
|
+
|
|
18
29
|
## 사용 가능한 스킬
|
|
19
30
|
|
|
20
31
|
| 스킬 | 설명 |
|
|
@@ -63,17 +74,6 @@ sppt settlement deposit <file.csv> # 은행 입금 내역 CSV 임포트 (KB·
|
|
|
63
74
|
sppt settlement deposit delete --date YYYY-MM-DD --provider <입금처> # 입금 내역 삭제
|
|
64
75
|
```
|
|
65
76
|
|
|
66
|
-
## 인증
|
|
67
|
-
|
|
68
|
-
```bash
|
|
69
|
-
sppt auth login --no-browser
|
|
70
|
-
sppt auth token create --name <name> [--ttl-days 30]
|
|
71
|
-
printf %s "$SHOPPORT_AGENT_TOKEN" | sppt auth token set --stdin
|
|
72
|
-
sppt auth token remove
|
|
73
|
-
sppt auth token list
|
|
74
|
-
sppt auth token revoke <id>
|
|
75
|
-
```
|
|
76
|
-
|
|
77
77
|
## 쿠폰
|
|
78
78
|
|
|
79
79
|
```bash
|
|
@@ -82,7 +82,7 @@ sppt coupon get cafe24 <coupon_no> [--json]
|
|
|
82
82
|
sppt coupon issues cafe24 <coupon_no> [--member <member_id>] [--order-status <status>] [--json]
|
|
83
83
|
sppt coupon revoke cafe24 <member_id> <coupon_no> [--confirm]
|
|
84
84
|
sppt coupon link cafe24 <coupon_no[,coupon_no...]> [--domain <domain>] [--copy]
|
|
85
|
-
sppt coupon create <channel> --name <name> --
|
|
85
|
+
sppt coupon create <channel> --name <name> --type <type> --value <N>
|
|
86
86
|
sppt coupon issue <channel> <couponId> --members <id1,id2,...>
|
|
87
87
|
sppt coupon support
|
|
88
88
|
```
|
|
@@ -55,8 +55,8 @@ sppt crm cafe24 customers # cafe24 회원목록 조회
|
|
|
55
55
|
- `sppt init 29cm --client-id <id> --client-secret <secret> --partner-key <key>`
|
|
56
56
|
- `sppt init musinsa --api-key <key> --api-secret <secret>`
|
|
57
57
|
- `sppt auth login` — 브라우저 OAuth 로그인
|
|
58
|
-
- `sppt auth login --no-browser` — 원격/헤드리스
|
|
59
|
-
- `sppt auth token create --name <name> [--ttl-days 30]` — 에이전트용
|
|
58
|
+
- `sppt auth login --no-browser` — 원격/헤드리스 환경의 device code 로그인
|
|
59
|
+
- `sppt auth token create --name <name> [--ttl-days 30]` — 에이전트용 토큰 발급
|
|
60
60
|
- `printf %s "$SHOPPORT_AGENT_TOKEN" | sppt auth token set --stdin` — 브라우저 없이 agent token 등록·서버 검증
|
|
61
61
|
- `sppt auth token remove` — 이 기기에 등록한 agent token만 제거 (서버 폐기 아님)
|
|
62
62
|
- `sppt auth token list|revoke <id>` — 에이전트 토큰 목록/폐기
|
|
@@ -155,7 +155,7 @@ sppt crm cafe24 customers # cafe24 회원목록 조회
|
|
|
155
155
|
- `sppt coupon issues cafe24 <coupon_no> [--member <member_id>] [--order-status <status>] [--json]` — 쿠폰 발급내역 조회
|
|
156
156
|
- `sppt coupon revoke cafe24 <member_id> <coupon_no> [--confirm]` — 회원 쿠폰 회수 (`--confirm` 없으면 dry-run)
|
|
157
157
|
- `sppt coupon link cafe24 <coupon_no[,coupon_no...]> [--domain <domain>] [--copy]` — 쿠폰 다운로드 URL 조립
|
|
158
|
-
- `sppt coupon create <channel> --name <name> --
|
|
158
|
+
- `sppt coupon create <channel> --name <name> --type <type> --value <N>` — 쿠폰 생성
|
|
159
159
|
- `sppt coupon issue <channel> <couponId> --members <id1,id2,...>` — 쿠폰 발급
|
|
160
160
|
- `sppt coupon support` — 채널별 쿠폰 기능 지원 현황
|
|
161
161
|
|