2.5 KiB
开放接口与中台日里程对齐 — 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 缓存已刷新。