map.md 4.0 KB

Cockpit 外壳与面板布局(执行索引)

Status: open Labels: wayfinder:map

本目录是 /to-spec + /to-tickets 的产物,不是 wayfinder effort:spec.md 是规格,issues/01–23 是实现票(01、02 已关闭),issues/24–27 是调研、待人工处理项与后续新增票(24 调研已关闭;25 待人工;26 watcher 崩溃已修复;27 接入 Cesium 常驻 Viewer,是票 03 的前置)。 本 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(ready-for-agent)是新增的引擎接入票:装 cesium + 静态资源/CESIUM_BASE_URL + 服务层创建唯一 Viewer;票 03 依赖它(相机契约必须落在真实引擎上)。
  • 相关技能: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 证明「切模式与收放面板都不重建」。

Not yet specified

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

Out of scope

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