设备详情人工走查验收说明（#115）

面向维护者手工验收「设备详情浮动面板」的最新一轮改动。记录时间：2026-11-10（Asia/Hong_Kong）。入口 http://localhost:8000 ，真实数据源（dataSource=real）。

0. 前置条件（已确认满足）

项	状态
前端 dev server 8000	运行中（HTTP 200）
后端逐指标判定接口	已发布并在跑新代码：/equipments/{code}/collection-records 的 cell 已带 assessment
后端启动方式	IntelliJ IDEA 以 target/classes 直跑（非 jar），带 spring-boot-devtools；本机 192.168.110.96:8301，进程 2026-11-10 09:53:52 启动、class 编译于 09:45
是否需要重启	不需要。线上响应已含本轮字段，重启只会增加中断风险

1. 验收步骤（按设备逐个走）

进入方式：打开 http://localhost:8000 → 点「点击进入系统」→ 地图上点设备（或从左侧设备台账进入设备详情）→ 切到 最新指标 页签。

1.1 环境监测设备（三态齐全）：21119740 测试环境监测-测试01

进入路径：监测点 CBWS202610150001 → 设备卡片 21119740。
看状态栏：应同时出现 在线 + 预警 + 报警 三个标签，末尾是「设备状态」说明。
看指标颜色：
- 悬浮物 / 酸碱度（pH）→ 绿（正常）
- 电导率 → 黄（预警）
- 氨氮 / 化学需氧量（COD）→ 红（报警）
看提示点：只有预警与报警值旁边有圆点；正常值没有点。黄点＝预警、红点＝报警；点的颜色不表示等级，等级在悬停时看。
本次实测：状态栏「在线预警报警」；三色齐全；6 个点（预警·3级 / 报警·4级）。
注意：等级色与状态色是两件事。例如「报警 · 4级」的数值是红的，提示点仍按状态为红；等级里的 4 级（绿）只出现在浮层文字里。

1.2 普通数值设备：2509250560010000 可燃气体监测-测试01

看状态栏：应显示该设备全部标签（本次实测「报警 + 工单处置」）。
看指标表：列头气体浓度（%LEL）/ 温度 / 湿度 / 电池电量。
预期：气体浓度 → 绿（阈值内正常）；温度/湿度/电池 → 未判定（白字、无点），因为后端未提供这些指标的规则映射，这是如实说明而不是故障。
本次实测：normal 与 unknown 并存，提示点 0 个（正常值不画点，符合预期）。

1.3 直接报警设备：860347065467627 井盖设备-测试01

看指标表：列头采集时间 / 倾斜角度 / 水浸报警状态 / 水位报警状态 / 温度 / 电池电量。
预期：设备直接上报的报警列 → 红；上报为正常的列 → 绿；无映射的附属数值 → 未判定。
本次实测：alarm（倾斜角度，报警·1级）/ normal（水浸正常）/ unknown（温度、电池）三态并存，8 个红点。
注意：该设备详情面板本次落在左栏下方被遮住——这是票 41 规格 R-3 明写的「锚定面板允许被侧栏遮盖」，不是本轮回归。把镜头平移一下即可看到面板（标签键仍为 OFFLINE/ALARM/WORK_ORDER）。

2. 通用检查项（每个设备都过一遍）

状态栏是多标签：在线/离线＋预警＋报警＋工单处置可并排；「独立设备」标签不出现在状态栏。
只有预警/报警有点：正常值、未判定值都不应出现圆点。
悬停立即出等级：鼠标移到点（或键盘 Tab 聚焦）→ 立刻弹出「预警 · N级 / 报警 · N级」，不需要等待、不是「？」光标、不用浏览器原生 title。
时间列在首列：列头「采集时间」，日期与时分秒分两行；格式 yyyy-mm-dd ＋ hh:mm:ss，不带时区/毫秒。
自动刷新不打断查看：切到第 2 页、展开一个条目、往下滚一点，等一轮「更新」→ 页签、页码、展开状态、滚动位置应保持；只有换设备/换范围/主动关闭才复位。
无横向滚动：表格在面板内不出现横向滚动条。

3. 判定不通过的标准（对照 #115 验收标准）

状态栏只显示一个标签 → 不通过。
正常值旁边出现圆点，或预警/报警值没有点 → 不通过。
悬停需要等待、显示「？」或浏览器原生提示 → 不通过。
数值颜色与 assessment.status 不一致（黄/红/绿错配）→ 不通过。
自动刷新后页签/页码/展开/滚动被复位 → 不通过。
时间列不在首列或格式不符 → 不通过。

4. 不通过怎么反馈

在 #115 回一条，带上：设备编码＋哪一项（1–6）＋实际现象＋期望。有截图更好。

5. 不在本次范围

前端实现与离线回归（AI 已完成：t11 63/63、t115、t116 14/14、t117）。
TEST_001 档案图片文件本身 404 —— 数据侧文件缺失，不影响本单验收。
噪声/漏失设备（如 8652052334）的 RMS/中心频率返回 未判定 · 需联合规则（频段＋连续确认＋恢复滞回），本轮不伪造普通阈值结论。
不改设备状态词表语义、不重做预警/报警/工单页签、不动点位摘要第一级。

6. 相关事实速查

判定协议：cell 上新增 assessment，含 status（NORMAL/WARNING/ALARM/UNKNOWN）、level（1–4 或 null）、levelColor、reason。
只读复核命令：curl http://192.168.110.96:8301/api/cockpit/v1/equipments/21119740/collection-records