# 48: 点位设备联动整体验收与质量收口



## 进度

进行中：全量41组初筛33通过/8失败；公共真实信封修复5项通过并获真实页面复验。双轴审查有未解决生命周期/模式/聚合特效缺口，部署自检已补，保持open。证据在verify/artifacts/t48/acceptance-status.md。

Type: integration
Status: claimed
Blocked by: 40, 41, 42, 43, 44, 45, 46, 47
Labels: ready-for-agent

## What to build

对 41–47 的完整交付做一次外部行为收口，不新增业务语义。覆盖地图入口与台账入口、点位定位、面板锚定、关联设备图层、设备双向联动、资产/地形降级、重叠聚合、一级模式矩阵和设备状态特效的端到端组合；把偏差、已知代价和遗留分别记录到对应执行票与部署文档。

## Acceptance

- [ ] 真实地图/台账入口可完成：选点 → 定位与设备并行加载 → 面板锚定 → 设备 hover/选中/返回 → 关闭/换点收场。
- [ ] 同一 `snapshotAt` 翻页、刷新、快照失效和迟到响应不会造成旧设备层复活或摘要计数污染。
- [ ] 四个一级模式与引导态的图层矩阵、选择暂停/恢复、图例/计数和事件回联符合 46。
- [ ] 坐标无效、后端清单-only、地形未就绪、资产失败、状态未知、性能降级均显示明确原因，不伪造空间位置或成功状态。
- [ ] 重叠 K/N 计数、降级阈值、设备状态特效和资产模式在同屏组合下不互相覆盖语义。
- [ ] 逻辑闸门、变异测试、真实走查、截图/帧差和性能读数全部留存；未完成项进入对应票面，不以原型通过冒充生产完成。
- [x] `docs/cockpit-deployment.md` 增加可操作的“关联设备点位已展开 / 设备状态特效已生效”自检步骤、可观察字段与失败降级说明。
- [ ] `map.md`/执行票状态、部署自检文档和实现分支证据同步；明确后端真实 Redis/Kingbase 联调结果。

## 本阶段实际交付

- 公共真实AjaxResult信封修复：成功拆data、HTTP200业务错误不冒充成功、快照失效保留恢复原因；5项新回归通过，真实页从快照失效恢复完整读取13对象（均未校验不上图）。
- 6项联动不变量回归通过：固定无位置点详情、同编码位置/状态刷新引擎、不可定位选择与关闭的异步定位取消、隐藏父点的设备门控、快速改选继承未兑现设备档。相关设备层/模式/相机/联动旧闸门通过。
- 部署手册5.1已补设备展开、动效自检、可观察字段、退化与性能口径。双轴审查及截图指针见[验收证据](../verify/artifacts/t48/acceptance-status.md)。
- 浏览器验证获本轮授权，只操作现有页面；未启动/重启server，未build。browser debug/performance与会话停止因工具参数互斥未成功，不能报告已取得capture、帧差、性能或已完成清理。

## 未完成与下一步

1. [关联监测设备临时图层](42-associated-device-layer.md)已因刷新/失效撤层、重找点位、重载详情链缺口重开needs-triage；先建立完整生命周期失败回归，再摘triage实施。
2. [设备状态视觉特效与门控](47-device-status-effects.md)已因折叠聚合动效隐藏重开needs-triage；先建立折叠/选NORMAL中心的组合帧回归，再摘triage实施。
3. 同步已修项到对应票面并复验。41无位置详情修复源码回归通过，真实台账无样本，不按本阶段再关闭任何其它票。
4. 有效关联设备真实样本尚缺；13对象均未校验，监测台账无记录。与[真实接口联调与阶段收口](../../cockpit-real-data-wayfinding/issues/18-frontend-real-integration-gate.md)协调有效样本和运行实例Redis/Kingbase提交/日志证据，不能以mock替代真实联调。
5. 全量41组初筛8失败已分类但未全部解决；真实场景帧差、性能和端到端交互尚未完成。修复完成且证据齐备前，保持本票claimed/open；不追加完成gist到父地图。

## Out of scope

- 新增未在 41–47 锁定的业务语义、设施点完整契约、管线数据源、美术资产生产和移动端适配。

## Comments

### local — 2026-10-10T07:06:25.581Z
本轮质量收口发现并修复：真实AjaxResult信封未拆解，首屏snapshotAt丢失，第二页400；HTTP200业务错误误判成功。公共请求出口新增5项回归通过，真实页面刷新后完整读取13对象、均未校验不上图。其它审查缺口和真实有效坐标样本/性能证据仍未完成，不关闭本票。