From de3d8ad567bdbfd1ef707a6e670b8edbebd5563f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=8E=E4=BD=97?= <huatuo@gentronhealth.com>
Date: Sat, 13 Jun 2026 02:11:14 +0800
Subject: [PATCH] =?UTF-8?q?docs(bug):=20=E8=AF=B8=E8=91=9B=E4=BA=AE?=
 =?UTF-8?q?=E5=88=86=E6=9E=90=E6=8A=A5=E5=91=8A=20Bug=20#719?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 MD/bugs/BUG_719_ANALYSIS.md | 147 ++++++++++++++++++++++++++++++++++++
 1 file changed, 147 insertions(+)
 create mode 100644 MD/bugs/BUG_719_ANALYSIS.md

diff --git a/MD/bugs/BUG_719_ANALYSIS.md b/MD/bugs/BUG_719_ANALYSIS.md
new file mode 100644
index 000000000..bf1e493be
--- /dev/null
+++ b/MD/bugs/BUG_719_ANALYSIS.md
@@ -0,0 +1,147 @@
+# Bug #719 诸葛亮分析报告
+
+> **文档类型**: Bug分析
+> **分析时间**: 2026-06-13 02:11:11
+> **分析模型**: mimo-v2.5 (LLM深度分析)
+
+---
+
+## 基本信息
+- **Bug #**: 719
+- **标题**: 【护士站-医嘱校对】已停止列表：频次/用法及停嘱医生字段未回写显示
+- **模块**: 病区护士工作站
+- **提出人**: 陈显精
+
+---
+
+Now I have a complete understanding of the bug. Let me provide the analysis.
+
+---
+
+## 一、Bug 理解
+
+### 禅道 Bug 原文
+
+**标题**: 【护士站-医嘱校对】已停止列表：频次/用法及停嘱医生字段未回写显示
+
+**重现步骤**:
+1. 医生端已对某医嘱进行"停嘱"操作（如：注射用头孢哌酮舒巴坦钠）
+2. 登录护士端进入"住院护士站" > "医嘱校对"
+3. 在查询页签中点击"已停止"标签
+4. 查看对应医嘱记录的"频次/用法"及"停嘱医生"两列
+
+**结果**: 列表中"频次/用法"及"停嘱医生"列内容为空，未显示任何数据。
+
+**期望**: 列表对应的"频次/用法"及"停嘱医生"列应正确显示数据，且与临床医生端显示内容一致（如：每日一次 静脉滴注、内科医生1）。
+
+### 附图关键信息
+- **图2513**（护士站"已停止"标签页）：两条已停医嘱记录中，"频次/用法"列和"停嘱医生"列均为空白。图中用红色标注"频次/用法 和停嘱医生未回写"。
+- **图2512**（医生站视图）：同一医嘱显示"频次/用法"为"每日一次 静脉滴注"，"停嘱医生"为"内科医生1"。
+
+### 综合总结
+护士在医嘱校对的"已停止"列表中查看已停医嘱时，"频次/用法"和"停嘱医生"两个字段显示为空。这两个字段在医生端正常显示。问题出在护士站查询已停止医嘱时，数据源（SQL查询或Java处理）未能正确返回这两个字段的值。
+
+---
+
+## 二、根因分析
+
+### 根因1：停嘱医生字段 —— `stopper_name` 映射到 `update_by` 被覆盖
+
+**核心问题链路**：
+
+1. **医生停嘱** (`AdviceManageAppServiceImpl.stopRegAdvice`): 设置 `update_by = SecurityUtils.getNickName()`（医生昵称）
+   - 此时 `update_by = "内科医生1"` ✓
+   - **但未设置 `stopper_id`**（虽然 V41 迁移已添加此列）
+
+2. **护士校对** (`AdviceProcessAppServiceImpl.adviceVerify`): 设置 `update_by = SecurityUtils.getNickName()`（护士昵称）
+   - 此时 `update_by` 被覆盖为护士名
+   - 如果护士昵称为空/NULL → `update_by = NULL`
+
+3. **SQL 查询** (`AdviceProcessAppMapper.xml`):
+   ```sql
+   NULL::bigint AS stopper_id,  -- 硬编码 NULL！
+   T1.update_by AS stopper_name -- 使用 update_by，已被覆盖
+   ```
+
+4. **Java 处理**:
+   ```java
+   e.setStopperName(e.getStopperName()); // 这是空操作！
+   ```
+
+**结论**: `stopper_name` 取自 `update_by`，而 `update_by` 被护士校对操作覆盖。若护士昵称为空，该字段为 NULL。V41 迁移添加了 `stopper_id` 列但 Java 实体和查询均未使用。
+
+**涉及文件**:
+- `AdviceProcessAppMapper.xml` (L209-210, L355-356): `NULL::bigint AS stopper_id` + `T1.update_by AS stopper_name`
+- `AdviceProcessAppServiceImpl.java` (L318): `e.setStopperName(e.getStopperName())` — 空操作
+- `AdviceManageAppServiceImpl.java` (L1127): `.set(MedicationRequest::getUpdateBy, stopUserName)` — 未设 `stopper_id`
+- `MedicationRequest.java`: 缺少 `stopperId` 字段
+- `ServiceRequest.java`: 缺少 `stopperId` 字段
+
+### 根因2：频次/用法字段 —— 需要进一步排查
+
+SQL 查询正确选取了 `T1.rate_code` 和 `T1.method_code`，Java 代码也正确计算了 `frequencyUsage`。但两个停嘱医嘱都为空，可能是：
+- 数据库中这两条医嘱的 `rate_code`/`method_code` 为 NULL（创建时未设置）
+- 或 `DictUtils.getDictLabel` 返回空字符串
+
+**需验证**: 检查 `med_medication_request` 表中对应记录的 `rate_code` 和 `method_code` 值。
+
+---
+
+## 三、修复方案
+
+### 修复1：停嘱医生字段（核心修复）
+
+**Step 1**: 给 `MedicationRequest` 和 `ServiceRequest` 实体添加 `stopperId` 字段
+
+**Step 2**: 更新医生站停嘱逻辑，设置 `stopper_id`
+
+```java
+// AdviceManageAppServiceImpl.stopRegAdvice
+// 获取停嘱医生的 practitionerId
+Long practitionerId = SecurityUtils.getLoginUser().getPractitionerId();
+// 药品
+.set(MedicationRequest::getStopperId, practitionerId)
+.set(MedicationRequest::getUpdateBy, stopUserName)
+// 诊疗
+.set(ServiceRequest::getStopperId, practitionerId)
+.set(ServiceRequest::getUpdateBy, stopUserName)
+```
+
+**Step 3**: 更新护士站 SQL 查询，用 `stopper_id` 关联 `adm_practitioner` 获取医生姓名
+
+```sql
+-- AdviceProcessAppMapper.xml 中 MedicationRequest UNION:
+-- 修改前:
+NULL::bigint AS stopper_id,
+T1.update_by AS stopper_name
+-- 修改后:
+T1.stopper_id AS stopper_id,
+COALESCE(practitioner_stop.name, T1.update_by) AS stopper_name
+-- 并增加 LEFT JOIN:
+LEFT JOIN adm_practitioner practitioner_stop ON T1.stopper_id = practitioner_stop.id AND practitioner_stop.delete_flag = '0'
+```
+
+对 ServiceRequest UNION 同理修改。
+
+**Step 4**: 更新护士站校对逻辑，停嘱单校对时不应覆盖 `update_by`（或同时保留 stopper 信息）
+
+### 修复2：频次/用法字段
+
+先验证数据：检查 `med_medication_request` 表中 `rate_code` 和 `method_code` 是否为 NULL。如果为 NULL，需检查订单创建流程是否正确设置了这两个字段。
+
+---
+
+## 四、路由决策
+
+**FIXER: guanyu（后端开发）+ zhaoyun（前端开发）**
+
+**REASON**: 根因在后端（SQL 查询 `stopper_name` 映射错误 + 实体缺少 `stopperId` + 停嘱逻辑未设 `stopper_id`），需 guanyu 修复实体类、Mapper XML、Service 层。频次/用法需排查数据库数据，也属后端。前端可能需确认"频次/用法"为空时的展示逻辑，属 zhaoyun 范围。
+
+---
+
+## 路由决策
+- **FIXER_ID**: guanyu
+- **修复 Agent**: guanyu（后端）
+- **原因**: LLM 分析决策
+
+> ⚠️ 修复人员请先验证以上分析是否正确，再执行修复。