# 无设备监测点修复：运行验证记录

- 初始修复基线：后端 `740d896`；编译时后端 `master=0a6b108`，并行工单改动未纳入本票补丁。
- 用户在本轮通过验收授权选项，明确允许后端编译、Cockpit/BusinessCockpit 契约测试和现有8301只读接口复验；未授权服务重启。
- 验证时间：2026-10-12 09:40（Asia/Shanghai）。

## 编译与契约测试

命令（后端根目录执行）：

```powershell
mvn -o -pl pipe-network-service/zksy-admin -am test '-Dtest=Cockpit*Test,BusinessCockpit*Test' '-Dsurefire.failIfNoSpecifiedTests=false'
```

结果：8模块 BUILD SUCCESS，**合计423项：zksy-system 2项 + zksy-admin 421项；Failures=0、Errors=0、Skipped=0**。本票三个测试类分别为分布21项、概览14项、真实概览适配器5项，包含新增六项回归。这里是按所列Cockpit/BusinessCockpit模式选择的契约回归，不声称整个仓库所有测试均运行。

第一次命令在workspace-write下因后端target目录写入权限失败，随后同一命令经扩展权限重试成功。测试日志保留在宿主临时目录；成功记录来源：Maven日志的zksy-system汇总2项、zksy-admin汇总421项和最终BUILD SUCCESS，而非只读取最后一个模块的数字。

## 真实环境复验（现有实例，未通过）

只读证据：[三端点统计响应摘录](artifacts/t28/live-readonly-verification.json)。均HTTP200、业务code200。

| 端点 | 当前实测 | 验收判据 | 状态 |
| --- | --- | --- | --- |
| map-snapshot | 6点，GS001/GS002/PS001/PS002/RQ001/RQ002；6点不可上图，7台独立设备 | 全量点位为6 | 通过（现有台账基线） |
| monitoring/overview | monitoringPointCount=0 | 应为6并与地图一致 | 未通过 |
| monitoring/distribution | EMPTY=0、total=0；excluded.invalidCoordinateCount=7；freshness=EMPTY/NO_RESOLVED_DEVICES | EMPTY=6、total≥6；坐标不排除统计，freshness不误报 | 未通过 |

只读进程查询确认8301监听实例为 **java PID28656，启动时间2026-10-12 09:36:40**，早于成功编译09:40:23。现有实例仍表现为补丁前实现；本轮未重启，不把源码编译及MockMvc测试通过当作真实环境生效。需要维护者重启/重新加载这个实例后重跑同一只读探针。

## 重启前阶段状态

当时执行票保持开启、认领保留；代码及契约测试已完成，但现有实例真实验收尚未通过，暂不提交推送。

## 维护者重启后复验（2026-10-12 10:05–10:08）

维护者在本轮确认已通过IDE重启实例。重跑相同三端点探针，新结果保留在[只读响应证据](artifacts/t28/live-readonly-verification.json)，旧结果另存[重启前证据](artifacts/t28/before-reload.json)。

| 验收项 | 重启后实测 | 判定 |
| --- | --- | --- |
| map-snapshot监测点 | 6，原六编码不变 | 通过 |
| overview监测点数与pointCodes | 6，编码与地图一致 | 通过 |
| distribution EMPTY桶与点位编码 | EMPTY=6，六编码齐全 | 通过 |
| distribution分页总数 | 13 = 6监测点 + 7未关联设备 | 通过 |
| 全量对象排除对账 | 候选13 = 纳入13 + 排除0；excluded四字段均0 | 通过 |
| 状态分布对账 | 全部桶之和13 = pagination.total | 通过 |
| 坐标与统计独立 | 六点renderable=false仍纳入统计，未伪造坐标校验 | 通过 |
| 新鲜度 | CURRENT/READY，无坐标导致的NO_RESOLVED_DEVICES误报 | 通过 |
| EMPTY/UNASSIGNED筛选 | 保留原六点；EMPTY筛选total=6且无独立设备 | 通过 |
| 正式行业筛选 | GAS不纳入未知行业空点，不伪造归属 | 通过 |

[真实验收断言](artifacts/t28/acceptance-checks.json) **12/12通过**，均只读GET，无数据写入。

## 隔离提交说明

验收结束时另一会话开始在共享monitoring分布服务等文件实施八桶状态契约。为不混入其在途修改，已从后端当时已推送的master `894402a` 创建独立分支 `fix/cockpit-empty-monitoring-points` 和临时工作树，只应用本票七文件补丁。即将提交的精确快照已于10:14复跑相同契约回归，八模块BUILD SUCCESS、合计423/423通过。最终提交[ba0ce076](http://192.168.110.30:3000/shaoy/pipe-ner-server/commit/ba0ce076f31086d2c024b2b4cd93a6c05105b9eb)（七文件，242增/62删）已成功推送修复分支；随后确认 `origin/master` 是该分支祖先，执行快进推送 `origin/fix/cockpit-empty-monitoring-points:master`，远端 `master` 与修复分支均指向 ba0ce076。远端 `master` 与修复分支均指向 ba0ce076。随后读取共享后端工作树时，发现并行会话已在本地master产生八桶契约提交 `7fb7c2c`，因此本地master相对origin/master ahead 1、behind 1，并保留若干未提交八桶相关文件。本轮没有重置、覆盖或强行推送这些并行改动；本票的ba0ce076已在远端master，后续集成八桶提交时应以该master为包含本修复的基线。