dalongxia/README_SQL_TEMPLATES.md
2026-03-04 13:25:48 +08:00

102 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 销售分析常用 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` 即可
## 运行示例
```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
customer-service-analysis --start 2026-02-01 --end 2026-02-09 --shop "亿家达"
```
## 注意事项
- 所有模板默认过滤 `配件` 和 `特殊单` 标签。
- 金额字段多为字符串,模板已使用 `TRY_CONVERT` 做安全转换。
- 库存预警建议:`estimated_stockout_days <= 10` 视为补货紧急。