上传源代码版本

.trae/documents/运营指标数学与统计学关系说明.md

@@ -0,0 +1,66 @@
+# 运营指标数学与统计学关系说明
+## 一、指标分类
+所有指标分为三类，形成从事实到统计的完整链路：
+| 分类 | 说明 | 特点 |
+|------|------|------|
+| 基础事实指标 | 直接从原始数据表统计得到，不依赖其他计算指标 | 数据来源唯一，准确性最高，是所有上层指标的基础 |
+| 过程计算指标 | 基于基础指标和业务规则计算得到的中间指标 | 用于支撑上层结果指标，可独立验证 |
+| 结果统计指标 | 基于基础指标和过程指标计算得到的最终运营指标 | 直接用于业务分析和考核，是最终产出 |
+## 二、全量指标定义与关系对照表
+### 1. 基础事实指标（无依赖，直接统计原始数据）
+| 指标名称 | 计算逻辑 | 数据来源 | 统计维度 |
+|---------|---------|---------|---------|
+| 当日扫描数 | 统计日期内扫描记录表的所有记录数 | `label_scan_history` | 日期 / 日期+客户 |
+| 当日换单完成数 | 统计日期内扫描成功（Result=0）的去重订单数 | `label_scan_history` | 日期 / 日期+客户 |
+| 当日换单失败数 | 统计日期内有扫描失败记录且无扫描成功记录的去重订单数 | `label_scan_history` | 日期 / 日期+客户 |
+| 当日STOP数 | 统计日期内扫描成功且描述包含STOP的去重订单数 | `label_scan_history` | 日期 / 日期+客户 |
+> **关系说明**：以上4个指标完全独立，均直接从扫描表统计，互相之间无依赖关系，是最底层的事实指标。
+### 2. 过程计算指标（依赖基础订单数据和业务规则）
+| 指标名称 | 计算逻辑 | 依赖关系 |
+|---------|---------|---------|
+| 当天新增换单数 | 统计日期内到仓的有标签去重订单数 | 依赖订单到仓时间、标签状态 |
+| 标签率 | 交接单维度：有标签订单数 / 总订单数 | 依赖交接单总订单数、有标签订单数 |
+| 考核基准时间 | GREATEST(首次扫描时间/到仓时间, 标签率首次达标时间) | 依赖到仓时间、首次扫描时间、标签率达标时间 |
+| 考核时间 | 基于考核基准时间的16点分界规则计算得到 | 依赖考核基准时间 |
+| 累计要换的总单数 | 有标签、标签推送时间<=统计日期、创建时间<=统计日期、且统计日未完成换单的去重订单数 | 依赖标签状态、标签推送时间、订单创建时间、换单成功状态 |
+> **关系说明**：过程指标是连接原始数据和结果指标的中间层，其计算结果直接影响上层结果指标的准确性。
+### 3. 结果统计指标（依赖过程指标和事实指标）
+| 指标名称 | 计算逻辑 | 依赖关系 | 数学公式 |
+|---------|---------|---------|---------|
+| 当天应该换单数 | 有考核时间、考核基准日期/考核截止日期=统计日期、且换单完成时间<=统计日期的去重订单数 | 依赖考核时间、换单成功状态 | - |
+| 24小时换单成功数 | 当天应该换单数中、首次成功时间在考核基准时间与考核时间之间、且完成时间=统计日期的去重订单数 | 依赖当天应该换单数、是否在考核期内完成 | 是当天应该换单数的子集 |
+| 当天换单完成率 | 当日换单完成数 / 当天应该换单数 | 依赖当日换单完成数（含考核内+非考核内历史订单）、当天应该换单数（当日考核内订单） | $完成率 = \frac{当日所有完成换单数}{当日考核内订单总数} \times 100\%$ |
+| 24小时换单率 | 24小时换单成功数 / 当天应该换单数 | 依赖24小时换单成功数、当天应该换单数 | $24小时换单率 = \frac{24小时换单成功数}{当天应该换单数} \times 100\%$ |
+## 三、核心数学/统计学关系
+### 1. 集合包含关系
+```mermaid
+graph TD
+    A[当日扫描总订单数] --> B[当日换单完成数]
+    A --> C[当日换单失败数]
+    B --> D[当日STOP数]
+    B --> E[当日完成的考核内订单]
+    B --> F[当日完成的非考核内历史订单]
+    G[当天应该换单数(当日考核内订单)] --> H[24小时换单成功数]
+    G --> E
+```
+- 当日换单完成数 = 当日完成的考核内订单 + 当日完成的非考核内历史订单（包含历史考核过期、标签率未达标等各种状态的订单）
+- 当日换单完成数 + 当日换单失败数 ≤ 当日扫描去重订单数（存在部分订单当日既有成功又有失败记录，被归类为成功）
+- 当日STOP数 是 当日换单完成数 的子集
+- 24小时换单成功数 是 当天应该换单数 的子集
+### 2. 互斥关系
+- 当日换单完成数 和 当日换单失败数 是互斥集合，无交集（同一个订单不会同时被计入两个指标）
+### 3. 比率类指标约束
+- 当天换单完成率 ≥ 0%，可超过100%：分子是当日完成的所有换单数（包含考核内和非考核内的历史订单），分母是当日考核内的订单总数，当完成了较多历史积压订单时比率会超过100%
+- 24小时换单率 ∈ [0%, 100%]：仅统计考核内当日完成的订单，分子是分母的子集
+### 4. 时间维度一致性
+- 所有指标均按UTC-5自然日统计，时间维度完全对齐
+- 考核时间、换单完成时间等跨天场景均已按UTC-5日期规则处理
+## 四、跨指标一致性校验规则
+可通过以下规则验证数据准确性：
+1. **扫描数校验**：`当日扫描数 ≥ 当日换单完成数 + 当日换单失败数`
+2. **完成率校验**：`当日换单完成数 ≤ 当天应该换单数 + 历史未完成换单数`
+3. **STOP数校验**：`当日STOP数 ≤ 当日换单完成数`
+4. **24小时换单率校验**：`24小时换单成功数 ≤ 当日换单完成数`
+## 五、客户维度与全局维度关系
+- 所有客户维度指标按客户代码拆分统计，同一日期所有客户的指标之和 = 全局维度对应指标
+- 客户维度的比率类指标（完成率、换单率）是各客户独立计算，不等于全局指标的简单平均