12451
0441d91d1f
feat(users+cabinets): 用户管理加角色过滤、数据范围仅操作员可配、柜子详情透出电表读数
## 1. 用户管理：角色过滤（页面总共只有三种角色，默认罗列全部太吵）
前端加角色下拉 + 后端 `GET /users` 新增 `role` 参数（0/1/2，越界当作不过滤）。
后端把 `build_user_list_where` 从**二元穷举 match 重构为条件累加** ——
加第三个过滤器时穷举会涨到 8 分支且极易漏。同时修一个潜在坑：
**OR 条件必须整体加括号**，否则 `phone LIKE ? OR name LIKE ?` 与
`organization_id = ?` 用 AND 混排时会变成
`(A AND phone LIKE ?) OR name LIKE ?`，把组织/角色过滤整个击穿
（搜个姓名就跨组织串数据）。
新增 6 个守门单测（含"占位符个数必须与 bind 次数一致"的反证），
已自证能失败：去掉 OR 括号 → 2 个用例 FAILED，还原 → 6 passed。
## 2. 数据范围：仅操作员(role=0)可配
按用户口径：
- **总管理员**：豁免范围限制，不需要配；
- **企业管理员**：天然管理本组织全部设备，配项目级范围反而有歧义；
- **操作员**：才需要设置可管理的项目。
前端对该按钮按 `record.role !== 0` 置灰并加 title 说明。
**创建/编辑时操作员必须选组织**（没有企业归属就看不到任何设备），校验文案也分开提示。
## 3. 柜子详情：透出电表读数
接口早已返回 `meter_wh`/`meter_at`，但**前端从没接过**（用户看不到）。
现加到详情页基本信息行（IMEI/ICCID/名称 之后），Wh → kWh 展示并附收到时刻；
`null` = 从未上报过，显示 `-` 而**不是 0 度**。
## ⛔ 表号：系统里没有，做不了
全仓搜不到 `meter_no`/`meter_id`/`meter_sn`/`表号`，协议里 `cabinet.meter`
只是读数（Wh），**没有电表编号字段**。这需要硬件侧在协议里加字段，
平台无法单方面补。
## ⚠️ 我这次犯的流程错误（已修正）
改了 Rust 代码后**只跑了 cargo check/test，没重新 `zigbuild` release 产物**，
`deploy -SkipBuild` 于是把几小时前的旧二进制发上去了 —— 第一次实测角色过滤
三种角色全返回、监控词。重建后才通过。
**教训：改 Rust 后必须重建 release 产物再发。**
## 验收
- `cargo check --all-targets` 两服务：**0 error / 0 warning**
- `cargo test --bin pms-api`：**210 passed**（204 + 6 新）
- web `npm run typecheck`：exit 0
- **角色过滤实测**（测试环境，临时超管+自签 JWT，用完即删）：
```
role=0 → 2 人，role 集合 [0] OK
role=1 → 1 人，role 集合 [1] OK
role=2 → 2 人，role 集合 [2] OK
不带 role → [0,1,2] OK
role=0 + keyword → 1 人 OK（keyword 单独查命中 0，证明不是靠关键字通过）
role=9 越界 → 5 人 OK（当作不过滤）
```
- 已发布测试 + 生产（四服务 active、0 ERROR、消费链探测通过、二进制时间戳已核对）
2026-09-21 05:02:09 +08:00
..
2026-09-21 05:02:09 +08:00
2026-09-20 04:42:51 +08:00
2026-09-20 04:42:51 +08:00
2026-09-21 05:02:09 +08:00
2026-07-02 05:38:01 +08:00