City-Lifeline-Cockpit/.scratch/cockpit-shell-panel-layout/map.md

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 — 二级面板改为同屏左右两栏加标题栏展开/收起，替代 mode/subview 切换。
• 决策地图 — mode/panelId 英文词典、三键相机契约、地面与管线视图合成、Cesium 集成方式、无登录页鉴权。
• ADR 0003 — 页面信息架构与 mode/panelId 词典。
• 01: Shell 与模式/面板映射 — 已关闭：外壳铺满视口（不锁 16:9）、四模式切换、每模式 4 面板同屏收放、范围/行业接入 filterStore 且切模式不重置；浏览器走查 15/15。
• 26: Dev server 文件监视被 .scratch 面板原子写击穿 — 已修复：.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。