City-Lifeline-Cockpit/.scratch/cockpit-real-data-wayfinding/handoff/t18-current-preflight.md

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

当前结论（2026-10-13）

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

所属工单：前端真实接口联调与阶段收口；后续真人步骤与结果模板：真人接手清单；此前仅历史资料核对：证据就绪性报告。三份文档的证据范围不同，本报告记录实际新预检。

实测与限制

项目	本轮结果	证据 / 限制
实际前端入口	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	新预检响应与版本记录；检查只证明读取可达，不等于面板、地图与边界全部通过
监测数据时间	三个监测端点均缺自有createdAt属性，21项检查中18过/3失败	已交监测三端点createdAt契约修复；缺字段不是显式null，不用响应时间冒充
真实正向工单样本	设备21119740、工单WO202610121103507623；stateCode=0/待派单，关联当前ALARM为true，事件e68a942d92	新预检candidate及两端原始响应；未派单、未接单、未处理、未结案，未作业务通过结论
WS订阅	16:36:38–16:37:08(+08:00)收到cockpitSubscribed，scope=all，errors=[]	30秒预检窗口；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	现场截图，交调色shader兼容修复；地图、定位、稳定性均不能据本次算通过

首次预检中三个事件聚合端点遗漏必需的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、未启动/重启前后端服务；未修改功能代码或真实业务数据。