City-Lifeline-Cockpit/.scratch/cockpit-real-data-wayfinding/verify/artifacts/t18/real-integration-gate-report.md

票 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 验证未运行。