4.3 KiB
4.3 KiB
实时氢气余量估算及百分比上线验收
发布结果
- 版本：
open-platform-hydrogen-estimate-202609082311；北京时间 2026-09-08 23:10:51 确认就绪。 - 服务：
lingniu-vehicle-open-platform，端口20310；OpenAPI版本1.9.0。 - 二进制 SHA-256：
ad9022068a4aaf2cdfac6c2b5ccb5a6aee7b63980e13fcd1af3548a54d74f179，与最终候选验收文件一致。 - 上一版本
open-platform-live-fields-202609082146保留。没有数据库迁移、容积数据改写或日用氢量算法修改；原门户静态资源沿用。
计算与来源
用户确认满充压力35 MPa，本次固定15°C作为满充参考温度。参考依据及字段完整定义见 oneos-vehicle-live-api-contract.md。
- kg优先使用合法终端上报；字段缺失时，以同一原始帧氢气压力、温度及该VIN已启用的全车水容积估算。无默认温度、默认容积，不把SOC当氢量。显式无效上报不会被估算掩盖。
- 百分比使用同一条剩余质量除以
PressureHydrogenMassKg(35,15,volumeL)，再乘100。使用未舍入质量与分母计算，输出kg及比例保留3位小数。 - 满充模型质量每1000升为23.99502872475178 kg。生产配置只读核对有1144台有效容积，范围380–2460升，最近同步时间2026-09-08 18:39:08.308+08:00；不把有容积等同于有有效遥测。
- kg来源
REPORTED/ESTIMATED，百分比来源ESTIMATED；返回满充kg、容积、35 MPa、15°C、算法版本、输入温压及异常原因。 - 最大氢压/最大氢温代表全车状态属于模型近似，不是逐瓶计量；本次35MPa参数不是每辆车铭牌额定压力的自动核验。
- 真零有效；缺数据或容量返回null及原因；超过100%时百分比null/INVALID并保留独立kg，不能悄悄截为100。陈旧记录保留原采集时间及STALE。
- 仅缺失时在原始帧接收时间前5分钟内检查每VIN最近5个候选；不完整温压可跳过，显式异常不能跳过。查询仍最多4并发、共享3秒预算，容量查询故障保留原上报kg。
验证
- API模块
go test ./...、开放平台go test -race ./internal/openplatform和go vet ./internal/openplatform通过。 - 文档专项测试、YAML解析及required字段校验、发布脚本自测、diff-check通过。
- 单元及SQL测试覆盖满充100%、零压力与真实零、缺容积、缺温度、NaN/null、超额定满充、未舍入分母、STALE、容量查询故障、回补不跨帧拼接、不完整候选跳过及无效候选阻挡。
- 在生产机器127.0.0.1:20311启动候选进程读取真实数据，以临时测试凭证调用正式三个HTTP接口。所有测试凭证与临时授权均在测试后删除，既有合作方密钥和授权未修改。
- 初轮四批各100台：78–80台kg及百分比有值，包含10–11台ESTIMATED kg及真实零；接口119–133毫秒。文档收尾后的最终二进制复验四轮：84–91台kg及百分比有值，后两轮分别46/58台ESTIMATED kg；实时221–345毫秒。每轮重新抽取活跃授权样本，不能视作同一车辆群组的趋势。
- 最终候选同时验证当日及前一日里程/用氢量，旧接口SUCCESS、VIN及白名单校验、401未认证、403未授权名单均通过；无enrichment错误日志。
- 正式版本三轮各100台：kg和百分比非空76/76/74台（包含STALE），每轮1个真实零；其余24/24/26台UNSUPPORTED，无MISSING/INVALID。该组三轮kg来源为REPORTED，百分比为ESTIMATED；压力温度估算kg路径由上述同二进制候选真实样本验证。
- 每条有效百分比都校验质量/满充kg的比值、35MPa和15°C参数、VIN容积与满充分母关系及ESTIMATED来源；允许显示数值舍入误差。
- 正式耗时：实时149/128/124毫秒；里程15/15/15毫秒；用氢6/6/5毫秒。响应数量、VIN、真零、NO_FIX空坐标、鉴权及越权拒绝验证通过。
- 公网
/healthz、/open-api/openapi.yaml、/open-api/docs/均200且版本/新增字段匹配，systemd active。
脱敏响应、容量统计、发布SHA及脚本证据保存在工作区 outputs/hydrogen-estimate-release-20260908/。旧版发布记录作为历史保留；其“百分比尚不支持”限制已由本次按条件估算实现取代。Seeker仍需映射接口字段并展示来源及质量，接口发布不会自动修改客户端页面。