# 销售分析常用 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名称、成本、材质、预览图等）
      - 结果集2：最近N天出货/售后件数
      - 结果集3：最近N天店铺分布（件数）
      - 结果集4：最近N天一区/二区/三区运费汇总
      - 结果集5：最近N天省份运费TOP
      - 结果集6：最近N天售后总览
      - 结果集7：最近N天售后类型/结果矩阵
      - 结果集8：最近N天售后原因TOP
      - 结果集9：最近N天每日总发货件数（按SKU）
      - 结果集10：库存风险预估（当前库存/日均发货/预计缺货天数/补货建议，补货安全线=10天）
      - 结果集11：近30天在售商品ID数量（按店铺渠道）
      - 结果集12：商品ID对应店铺名/渠道/运营人（通知清单）
      - 结果集13：缺货风险通知清单（采购/工厂/仓库/店铺/运营）

12. `product-skus-by-id`（CLI辅助命令）
    - 用途：按商品ID查询该ID下所有SKU编码与SKU名称
    - 命令：`product-skus-by-id "<商品id>" --limit 1000`

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`

15. `sku_stock_risk_report.sql`
    - 用途：按SKU编码查询库存、近30天日均发货件数、预计缺货天数、补货建议（安全线10天）
    - 默认时间：最近30天（模板顶部可改 `@lookback_days`）
    - 参数：修改模板顶部 `@sku` 即可

16. `stock-risk-alerts`（CLI辅助命令）
    - 用途：查询近30天所有在售SKU的缺货预警明细（SKU编码维度）
    - 命令：`stock-risk-alerts --days 30 --limit 500`
    - 输出：
      - 结果集1：全量在售SKU/风险SKU汇总
      - 结果集2：风险明细（预计缺货天数、补货建议、采购、工厂、仓库、运营、渠道/店铺）
    - 常用参数：
      - `--lead-days 10`（补货提前期）
      - `--warn-days 15`（预警阈值）
      - `--include-safe`（包含安全SKU）

## 运行示例

```bash
company-db run-file /root/.openclaw/workspace/sqlserver/shop_weekly_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/after_sale_360_report.sql
company-db run-file /root/.openclaw/workspace/sqlserver/sku_stock_risk_report.sql
product-info "CJ019317N1097V01" --days 30 --limit 20
stock-risk-alerts --days 30 --limit 500
customer-service-analysis --start 2026-02-01 --end 2026-02-09 --shop "亿家达"
```

## 注意事项

- 所有模板默认过滤 `配件` 和 `特殊单` 标签。
- 金额字段多为字符串，模板已使用 `TRY_CONVERT` 做安全转换。
- 库存预警建议：`estimated_stockout_days <= 10` 视为补货紧急。