# 销售分析常用 SQL 模板包

数据源：`JSDataMiddlePlatform`（SQLServer）  
执行方式：`company-db run-file <sql文件路径>`

默认分析口径（已按最新要求）：
- 主口径优先：`发货件数 / 售后件数 / 订单数`
- 金额口径：仅补充展示；除非明确要求，不作为主排序维度

## 模板列表

1. `shop_weekly_report.sql`
   - 用途：店铺周报（平台/店铺销售、退款、毛利、高退款风险店铺）
   - 默认时间：上一个自然周

2. `sku_structure_report.sql`
   - 用途：SKU结构分析（类目结构、SKU Top、价格带结构）
   - 默认时间：最近30天

3. `refund_reason_report.sql`
   - 用途：退款原因分析（全局原因Top、平台内原因Top、店铺风险清单、类型矩阵）
   - 默认时间：最近30天

4. `fee_ratio_alert.sql`
   - 用途：费比异常预警（店铺级P1/P2/P3预警、全局日趋势）
   - 默认时间：最近14天

5. `logistics_sla_report.sql`
   - 用途：物流时效/SLA分析（支付到发货、发货到签收、延迟预警）
   - 默认时间：最近30天

6. `freight_efficiency_report.sql`
   - 用途：运费效率分析（单票成本、单位重量成本、省份/快递组合成本）
   - 默认时间：最近30天

7. `install_service_quality_report.sql`
   - 用途：安装服务质量（工单状态、服务商表现、待审核区域）
   - 默认时间：最近90天

8. `customer_service_hotspot_report.sql`
   - 用途：客服问题热点（问题Top、店铺问题热点、日趋势）
   - 默认时间：最近30天

9. `link_target_coverage_report.sql`
   - 用途：链接目标覆盖（在线链接、运营负载、类目/价格带分布）
   - 默认时间：在线链接全量

10. `after_sale_360_report.sql`
   - 用途：售后360分析（退款金额、一级/二级原因、类型矩阵、安装工单联动）
   - 默认时间：上一个自然周

11. `product-info`（CLI辅助命令）
   - 用途：按 SKU/SPU/关键词查询产品基础信息（成本、材质、预览图地址）
   - 命令：`product-info "<sku或关键词>" --days 30 --limit 20`
   - 输出：
     - 结果集1：产品基础信息（含 `sku_name`、`cost_price`、`board_material`、`preview_pic_url`）
     - 结果集2：最近N天出货/售后件数
     - 结果集3：最近N天店铺分布（件数）
     - 结果集4：最近N天一区/二区/三区运费汇总
     - 结果集5：最近N天省份运费TOP
     - 结果集6：最近N天售后总览（申请件数/退回件数/退款单数）
     - 结果集7：最近N天售后类型/结果矩阵
     - 结果集8：最近N天售后原因TOP（含来源）

12. `product-skus-by-id`（CLI辅助命令）
   - 用途：按 商品ID 查询该ID下所有 SKU编码 与 SKU名称
   - 命令：`product-skus-by-id "<商品id>" --limit 1000`
   - 输出：
     - 结果集1：匹配汇总（SKU数量/SPU数量）
     - 结果集2：SKU编码+SKU名称清单（含分类、成本、预览图）

13. `customer_service_experience_report.sql`
   - 用途：客服体验与话术分析（用户反馈问题结构、体验分、风险话术、日趋势）
   - 默认时间：最近30天（可改模板顶部 `@start_date/@end_date`）

14. `customer-service-analysis`（CLI辅助命令）
   - 用途：按指定时间段做客服维度的用户反馈体验/话术分析
   - 命令：`customer-service-analysis --start 2026-02-01 --end 2026-02-09 --shop "亿家达" --limit 20`
   - 输出：
     - 结果集1：时间段总览（会话量、空内容率、无对应分类率）
     - 结果集2：一级/二级问题结构 TOP
     - 结果集3：店铺体验分对比
     - 结果集4：话术覆盖率（问候/共情/承诺/收尾）
     - 结果集5：风险话术命中 TOP
     - 结果集6：每日体验趋势
     - 结果集7：风险对话案例 + 建议回复话术
     - 结果集8：客服能力评分（响应能力/满意度/退款效率/求助风险控制 + 总分等级）
     - 结果集9：按客服名字评分（可识别优秀客服）

### 客服能力评分口径（代理映射）

- 参考维度：旺旺响应能力、旺旺满意度、退款处理体验、平台求助风险控制
- 当前数据库可用字段：`pc_kfChatLog.content/mainReason/secondReason/thirdReason/reasonContent`
- 评分权重（总分100）：
  - 响应能力 30%
  - 满意度 30%
  - 退款效率 20%
  - 求助风险控制 20%
- 等级：`S>=90`，`A>=80`，`B>=70`，`C>=60`，`D<60`
- 说明：该评分为“规则维度代理口径”，用于内部运营诊断，不等同平台官方最终分数。

## 运行示例

```bash
company-db run-file /root/.openclaw/workspace/sqlserver/shop_weekly_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/sku_structure_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/refund_reason_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/fee_ratio_alert.sql
company-db run-file /root/.openclaw/workspace/sqlserver/logistics_sla_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/freight_efficiency_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/install_service_quality_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/customer_service_hotspot_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/link_target_coverage_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/after_sale_360_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/customer_service_experience_report.sql
customer-service-analysis --start 2026-02-01 --end 2026-02-09 --shop "亿家达" --limit 20
```

## 注意事项

- 所有模板都默认过滤 `配件` 和 `特殊单` 标签。
- 金额字段多为字符串，模板已使用 `TRY_CONVERT` 做安全转换。
- 如需自定义时间，修改每个模板顶部变量即可。