12451
c1b44b6e23
feat(web): 能耗页新增「整柜日用电量（电表读数口径）」区块
后端 `GET /api/cabinets/{id}/meter-usage` 上一提交已上线，本提交把它接到既有的
能耗管理页（`/energy`）—— 用户指出已有能源统计页面，无需新建页面。
## 区块内容
- 柜子下拉（复用 `/cabinets/options`，支持搜索）+ 表格（日期 / 电表末读数 / 当日用电 / 数据质量）
- 分页 15 条/页，未选柜子时提示"请先选择柜子"（而不是显示空表格）
- 表格下方一行区间合计（kWh），并注明"无基准与电表更换日不计入"
## ⛔ 与页面既有区块的区别（必须让用户看见，不能混）
区块顶部加了一条 Alert 常驻说明：
> 本区块是电表读数口径（整柜实际用电，硬件计量、含非充电损耗）；
> 上方卡片与排行是订单电量口径（平台按 V×I×Δt 积分的估算值）。
> 两者数值必然不一致，不可互相替代。
## 三个语义坑在前端的落地（与后端 flags 一一对应）
| flags | 前端渲染 |
|---|---|
| `no_baseline` | 当日用电显示 **`-`**（**不是 0**） |
| `covers_multiple_days` | 数据质量列显示"覆盖多日"（warning 色） |
| `meter_reset_or_replaced` | 当日用电显示 **`-`**，数据质量列显示"电表更换/清零"（danger 色） |
数据质量列正常时显示"正常"。`flags` 与文案的映射收在 `METER_FLAG_META` 常量表里，
**新增 flag 必须同步该表**（否则会渲染成空白标签）。
## 验证
- `npm run typecheck`：**exit 0**
- **自证能失败**：植入未定义变量 `meterFlagNoSuchVar` → `TS2304` / **exit 2**；还原 → exit 0
> 附：第一次自证我选错了判据（把接口的 `usage_wh?` 改成必填），typecheck 不报错 ——
> 因为接口数据源是 `any`，类型由我自己声明的接口决定，改必填确实不冲突。
> 换成编译期必错的未定义变量后才验证成功。**是判据选错，不是工具假绿。**
- `npm run build`：exit 0（产物 572 KB / 6 个文件）
- 后端全量验收仍绿：`cargo check` 0 告警、`cargo test` **204 passed**、
`device_status_parse` 16/16、`rssi_signal` 9/9、结构漂移无
- **端到端**（临时超管账号 + 自签 JWT，用完即删）：造 5 条读数打真实 HTTPS，
断言前端渲染所需的每个字段都在、`flags` 取值与 `METER_FLAG_META` 的 key 一一对应、
三个语义坑全部生效、汇总 500 正确 ⇒ **exit 0**
- 已发布：测试 + 生产（web 产物时间戳与本地构建一致 `00:19:40`，
生产 0 ERROR、域名 401/200；测试环境 nginx reload 后三服务 active）
2026-09-21 00:25:11 +08:00
..
2026-09-20 02:44:51 +08:00
2026-09-20 02:44:51 +08:00
2026-09-19 23:41:09 +08:00
2026-09-21 00:25:11 +08:00
2026-09-19 23:41:09 +08:00
2026-09-20 03:23:00 +08:00
2026-09-20 00:44:35 +08:00
2026-09-19 23:41:09 +08:00
2026-07-02 05:38:01 +08:00