dros/docs/实现/双击RIS条目后追加体位功能设计.md

双击RIS条目后追加体位功能设计

需求整理

功能需求

• 在工作列表(worklist)中双击RIS条目时，先执行保存到本地的操作
• 保存成功后，自动打开追加体位对话框
• 用户可以在对话框中选择要追加的体位
• 确认后将选中的体位追加到当前检查中

用户场景

1. 用户在工作列表中浏览RIS数据
2. 双击某个RIS条目
3. 系统自动保存该RIS数据到本地
4. 保存成功后弹出追加体位对话框
5. 用户选择需要追加的体位
6. 确认追加，体位添加到检查中

业务规则

• 只有RIS数据(entry_id存在)才触发此流程
• 保存失败时不打开追加对话框
• 追加体位需要基于当前选中的体位信息
• 追加操作失败时给出相应提示

参与者

核心组件

• WorklistPage (src/pages/patient/worklist.tsx): 工作列表页面，处理双击事件
• AppendViewModal (src/pages/exam/components/AppendViewModal.tsx): 追加体位对话框组件
• BodyPositionList (src/pages/exam/components/BodyPositionList.tsx): 体位列表组件（参考追加体位按钮实现）

业务逻辑

• saveRisData (src/domain/patient/risSaveLogic.ts): RIS数据保存逻辑
• saveRisBatch (src/API/patient/risActions.ts): RIS批量保存API
• appendViewsThunk (src/states/exam/appendViewSlice.ts): 追加体位Redux异步操作

Redux状态

• selectedBodyPosition: 当前选中的体位信息
• selectedViews: 用户选中的待追加视图
• viewSelection: 视图选择状态管理

辅助组件

• BodyPositionFilter: 身体部位过滤器
• RegisterAvailableList: 可选体位列表
• SelectedProtocolList: 已选体位列表

业务链路

用户双击RIS条目
    ↓
WorklistPage.handleRowDoubleClick(record)
    ↓ (判断为RIS数据)
调用 saveRisData(record.entry_id, onSuccessCallback)
    ↓ (异步保存)
saveRisSingle(entryId, []) → API调用
    ↓ (保存成功)
显示成功弹框 + 执行onSuccessCallback
    ↓
打开 AppendViewModal 追加体位对话框
    ↓
用户选择体位 → 确认追加
    ↓
appendViewsThunk() → 追加体位到检查
    ↓ (追加成功)
自动调用 worklistToExam() 进入检查页面

数据流

流程图 (Mermaid)

sequenceDiagram
    participant U as 用户
    participant W as WorklistPage
    participant S as saveRisData
    participant A as AppendViewModal
    participant T as appendViewsThunk

    U->>W: 双击RIS条目
    W->>S: saveRisData(entryId, callback)
    S->>S: 调用saveRisSingle(entryId, [])
    S->>W: 保存成功回调 + study信息
    W->>A: 打开模态框 + 传递study信息
    A->>U: 显示追加体位界面
    U->>A: 选择体位
    U->>A: 确认追加
    A->>T: appendViewsThunk(study_id, views)
    T->>A: 追加成功
    A->>W: 调用onSuccess回调
    W->>W: 创建Task对象 + 调用worklistToExam()
    W->>U: 进入检查页面

数据传递链路

1. 双击事件: record: Task → handleRowDoubleClick → saveRisData(entryId, onSuccess)
2. 保存成功回调: onSuccess 函数执行 → 设置 isAppendModalOpen = true
3. 模态框初始化: selectedBodyPosition → setCurrentBodyPart(bodyPartId)
4. 用户选择: selectedViews 数组收集用户选择的体位
5. 确认追加: selectedViews + study_id + currentWork → appendViewsThunk

输入数据

• record (Task): 双击的RIS条目数据，包含 entry_id 用于保存
• selectedBodyPosition: 当前检查的体位信息，用于初始化追加模态框

输出数据

• 保存成功的RIS数据本地化
• 新追加的体位列表更新到当前检查

实现方案

方案选择

采用方案1: 修改saveRisData接受成功回调参数，在保存成功后执行回调打开模态框。

代码修改点

1. risSaveLogic.ts: 修改 saveRisData 函数使用 saveRisSingle API，返回保存的study信息
2. AppendViewModal.tsx: 添加 studyId 和 currentWork 参数，支持worklist页面调用
3. worklist.tsx: 添加 AppendViewModal 组件和相关状态管理，传递study信息
4. worklist.tsx: 修改 handleRowDoubleClick 使用回调接收study信息并打开模态框

状态管理

在WorklistPage中添加:

• isAppendModalOpen: boolean 状态控制模态框显示
• currentStudy: any 状态存储当前保存的study信息
• 导入 AppendViewModal 组件
• 处理模态框关闭逻辑，清空study信息

问题修复

问题: 弹出的对话框中点击"追加"按钮提示"未找到当前检查信息" 原因: AppendViewModal依赖Redux状态 selectedBodyPosition，但worklist页面没有设置此状态 解决方案:

• 修改AppendViewModal支持接收外部传入的 studyId 和 currentWork 参数
• 在worklist页面保存RIS数据成功后，传递study信息给AppendViewModal
• AppendViewModal优先使用传入的参数，其次使用Redux状态