# 票 18 真实接口联调验收矩阵

记录环境：`http://192.168.110.96:8301`，只读 GET；前端 real 配置通过本机忽略文件启用，未改入库部署配置。

代码基线：前端 `master/b8917ed`（已推送）；后端运行来源尚需部署负责人确认，仓库远端 `master=a151183`，本地源码 HEAD `d8a6b03`，运行实例与源码提交未完成可验证绑定。

## 结论

当前不能宣称阶段收口，也不能关闭票 18。修正后的真实探针共 123 次请求，92 项通过、33 项失败。失败既包含后端契约/数据问题，也包含前端消费验证缺口。

## 已验证

| 区域 | 真实证据 | 结果 |
| --- | --- | --- |
| foundation / 只读 | `readOnly=true`，接口 200 | 通过 |
| 地图快照 | 6 个真实监测点、7 个真实未关联设备；坐标均 `UNVERIFIED` 且 `renderable=false` | 通过读取；不可宣称可上图 |
| 地图分页 | 首屏签发 `snapshotAt`；直接请求第 2 页不带 token 返回 `SNAPSHOT_EXPIRED` | 后端规则通过；浏览器实际分页曾漏带 token，失败 |
| 设施基础档案 | 真实返回 1006：水厂、泵站、管网及排水设施 | 接口可达；前端适配器显示为空，消费失败 |
| 管网统计 | 真实 `network_type` 分组 `0=537、1=3735、2=996` | 发现 0/1 映射漏计问题 |
| 设备档案/工单 | 7 台真实设备档案、工单列表和 7 张工单时间线可达 | 通过读取 |
| 指标 | current/history 接口可达，但 7 台样本均 `EMPTY` | 只有空态证据，无非空指标验收 |
| WebSocket | 浏览器显示“状态推送已连接”；独立 WS 观察因会话清理未形成可复查落盘证据 | 待重新取证 |

## 已确认阻断

1. 地图快照响应未提供 `pointStatusDistribution`，`pointStatus` 查询被忽略；`UNKNOWN`/`UNASSOCIATED` 在 monitoring distribution 返回 400，和前端八桶契约不一致。
2. 浏览器真实联调中地图第 2 页请求曾不带首屏 `snapshotAt`，后端正确返回 400 `SNAPSHOT_EXPIRED`；页面进入失效/无数据态。
3. 前端 real 适配器未正确消费真实响应信封中的 `data`，真实 `/map-snapshot` 与 `/infrastructure/base-archives` 被转换为空；业务 code=500 的事件响应曾被适配为 success，存在严重误判风险。
4. 当前预警设置、应急保障、运行概况、跨设备事件族真实请求返回业务 `code=500`，错误显示为 `early_warning.warning_name` 数据库字段不存在。
5. 设备事件 current/history 真实请求返回业务 500；有效时间区间的指标读取已改为返回 EMPTY，须区分“真实无数据”和“接口错误”。
6. `CockpitShell.vue` 的 `modeLayerPlan` 永久传 `facilities:null` 与 `pipelines:null`；管线与设施真实几何没有进入地图计划，页面显示“设施/管线数据未就绪”。
7. 后端设施类型命名空间错误：设施 `network_type` 被设备 `equipment_type` 字典解释，导致真实排水/供水类型名称和行业错配；基础档案、管理信息、概览适配器对数字 0/1 映射缺失，已确认漏计 4272 条管网记录。
8. 后端所有监测点/设备坐标校核为 `UNVERIFIED_COORDINATE`，这符合当前“不臆造坐标”的契约，但没有可信校核来源时不能完成可视化验收。
9. 真实点位 6 条全部 `EMPTY` 且无关联设备；7 台设备未关联有效监测点。该事实已验证，但不能据此推断数据库关系从未存在。

## 真人闭环待执行

业务人员必须在外部业务系统执行：真实设备报警触发、关联生成工单、推进一次获准状态流转。驾驶舱只读核对报警、工单、设备/监测点关系、时间线、状态增量和新鲜度；不得直接改库、不得用 mock 替代。当前尚未形成真人操作时间、事件标识、WS 增量帧和最终业务签字证据，因此不得关闭票。

## 下一步

1. 前端执行票修复真实信封消费、地图快照分页 token、状态筛选和业务错误映射；后端修复预警字段/事件族、设施类型映射与 0/1 管网映射；管线/设施几何接线需明确独立执行范围。
2. 重新部署并锁定运行实例提交哈希，重跑矩阵，特别是非空指标、事件、四模式面板和真实设施/管线图层。
3. 由真人执行报警—工单闭环；记录 `deviceCode`、事件/工单编码、操作时间、WS 帧、驾驶舱可见结果。
4. 所有阻断清零且人工验收完成后，才可将四态推进到“真实数据联调完成/模式整体收口”，再关闭票 18。

## 范围声明

本记录只包含真实只读联调和人工接手计划；没有部署、数据库写入、工单写操作或 mock 证据冒充。项目规则要求的 build/debug 验证未运行。