shopport 0.1.13 → 0.1.14

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.
@@ -4,8 +4,8 @@
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-BNQET2n6.js"></script>
8
- <link rel="stylesheet" crossorigin href="/assets/index-CmNZBac2.css">
7
+ <script type="module" crossorigin src="/assets/index-IAVpl9uK.js"></script>
8
+ <link rel="stylesheet" crossorigin href="/assets/index-BpicUJlc.css">
9
9
  </head>
10
10
  <body>
11
11
  <div id="root"></div>
@@ -0,0 +1,92 @@
1
+ ---
2
+ name: sppt-daily-report
3
+ version: 1.1.0
4
+ description: |
5
+ 매일 아침 매출/주문 현황 브리핑 워크플로우.
6
+ Use when asked to "데일리 리포트", "오늘 브리핑", "매출 요약해줘", "아침 리포트".
7
+ triggers:
8
+ - 데일리 리포트
9
+ - daily report
10
+ - 아침 브리핑
11
+ - 매출 요약
12
+ - 모닝 브리핑
13
+ - 오늘 리포트
14
+ allowed-tools:
15
+ - Bash
16
+ - Read
17
+ ---
18
+
19
+ # daily-report
20
+
21
+ 매일 아침 매출/주문 현황을 브리핑 형식으로 요약하는 워크플로우.
22
+
23
+ ## When to use
24
+
25
+ - "데일리 리포트", "오늘 매출", "아침 브리핑" 요청 시
26
+ - 매일 아침 운영 현황을 한눈에 파악하고 싶을 때
27
+
28
+ ## Prerequisites
29
+
30
+ - 최소 1개 판매 채널 설정 완료
31
+
32
+ ## Steps
33
+
34
+ ### 1. 데이터 수집
35
+
36
+ 커맨드 **1회**로 모든 데이터를 가져옵니다:
37
+
38
+ ```bash
39
+ sppt report daily --json
40
+ ```
41
+
42
+ 옵션:
43
+ - `--period 7d` (기본값) — 기간 변경 가능
44
+ - `--top 3` (기본값) — 상품 순위 개수
45
+ - `--no-pull` — API 호출 없이 로컬 캐시만
46
+
47
+ ### 2. 브리핑 포맷으로 출력
48
+
49
+ JSON 응답을 파싱하여 아래 포맷으로 출력합니다.
50
+ 매출 금액은 천 단위 콤마 포맷을 사용합니다.
51
+ 인사말은 시간대에 맞게 조정합니다 (아침/오후/저녁).
52
+
53
+ ```
54
+ 안녕하세요. 좋은 아침이에요. 이번 주 매출 현황을 요약해 드릴게요.
55
+
56
+ - 총 판매건수: {summary.totalQuantity}건 / 총 매출 {summary.totalRevenue}원
57
+ - 채널별 매출
58
+ - {channels[].channel}: {revenue}원 ({quantity}건, {pct}%)
59
+ - 가장 많이 팔린 상품
60
+ - 1위: {topProducts[0].product} ({quantity}건 / {revenue}원)
61
+ - 2위: ...
62
+ - 3위: ...
63
+
64
+ {pendingOrders.length > 0 이면}
65
+ ⚠️ 미처리 주문 {N}건 — 발주 확인이 필요합니다.
66
+ - {channel} {orderId}: {product} ({amount}원)
67
+
68
+ 자세한 내용은 대시보드에서 확인할 수 있어요.
69
+ 대시보드를 보여드릴까요?
70
+
71
+ `sppt dashboard`
72
+
73
+ 다음은 매출 분석을 해드릴게요.
74
+ 무엇부터 분석해 드릴까요?
75
+
76
+ 1. 지난 주 대비 매출이익률에 영향을 준 원인 분석
77
+ 2. 지난 주 대비 채널별 매출 분포 변화 원인 분석
78
+ 3. 상품별 판매 트렌드 심층 분석
79
+ ```
80
+
81
+ ### 3. 후속 분석 (선택)
82
+
83
+ 사용자가 1~3 중 선택하면 해당 분석을 수행합니다:
84
+
85
+ 1. **매출이익률 분석**: `sppt settlement summary --days 7` + `sppt settlement summary --days 14` 비교
86
+ 2. **채널별 분포 분석**: `sppt report --by channel --period 7d` vs `sppt report --by channel --period 2w` 비교
87
+ 3. **상품 트렌드 분석**: `sppt report --by product --period 7d` 전주 대비 증감 확인
88
+
89
+ ## Error handling
90
+
91
+ - **채널 연결 실패**: CLI가 자동으로 건너뛰고 나머지 채널 결과 반환
92
+ - **주문 0건**: "이번 주 주문이 없습니다" 표시
@@ -29,6 +29,7 @@ sppt --help
29
29
  | 스킬 | 설명 |
30
30
  |---|---|
31
31
  | `/sppt` | shopport 전체 도움말 + 스킬 목록 |
32
+ | `/sppt-daily-report` | 매일 아침 매출/주문 브리핑 |
32
33
  | `/sppt-order-collect` | 멀티채널 주문 한번에 모아보기 |
33
34
  | `/sppt-order-fulfill` | 주문 확인 → 소싱 발주 → 송장 등록 |
34
35
  | `/sppt-source-to-register` | 소싱 검색 → 마진 계산 → 판매 채널 등록 |
@@ -32,6 +32,7 @@ sppt context # AI용 스토어 브리핑
32
32
 
33
33
  | 스킬 | 설명 |
34
34
  |---|---|
35
+ | `/sppt-daily-report` | 매일 아침 매출/주문 브리핑 |
35
36
  | `/sppt-order-collect` | 멀티채널 주문 한번에 모아보기 |
36
37
  | `/sppt-order-fulfill` | 주문 확인 → 소싱 발주 → 송장 등록 |
37
38
  | `/sppt-source-to-register` | 소싱 검색 → 마진 계산 → 판매 채널 등록 |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "shopport",
3
- "version": "0.1.13",
3
+ "version": "0.1.14",
4
4
  "description": "커머스 운영 자동화 CLI — Cafe24, Coupang, SmartStore, Shopify 통합 관리",
5
5
  "type": "module",
6
6
  "bin": {