523 lines
19 KiB
JSON
523 lines
19 KiB
JSON
[
|
||
{
|
||
"id": "snpt_daily_gmv_trend",
|
||
"title": "日GMV趋势",
|
||
"desc": "按日统计GMV与订单量趋势",
|
||
"type": "trend",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_date",
|
||
"price",
|
||
"quantity"
|
||
],
|
||
"time_column": "order_date",
|
||
"constraints": {
|
||
"dim_cardinality_hint": null,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"GMV=SUM(price*quantity)",
|
||
"请避免选择地址等PII字段"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "start_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "end_date",
|
||
"type": "date"
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "SELECT DATE(order_date) AS dt, SUM(price*quantity) AS gmv, COUNT(*) AS orders\nFROM {{table}}\nWHERE DATE(order_date) BETWEEN {{start_date}} AND {{end_date}}\nGROUP BY dt\nORDER BY dt;"
|
||
},
|
||
"business_caliber": "GMV口径：price×quantity；订单量：记录条数；粒度=日。",
|
||
"examples": [
|
||
"近30天GMV趋势",
|
||
"2025Q1每日GMV与订单数"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_daily_gmv_ma7",
|
||
"title": "7日GMV均线",
|
||
"desc": "GMV按日与7日滑动平均",
|
||
"type": "trend",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_date",
|
||
"price",
|
||
"quantity"
|
||
],
|
||
"time_column": "order_date",
|
||
"constraints": {
|
||
"dim_cardinality_hint": null,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"窗口=包含当日的过去7天",
|
||
"若日期有缺口，均线可能偏移"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "start_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "end_date",
|
||
"type": "date"
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "WITH d AS (\n SELECT DATE(order_date) AS dt, SUM(price*quantity) AS gmv\n FROM {{table}}\n WHERE DATE(order_date) BETWEEN {{start_date}} AND {{end_date}}\n GROUP BY dt\n)\nSELECT dt,\n gmv,\n AVG(gmv) OVER (ORDER BY dt ROWS BETWEEN 6 PRECEDING AND CURRENT ROW) AS gmv_ma7\nFROM d\nORDER BY dt;"
|
||
},
|
||
"business_caliber": "GMV=price×quantity；窗口=7天（含当日），按自然日排序计算。",
|
||
"examples": [
|
||
"本季度GMV与7日均线",
|
||
"促销期走势平滑对比"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_yoy_daily_gmv",
|
||
"title": "GMV同比（日）",
|
||
"desc": "对比去年同日GMV与同比%",
|
||
"type": "ratio",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_date",
|
||
"price",
|
||
"quantity"
|
||
],
|
||
"time_column": "order_date",
|
||
"constraints": {
|
||
"dim_cardinality_hint": null,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"需要查询窗口覆盖到去年的对应日期",
|
||
"闰年按日期对齐处理"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "start_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "end_date",
|
||
"type": "date"
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "WITH cur AS (\n SELECT DATE(order_date) AS dt, SUM(price*quantity) AS gmv\n FROM {{table}}\n WHERE DATE(order_date) BETWEEN {{start_date}} AND {{end_date}}\n GROUP BY dt\n),\nprev AS (\n SELECT DATE(DATE_SUB(order_date, INTERVAL 1 YEAR)) AS dt, SUM(price*quantity) AS gmv_last\n FROM {{table}}\n WHERE DATE(order_date) BETWEEN DATE_SUB({{start_date}}, INTERVAL 1 YEAR) AND DATE_SUB({{end_date}}, INTERVAL 1 YEAR)\n GROUP BY DATE(DATE_SUB(order_date, INTERVAL 1 YEAR))\n)\nSELECT c.dt,\n c.gmv,\n p.gmv_last,\n CASE WHEN p.gmv_last IS NULL OR p.gmv_last=0 THEN NULL ELSE (c.gmv - p.gmv_last)/p.gmv_last END AS yoy\nFROM cur c LEFT JOIN prev p ON c.dt = p.dt\nORDER BY c.dt;"
|
||
},
|
||
"business_caliber": "同比=当日GMV与去年同日GMV之差/去年同日GMV；GMV=price×quantity。",
|
||
"examples": [
|
||
"最近90天GMV同比曲线",
|
||
"节假日同比表现"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_topn_category_gmv",
|
||
"title": "类目GMV排行",
|
||
"desc": "按类目统计GMV并取TopN",
|
||
"type": "topn",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_date",
|
||
"category",
|
||
"price",
|
||
"quantity"
|
||
],
|
||
"time_column": "order_date",
|
||
"constraints": {
|
||
"dim_cardinality_hint": 6,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"类目枚举较少，建议TopN<=6用于展示",
|
||
"可追加订单量与件数"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "start_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "end_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "top_n",
|
||
"type": "int",
|
||
"default": 10
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "SELECT category,\n SUM(price*quantity) AS gmv,\n COUNT(*) AS orders,\n SUM(quantity) AS qty\nFROM {{table}}\nWHERE DATE(order_date) BETWEEN {{start_date}} AND {{end_date}}\nGROUP BY category\nORDER BY gmv DESC\nLIMIT {{top_n}};"
|
||
},
|
||
"business_caliber": "GMV=price×quantity；统计范围=指定日期内；粒度=类目。",
|
||
"examples": [
|
||
"上月类目Top5",
|
||
"本季度类目GMV结构"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_share_channel",
|
||
"title": "渠道GMV占比",
|
||
"desc": "统计各渠道GMV及占比",
|
||
"type": "ratio",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_date",
|
||
"channel",
|
||
"price",
|
||
"quantity"
|
||
],
|
||
"time_column": "order_date",
|
||
"constraints": {
|
||
"dim_cardinality_hint": 4,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"占比以总GMV为分母；占比之和≈100%",
|
||
"适合饼图/堆叠柱"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "start_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "end_date",
|
||
"type": "date"
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "WITH base AS (\n SELECT channel, SUM(price*quantity) AS gmv\n FROM {{table}}\n WHERE DATE(order_date) BETWEEN {{start_date}} AND {{end_date}}\n GROUP BY channel\n), total AS (\n SELECT SUM(gmv) AS tg FROM base\n)\nSELECT b.channel, b.gmv, b.gmv/t.tg AS gmv_share\nFROM base b CROSS JOIN total t\nORDER BY b.gmv DESC;"
|
||
},
|
||
"business_caliber": "渠道GMV占比=渠道GMV/全部渠道GMV；时间范围由参数限定。",
|
||
"examples": [
|
||
"本月各渠道占比",
|
||
"Q1渠道结构对比"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_topn_product_gmv",
|
||
"title": "商品GMV排行",
|
||
"desc": "按商品ID统计GMV并取TopN",
|
||
"type": "topn",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_date",
|
||
"product_id",
|
||
"price",
|
||
"quantity"
|
||
],
|
||
"time_column": "order_date",
|
||
"constraints": {
|
||
"dim_cardinality_hint": 1000,
|
||
"fk_join_available": true,
|
||
"notes": [
|
||
"product_id基数较高，建议LIMIT<=50",
|
||
"可与商品维表联查名称等属性"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "start_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "end_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "top_n",
|
||
"type": "int",
|
||
"default": 20
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "SELECT product_id,\n SUM(price*quantity) AS gmv,\n SUM(quantity) AS qty,\n COUNT(*) AS orders\nFROM {{table}}\nWHERE DATE(order_date) BETWEEN {{start_date}} AND {{end_date}}\nGROUP BY product_id\nORDER BY gmv DESC\nLIMIT {{top_n}};"
|
||
},
|
||
"business_caliber": "GMV=price×quantity；粒度=商品ID。",
|
||
"examples": [
|
||
"上周热销商品Top20",
|
||
"年度销量Top10商品"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_join_product_dim",
|
||
"title": "商品维表联查",
|
||
"desc": "以product_id关联商品维表或使用纯ID",
|
||
"type": "join",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"product_id"
|
||
],
|
||
"time_column": null,
|
||
"constraints": {
|
||
"dim_cardinality_hint": 1000,
|
||
"fk_join_available": true,
|
||
"notes": [
|
||
"若无维表则保留纯ID版输出",
|
||
"谨慎选择PII字段，勿输出地址类字段"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "dim_product",
|
||
"type": "identifier"
|
||
},
|
||
{
|
||
"name": "select_cols",
|
||
"type": "string",
|
||
"default": "f.product_id, f.price, f.quantity"
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "-- 命名版\nSELECT {{select_cols}}\nFROM {{table}} f\nLEFT JOIN {{dim_product}} d ON f.product_id = d.product_id;\n\n-- 纯ID版\nSELECT product_id, price, quantity FROM {{table}};"
|
||
},
|
||
"business_caliber": "外键：product_id→商品维表主键；度量来源于事实表price与quantity。",
|
||
"examples": [
|
||
"联查商品名称后做TopN",
|
||
"仅用ID进行商品分析"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_join_customer_dim",
|
||
"title": "客户维表联查",
|
||
"desc": "以customer_id关联客户维表或使用纯ID",
|
||
"type": "join",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"customer_id"
|
||
],
|
||
"time_column": null,
|
||
"constraints": {
|
||
"dim_cardinality_hint": 2713,
|
||
"fk_join_available": true,
|
||
"notes": [
|
||
"如无维表，可直接按customer_id聚合",
|
||
"避免输出shipping_address/billing_address等PII"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "dim_customer",
|
||
"type": "identifier"
|
||
},
|
||
{
|
||
"name": "select_cols",
|
||
"type": "string",
|
||
"default": "c.customer_name, f.customer_id, SUM(f.price*f.quantity) AS gmv"
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "-- 命名版\nSELECT {{select_cols}}\nFROM {{table}} f\nLEFT JOIN {{dim_customer}} c ON f.customer_id = c.customer_id\nGROUP BY c.customer_name, f.customer_id;\n\n-- 纯ID版\nSELECT customer_id, SUM(price*quantity) AS gmv\nFROM {{table}}\nGROUP BY customer_id;"
|
||
},
|
||
"business_caliber": "外键：customer_id→客户维表主键；GMV=price×quantity。",
|
||
"examples": [
|
||
"客户分群GMV",
|
||
"重点客户消费额排行"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_quality_dup_order",
|
||
"title": "主键重复检查",
|
||
"desc": "检查order_id唯一性并抽样输出",
|
||
"type": "quality",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_id"
|
||
],
|
||
"time_column": null,
|
||
"constraints": {
|
||
"dim_cardinality_hint": 10000,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"画像显示order_id应唯一；若结果非空为异常"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "limit_sample",
|
||
"type": "int",
|
||
"default": 50
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "WITH d AS (\n SELECT order_id, COUNT(*) AS cnt\n FROM {{table}}\n GROUP BY order_id\n HAVING COUNT(*)>1\n)\nSELECT * FROM d LIMIT {{limit_sample}};"
|
||
},
|
||
"business_caliber": "主键口径：order_id全表唯一；用于数据质量预警与排查。",
|
||
"examples": [
|
||
"是否存在重复订单？",
|
||
"查看重复订单样本"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_quality_price_outlier",
|
||
"title": "价格异常检测",
|
||
"desc": "基于当日均值±3σ识别异常价",
|
||
"type": "quality",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_date",
|
||
"price"
|
||
],
|
||
"time_column": "order_date",
|
||
"constraints": {
|
||
"dim_cardinality_hint": null,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"仅质量预警，不直接代表业务错误",
|
||
"当天样本过少时波动较大"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "start_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "end_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "limit_sample",
|
||
"type": "int",
|
||
"default": 100
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "WITH stats AS (\n SELECT DATE(order_date) AS dt, AVG(price) AS mu, STDDEV_POP(price) AS sigma\n FROM {{table}}\n WHERE DATE(order_date) BETWEEN {{start_date}} AND {{end_date}}\n GROUP BY dt\n)\nSELECT f.*\nFROM {{table}} f\nJOIN stats s ON DATE(f.order_date)=s.dt\nWHERE (f.price > s.mu + 3*s.sigma OR f.price < s.mu - 3*s.sigma)\nLIMIT {{limit_sample}};"
|
||
},
|
||
"business_caliber": "异常定义：价格超出当日均值±3×标准差（总体标准差）。",
|
||
"examples": [
|
||
"近30天价格异常样本",
|
||
"促销期异常价监控"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_sample_recent_orders",
|
||
"title": "近期明细抽样",
|
||
"desc": "抽样查看近期订单核心字段",
|
||
"type": "sample",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"order_date",
|
||
"order_id",
|
||
"customer_id",
|
||
"product_id",
|
||
"category",
|
||
"price",
|
||
"quantity",
|
||
"channel",
|
||
"payment_method",
|
||
"delivery_status"
|
||
],
|
||
"time_column": "order_date",
|
||
"constraints": {
|
||
"dim_cardinality_hint": null,
|
||
"fk_join_available": true,
|
||
"notes": [
|
||
"为保护隐私，不展示shipping_address与billing_address",
|
||
"仅用于人工核验"
|
||
]
|
||
}
|
||
},
|
||
"variables": [
|
||
{
|
||
"name": "start_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "end_date",
|
||
"type": "date"
|
||
},
|
||
{
|
||
"name": "limit_rows",
|
||
"type": "int",
|
||
"default": 100
|
||
}
|
||
],
|
||
"dialect_sql": {
|
||
"mysql": "SELECT DATE(order_date) AS dt,\n order_id, customer_id, product_id, category,\n price, quantity, channel, payment_method, delivery_status\nFROM {{table}}\nWHERE DATE(order_date) BETWEEN {{start_date}} AND {{end_date}}\nORDER BY dt DESC\nLIMIT {{limit_rows}};"
|
||
},
|
||
"business_caliber": "明细抽样用于数据核验；不输出PII地址信息。",
|
||
"examples": [
|
||
"抽样查看上周订单",
|
||
"核对节假日订单明细"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_filter_paid_delivered",
|
||
"title": "支付已送达筛选",
|
||
"desc": "过滤支付方式为信用卡且配送状态为已送达",
|
||
"type": "sample",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"payment_method",
|
||
"delivery_status"
|
||
],
|
||
"time_column": null,
|
||
"constraints": {
|
||
"dim_cardinality_hint": 5,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"此片段为WHERE条件模板，可拼接到任意查询",
|
||
"delivery_status枚举包含Delivered/Pending/Returned/Shipped"
|
||
]
|
||
}
|
||
},
|
||
"variables": [],
|
||
"dialect_sql": {
|
||
"mysql": "WHERE payment_method = 'Credit Card' AND delivery_status = 'Delivered'"
|
||
},
|
||
"business_caliber": "口径：支付渠道=信用卡；物流状态=已送达（Delivered）。可与时间或维度条件叠加。",
|
||
"examples": [
|
||
"筛选信用卡已送达订单",
|
||
"在TopN商品中仅看已送达信用卡订单"
|
||
]
|
||
},
|
||
{
|
||
"id": "snpt_filter_device_channel",
|
||
"title": "设备渠道筛选",
|
||
"desc": "按设备类型与渠道过滤分析范围",
|
||
"type": "sample",
|
||
"applicability": {
|
||
"required_columns": [
|
||
"device_type",
|
||
"channel"
|
||
],
|
||
"time_column": null,
|
||
"constraints": {
|
||
"dim_cardinality_hint": 7,
|
||
"fk_join_available": false,
|
||
"notes": [
|
||
"device_type枚举：Desktop/Mobile/Tablet",
|
||
"channel枚举：Email/Organic/Paid Search/Social"
|
||
]
|
||
}
|
||
},
|
||
"variables": [],
|
||
"dialect_sql": {
|
||
"mysql": "WHERE device_type IN ('Mobile','Desktop') AND channel IN ('Paid Search','Social')"
|
||
},
|
||
"business_caliber": "限制分析在指定设备与渠道；可直接作为WHERE子句片段复用。",
|
||
"examples": [
|
||
"仅看移动端付费渠道GMV",
|
||
"桌面+社媒渠道订单明细"
|
||
]
|
||
}
|
||
] |