docs(bug): 诸葛亮分析报告 Bug #728
This commit is contained in:
147
MD/bugs/BUG_728_ANALYSIS.md
Normal file
147
MD/bugs/BUG_728_ANALYSIS.md
Normal file
@@ -0,0 +1,147 @@
|
||||
# Bug #728 诸葛亮分析报告
|
||||
|
||||
> **文档类型**: Bug分析
|
||||
> **分析时间**: 2026-06-13 01:00:18
|
||||
> **分析模型**: mimo-v2.5 (LLM深度分析)
|
||||
|
||||
---
|
||||
|
||||
## 基本信息
|
||||
- **Bug #**: 728
|
||||
- **标题**: 【住院护士站-医嘱校对】转科医嘱核对通过后原床位被提前释放，导致转科前待处理事项无法执行
|
||||
- **模块**: 病区护士工作站
|
||||
- **提出人**: 陈显精
|
||||
|
||||
---
|
||||
|
||||
分析完成。以下是完整的 Bug 分析报告：
|
||||
|
||||
---
|
||||
|
||||
## 一、Bug 理解
|
||||
|
||||
**禅道标题：** 【住院护士站-医嘱校对】转科医嘱核对通过后原床位被提前释放，导致转科前待处理事项无法执行
|
||||
|
||||
**重现步骤：**
|
||||
1. 医生端为患者（002床 不知道）开立转科预嘱并签发
|
||||
2. 登录住院护士站，在【医嘱校对】页面"未校对-临时医嘱"中找到该患者的"转科"医嘱
|
||||
3. 选中该医嘱，点击【核对通过】，提示"校对成功"
|
||||
4. 切换至其他菜单（医嘱执行、汇总领药等）
|
||||
|
||||
**结果：**
|
||||
- 护士核对通过转科医嘱后，系统**立即释放并清退了该患者的原床位**（床号显示为 `-:-`，非在科状态）
|
||||
- 患者从左侧在科患者列表中**消失**，护士无法在【医嘱执行】【汇总领药】等界面选中该患者
|
||||
- 转科前尚未完成的带药、治疗等医嘱无法执行
|
||||
|
||||
**期望：**
|
||||
1. 核对通过转科医嘱后，应**保留原床位占用**和在科状态
|
||||
2. 允许护士继续处理转科前所有待执行医嘱
|
||||
3. **只有**护士在【入出转管理】页面确认执行【转科】或【清床】操作后，才正式释放床位
|
||||
|
||||
**附图关键信息：**
|
||||
- 图2527：校对页面，红框标注"核对通过"按钮和转科医嘱
|
||||
- 图2526/2529：入出转管理页面，床号显示 `-:-`，患者已标记"待转科"，仍显示"待取药/待退药"和"待处理执行单"
|
||||
- 图2528：校对页面，患者"不知道"已从左侧列表消失，红框注释"转科医嘱护士校对通过后 待转科的患者床位应该保留"
|
||||
|
||||
**综合总结：** 护士在医嘱校对页面核对通过转科医嘱后，系统过早触发了床位释放和在科状态变更，导致患者从在科列表中消失，护士无法继续执行转科前遗留的待办医嘱。正确行为应是核对通过仅更新医嘱状态，保留床位和在科状态，待护士在入出转管理页面手动执行转科时才释放资源。
|
||||
|
||||
---
|
||||
|
||||
## 二、根因分析
|
||||
|
||||
**核心问题代码：** `AdviceProcessAppServiceImpl.adviceVerify()` 方法（第 465-472 行）
|
||||
|
||||
```java
|
||||
// 处理转科/出院等特殊医嘱
|
||||
for (ServiceRequest serviceRequest : normalRequests) {
|
||||
if (ActivityDefCategory.TRANSFER.getValue().equals(serviceRequest.getCategoryEnum())) {
|
||||
encounterService.updateEncounterStatus(serviceRequest.getEncounterId(),
|
||||
EncounterZyStatus.PENDING_TRANSFER.getValue()); // ← BUG：校对时立即改变患者状态
|
||||
} else if (ActivityDefCategory.DISCHARGE.getValue().equals(serviceRequest.getCategoryEnum())) {
|
||||
encounterService.updateEncounterStatus(serviceRequest.getEncounterId(),
|
||||
EncounterZyStatus.AWAITING_DISCHARGE.getValue());
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**根因链条：**
|
||||
1. **`adviceVerify`（校对通过）** 在处理转科医嘱时，直接调用 `encounterService.updateEncounterStatus()` 将患者 encounter 状态改为 `PENDING_TRANSFER`（6）
|
||||
2. 同时，转科医嘱的 ServiceRequest 状态被设为 `COMPLETED`（3）
|
||||
3. 这触发了系统级联反应——患者状态变更导致床位信息被释放（`encounter_location` 中 BED 类型的记录状态被联动修改），患者从在科患者列表中消失
|
||||
4. **实际的转科操作** 由 `ATDManageAppServiceImpl.transferDepartment()` 执行，这才是应该执行床位释放、状态变更的地方
|
||||
|
||||
**正确的时序设计：**
|
||||
- **校对通过** → 仅更新医嘱状态（转科医嘱→COMPLETED），**不改变**患者 encounter 状态
|
||||
- **入出转管理→转科** → 执行床位释放、状态变更、新病区分配
|
||||
|
||||
**涉及文件：**
|
||||
- `AdviceProcessAppServiceImpl.java` — `adviceVerify()` 方法，第 465-472 行
|
||||
- `ATDManageAppServiceImpl.java` — `transferDepartment()` 方法（正确的转科执行逻辑）
|
||||
- `EncounterLocationServiceImpl.java` — `updateEncounterLocationStatus()` 方法（床位状态更新）
|
||||
|
||||
---
|
||||
|
||||
## 三、修复方案
|
||||
|
||||
### 修复步骤
|
||||
|
||||
**步骤 1：修改 `AdviceProcessAppServiceImpl.adviceVerify()` 方法**
|
||||
|
||||
**文件：** `healthlink-his-server/healthlink-his-application/src/main/java/com/healthlink/his/web/inhospitalnursestation/appservice/impl/AdviceProcessAppServiceImpl.java`
|
||||
|
||||
**修改内容：** 删除校对通过时对转科医嘱的 encounter 状态更新
|
||||
|
||||
将第 463-472 行：
|
||||
```java
|
||||
// 处理转科/出院等特殊医嘱
|
||||
for (ServiceRequest serviceRequest : normalRequests) {
|
||||
if (ActivityDefCategory.TRANSFER.getValue().equals(serviceRequest.getCategoryEnum())) {
|
||||
encounterService.updateEncounterStatus(serviceRequest.getEncounterId(),
|
||||
EncounterZyStatus.PENDING_TRANSFER.getValue());
|
||||
} else if (ActivityDefCategory.DISCHARGE.getValue().equals(serviceRequest.getCategoryEnum())) {
|
||||
encounterService.updateEncounterStatus(serviceRequest.getEncounterId(),
|
||||
EncounterZyStatus.AWAITING_DISCHARGE.getValue());
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
改为：
|
||||
```java
|
||||
// 转科/出院医嘱核对通过时，不立即改变患者 encounter 状态
|
||||
// 状态变更推迟到入出转管理页面执行转科/出院操作时触发（ATDManageAppServiceImpl.transferDepartment）
|
||||
// 校对通过仅更新医嘱状态（已在上方 COMPLETED 处理），保留原床位和在科状态
|
||||
```
|
||||
|
||||
**说明：**
|
||||
- 转科医嘱的 `ServiceRequest` 状态已在上方通过 `updateCompleteRequestStatus` 设为 COMPLETED（3），这是正确的
|
||||
- 删除的是 encounter 状态的联动更新，不影响医嘱本身的校对完成
|
||||
- 出院医嘱同理删除（AWAITING_DISCHARGE 状态应推迟到出院操作时设置）
|
||||
|
||||
**步骤 2：编译验证**
|
||||
```bash
|
||||
mvn clean compile -DskipTests -pl healthlink-his-server/healthlink-his-application
|
||||
mvn test -pl healthlink-his-server/healthlink-his-application -Dtest="NurseStationTest" -Dsurefire.failIfNoSpecifiedTests=false
|
||||
```
|
||||
|
||||
**步骤 3：前端确认（无需修改）**
|
||||
|
||||
前端【医嘱校对】页面无需修改，因为：
|
||||
- 医嘱校对接口返回"校对成功"后，前端刷新医嘱列表，转科医嘱状态正确更新为"已完成"
|
||||
- 患者在科列表的刷新由后端 `selectInpatientPage` 查询驱动，患者 encounter 状态不变 → 列表中继续显示
|
||||
|
||||
---
|
||||
|
||||
## 四、路由决策
|
||||
|
||||
**FIXER:** guanyu（关羽 — 后端开发）
|
||||
|
||||
**REASON:** 修复涉及 Java 后端 Service 层逻辑修改（`AdviceProcessAppServiceImpl.adviceVerify` 方法），属于纯后端业务逻辑调整，无前端改动，由后端开发 Agent 执行最合适。
|
||||
|
||||
---
|
||||
|
||||
## 路由决策
|
||||
- **FIXER_ID**: guanyu
|
||||
- **修复 Agent**: guanyu（后端）
|
||||
- **原因**: ** 修复涉及 Java 后端 Service 层逻辑修改（`AdviceProcessAppServiceImpl.adviceVerify` 方法），属于纯后端业务逻辑调整，无前端改动，由后端开发 Agent 执行最合适。
|
||||
|
||||
> ⚠️ 修复人员请先验证以上分析是否正确，再执行修复。
|
||||
Reference in New Issue
Block a user