REVOXELSEG_DICOM/工程分析/需求分析-2026-05-20-22-35-42.md

需求分析-2026-05-20-22-35-42

开始时间

2026-05-20-22-35-42

原始需求摘要

1. 将映射视图下方文案 Overlay Label Map · Overlay Label Map 已就绪 精简为 Overlay Label Map。
2. 系统管理工作区修改账号为同名账号时，需要给出清晰反馈，避免只暴露浏览器 409 报错。
3. “导出项目及结果”中，导出分割影像时新增“构件分别导出 / 构件整体导出”选项，用于处理构件重叠场景。
4. 导出面板初始默认不选择 DICOM 原始影像 和 STL 原始模型，且二者位于选项最上方，分割影像放到最下方。
5. 新建项目没有 DICOM 影像时显示“请导入DICOM影像”，同时修复 DICOM 与 3D 模型导入按钮无响应问题。
6. “头部CT 模型逆向体素化演示”作为默认测试数据，用户导入新影像或模型不得覆盖原始数据；恢复演示环境后仍回到初始 DICOM 与 STL。
7. 逆向工作区初始状态默认对模型做一次 Z 轴拉伸。

业务目标

• 让项目导入、导出和逆向工作区初始对齐流程更符合实际使用习惯。
• 对重叠构件分割导出提供整体标签图和按构件独立导出两种策略。
• 保护默认演示数据资产，支持用户项目独立导入。
• 用明确的界面反馈替代后台管理接口冲突时的裸错误。

输入与输出

• 输入：用户在项目库中导入 DICOM/STL 文件、在导出面板选择导出目标与分割导出方式、在系统管理中编辑账号。
• 输出：项目级独立资产目录、导出 tar.gz 包、分割整体或分构件 NII.GZ、清晰错误提示、更新后的逆向工作区初始位姿。

影响范围

• WebSite/server.ts：导入资产接口、项目资产路径解析、导出包分割策略、用户冲突响应。
• WebSite/src/lib/api.ts：导出参数与导入接口封装。
• WebSite/src/components/ProjectLibrary.tsx：导入按钮、空项目提示、导出选项顺序和分割导出方式。
• WebSite/src/components/ReverseWorkspace.tsx：Overlay 文案、导出选项、默认 Z 拉伸。
• WebSite/src/components/UserManagement.tsx：409 冲突友好提示。

关键约束

• 必须保留默认 Head_CT_DICOM/ 与 Head_CT_ReConstruct/ 原始数据，不允许导入时覆盖。
• 导出面板的项目库与逆向工作区入口保持一致。
• 默认 Z 拉伸不能覆盖项目库已有保存结果的位姿。
• 只提交本次相关文件，不混入历史删除文档和软著材料。

风险点

• DICOM 文件可能较大，前端转 base64 上传会增加内存与请求体体积，需要设置后端请求体限制并控制失败反馈。
• 分构件导出会增加生成时间与压缩包体积，需要沿用当前可见/全部构件过滤逻辑。
• 修改模型路径解析后，所有 STL 预览、导出、分割生成都要使用项目级路径，避免只在部分接口生效。

默认假设

• 本次“导入按钮”先支持浏览器本地文件选择上传，DICOM 支持多文件，STL 支持多文件。
• “构件整体导出”为现有单个 label map；“构件分别导出”为每个构件生成一个独立 label map，并附带统一标签 JSON。
• 默认 Z 轴拉伸只在没有已保存逆向分割结果的新进入工作区中执行一次。