36 lines
4.3 KiB
Markdown
36 lines
4.3 KiB
Markdown
# 实时氢气余量估算及百分比上线验收
|
||
|
||
## 发布结果
|
||
|
||
- 版本：`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`。
|
||
|
||
1. kg优先使用合法终端上报；字段缺失时，以同一原始帧氢气压力、温度及该VIN已启用的全车水容积估算。无默认温度、默认容积，不把SOC当氢量。显式无效上报不会被估算掩盖。
|
||
2. 百分比使用同一条剩余质量除以 `PressureHydrogenMassKg(35,15,volumeL)`，再乘100。使用未舍入质量与分母计算，输出kg及比例保留3位小数。
|
||
3. 满充模型质量每1000升为23.99502872475178 kg。生产配置只读核对有1144台有效容积，范围380–2460升，最近同步时间2026-09-08 18:39:08.308+08:00；不把有容积等同于有有效遥测。
|
||
4. kg来源 `REPORTED` / `ESTIMATED`，百分比来源 `ESTIMATED`；返回满充kg、容积、35 MPa、15°C、算法版本、输入温压及异常原因。
|
||
5. 最大氢压/最大氢温代表全车状态属于模型近似，不是逐瓶计量；本次35MPa参数不是每辆车铭牌额定压力的自动核验。
|
||
6. 真零有效；缺数据或容量返回null及原因；超过100%时百分比null/INVALID并保留独立kg，不能悄悄截为100。陈旧记录保留原采集时间及STALE。
|
||
7. 仅缺失时在原始帧接收时间前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仍需映射接口字段并展示来源及质量，接口发布不会自动修改客户端页面。
|