在准备环境前提交次全部更改。
This commit is contained in:
227
apps/etl/connectors/feiqiu/docs/business-rules/dws_metrics.md
Normal file
227
apps/etl/connectors/feiqiu/docs/business-rules/dws_metrics.md
Normal file
@@ -0,0 +1,227 @@
|
||||
# DWS 汇总层口径定义
|
||||
|
||||
本文档定义 `dws` 模式下各汇总指标的业务口径、计算规则和数据来源。
|
||||
所有指标均基于 DWD 明细层数据聚合生成。
|
||||
|
||||
> **状态**：骨架文档，各章节待补充具体计算公式与字段映射。
|
||||
|
||||
---
|
||||
|
||||
## 1. 助教业绩
|
||||
|
||||
### 1.1 助教日报（dws_assistant_daily_detail）
|
||||
|
||||
<!-- 待补充：日维度助教业绩指标定义，包括订单数、服务时长、收入等 -->
|
||||
|
||||
- 目标表：`dws.dws_assistant_daily_detail`
|
||||
- 数据来源：DWD 订单事实表、助教维度表
|
||||
- 粒度：门店 × 助教 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 1.2 助教月报（dws_assistant_monthly_summary）
|
||||
|
||||
<!-- 待补充：月维度助教业绩汇总指标 -->
|
||||
|
||||
- 目标表：`dws.dws_assistant_monthly_summary`
|
||||
- 数据来源：助教日报聚合
|
||||
- 粒度：门店 × 助教 × 年月
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 1.3 助教客户统计（dws_assistant_customer_stats）
|
||||
|
||||
<!-- 待补充：助教服务客户维度的统计指标 -->
|
||||
|
||||
- 目标表：`dws.dws_assistant_customer_stats`
|
||||
- 数据来源：DWD 订单事实表、会员维度表
|
||||
- 粒度：门店 × 助教 × 会员
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 1.4 助教财务分析（dws_assistant_finance_analysis）
|
||||
|
||||
<!-- 待补充：助教维度的财务分析指标 -->
|
||||
|
||||
- 目标表：`dws.dws_assistant_finance_analysis`
|
||||
- 数据来源：DWD 支付/退款事实表
|
||||
- 粒度：门店 × 助教 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
---
|
||||
|
||||
## 2. 薪酬计算
|
||||
|
||||
### 2.1 助教薪酬（dws_assistant_salary_calc）
|
||||
|
||||
<!-- 待补充：薪酬计算规则、提成比例、结算周期 -->
|
||||
|
||||
- 目标表：`dws.dws_assistant_salary_calc`
|
||||
- 数据来源：助教日报/月报、充值提成
|
||||
- 粒度：门店 × 助教 × 结算周期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 2.2 充值提成（dws_assistant_recharge_commission）
|
||||
|
||||
<!-- 待补充：充值提成计算规则 -->
|
||||
|
||||
- 目标表：`dws.dws_assistant_recharge_commission`
|
||||
- 数据来源：DWD 充值事实表
|
||||
- 粒度：门店 × 助教 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
---
|
||||
|
||||
## 3. 财务日报
|
||||
|
||||
### 3.1 财务日报汇总（dws_finance_daily_summary）
|
||||
|
||||
<!-- 待补充：每日财务汇总口径，含收入、支出、利润等 -->
|
||||
|
||||
- 目标表：`dws.dws_finance_daily_summary`
|
||||
- 数据来源：DWD 支付/退款/订单事实表
|
||||
- 粒度：门店 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 3.2 收入结构（dws_finance_income_structure）
|
||||
|
||||
<!-- 待补充：收入按来源/类型的分类口径 -->
|
||||
|
||||
- 目标表：`dws.dws_finance_income_structure`
|
||||
- 数据来源：DWD 支付事实表
|
||||
- 粒度：门店 × 日期 × 收入类型
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 3.3 折扣明细（dws_finance_discount_detail）
|
||||
|
||||
<!-- 待补充：折扣/优惠统计口径 -->
|
||||
|
||||
- 目标表：`dws.dws_finance_discount_detail`
|
||||
- 数据来源：DWD 订单事实表
|
||||
- 粒度：门店 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 3.4 充值汇总（dws_finance_recharge_summary）
|
||||
|
||||
<!-- 待补充：充值金额、笔数等汇总口径 -->
|
||||
|
||||
- 目标表：`dws.dws_finance_recharge_summary`
|
||||
- 数据来源：DWD 充值事实表
|
||||
- 粒度：门店 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 3.5 支出汇总（dws_finance_expense_summary）
|
||||
|
||||
<!-- 待补充：支出分类汇总口径 -->
|
||||
|
||||
- 目标表：`dws.dws_finance_expense_summary`
|
||||
- 数据来源：DWD 支出事实表
|
||||
- 粒度：门店 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 3.6 平台结算（dws_platform_settlement）
|
||||
|
||||
<!-- 待补充：第三方平台（团购等）结算口径 -->
|
||||
|
||||
- 目标表：`dws.dws_platform_settlement`
|
||||
- 数据来源：DWD 团购/支付事实表
|
||||
- 粒度：门店 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
---
|
||||
|
||||
## 4. 会员分析
|
||||
|
||||
### 4.1 会员消费汇总（dws_member_consumption_summary）
|
||||
|
||||
<!-- 待补充：会员消费行为汇总口径 -->
|
||||
|
||||
- 目标表：`dws.dws_member_consumption_summary`
|
||||
- 数据来源：DWD 订单/支付事实表、会员维度表
|
||||
- 粒度：门店 × 会员
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
### 4.2 会员到访明细（dws_member_visit_detail）
|
||||
|
||||
<!-- 待补充：会员到访频次、时段分布等口径 -->
|
||||
|
||||
- 目标表：`dws.dws_member_visit_detail`
|
||||
- 数据来源：DWD 订单事实表
|
||||
- 粒度：门店 × 会员 × 日期
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
---
|
||||
|
||||
## 5. 订单汇总
|
||||
|
||||
### 5.1 订单汇总宽表（dws_order_summary）
|
||||
|
||||
<!-- 待补充：订单维度的汇总宽表口径 -->
|
||||
|
||||
- 目标表：`dws.dws_order_summary`
|
||||
- 数据来源：DWD 订单/支付/退款事实表
|
||||
- 粒度：门店 × 结账单
|
||||
- 核心指标：*(待定义)*
|
||||
|
||||
---
|
||||
|
||||
## 6. 自定义指数算法
|
||||
|
||||
指数算法的详细计算流程、参数与归一化方法请参阅 [index_algorithm_cn.md](index_algorithm_cn.md)。
|
||||
|
||||
以下为各指数对应的汇总表概览：
|
||||
|
||||
### 6.1 会员召回指数 — WBI（dws_member_recall_index）
|
||||
|
||||
<!-- 待补充：WBI 指数的业务口径与触发条件 -->
|
||||
|
||||
- 目标表：`dws.dws_member_recall_index`
|
||||
- 粒度：门店 × 会员
|
||||
|
||||
### 6.2 新客转化指数 — NCI（dws_member_newconv_index）
|
||||
|
||||
<!-- 待补充：NCI 指数的业务口径与评分规则 -->
|
||||
|
||||
- 目标表：`dws.dws_member_newconv_index`
|
||||
- 粒度：门店 × 会员
|
||||
|
||||
### 6.3 关系指数 — RS（dws_member_assistant_relation_index）
|
||||
|
||||
<!-- 待补充：RS 指数的业务口径与亲密度计算 -->
|
||||
|
||||
- 目标表：`dws.dws_member_assistant_relation_index`
|
||||
- 粒度：门店 × 会员 × 助教
|
||||
|
||||
### 6.4 助教-会员亲密度（dws_member_assistant_intimacy）
|
||||
|
||||
<!-- 待补充：亲密度评分口径 -->
|
||||
|
||||
- 目标表：`dws.dws_member_assistant_intimacy`
|
||||
- 粒度：门店 × 会员 × 助教
|
||||
|
||||
### 6.5 回流指数 — OS（dws_member_winback_index）
|
||||
|
||||
<!-- 待补充：OS 指数的业务口径与回流判定规则 -->
|
||||
|
||||
- 目标表：`dws.dws_member_winback_index`
|
||||
- 粒度：门店 × 会员
|
||||
|
||||
### 6.6 人工台账 — ML（dws_ml_manual_order_source / dws_ml_manual_order_alloc）
|
||||
|
||||
<!-- 待补充：ML 人工台账的业务口径与分配规则 -->
|
||||
|
||||
- 宽表：`dws.dws_ml_manual_order_source`
|
||||
- 窄表：`dws.dws_ml_manual_order_alloc`
|
||||
- 粒度：门店 × 订单 × 助教
|
||||
|
||||
### 6.7 指数百分位历史（dws_index_percentile_history）
|
||||
|
||||
<!-- 待补充：指数百分位归一化的历史快照口径 -->
|
||||
|
||||
- 目标表：`dws.dws_index_percentile_history`
|
||||
- 粒度：门店 × 指数类型 × 日期
|
||||
|
||||
---
|
||||
|
||||
## 维护约定
|
||||
|
||||
- 新增或修改 DWS 指标时，须同步更新本文档对应章节
|
||||
- 计算公式应包含：输入字段、聚合方式、过滤条件、精度/舍入规则
|
||||
- 金额字段统一 `NUMERIC(12,2)`，货币单位人民币（CNY）
|
||||
Reference in New Issue
Block a user