# Cockpit 外壳与面板布局（执行索引）

Status: open
Labels: wayfinder:map

本目录是 `/to-spec` + `/to-tickets` 的产物，不是 wayfinder effort：`spec.md` 是规格，`issues/01`–`23` 是实现票（01 已实施，待人工审查），`issues/24`–`26` 是调研、待人工处理项与工程缺陷票（26：dev server watcher 崩溃，ready-for-agent）。
本 `map.md` 的唯一作用是把这个 effort 暴露给 issue tracker 面板——面板只枚举含 `map.md` 的 `.scratch/<effort>/`，没有 `map.md` 的目录连同它的票都不会被列出。
`Labels: wayfinder:map` 在这里只用于让面板按**地图视图**渲染本 effort 的子票状态、进度与依赖分层；不代表本 effort 由 `/wayfinder` 驱动——推进仍走 `/implement`。

## Destination

按 `spec.md`、`CONTEXT.md` 与 `docs/adr/0001`–`0008` 实现 `/cockpit` 外壳：单路由、四个一级模式、每个模式左右两栏共 4 个二级面板、中央地图常驻。语义已由 `.scratch/web-cockpit-decision-map/` 锁死，本 effort 不再发明 `mode`、`panelId`、相机或鉴权的含义。

## Notes

- 执行清单是 `issues/01`–`23`，按各票 `Blocked by` 的依赖顺序推进，一票一个全新上下文。
- `issues/24`（resolved）是 AFK 调研，产物在 `research/panel-field-coverage.md`，不改业务代码。
- `issues/25`（ready-for-human）是后端补契约与业务定义缺口，需要人或后端负责人处理；不阻塞 `01`–`23` 的 mock 阶段。
- 相关技能：`implement`、`tdd`、`code-review`；TvT.js 侧基线是 `skills/tvt-js-plugin-builder/`。
- 验收清单就在每张票正文里，完成时勾上并同步该票的 `Status:` 行。

## Decisions so far

- [spec.md](spec.md) — 二级面板改为同屏左右两栏加标题栏展开/收起，替代 `mode/subview` 切换。
- [决策地图](../web-cockpit-decision-map/map.md) — `mode`/`panelId` 英文词典、三键相机契约、地面与管线视图合成、Cesium 集成方式、无登录页鉴权。
- [ADR 0003](../../docs/adr/0003-web-page-information-architecture.md) — 页面信息架构与 `mode`/`panelId` 词典。
- [01: Shell 与模式/面板映射](issues/01-shell-mode-panel-mapping.md) — 已关闭：外壳铺满视口（不锁 16:9）、四模式切换、每模式 4 面板同屏收放、范围/行业接入 filterStore 且切模式不重置；浏览器走查 15/15。
- [26: Dev server 文件监视被 `.scratch` 面板原子写击穿](issues/26-devserver-watch-scratch-crash.md) — 已修复：`.fes.js` 的 dev server watch 排除 `**/.scratch/**`（Vite 默认 ignore 合并不覆盖），3 轮原子写模拟 + src 热更均实测通过。

## Not yet specified

- 甲方本地瓦片、地形与 3D Tiles 的实际交付物清单。
- 设计公司视觉终稿如何替换驾驶舱占位 token。
- 后端补契约的落地时间与责任人（见 `issues/25`）。

## Out of scope

- 登录、权限管理、工单处置等写操作。
- UE5、Pixel Streaming、Docker、国产化认证。
- CAD 转换、坐标精化、高精度模型生产。
- 重写 `issues/01`–`23`。