# 开放接口与中台日里程对齐 — 2026-09-18

已部署 `mileage-platform-alignment-20260918`，线上公网单日、区间分页及显式协议优先级请求均确认：粤AGG5043 / LB9A32A29R0LS1065 / 2026-09-17 返回 `dailyMileageKm=308.2`、`totalMileageKm=42077`、`status=NORMAL`，无 `dataQuality` 异常字段。

## 修复

开放平台优先保留中台已选中、质量为 OK 且日里程/累计值与最终日统计匹配的来源结果，不再因前后两天选择的来源不同而将其改为异常，也不跨来源重新相减。统计起止时间仍保留该来源真实基线。未验证的来源继续使用原累计差与异常检查；INVALID_DELTA、协议不明历史导入及 GPS 估算未被放行。无当日记录时仍结转累计值、日里程为 0。

未修改车辆源数据或中台里程统计表。仅发布开放平台服务；更新了接口内嵌文档和只读核对工具。

## 验证

- API Go 模块 `go test ./...` 通过。
- 新增来源切换 308.2 样本、单日/区间切分一致性、缺报结转、异常记录不被平台标识绕过及 SQL 读取回归测试。
- 生产只读批量验证覆盖 1,024 辆车、09-15～09-17 共 2,063 条结果：1,540 条已验证日统计、523 条结转；平台日里程差异 0，单日与区间差异 0。
- 公网 POST `/api/v1/vehicles/mileage/query` 实际返回 308.2 / NORMAL，traceId：`25fb3895520655b957e27783cee36b09`。
- 公网 POST `/api/v1/vehicles/mileage/range/query` 以 pageSize=1 读取三页，09-17 返回相同数值及状态，traceId：`3f210f2b0bf95cf55015429db252a150`。
- 显式协议优先级 GB32960、MQTT、JT808 返回相同结果。
- 测试应用 74 仅授权目标车辆，验证后已停用、清空车辆授权，原测试密钥已返回 HTTP 401；报告不包含密钥。
- 新服务健康检查通过；运行二进制 SHA-256 见 deployment.json。

## 发布与回退

新目录：`/opt/lingniu-vehicle-open-platform/releases/mileage-platform-alignment-20260918`。
旧目录：`/opt/lingniu-vehicle-open-platform/releases/mileage-reconciliation-20260916`。
环境配置及旧版本路径备份：`/opt/lingniu-vehicle-open-platform/backups/mileage-platform-alignment-20260918`。

回退时恢复备份环境配置、将 current 指回旧版本并重启 lingniu-vehicle-open-platform；无数据库迁移需回退。

下游 BI 缓存不在本次修改范围。若仍展示旧异常，需要重新拉取或等待缓存过期；本次未声称 BI 缓存已刷新。