REVOXELSEG_DICOM/工程分析/需求分析-2026-05-19-23-47-31.md

需求分析-2026-05-19-23-47-31

开始时间

2026-05-19-23-47-31

原始需求摘要

用户要求对逆向工作区右侧视图做产品润色：将“Mask 展示”重命名为“逆向分割映射视图”或“体素化映射视图”；明确该区域以二维 DICOM 切片为底图，叠加由三维 STL 模型逆向推导生成的二维分割掩码 Label Map；覆盖层颜色、透明度、显示隐藏状态必须与中间“可视化工具栏”的“构件层级”实时联动；右侧视图还需要独立 Slice Navigator，支持逐层浏览当前 Z 轴 DICOM 切片及对应分割结果。

业务目标

• 将右侧结果区从“STL 实体切面”语义升级为“DICOM + STL 逆向体素化映射”的二维校验视图。
• 让医生或标注人员能在同一个二维视图中核对原始 CT 灰度影像和由 STL 构件层级推导出的 Label Map。
• 保证构件层级面板中的颜色、透明度和显隐状态立即反映在右侧叠加层中。
• 让右侧视图拥有独立于左侧 DICOM 范围控件的逐层切片浏览能力。

输入与输出

• 输入：
  • 默认项目的 DICOM 切片预览接口 /api/projects/:projectId/dicom-preview
  • STL preview 接口 /api/projects/:projectId/models/:fileName/preview
  • 项目级 moduleStyles
  • 用户选择的独立映射切片序号
• 输出：
  • 右侧“逆向分割映射视图”
  • DICOM Base Layer
  • STL 逆向投影 Overlay Label Map
  • 与构件层级联动的颜色、透明度、显示隐藏状态
  • 独立 Slice Navigator

影响范围

• 主要影响 WebSite/src/components/ReverseWorkspace.tsx。
• 可能需要补充 WebSite/src/index.css 的滑条样式。
• 不改变后端 API、不改变项目状态结构、不改变导出格式。
• 文档会新增本次需求、实现、测试方案，并更新经验记录。

关键约束

• 历史经验要求不要伪造无来源 Mask。本次覆盖层必须从 STL preview 几何数据推导，且每个覆盖区域对应具体 STL 构件与 partId。
• DICOM 原始影像必须作为底层常驻显示。
• Overlay 可视属性必须直接读取 moduleStyles，避免右侧另建一套独立状态。
• Slice Navigator 必须独立于左侧 DICOM 切片范围，不应破坏左侧三维融合和模型切分流程。
• 当前工作区已有历史工程分析文档删除状态，本次提交不能混入这些删除。

风险点

• 当前后端尚未提供医学级真实体素化 Label Map，本次前端只能基于 STL preview 三角面做浏览器侧逆向投影映射，精度取决于 STL 预览采样与配准状态。
• 高频拖动 Slice Navigator 会触发 DICOM 预览请求，需要防止旧请求覆盖新结果。
• Canvas 图层尺寸必须保持一致，否则 DICOM 和 Overlay 会错位。
• 构件数量和 STL 采样量较大时，Overlay 绘制可能有性能压力。

默认假设

• 本次按已有确认执行，不在方案阶段等待二次确认。
• 右侧视图标题采用“逆向分割映射视图”，在界面中辅以 Label Map、Slice Navigator 等短标签。