51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
# 需求分析-2026-05-20-02-02-37
|
||
|
||
## 开始时间
|
||
|
||
2026-05-20-02-02-37
|
||
|
||
## 原始需求摘要
|
||
|
||
用户要求将“可视化工具栏”中的“模型位姿”数值变成可编辑输入，允许直接输入数值调整模型；同时新增“导入位姿数据”选项，并与“导出全部 NII.GZ”中的位姿数据 JSON 格式匹配。
|
||
|
||
## 业务目标
|
||
|
||
- 提升模型位姿精调效率，支持滑条、按钮和数值输入三种方式共用同一位姿状态。
|
||
- 支持把已导出的位姿 JSON 再导入当前项目，恢复 activePose、保存位姿列表，并继续驱动三维融合视图、右侧映射视图和分割导出。
|
||
- 保持医疗影像工具栏界面紧凑、可读、可控。
|
||
|
||
## 输入与输出
|
||
|
||
- 输入：
|
||
- 用户在模型位姿数值框中输入旋转、平移、缩放数值。
|
||
- 用户选择位姿 JSON 文件导入。
|
||
- 输出：
|
||
- 当前 `modelPose` 实时更新。
|
||
- 可选保存位姿列表 `modelPoses` 更新并写入后端。
|
||
- 右侧逆向分割映射视图和 NIfTI 分割导出继续使用当前位姿。
|
||
|
||
## 影响范围
|
||
|
||
- `WebSite/src/components/ReverseWorkspace.tsx`
|
||
- `工程分析/经验记录.md`
|
||
- 本次需求、实现、测试文档。
|
||
|
||
## 关键约束
|
||
|
||
- 位姿输入需要沿用现有 `poseStepConfig` 的最小值、最大值和精度。
|
||
- 导入格式必须兼容当前导出的 `pose-data.json`，尤其是 `activePose` 与 `modelPoses`。
|
||
- 导入失败需要给出明确错误，不破坏当前位姿。
|
||
- 用户导入保存位姿列表后，要继续通过 `PATCH /model-poses` 持久化。
|
||
|
||
## 风险点
|
||
|
||
- 数字输入的中间态可能为空或非法，需要避免把 `NaN` 写入位姿状态。
|
||
- 导入的 JSON 可能包含不完整或越界数值，需要归一化和 clamp。
|
||
- 默认位姿不能丢失；导入外部 `modelPoses` 时应保留或补齐默认/俯视/侧视。
|
||
|
||
## 默认假设
|
||
|
||
- 导入位姿数据优先读取导出 JSON 中的 `activePose`；如果没有，则读取第一个可用的 `modelPoses[0].pose` 或对象自身作为单个位姿。
|
||
- 如果导入文件包含 `modelPoses`，则将其作为保存位姿列表导入并持久化。
|
||
- 如果只导入单个位姿，则仅更新当前位姿，不覆盖保存列表。
|