REVOXELSEG_DICOM/工程分析/需求分析-2026-05-24-15-55-48.md

需求分析-2026-05-24-15-55-48

开始时间

2026-05-24-15-55-48

原始需求摘要

1. 逆向工作区“构件层级”标题右侧增加全局小眼睛按钮，可一键显示或隐藏所有构件。
2. 项目列表中增加项目锁定能力：在“进入逆向工作区”左侧增加“锁定按钮”；锁定时将位姿数据保存到 项目数据/锁定结果/；进入逆向工作区时若项目已锁定则提示需要解锁；项目列表左侧支持筛选未上锁项目；项目按最后处理时间排序。
3. 修正 DICOM 切片位置滚动条：滚动后轨道不要出现进度色；显示顺序保持正确，但 1 应位于滚动条最上方，通过下拉从 1 到 N 查看切片。

业务目标

• 让批量构件显示控制更高效，便于快速观察 DICOM 与 STL 的融合效果。
• 为项目处理状态增加可控的“锁定”机制，避免已确认位姿的项目被误进入/误编辑。
• 将锁定时的关键位姿数据落盘，便于后续追溯和复核。
• 让切片滚动控件语义与用户认知一致：顶部为第 1 张，向下逐步增加。

输入与输出

• 输入：项目列表操作、构件可见性操作、DICOM 切片滚动条操作。
• 输出：项目锁定状态、锁定结果 JSON 文件、构件显示状态更新、正确方向的切片预览与无进度色滚动条。

影响范围

• 前端：项目库、逆向工作区、DICOM 切片控件、构件层级工具栏。
• 后端：项目状态结构、锁定/解锁接口、锁定结果落盘、项目排序字段维护。
• 文档：Docker部署/ 部署说明与工程分析经验记录。

关键约束

• 必须沿用现有 WebSite/server.ts 的项目状态持久化方式。
• 新增字段需要兼容既有 state.json，避免旧项目读取失败。
• 锁定结果必须写入仓库根目录下的 项目数据/锁定结果/。
• 不提交大型医学影像数据、运行态导出文件或无关工作区变化。

风险点

• 锁定后禁止进入工作区需要和项目卡片按钮状态、错误提示保持一致。
• 位姿数据来源可能同时存在于项目级 modelPose 和后端当前状态，需要归一化保存。
• DICOM 视图已经做过切片编号反转，滚动方向调整时不能再次破坏显示编号。
• 一键隐藏所有构件会影响跨页面共享样式，需要调用既有构件样式 API。

默认假设

• “锁定按钮”需要支持再次点击解锁，解锁后允许进入逆向工作区。
• “最后处理时间”使用项目最近更新时间、最后导出时间或最后锁定时间中的最新值排序。
• 切片滚动条无需保留蓝色进度轨道，只保留中性轨道与滑块。