From ddbba184312c9b63951e19616365d494da323f0e Mon Sep 17 00:00:00 2001 From: lingniu Date: Mon, 20 Jul 2026 10:00:09 +0800 Subject: [PATCH] docs(ops): record latest mileage backfill --- ...7-20-daily-mileage-track-reconciliation.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/ops/2026-07-20-daily-mileage-track-reconciliation.md b/docs/ops/2026-07-20-daily-mileage-track-reconciliation.md index 321cfc64..4e6eb293 100644 --- a/docs/ops/2026-07-20-daily-mileage-track-reconciliation.md +++ b/docs/ops/2026-07-20-daily-mileage-track-reconciliation.md @@ -220,6 +220,34 @@ stat-writer 已支持在累计里程缺失时，用有速度证据的相邻 GPS 本轮不需要重新发布服务：生产已运行包含累计里程停滞恢复、100 米漂移阈值、来源重选举和轨迹累计值“非区间”标识的修复版本；此次完成的是当前时刻全量事实复核和增量安全补录。 +## 7 月 20 日 09:56 插入事项全量回补 + +用户再次以沪A01559F、沪A62013F 为例反馈“轨迹回放有里程、今日里程未计算”。本次不再把页面点位数值当作统计证据，而是同时读取生产轨迹接口、TDengine 完整位置点、来源候选、最终投影和诊断接口： + +- 沪A01559F 当天完整读取 260 个宇通源点，质量过滤后 259 点、2 个坐标值，最高和平均速度均为 0，平台轨迹摘要 `distanceKm=0`；最终日里程为宇通 `stationary_carry_forward` 0 km。 +- 沪A62013F 当天完整读取 271 个宇通源点，质量过滤后 259 点、2 个坐标值，最高和平均速度均为 0，平台轨迹摘要 `distanceKm=0`；最终日里程为宇通 `stationary_carry_forward` 0 km。 +- 两车轨迹位置点均没有可用总里程字段；实时快照中的 14,097 km、24,245 km 分别是设备累计总里程，最新累计里程事件仍停留在 7 月 19 日和 7 月 18 日。两车不是漏写，也没有可补的正向里程。 + +随后按 2026-07-20 上海自然日对 GB32960、JT808、YUTONG_MQTT 执行全量 dry-run 和正式幂等回补。dry-run 重建 948 个来源聚合、补齐 10 个宇通静止结转候选、计算 6 个 JT808 GPS 安全聚合；正式运行随实时数据增长写入 954 个来源聚合并规范化 426 个 JT808 平台来源。回补没有重置统计表，没有发现低于 100 米的遗留漂移候选，也没有 GB32960 或宇通 GPS 正向降级候选。 + +回补后共有 9 个 JT808 GPS 安全候选被最终统计选中，其中 4 辆是相对 09:23 复核新增的正向结果： + +| 车牌 | VIN | 最终日里程 | 处理结果 | +| --- | --- | ---: | --- | +| 粤AGP5770 | `LB9A32A22R0LS1666` | 0.117 km | 新增补录 | +| 粤AGP5636 | `LB9A32A23R0LS1479` | 0.148 km | 新增补录 | +| 粤AGP5615 | `LB9A32A23R0LS1594` | 0.176 km | 新增补录 | +| 粤AGP5359 | `LB9A32A24R0LS1524` | 0.143 km | 新增补录 | +| 浙F02268F | `LA9HE60A6PBAF4022` | 0.241 km | 既有候选增量更新 | +| 粤AGG3413 | `LB9A32A24R0LS1040` | 0.252 km | 既有候选增量更新 | +| 沪A66216F | `LKLG7C4E1NA774783` | 1.918 km | 既有候选增量更新 | +| 沪A69826F | `LKLG7C4E2NA774775` | 14.517 km | 既有候选增量更新 | +| 沪A63305F | `LKLG7C4E3NA774798` | 0.209 km | 既有候选增量更新 | + +回补后诊断覆盖 817 个活跃“协议 × 车辆”项：GB32960 328 个、JT808 440 个、宇通 47 个均已有最终日里程，`pipeline_issue_total=0`。三协议 Kafka 全部分区 lag 为 0，stat-writer 三个消费线程的重试队列均为 0，容量巡检退出码为 0。剩余两个源数据缺口仍为沪A00113F 的 JT808 和宇通 VIN `LMRKH9AC9R1004121`，二者源头没有总里程字段且没有满足业务门槛的可信移动线段，继续保留缺口而不构造数值。 + +本次无需再发布 Go 服务：生产 `mileage-gps-candidate-reconcile-202607200350` 已包含实时 GPS 兜底、阈值下漂移拒绝、来源重选举和幂等回补能力。Web 轨迹点位已明确展示“设备累计值 · 非区间”，平台轨迹摘要与日里程统计因此可以按同一业务语义核验。 + ## 限制与后续监控 - GPS 估算只在仪表里程缺失或停滞时兜底，不替代 GB32960、宇通仪表里程或 JT808 设备里程。