REVOXELSEG_DICOM/工程分析/实现方案-2026-05-20-22-35-42.md

实现方案-2026-05-20-22-35-42

实现方案文档路径

工程分析/实现方案-2026-05-20-22-35-42.md

修改目标

• 精简 Overlay Label Map 状态文案。
• 导出项目及结果支持分割整体/分构件导出，并调整默认勾选与排序。
• 为项目库 DICOM/STL 导入按钮接入真实上传流程，空项目展示导入提示。
• 项目级上传资产独立存储，恢复演示环境仍使用默认数据。
• 用户账号重名冲突给出可读反馈。
• 逆向工作区无保存结果时初次加载默认执行 Z 轴等比例拉伸。

涉及路径

• WebSite/server.ts
• WebSite/src/lib/api.ts
• WebSite/src/components/ProjectLibrary.tsx
• WebSite/src/components/ReverseWorkspace.tsx
• WebSite/src/components/UserManagement.tsx
• 工程分析/经验记录.md

技术路线

1. 后端新增项目上传资产目录 WebSite/data/uploads/<projectId>/dicom|stl，导入接口接收 base64 文件并写入项目专属目录。
2. 后端统一项目 DICOM/STL 路径解析，预览、三维融合、模型文件、导出和分割生成均读取项目路径。
3. 导出包接口增加 segmentationExportMode=combined|separate 参数；整体模式沿用现有 label map，分构件模式逐个构件生成独立 NII.GZ。
4. 前端导出面板增加分割导出方式单选，调整默认选择和选项顺序。
5. 项目库导入按钮使用隐藏文件输入，按当前视图选择 DICOM 或 STL 上传，并刷新项目状态。
6. 用户管理编辑接口 409 时展示“账号已存在，请更换账号”等提示。
7. 逆向工作区加载项目后，若没有保存结果，则在 fusion volume 和模型边界都就绪后触发一次 Z 拉伸。

执行步骤

1. 编写本次需求分析、实现方案、测试方案。
2. 阅读并定位导出、导入、项目路径、用户管理和逆向工作区相关源码。
3. 修改后端资产导入与导出逻辑。
4. 修改前端项目库、逆向工作区和用户管理交互。
5. 执行 npm run lint 与 npm run build。
6. 使用 tmux 重启 revoxelseg-dicom 服务并验证 /api/health 与首页。
7. 追加经验记录，提交并推送本次相关文件。

兼容性与回滚方案

• 未导入资产的默认项目继续读取 Head_CT_DICOM/ 与 Head_CT_ReConstruct/。
• 已保存的项目路径由状态文件保存，恢复演示环境可通过现有重置接口回到默认路径。
• 若分构件导出失败，可回退为 segmentationExportMode=combined 的原有整体导出。

预计文件变更

• 前端：3 个组件与 API 封装。
• 后端：1 个 Express 服务文件。
• 工程文档：本次三件套与经验记录。

提交与部署策略

• 仅暂存本次修改的源码与工程分析文档。
• commit message 包含 2026-05-20-22-35-42 与简要描述。
• 提交后推送到既有 Gitea 远端，并重启 4000 端口服务。