50-untitled.md 7.6 KB

局部管道示意模型细节与中心定位环移除

What to build

按已确认局部邻域管网规格,选中管段进入增强窗后呈现中空管壁、端部法兰及螺栓、分节接缝;删除独立中心定位环,继续使用主图行业配色。邻近管段后续使用简化细节。不是工程竣工模型,不添加参考图中无依据的支墩。

Acceptance criteria

  • 中空管壁、端部法兰/螺栓与接缝几何已实现,端部管腔开放;现场美术效果待验。
  • 没有独立定位环;法兰位于整条路径两端,不在共享折点叠加。
  • 主图行业色、源路径、示意免责声明和三键操作保留。
  • 换选/关闭释放全部几何材质,不残留旧模型,逐资源监听回归通过。
  • 公开场景渲染/领域计划回归先红后绿;离线与现场证据分开。
  • 维护者确认实际画面观感;本轮按项目规则跳过build/debug及浏览器。

Context

已确认采用中空壁+法兰螺栓+分节接缝,删除中心环。完整方案见局部邻域管网与窨井规格。51邻域管网、52设备、53窨井另票推进;不把新需求或23的现场验收记成本票已经完成。

验证与审查

T50模型回归9/9(轴向通腔、壁命中、法兰/螺栓、接缝、去环、短段居中、纵向与折线、几何材质逐个释放);颜色与交互19/19;旧增强9/9;点击关闭连通性、SFC5/5、布局通过。规范审查无硬违规;规格审查发现内部折点双法兰和释放测试不足,新增用例先红后绿并修订;fitScale命名更正。未现场视觉验收。

为什么需要人工接手

归类:需人工测试(维护者本人视觉验收)。

  • 本票代码与离线回归已完成;相关改动在提交 e5f65ad(管道细节/去环)与后续 713cb2b、c88296e 中,t50-pipe-detail.mjs 9/9 通过。
  • 唯一未完成项是验收第 6 条「维护者确认实际画面观感」:需要维护者本人在正式入口 http://127.0.0.1:8000/#/cockpit 打开地下管线详情视图目视判断。
  • AI 不代劳的原因:AGENTS.md 明确禁止自动运行 build/dev/preview 及浏览器调试截图。离线几何断言(中空腔、法兰数量、资源释放)能证明构造正确,但不能证明「看起来像不像管道、法兰螺栓比例是否自然」这一视觉判断。
  • 本票不阻塞 51、52、53 的代码推进(各票离线验证已完成)。

给维护者的实施清单

  1. 准备:由维护者本人启动前端 yarn dev(遵循 AGENTS.md,AI 不代为启动),浏览器打开 http://127.0.0.1:8000/#/cockpit。
  2. 进入入口:在中央一张图上拾取任一管道,进入「地下管线详情视图」。
  3. 逐项目检:
    • 主选管段是否为中空管壁(能看见管腔开口,不是实心圆柱);
    • 两端是否有法兰 + 一圈螺栓,且折线中间拐点不堆叠法兰;
    • 是否有分节接缝;
    • 场景中心没有独立定位环/圆环;
    • 管体是否保持行业色(燃气红 / 供水蓝 / 污水绿 / 雨水青);
    • 邻近管道是否只保留简化粗模、在范围边界裁切。
  4. 检查点(任一不满足即需回填反馈):法兰/螺栓与管径的比例、螺栓是否浮在管外、接缝是否过密或看不见、中空腔在小管径下是否仍可辨、8 倍显示下细节是否被拉扁。
  5. 边界与回归:换选另一条管道、切换 25/50/100 米范围、关闭窗口再打开——确认旧模型释放、无残留、三键(左拖/右旋/滚轮)正常。
  6. 不在本票范围:邻域裁切(51)、设备模型与内部详情(52)、窨井剖切(53)、真实管径换算(54)、场景设备图标(58);参考图中无依据的支墩属明确不做项。

比例参照(DN400 源径 ×8 显示)

项目 数值
显示半径 R 1.600 m
内腔半径 1.408 m
管壁厚 0.192 m(R 的 12%)
法兰外径 2.208 m(R×1.38)
法兰厚度 ≤0.480 m(短管 0.983 m 时 0.147 m)
螺栓中心半径 1.872 m(落在法兰面 1.408–2.208 m 内,不悬空)
螺栓半径 / 数量 0.160 m / 每端 8 颗
分节接缝 每 1.2 m 一节,最多 8 节

目检时可用这些数值判断比例是否合理,而不是凭印象。

可复跑的离线证据

  • 模型回归:node .scratch/cockpit-shell-panel-layout/verify/t50-pipe-detail.mjs(9 项:轴向通腔、壁命中、法兰/螺栓、接缝/去环、行业色与源不变、逐资源释放、短管不拉伸、纵向腔体、折线仅两端法兰、重复销毁)。
  • 相关批次:node .scratch/cockpit-shell-panel-layout/verify/t50-53-local-enhancement.mjs。

进度

  • 2026-10-16 代码与离线回归完成,转 ready-for-human。
  • 2026-10-20 按 /wayfinder 接手:复核归类为「需人工测试」,认领人 codex;实现与离线证据仍有效。
  • 2026-10-20 复核:t50-pipe-detail.mjs 复跑 9/9;确认管段视图无独立圆环,仓内唯一 TorusGeometry 是弯头构件外形(threePipeEnhancement.js:139),不属于本票删除对象;已补入比例参照表。
  • 两处记录:本票正文曾被 deck_issue_patch 传入空 body 误擦两次,均已按原文恢复;后续对该票只用 deck_issue_report 上报,不再传 body。

Status: ready-for-human Assignee: codex Type: task Blocked by: Labels: ready-for-human, wayfinder:task

Comments

local — 2026-10-16T07:57:00.375Z

票50代码与离线回归已实现:中空管壁、端部法兰螺栓、分节接缝、删除独立中心环、短管段自适应居中。独立规范审查无硬违规;规格审查提出内部折点双法兰和材质释放测试缺口,均补测修订。T50 9/9,颜色输入19/19、旧T23 9/9、点击关闭、SFC5/5、布局回归通过。按AGENTS跳过build/dev/browser,尚无现场视觉验收,保持打开。

local — 2026-10-20T15:56:50.992Z

按 /wayfinder 接手处理(用户指定)。读全票面:实现与离线回归已完成,唯一未完成项为「维护者确认实际画面观感」。复核归类:需人工测试(AI 不能代替维护者看画面,且 AGENTS.md 禁止自动 build/dev/浏览器)。正在进行代码与验证命令的现状核实,随后输出实施清单。

local — 2026-10-20

已核实代码现状:services/pipeDetailGeometry.js 仍为中空 Lathe 套筒 + 两端法兰 + 每端 8 螺栓 + 分节接缝,独立定位环不存在;t50-pipe-detail.mjs 9/9 离线通过。正文因空 patch 被误擦,已恢复并补入人工接手分类、实施清单与可复跑命令。

local — 2026-10-20T15:58:56.027Z

复核补充(可直接对照目检):DN400 源径×8 后显示半径 1.6m、内腔半径 1.408m、壁厚 0.192m(R 的12%)、法兰外径 2.208m、螺栓中心半径 1.872m(落在法兰面 1.408–2.208m 内、不悬空)、螺栓半径 0.160m 每端8颗、短管0.983m时法兰厚0.147m。另核实仓内唯一的 TorusGeometry 是【弯头构件】外形(threePipeEnhancement.js:139),不是本票要删的“独立中心定位环”;管段视图内无任何圆环。t50-pipe-detail.mjs 复跑 9/9 通过。

Answer

代码完成、离线 9/9 通过;剩余唯一动作是维护者本人在正式入口目检画面观感,确认后即可关闭本票。