docs(cockpit): 补设备详情人工走查验收说明

记录三台样本设备的逐步验收步骤、6 条通用检查项、不通过判定标准与反馈格式，
含本次实测结论（21119740 三态齐全、2509250560010000 普通数值、860347065467627 直接报警）。
同时记录已核实的边界：未判定不等于正常、锚定面板可被侧栏遮盖属既有规格、
噪声联合规则暂不伪造阈值结论。

docs/cockpit-device-detail-acceptance.md

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