jennisonzhang/LabelChange-server
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
LabelChange-server/.trae/documents/complete_metrics_definition_v6.md
Im-Jenisson b2a9b7d3c2 上传源代码版本
2026-06-01 16:30:29 +08:00

11 KiB
Raw Permalink Blame History

日级报表所有指标的来源和计算方式 - 完整版（v6.0）

更新日期: 2026-05-16
版本: v6.0 - 完整字段来源总结
状态: ✅ 编译通过，逻辑最终确定

核心指标定义变更

24H换单率 - 最终定义

新公式：

24H换单率 = 高标签率考核通过数 / 高标签率应该换单数 × 100%

其中：
- 高标签率考核通过数 = 16点前考核通过 + 16点后考核通过
- 高标签率应该换单数 = 所有冻结标签率≥80%的订单

场景说明：

情景1：冻结标签率 = 79% （< 80%）
├─ 100个订单
├─ 完成数：80个
├─ 贡献到24H换单率的分子：0（不计入）
├─ 贡献到24H换单率的分母：0（不计入）

情景2：冻结标签率 = 80% （>= 80%）
├─ 100个订单
├─ 考核通过数：75个
├─ 贡献到24H换单率的分子：75（全部计入）
├─ 贡献到24H换单率的分母：100（全部计入）

汇总24H换单率：
24H换单率 = 75 / 100 = 75%
（注意：79%的100个订单不参与计算）

完整字段清单与数据来源

第1组：基础时间字段

字段名 中文名 数据来源 计算方式 说明
Date 日期 ArrivalRequests DATE(CONVERT_TZ(到货时间, '+00:00', '-05:00')) UTC-5时区的自然日

第2组：基础统计字段（直接来自原始数据）

字段名 中文名 数据来源 CTE 查询逻辑 说明
DailyNewReplaceCount 当日新增换单数 DailyBase COUNT(DISTINCT 交接单) WHERE 到货日期=当日 当天新增的交接单总数
DailyFailureCount 当日换单失败数 DailyFailedOrders COUNT(DISTINCT 订单) WHERE 失败标记时间=当日 当天新增失败的订单数
DailySuccessCount 当日换单成功数 DailySuccessCount COUNT(DISTINCT 订单) WHERE 首次成功时间=当日 当天首次成功扫描的订单数
DailyStopCount 当日STOP数 DailyScanMetrics COUNT(DISTINCT 订单) WHERE STOP标记时间=当日 当天被STOP的订单数
BeforeNoonArrivedCount 16点前到仓包裹数 DailyBase COUNT(DISTINCT 订单) WHERE 到货时间 BETWEEN 当日00:00 AND 16:00 当天早上16点前到达的订单
AfternoonArrivedCount 16点后到仓包裹数 DailyBase COUNT(DISTINCT 订单) WHERE 到货时间 BETWEEN 当日16:01 AND 23:59 当天下午16点后到达的订单
DailyCompletedOrders 当日完成数 DailyCompletedOrders COUNT(DISTINCT 订单) WHERE 完成时间=当日 当天完成流程的订单数
Daily24HCompleted 24H内完成数 Daily24HCompletedOrders COUNT(DISTINCT 订单) WHERE 完成时间在24小时内 24小时周期内完成的订单数
DailyLabelPushCount 当日标签推送数 DailyBase COUNT(DISTINCT 订单) WHERE 标签推送时间=当日 当天新增推送的标签数
DailyScanCount 当日扫描数 DailyScanMetrics COUNT(DISTINCT 订单) WHERE 首次扫描时间=当日 当天首次被扫描的订单数

第3组：递推累计字段（需要上一日数据）

字段名 中文名 计算方式 说明
CumulativeTotalReplaceCount 累计要换的总单数 MAX(0, 前一日累计 + 前一日新增 - 前一日完成) 当前待处理的积压交接单数
ShouldReplaceCount 当天应该换单数 累计要换的总单数 + 当日新增换单数 当天的完成目标数
UnfinishedFailureCount 换单失败未完结订单 从HistoryUnfinished或LatestUnfinished 失败且未完成的订单数

第4组：考核维度字段

4.1 高标签率考核通过（标签率≥80%）

字段名 中文名 数据来源 CTE 考核逻辑 说明
BeforeNoonPassedCount 16点前考核通过包裹数 DailyBeforeNoonPassed WHERE 到货时间<16:00 AND 首次成功时间≤考核时间 AND 标签率≥80% 16点前到仓，标签率高，按16点分段规则考核通过
AfternoonPassedCount 16点后考核通过包裹数 DailyAfternoonPassed WHERE 到货时间≥16:00 AND 首次成功时间≤考核时间 AND 标签率≥80% 16点后到仓，标签率高，按23:59:59规则考核通过

考核时间规则：

IF 冻结标签率 >= 80% THEN
  IF 到货时间 < 16:00 THEN
    考核时间 = 当日16:00 ~ 次日16:00
  ELSE
    考核时间 = 当日16:00 ~ 次日23:59:59
  END IF
ELSE
  考核时间 = NULL（完成即达标）
END IF

4.2 低标签率考核通过（标签率<80%）

字段名 中文名 数据来源 CTE 考核逻辑 说明
LowLabelRatePassedCount 低标签率考核通过包裹数 DailyLowLabelRatePassed WHERE 首次成功时间 IS NOT NULL AND 标签率<80% 标签率低，只要完成就达标

第5组：标签率维度字段

字段名 中文名 数据来源 CTE 计算方式 说明
HighLabelRateShouldCount 高标签率应该换单数 DailyHighLabelRateShould COUNT(所有冻结标签率≥80%的交接单中的包裹) 应该按高标签率规则处理的订单总数
LowLabelRateShouldCount 低标签率应该换单数 DailyLowLabelRateShould COUNT(所有冻结标签率<80%的交接单中的包裹) 应该按低标签率规则处理的订单总数

第6组：衍生计算字段

6.1 考核通过总数

字段名 中文名 计算公式 说明
AssessmentPassedCount 考核通过总数 16点前考核通过 + 16点后考核通过 + 低标签率考核通过 所有通过考核的订单总数

6.2 当天换单完成率

字段名 中文名 计算公式 说明
DailyCompletionRate 当天换单完成率 当日完成数 / 当天应该换单数 × 100% 当天的完成达成率

6.3 24H换单率（最终定义）

字段名 中文名 计算公式 说明
Rate24Hour 24H换单率 高标签率考核通过数 / 高标签率应该换单数 × 100% 关键KPI：标签率≥80%的订单在24小时内的考核达成率

详细计算：

高标签率考核通过数 = 16点前考核通过包裹数 + 16点后考核通过包裹数

24H换单率 = 高标签率考核通过数 / 高标签率应该换单数 × 100%

示例：
16点前考核通过：40个
16点后考核通过：35个
高标签率考核通过数 = 40 + 35 = 75个

高标签率应该换单数 = 100个

24H换单率 = 75 / 100 = 75%

6.4 元数据

字段名 中文名 计算方式 说明
DataFetchTime 数据拉取时间（UTC-5） UTC_TIMESTAMP() - INTERVAL 5 HOUR 报表生成时间

冻结标签率详解

定义

冻结标签率 = (最早扫描时间 > 标签推送时间的包裹数) / 总包裹数 × 100%

计算来源

InterchangeUnitLabelRates CTE:
├─ 对每个交接单计算
├─ 最早扫描时间 = MIN(label_scan_history.CreatedAt)
├─ 标签推送时间 = label_replace_requests.LabelRetrievedAt
└─ 比较：最早扫描时间 > 标签推送时间
   ↓
   TRUE → 标签在作业开始前推送（高标签率）
   FALSE → 标签在作业开始时或之后推送（低标签率）

应用

IF 冻结标签率 >= 80% THEN
  整个交接单的所有包裹 → 按高标签率规则处理
    ├─ 16点前到仓 → 考核时间 = 当日16:00 ~ 次日16:00
    └─ 16点后到仓 → 考核时间 = 当日16:00 ~ 次日23:59:59
  
ELSE IF 冻结标签率 < 80% THEN
  整个交接单的所有包裹 → 按低标签率规则处理
    └─ 完成即达标（无固定考核时间）
END IF

完整的数据流示例

场景数据

【高标签率交接单】冻结标签率 = 85%
├─ 100个应该完成的订单
├─ 16点前到仓：60个
├─ 16点后到仓：40个
├─ 16点前考核通过：50个
├─ 16点后考核通过：30个

【低标签率交接单】冻结标签率 = 30%
├─ 100个应该完成的订单
├─ 完成即达标
├─ 实际完成：85个

【总计】200个订单

指标计算

1. 标签率维度统计
   高标签率应该换单数 = 100（冻结标签率≥80%的交接单）
   低标签率应该换单数 = 100（冻结标签率<80%的交接单）

2. 考核通过统计
   高标签率考核通过 = 50 + 30 = 80个
   低标签率考核通过 = 85个（完成即达标）
   考核通过总数 = 80 + 85 = 165个

3. 完成率统计
   当天换单完成率 = (50 + 30 + 85) / 200 × 100% = 82.5%

4. 24H换单率（关键指标）
   24H换单率 = 高标签率考核通过数 / 高标签率应该换单数
           = 80 / 100 × 100% = 80%
   
   注意：低标签率的85个完成订单不参与这个指标
   因为24H换单率只关注"标签率≥80%"的履约情况

指标的业务含义

当天换单完成率 (82.5%)

  • 含义：当天应该完成的所有200个订单中，有82.5%在当天完成
  • 用途：衡量当天的工作效率
  • 计算：(当日完成数) / (当天应该换单数)

24H换单率 (80%)

  • 含义：标签率≥80%的100个订单中，有80个在24小时内满足考核条件
  • 用途：客户看到的关键指标，衡量"高质量需求"的履约能力
  • 计算：(高标签率考核通过数) / (高标签率应该换单数)
  • 为什么不包括低标签率？
    • 低标签率的订单只需"完成即达标"，门槛较低
    • 24H换单率重点反映"标签率高"（难度大）的订单的完成情况
    • 对客户更有说服力

SQL CTE 关键依赖关系

基础表 (label_replace_requests, OverallScanStatus, arrival_handover_forms)
    ↓
┌─ ArrivalRequests (考核时间计算)
│    ↓
├─ InterchangeUnitLabelRates (冻结标签率计算)
│    ↓
├─ DailyBeforeNoonPassed (16点前考核通过)
│
├─ DailyAfternoonPassed (16点后考核通过)
│    ↓
├─ DailyHighLabelRateAssessed (高标签率考核通过数汇总)
│
├─ DailyLowLabelRatePassed (低标签率考核通过)
│
├─ DailyHighLabelRateShould (高标签率应该换单数)
│
├─ DailyLowLabelRateShould (低标签率应该换单数)
│
└─ DailyStatsWithPrev (最终汇总)
     ↓
   最终SELECT (所有指标输出)

编译状态

✅ 编译成功 (exit code 0)

  • 24H换单率公式已修正
  • 所有字段来源已梳理
  • SQL逻辑已完整

关键总结

24H换单率的核心价值

公式：高标签率考核通过数 / 高标签率应该换单数

意义：

  1. ✅ 专注于高难度需求：只看标签率≥80%的订单
  2. ✅ 衡量24小时履约：在规定考核时间内是否完成
  3. ✅ 对客户有说服力：客观反映在更高要求下的完成能力
  4. ✅ 分子分母明确：分子=考核通过，分母=应该换单

与其他指标的区别

指标 分子 分母 涵盖范围
当天完成率 当日完成数 当天应该换单数 所有订单
24H换单率 高标签率考核通过 高标签率应该换单 仅≥80%
考核通过率 考核通过总数 高标签率应该换单 参考用