chore: snapshot production code before Apple Design UI refinement

2026-09-17 18:05:57 +08:00
parent 9f0a87f49e
commit f7e7176f88
90 changed files with 8990 additions and 328 deletions
@@ -0,0 +1,45 @@
+# 氢耗统计与导出口径修正
+
+百公里氢耗使用修正用氢量（`soc_balanced_consumption_kg`）除以匹配里程乘以 100。
+匹配里程延续既有口径：优先氢能统计的混动里程，否则使用日纯氢里程。
+每日值、车辆区间合计和车队区间汇总均使用此口径；区间效率只计质量通过且有匹配里程的车辆日。
+修正用氢量缺失时不回退物理用氢量，零里程不计算效率。
+物理用氢量仍保留在 Excel 独立列及计算证据中。
+
+Excel「氢能明细」增加当天所在省、市、大区、定位时间和位置状态。
+省市取北京时间该日最后一个有效历史定位点，经现有服务端高德接口解析。
+跨省、市行驶以该点归属为准，不表示全天仅在该行政区活动。
+无当天有效定位时标记未知；历史位置或地址接口失败时终止导出并提示重试。
+位置请求限制为三个并发，支持进度显示及取消。大范围导出会增加位置查询耗时。
+
+大区采用七区划分：华东、华北、华中、华南、东北、西南、西北；西部未合并成“华西”。
+直辖市的城市字段在解析接口未返回时使用直辖市名称。
+
+本次无需数据库迁移或历史用氢重算，依赖已有修正用氢量、历史定位数据及高德服务配置。
+已同时发布 API 和 Web，版本 `hydrogen-consumption-202609100956`。
+保留上一版 `platform-performance-202609091012` 供回滚。
+
+正式域名 https://vehicle.d.lnoneos.com 上抽查 200 条车辆日记录：149 条可计算，
+全部符合修正口径，其中 146 条修正量与物理量不同；单车区间汇总核验通过。
+当天历史位置和高德省市解析核验通过。API 服务 active，运行版本及二进制 SHA-256 与发布产物一致。
+发布脚本的当前及兼容静态资源逐字节检查通过。
+验收证据位于 `outputs/hydrogen-consumption-release-20260910/`。
+
+
+## 2026-09-10 补充修复与线上交互验收
+
+版本 `hydrogen-consumption-202609101134` 已发布，上一版 `hydrogen-consumption-202609100956` 保留。
+上次仅统一日氢耗比率，日数据主字段 `hydrogenConsumptionKg` 仍为物理量；现改为修正量，
+物理量通过 `hydrogenPhysicalConsumptionKg` 单独返回。计算证据主比率字段改为修正比率，
+原物理比率通过 `physicalConsumptionKgPer100Km` 保留。客户权限过滤同时屏蔽新增物理量字段。
+这些改动作用于历史查询，未改写原始物理计算证据。
+
+氢耗视图导出现在以「氢能明细」作为第一张工作表，省、市、大区移至第3～5列；
+文件名明确标为车辆氢耗明细。里程视图保留里程表在首位。
+
+正式域名通过 Playwright + 已安装 Chrome 实际点击氢耗视图、导出 Excel，并用 ExcelJS 重新打开下载文件：
+浙F09968F / 2026-09-01，修正量8.714kg，物理量12.813kg，匹配里程77km，
+每日氢耗11.316883116883117kg/100km，地区为浙江省、嘉兴市、华东；首表、列序、数值断言通过。
+桌面1440×1000页面正常、无运行时错误。未覆盖手机端导出及用户尚未提供的具体异常记录。
+另外抽查2026-07-13、2026-08-11、2026-09-08各200条历史车辆日，
+主用氢量与修正量字段一致，可计算比率均符合修正公式。