# DWS 汇总层口径定义

本文档定义 `billiards_dws` 模式下各汇总指标的业务口径、计算规则和数据来源。
所有指标均基于 DWD 明细层数据聚合生成。

> **状态**：骨架文档，各章节待补充具体计算公式与字段映射。

---

## 1. 助教业绩

### 1.1 助教日报（dws_assistant_daily_detail）

<!-- 待补充：日维度助教业绩指标定义，包括订单数、服务时长、收入等 -->

- 目标表：`billiards_dws.dws_assistant_daily_detail`
- 数据来源：DWD 订单事实表、助教维度表
- 粒度：门店 × 助教 × 日期
- 核心指标：*(待定义)*

### 1.2 助教月报（dws_assistant_monthly_summary）

<!-- 待补充：月维度助教业绩汇总指标 -->

- 目标表：`billiards_dws.dws_assistant_monthly_summary`
- 数据来源：助教日报聚合
- 粒度：门店 × 助教 × 年月
- 核心指标：*(待定义)*

### 1.3 助教客户统计（dws_assistant_customer_stats）

<!-- 待补充：助教服务客户维度的统计指标 -->

- 目标表：`billiards_dws.dws_assistant_customer_stats`
- 数据来源：DWD 订单事实表、会员维度表
- 粒度：门店 × 助教 × 会员
- 核心指标：*(待定义)*

### 1.4 助教财务分析（dws_assistant_finance_analysis）

<!-- 待补充：助教维度的财务分析指标 -->

- 目标表：`billiards_dws.dws_assistant_finance_analysis`
- 数据来源：DWD 支付/退款事实表
- 粒度：门店 × 助教 × 日期
- 核心指标：*(待定义)*

---

## 2. 薪酬计算

### 2.1 助教薪酬（dws_assistant_salary_calc）

<!-- 待补充：薪酬计算规则、提成比例、结算周期 -->

- 目标表：`billiards_dws.dws_assistant_salary_calc`
- 数据来源：助教日报/月报、充值提成
- 粒度：门店 × 助教 × 结算周期
- 核心指标：*(待定义)*

### 2.2 充值提成（dws_assistant_recharge_commission）

<!-- 待补充：充值提成计算规则 -->

- 目标表：`billiards_dws.dws_assistant_recharge_commission`
- 数据来源：DWD 充值事实表
- 粒度：门店 × 助教 × 日期
- 核心指标：*(待定义)*

---

## 3. 财务日报

### 3.1 财务日报汇总（dws_finance_daily_summary）

<!-- 待补充：每日财务汇总口径，含收入、支出、利润等 -->

- 目标表：`billiards_dws.dws_finance_daily_summary`
- 数据来源：DWD 支付/退款/订单事实表
- 粒度：门店 × 日期
- 核心指标：*(待定义)*

### 3.2 收入结构（dws_finance_income_structure）

<!-- 待补充：收入按来源/类型的分类口径 -->

- 目标表：`billiards_dws.dws_finance_income_structure`
- 数据来源：DWD 支付事实表
- 粒度：门店 × 日期 × 收入类型
- 核心指标：*(待定义)*

### 3.3 折扣明细（dws_finance_discount_detail）

<!-- 待补充：折扣/优惠统计口径 -->

- 目标表：`billiards_dws.dws_finance_discount_detail`
- 数据来源：DWD 订单事实表
- 粒度：门店 × 日期
- 核心指标：*(待定义)*

### 3.4 充值汇总（dws_finance_recharge_summary）

<!-- 待补充：充值金额、笔数等汇总口径 -->

- 目标表：`billiards_dws.dws_finance_recharge_summary`
- 数据来源：DWD 充值事实表
- 粒度：门店 × 日期
- 核心指标：*(待定义)*

### 3.5 支出汇总（dws_finance_expense_summary）

<!-- 待补充：支出分类汇总口径 -->

- 目标表：`billiards_dws.dws_finance_expense_summary`
- 数据来源：DWD 支出事实表
- 粒度：门店 × 日期
- 核心指标：*(待定义)*

### 3.6 平台结算（dws_platform_settlement）

<!-- 待补充：第三方平台（团购等）结算口径 -->

- 目标表：`billiards_dws.dws_platform_settlement`
- 数据来源：DWD 团购/支付事实表
- 粒度：门店 × 日期
- 核心指标：*(待定义)*

---

## 4. 会员分析

### 4.1 会员消费汇总（dws_member_consumption_summary）

<!-- 待补充：会员消费行为汇总口径 -->

- 目标表：`billiards_dws.dws_member_consumption_summary`
- 数据来源：DWD 订单/支付事实表、会员维度表
- 粒度：门店 × 会员
- 核心指标：*(待定义)*

### 4.2 会员到访明细（dws_member_visit_detail）

<!-- 待补充：会员到访频次、时段分布等口径 -->

- 目标表：`billiards_dws.dws_member_visit_detail`
- 数据来源：DWD 订单事实表
- 粒度：门店 × 会员 × 日期
- 核心指标：*(待定义)*

---

## 5. 订单汇总

### 5.1 订单汇总宽表（dws_order_summary）

<!-- 待补充：订单维度的汇总宽表口径 -->

- 目标表：`billiards_dws.dws_order_summary`
- 数据来源：DWD 订单/支付/退款事实表
- 粒度：门店 × 结账单
- 核心指标：*(待定义)*

---

## 6. 自定义指数算法

指数算法的详细计算流程、参数与归一化方法请参阅 [index_algorithm_cn.md](index_algorithm_cn.md)。

以下为各指数对应的汇总表概览：

### 6.1 会员召回指数 — WBI（dws_member_recall_index）

<!-- 待补充：WBI 指数的业务口径与触发条件 -->

- 目标表：`billiards_dws.dws_member_recall_index`
- 粒度：门店 × 会员

### 6.2 新客转化指数 — NCI（dws_member_newconv_index）

<!-- 待补充：NCI 指数的业务口径与评分规则 -->

- 目标表：`billiards_dws.dws_member_newconv_index`
- 粒度：门店 × 会员

### 6.3 关系指数 — RS（dws_member_assistant_relation_index）

<!-- 待补充：RS 指数的业务口径与亲密度计算 -->

- 目标表：`billiards_dws.dws_member_assistant_relation_index`
- 粒度：门店 × 会员 × 助教

### 6.4 助教-会员亲密度（dws_member_assistant_intimacy）

<!-- 待补充：亲密度评分口径 -->

- 目标表：`billiards_dws.dws_member_assistant_intimacy`
- 粒度：门店 × 会员 × 助教

### 6.5 回流指数 — OS（dws_member_winback_index）

<!-- 待补充：OS 指数的业务口径与回流判定规则 -->

- 目标表：`billiards_dws.dws_member_winback_index`
- 粒度：门店 × 会员

### 6.6 人工台账 — ML（dws_ml_manual_order_source / dws_ml_manual_order_alloc）

<!-- 待补充：ML 人工台账的业务口径与分配规则 -->

- 宽表：`billiards_dws.dws_ml_manual_order_source`
- 窄表：`billiards_dws.dws_ml_manual_order_alloc`
- 粒度：门店 × 订单 × 助教

### 6.7 指数百分位历史（dws_index_percentile_history）

<!-- 待补充：指数百分位归一化的历史快照口径 -->

- 目标表：`billiards_dws.dws_index_percentile_history`
- 粒度：门店 × 指数类型 × 日期

---

## 维护约定

- 新增或修改 DWS 指标时，须同步更新本文档对应章节
- 计算公式应包含：输入字段、聚合方式、过滤条件、精度/舍入规则
- 金额字段统一 `NUMERIC(12,2)`，货币单位人民币（CNY）