# 前端真实接口联调：当前预检与验收启动条件

## 当前结论（2026-10-13）

**尚未达到完整真人验收就绪条件。** 已完成用户明确要求的当前版本核对、真实只读接口预检、WS订阅预检及浏览器进入系统检查；没有代执行任何外部业务操作。地图渲染停止、监测数据时间契约缺失及交付基线未锁定，均需先处理，不能用真人签字替代。

所属工单：[前端真实接口联调与阶段收口](../issues/18-frontend-real-integration-gate.md)；后续真人步骤与结果模板：[真人接手清单](t18-human-takeover.md)；此前仅历史资料核对：[证据就绪性报告](t18-evidence-readiness.md)。三份文档的证据范围不同，本报告记录实际新预检。

## 实测与限制

| 项目 | 本轮结果 | 证据 / 限制 |
| --- | --- | --- |
| 实际前端入口 | `http://127.0.0.1:8000/#/cockpit`，现有Vite dev服务；进入系统后配置显示real | 当前路由为hash；不含hash的 `/cockpit` 首次返回首页。未启动替代服务 |
| 真实后端 | `http://192.168.110.96:8301/api/cockpit/v1`，18个端点均 HTTP200、业务code200、readOnly=true | [新预检响应与版本记录](../verify/artifacts/t18/takeover-2026-10-13T08-44-40-563Z/preflight.json)；检查只证明读取可达，不等于面板、地图与边界全部通过 |
| 监测数据时间 | 三个监测端点均缺自有createdAt属性，21项检查中18过/3失败 | 已交[监测三端点createdAt契约修复](../issues/35-createdat.md)；缺字段不是显式null，不用响应时间冒充 |
| 真实正向工单样本 | 设备21119740、工单WO202610121103507623；stateCode=0/待派单，关联当前ALARM为true，事件e68a942d92c48ac709fca8cee3160f3b | 新预检candidate及两端原始响应；未派单、未接单、未处理、未结案，未作业务通过结论 |
| WS订阅 | 16:36:38–16:37:08(+08:00)收到cockpitSubscribed，scope=all，errors=[] | [30秒预检窗口](../verify/artifacts/t18/ws-takeover-preflight-20261013-163637.json)；deltaFrames=0，无真人动作，不判断增量通过或故障。窗口已结束，目前没有长时间捕获运行 |
| 浏览器real呈现 | 总体概览可见设施5283、设备9、在线3/9、当前预警29、当前报警66；状态栏可见EMPTY6/UNASSOCIATED9 | 仅当前界面读数；不是固定长期期望。无四模式全部面板新通过结论 |
| 地图 | 黑屏并报Fragment shader failed to compile / varying Illegal use of reserved word / Rendering has stopped | [现场截图](../verify/artifacts/t18/takeover-browser-20261013/rendering-stopped.jpg)，交[调色shader兼容修复](../issues/36-untitled.md)；地图、定位、稳定性均不能据本次算通过 |

首次预检中三个事件聚合端点遗漏必需的eventFamily，故返回400；已按真实适配器补参并重跑。首次记录另存，作为探针自身错误历史；它不是后端新缺陷。本表仅使用修正入参后的18请求/21检查结果。

浏览器控制台的Cesium生成shader含 `#version 300 es` 和 `varying vec2 v_textureCoordinates;`，gradeSaturation等uniform与工作树调色stage对应；调用栈经过PostProcessStage.execute。本轮CSS视口1600×1000，会话曾设置ipad-mini仿真，故不把这次观察泛化为所有浏览器/GPU的结论；修复应在实际桌面GPU环境重新验收。浏览器调试capture启动因工具参数校验失败，未取得完整网络调试录制；保留的是实际页面、截图、控制台读取及独立GET/WS证据，不声称已有完整HAR或data-*断言。

## 版本核对

- 前端master HEAD=`5a83ab9b836156a4bb9468d1868e4d8040238571`；实际 `git ls-remote` 的origin/master=`a6fbbea9dc32e83ee61dcb5a6646bf5875399636`。本地显示ahead12；驾驶舱36个已跟踪源码文件有工作树差异，另有未跟踪源码/素材与并行工作。抖动修复相关源码及验证材料仍未形成干净已交付基线。未替并行工作提交、推送或回退。
- 后端master HEAD=`a96091ce081411e8ceedcf73fe38274d0c63fae8`；实际远端master=`3e448568cd7db6c9a710479283553eab16e67817`，缓存origin/master仍为989a707e。本地“ahead1”只相对缓存，不能据此断言实际远端缺修复；本轮未fetch、未推断祖先关系。后端已跟踪工作树只见IDE编码配置差异。
- 前端是含未提交改动的dev实例；后端当前进程产物与纯净提交的绑定尚未建立。本轮API/界面证据属于观察窗口，不等于正式已提交交付版本。

## 验收启动条件与下一步

1. 对应前端执行票恢复地图渲染；对应后端执行票补齐三端点createdAt契约。两项为可代理的技术工作，不交给用户手工修代码。
2. 交付负责人协调并行修改，完成限定提交/推送，代理核对实际运行产物及前后端版本。新版本追加基线卡片，保留旧记录。
3. 代理在相同稳定运行基线重做受影响预检，补齐四模式、筛选/分页、边界/失败态和浏览器断言。旧mock证据不替代真实通过。
4. 上述准备完成后，代理通知用户可开始，并立即开启新的WS捕获窗口；确认订阅回执后才通知业务人员推进工单，避免用户动作落在捕获窗口外。
5. 真人按接手清单做页面业务走查、90秒静置与刷新检查、真实报警—工单各阶段流转及团队验收；代理同步对照程序证据。先用上述样本做状态推进检查可以，但新一轮完整链路若需要从报警生成/工单创建开始，须业务人员选定可真实执行的新样本，不能把旧创建记录冒充当前窗口内动作。

现阶段请保持候选工单待派单，不安排最终验收签字。发现的问题已回执行票并接入上位阻塞关系；上位工单保持claimed/ready-for-human/open，本次不关闭、不升级基线状态，不向地图Decisions so far写完成记录。

本轮只运行用户已要求的GET、WS及浏览器预检，未运行项目build、未启动/重启前后端服务；未修改功能代码或真实业务数据。