# Web 驾驶舱实现前决策地图

Labels: wayfinder:map
Status: resolved

地图收口：8/8 决策票 resolved，目的地达成（有执行侧实证），正式交给主流程。

## Destination

把实现 23 张 tracer-bullet tickets 前仍会发明语义的决策锁死。地图完成时，agent 可按现有 spec、ADR 和 `.scratch/cockpit-shell-panel-layout/issues/` 开工，不再发明 `mode`、面板、相机或鉴权语义。

## Handoff

地图只产出决策，不实现功能。后续按主流程走：

- 23 张实现票仍是执行清单，位于 [`../cockpit-shell-panel-layout/issues/`](../cockpit-shell-panel-layout/issues/)。
- [01: Shell 与模式/面板映射](../cockpit-shell-panel-layout/issues/01-shell-mode-panel-mapping.md) 已按本图决策实施；14/14 自动走查通过，按维护者要求进入人工审查，审查通过后收口。
- 实施按依赖顺序做，每票一个全新上下文。

## Notes

- Domain: 城市生命线 Web 驾驶舱。词汇以 `CONTEXT.md` 为准。
- 每次会话先读：`CONTEXT.md`、`docs/adr/0001`–`0008`、`.scratch/cockpit-shell-panel-layout/spec.md`。
- 23 张实现票仍是执行清单，不在这张地图里重写。
- 本地图只产出决策，不实现功能。
- 技能：grilling、domain-modeling、research、prototype。
- 决策票的状态词是 wayfinder 自己的 `open`/`claimed`/`resolved`，**不套 triage 的五种标签**。要推进决策票走 `/wayfinder`；`/triage` 只面向实现票与外来问题。
- 已锁定：唯一 `/cockpit` 外壳、四个一级模式、无 `subview`、`expandedPanelIds`、JavaScript 不升为新规范、Cesium 主图 / Three.js 增强、**驾驶舱只读 REST 与 WS 不鉴权（后端其他路径不变）**。

## Decisions so far

<!-- 本地图已关闭的决策票索引；一条决策只活在票里 -->

- [Cesium integration into Fes and Vite](issues/06-cesium-fes-vite-integration.md) — 用 npm `cesium` + 四目录静态拷贝 + 相对 `CESIUM_BASE_URL`（`./` / qiankun），地图服务建常驻 Viewer；simpleGIS/geokit 只参考不依赖。
- [Mode and panel-expand state ownership](issues/01-mode-and-expand-state-ownership.md) — `mode` 与 `expandedPanelIds` 都进 `uiStore`；切一级模式重置展开、不重置行业筛选。
- [Three-panel versus four-cell layout including environment monitoring](issues/03-three-vs-four-cell-layout.md) — 四个模式均为 4 面板；总体概览加态势总览，运行监测加监测点台账；不设环境监测二级面板。
- [English mode and panelId dictionary with column assignment](issues/02-mode-panelid-dictionary-and-columns.md) — `mode` 用 camelCase 四值，16 个 `panelId` 扁平全局唯一，左右栏各两块，中文走独立 `panelLabels` 映射。
- [Spring-arm orbit pivot](issues/04-spring-arm-orbit-pivot.md) — 中心取选中对象地表点，未选中回退地面拾取点；选中时平滑换中心并保持 heading/range，取消选中不回退。
- [Ground and pipeline view composition with camera contract](issues/05-ground-pipeline-camera-composition.md) — 地面/管线是全局视图条件，同时改相机预设与图层可见性（管线视图把地表压半透明）；中心不重置、三键不变、状态归 `filterStore`。
- [Cockpit API auth without a login page](issues/07-cockpit-api-auth-without-login.md) — 原始决策要求部署注入凭据；后续修订为驾驶舱只读 REST `/api/cockpit/v1/**` 与 WS `/ws/deviceStatus` 不鉴权，后端其他路径和未来写接口不变，后端实现与目标环境证据由真实数据接线地图承接。
- [Cockpit page file shape](issues/08-cockpit-page-file-shape.md) — 入口为 `src/pages/cockpit/index.vue`（薄），全部代码收在新建 `src/modules/cockpit`；不用 `layout.vue`，不写 `router.routes`。
- ——收束：目的地判据成立——mode/面板（票 01/02/03）、相机（票 04/05 + ADR 0008）、Cesium 集成（票 06）、鉴权（票 07）、工程结构（票 08）全部锁死；实证：实现票 T01 已按此建成并通过脚本断言、路由生成与 Vite 编译验证，全程未发明任何语义。交接去向：[Cockpit 外壳与面板布局（执行索引）](../cockpit-shell-panel-layout/map.md) 承载 T01–T25 的执行状态；后端补契约与 3 个业务定义问题归实现票 25（ready-for-human），不属本图职责。

## Not yet specified

- 甲方本地瓦片、地形、3D Tiles 的实际交付物清单。
- 设计公司视觉终稿如何替换占位 token。
- Three.js 管线增强的视觉语言和选中精度。

<!-- 已毕业：面板字段覆盖 → 实现票 24（resolved，产物 research/panel-field-coverage.md）；衍生的后端补契约与业务定义问题 → 实现票 25。均随收口移出雾区。 -->

## Out of scope

- 登录、权限管理、工单处置等写操作。
- UE5、Pixel Streaming、Docker、国产化认证。
- CAD 转换、坐标精化、高精度模型生产。
- 设计终稿本身。
- 竖屏、移动端、超宽屏、多屏拼接。
- 首期用 query 记录 `mode` 以便分享。
- 重写 23 张实现票。