55 lines
3.3 KiB
Markdown
55 lines
3.3 KiB
Markdown
# 需求分析-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 轴拉伸只在没有已保存逆向分割结果的新进入工作区中执行一次。
|