Files
LabelChange-server/.trae/documents/运营指标逻辑全量对齐修复计划.md
2026-06-01 16:30:29 +08:00

5.6 KiB
Raw Permalink Blame History

运营指标逻辑全量对齐修复计划

问题背景

当前最新运营监控.sql的统计结果和运营指标验证明细查询.sql的明细数据不一致5月1日「当天应该换单数」明细统计为9593汇总统计仅为8537核心问题为联表条件过滤了部分有效订单同时需要按照最新的指标定义全量对齐所有指标的计算逻辑。

修复目标

  1. 完全对齐用户给出的所有指标统计规则
  2. 5月1日「当天应该换单数」统计结果等于9593与明细完全一致
  3. 所有指标计算逻辑在汇总SQL和明细SQL中保持统一
  4. 正确处理时区转换所有时间除到仓时间外统计时均转换为UTC-5日期维度统一使用UTC-5自然日
  5. 累计要换的总单数按RequestId去重无重复统计

修复步骤

步骤1读取当前SQL文件确认现有逻辑

读取以下两个核心SQL文件梳理当前的联表逻辑、指标计算方式和存在的问题

  • d:\EPproject\LabelReplaceServer\最新运营监控.sql
  • d:\EPproject\LabelReplaceServer\运营指标验证明细查询.sql

步骤2补全AllDates日期维度

确保日期维度包含所有需要用到的日期,避免联表时丢失有效数据:

AllDates AS (
    SELECT ReceiptDate AS 日期 FROM OrderFullInfo -- 到仓日期UTC-5
    UNION
    SELECT LabelRetrievedDate_UTC5 AS 日期 FROM OrderFullInfo WHERE LabelRetrievedDate_UTC5 IS NOT NULL -- 标签推送日期UTC-5
    UNION
    SELECT FirstSuccessDate_UTC5 AS 日期 FROM OrderFullInfo WHERE FirstSuccessDate_UTC5 IS NOT NULL -- 标签率达标日期UTC-5
    UNION
    SELECT DATE(CONVERT_TZ(AssessmentBaseTime, '+00:00', '-05:00')) AS 日期 FROM OrderFullInfo WHERE AssessmentBaseTime IS NOT NULL -- 考核基准日期转UTC-5
    UNION
    SELECT DATE(CONVERT_TZ(AssessmentTime, '+00:00', '-05:00')) AS 日期 FROM OrderFullInfo WHERE AssessmentTime IS NOT NULL -- 考核截止日期转UTC-5
    UNION
    SELECT DATE(CONVERT_TZ(ScanTime, '+00:00', '-05:00')) AS 日期 FROM ScanHistory WHERE ScanTime IS NOT NULL -- 扫描日期转UTC-5
    UNION
    SELECT DATE(CONVERT_TZ(LabelPushTime, '+00:00', '-05:00')) AS 日期 FROM LabelPushHistory WHERE LabelPushTime IS NOT NULL -- 标签推送日期转UTC-5
    UNION
    SELECT DATE(CONVERT_TZ(ReplaceSuccessTime, '+00:00', '-05:00')) AS 日期 FROM ReplaceHistory WHERE ReplaceSuccessTime IS NOT NULL -- 换单完成日期转UTC-5
)

步骤3优化主查询联表逻辑

移除所有多余的过滤条件,确保所有有考核时间的订单都能被正确关联:

  • 保持AllDates LEFT JOIN OrderFullInfo的关联方式
  • 移除所有在JOIN条件和WHERE条件中多余的LabelRate >= 0.8判断有考核时间的订单默认已满足标签率≥80%
  • 移除对FirstScanTime_UTC5非空的判断,兼容无扫描记录的订单

步骤4全量更新所有指标计算逻辑严格对齐用户定义

指标定义对照表

指标名称 计算逻辑 说明
日期 自然日时间UTC-5 -
当天新增换单数 到仓时间是当天的有标签订单总数 到仓时间本身为UTC-5无需转换
累计要换的总单数 有标签并且(当日没有换单成功记录 或者 换单完成时间大于今天)的不重复订单总数 按RequestId去重换单完成时间转换为UTC-5判断
当天应该换单数 考核基准日期是当天 或者 考核截止日期是当天的订单总数 考核基准时间、考核截止时间均转换为UTC-5判断
当日换单完成数 换单完成记录时间是当天的包裹数不包含STOP数 换单完成时间转换为UTC-5判断
当日换单失败数 换单非完成记录时间是当天的包裹数 换单记录时间转换为UTC-5判断
当日STOP数 换单完成时间是当天并且描述中含有STOP的包裹数 换单完成时间转换为UTC-5判断
24小时换单成功数 首次换单完成时间在考核基准时间与考核时间之间的包裹数 所有时间均转换为UTC-5后判断时间范围
当日标签推送数 标签推送时间是当天的包裹数 标签推送时间转换为UTC-5判断
当日扫描数 扫描时间是当天的扫描历史记录总数 扫描时间转换为UTC-5判断
当天换单完成率 当日换单完成数 / (当天应该换单数 + 累计要换的总单数) -
24小时换单率 24小时换单成功数 / 当天应该换单数 -
数据拉取时间 当前时间UTC-5 -

步骤5调整字段输出顺序

按照用户要求的顺序排列输出字段:

  1. 日期
  2. 当天新增换单数
  3. 累计要换的总单数
  4. 当天应该换单数
  5. 当日换单完成数
  6. 当日换单失败数
  7. 当日STOP数
  8. 24小时换单成功数
  9. 当日标签推送数
  10. 当日扫描数
  11. 当天换单完成率
  12. 24小时换单率
  13. 数据拉取时间UTC_5

步骤6同步更新明细查询SQL

确保运营指标验证明细查询.sql的逻辑和汇总SQL完全对齐

  • 同步更新所有指标的计算逻辑
  • 保持字段命名一致
  • 保留所有明细字段的输出,方便用户手动核对

步骤7验证统计结果

执行汇总SQL查询2026-05-01的「当天应该换单数」确认结果等于9593与明细统计结果完全一致。

验收标准

  1. 5月1日「当天应该换单数」= 9593
  2. 所有指标逻辑完全符合用户给出的定义
  3. 汇总SQL和明细SQL统计结果完全一致
  4. SQL可正常运行无语法错误
  5. 所有非到仓时间的统计均已转换为UTC-5时区
  6. 累计要换的总单数已按RequestId去重无重复统计