map.md 5.0 KB

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

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

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 — 用 npm cesium + 四目录静态拷贝 + 相对 CESIUM_BASE_URL(./ / qiankun),地图服务建常驻 Viewer;simpleGIS/geokit 只参考不依赖。
  • Mode and panel-expand state ownership — mode 与 expandedPanelIds 都进 uiStore;切一级模式重置展开、不重置行业筛选。
  • Three-panel versus four-cell layout including environment monitoring — 四个模式均为 4 面板;总体概览加态势总览,运行监测加监测点台账;不设环境监测二级面板。
  • English mode and panelId dictionary with column assignment — mode 用 camelCase 四值,16 个 panelId 扁平全局唯一,左右栏各两块,中文走独立 panelLabels 映射。
  • Spring-arm orbit pivot — 中心取选中对象地表点,未选中回退地面拾取点;选中时平滑换中心并保持 heading/range,取消选中不回退。
  • Ground and pipeline view composition with camera contract — 地面/管线是全局视图条件,同时改相机预设与图层可见性(管线视图把地表压半透明);中心不重置、三键不变、状态归 filterStore。
  • Cockpit API auth without a login page — 原始决策要求部署注入凭据;后续修订为驾驶舱只读 REST /api/cockpit/v1/** 与 WS /ws/deviceStatus 不鉴权,后端其他路径和未来写接口不变,后端实现与目标环境证据由真实数据接线地图承接。
  • Cockpit page file shape — 入口为 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 外壳与面板布局(执行索引) 承载 T01–T25 的执行状态;后端补契约与 3 个业务定义问题归实现票 25(ready-for-human),不属本图职责。

Not yet specified

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

Out of scope

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