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

Status: open Labels: wayfinder:map

本目录是 /to-spec + /to-tickets 的产物，不是 wayfinder effort：spec.md 是规格，issues/01–23 是实现票（01、02、06 已关闭），issues/24–28 是调研、待人工处理项与后续新增票（24 调研已关闭；25 待人工；26 watcher 崩溃已修复；27 接入 Cesium 常驻 Viewer，是票 03 的前置，已关闭；28 外壳填满容器已关闭）。本 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 阶段。
issues/26（resolved）是 dev server watcher 的 EBUSY 崩溃修复：忽略清单须同时覆盖 .scratch 面板原子写与 DSH 编辑审阅临时文件。
issues/27（resolved）是引擎接入票：装 cesium + 静态资源/CESIUM_BASE_URL + 服务层创建唯一 Viewer；票 03 依赖它（相机契约必须落在真实引擎上）。已关闭，验证证据与遗留（本工作区 fes build 因两个未跟踪插件缺依赖而跑不完）见票面。
真实启动路径是 yarn dev（= fes dev → .fes.js：layout.navigation: null，无页头）；真实应用环境不使用 predev 启动（维护者 2026-09-16 明确）。yarn pre.dev / pre.dev.one 是 TvT 预演站布局（navigation: 'top' + isFixedHeader，顶部多 54px 固定页头），那里出现的布局异常（如 A12 红）属环境差异。A12 证据里的 pageHeaderH 用来分辨这一点（见票 28）。
复跑走查前重启 dev server：长跑实例可能仍给浏览器发旧模块（懒加载的 cesiumEngine.js 曾因此把 A15 判红一次：widgetChrome: 1；重启后同一份代码 20/20、widgetChrome: 0）。涉及引擎、懒加载模块的走查尤其要先重启。
相关技能：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 与模式/面板映射 — 已关闭（第二轮）：外壳铺满视口、每模式 4 面板同屏且收放真正改变高度、范围/行业接入 filterStore 且切模式不重置、一张图用临时影像铺满背景；浏览器走查 16/16 + 维护者目测确认。
26: Dev server 文件监视被 .scratch 面板原子写击穿 — 已修复（含重开补验）：.fes.js 的 dev server watch 忽略 **/.scratch/** 与 **/.dsh-*（Vite 默认 ignore 合并不覆盖）；两个触发源——面板原子写与 DSH 编辑审阅临时文件——均实测不再击穿。
02: MapCanvas 常驻挂载 — 已关闭：新增 services/mapService.js 持有实例生命周期（幂等挂载、尺寸上报、离开才销毁）+ 常驻宿主组件 MapCanvas.vue；逻辑单测 + 走查 A14 证明「切模式与收放面板都不重建」。
06: 驾驶舱自有静态资产与视觉占位 — 已关闭：token 唯一来源 styles/tokens.css 挂 .cockpit-shell（不挂 :root，免漏插件样式）、public/cockpit/ 自持资产、占位/图标/状态标签三件套（PanelPlaceholder / icons.js+CockpitIcon / statusTones.js+StatusTag，标签带文字不吃纯色）；零依赖脚本 15/15 + 走查 19/19。副产：查清 A12「铺满」的 predev 环境差异（并立票 28），走查脚本加 pageHeaderH 与前置条件说明。
27: 接入 Cesium 常驻 Viewer — 已关闭：cesium@1.145.0 固定版本（不进 federation shared、进 manualChunks 单独分包）+ src/common/cesiumStaticPlugin.js（dev/pre.dev 中间件与 build 拷贝四个静态目录，pre.dev.one 的 copyPublicDir:false 同样生效）+ services/cesiumAssets.js（CESIUM_BASE_URL 在 import 之前写入，取 publicPath: './' / qiankun 注入路径）+ services/cesiumEngine.js（唯一 Viewer：控件与默认相机输入全关、baseLayer:false 不伪造配准）+ mapService 持有引擎生命周期与宿主状态浮标；yarn dev 走查 20/20（含强制失败的兜底断言）、pre.dev.one 19/20（仅 A12 环境差异红）、yarn pre.build.one 日志证明四目录进产物。遗留：本工作区 fes build 被两个未跟踪插件缺依赖挡住（@takram/three-3d-tiles-support、leaflet），cesium 分包暂无产物证据。
28: 外壳填满所在容器，而不是硬用 100vh — 已关闭：.cockpit-shell 由 height: 100vh 改为 absolute + inset: 0，贴着最近的定位容器（没有定位祖先时按规范落回初始包含块＝视口）；氛围层同步由 fixed 改 absolute，不再盖到宿主页头那一带。零依赖脚本 7/7（旧实现复现「越界 54px + 宿主滚动条」，交付实现容器等高、底边贴合、真·视口 resize 跟随），走查 A12 仍绿。附带确立：真实启动路径是 yarn dev，predev 预演站不是真实应用环境。

Not yet specified

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

Out of scope

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

map.md 6.9 KB تاريخچه خام