docs(bug): 诸葛亮分析报告 Bug #712
This commit is contained in:
139
MD/bugs/BUG_712_ANALYSIS.md
Normal file
139
MD/bugs/BUG_712_ANALYSIS.md
Normal file
@@ -0,0 +1,139 @@
|
||||
# Bug #712 诸葛亮分析报告
|
||||
|
||||
> **文档类型**: Bug分析
|
||||
> **分析时间**: 2026-06-13 02:46:37
|
||||
> **分析模型**: mimo-v2.5 (LLM深度分析)
|
||||
|
||||
---
|
||||
|
||||
## 基本信息
|
||||
- **Bug #**: 712
|
||||
- **标题**: 【收费工作站-预交金管理】“预交金管理”页面缺失展示“支付方式”列及患者“床号”、“费用类型”
|
||||
- **模块**: 住院登记管理
|
||||
- **提出人**: 陈显精
|
||||
|
||||
---
|
||||
|
||||
分析完成。以下是完整的 Bug #712 分析报告。
|
||||
|
||||
---
|
||||
|
||||
## 一、Bug 理解
|
||||
|
||||
**Bug 标题**：【收费工作站-预交金管理】"预交金管理"页面缺失展示"支付方式"列及患者"床号"、"费用类型"
|
||||
|
||||
**重现步骤**：
|
||||
1. 登录系统，进入"收费工作站" → "预交金管理"页面
|
||||
2. 输入住院号查询关联患者（如"三太子"）
|
||||
3. 检查患者基本信息卡片及下方收支明细列表
|
||||
|
||||
**期望结果**：
|
||||
1. 患者卡片区增加展示"床号"（如：012床）与"费用类型"（医保类型，如：职工医保）
|
||||
2. 明细列表区在"票据类型"与"收款时间"之间新增"支付方式"字段列
|
||||
|
||||
**附图分析关键信息**：
|
||||
- 图2492/2493 显示患者卡片区域"在院科室/病区: 呼吸内科病房/呼吸内科一区"，**没有独立展示床号和费用类型**
|
||||
- 收支明细列表列头为：序号、收据号、金额、票据类型、收款时间、收款员 —— **缺少"支付方式"列**
|
||||
- 截图中有红色标注："增加患者床号和费用类型"、"增加支付方式字段列"
|
||||
|
||||
**综合总结**：用户在预交金管理页面查询住院患者后，患者信息卡片只显示了科室/病区，无法看到该患者的具体床号和医保费用类型；下方流水明细列表缺少支付方式列，无法知道每笔交易的支付渠道（现金/支付宝等）。这两个信息对打印收据和财务核对都是必需的。
|
||||
|
||||
---
|
||||
|
||||
## 二、根因分析
|
||||
|
||||
经过全链路 6 环分析，问题分布在前端和后端两个层面：
|
||||
|
||||
### 缺陷 1：费用类型（费用类型/医保类型）缺失
|
||||
|
||||
**前端** `index.vue:88-110`：患者信息卡片区域没有展示"费用类型"字段。
|
||||
**后端** `AdvancePaymentInfoDto.java`：DTO 缺少 `ybClassText`（医保类别文本）字段。
|
||||
**后端** `AdvancePaymentManageAppMapper.xml`：`getAdvancePaymentInfo` SQL 查询未 SELECT `ae.yb_class_text`。
|
||||
**数据库**：`adm_encounter` 表已有 `yb_class_text` 字段（保险类型文本，如"职工医保"）。
|
||||
|
||||
### 缺陷 2：床号显示不突出
|
||||
|
||||
**后端** SQL 已查询 `alb.name AS bed_name`，DTO 已有 `bedName` 字段。
|
||||
**前端** `index.vue:115-120`：床号被拼在"在院科室/病区"字符串中（`wardName + houseName + bedName`），没有独立展示为"床号：012床"。
|
||||
|
||||
### 缺陷 3：支付方式列缺失
|
||||
|
||||
**前端** `index.vue:147`：`<vxe-column field="payWay" title="支付方式" />` 被注释掉了。
|
||||
**后端** `AdvancePaymentFlowRecordDto.java`：DTO 缺少支付方式字段（`payEnum` / `payWay`）。
|
||||
**后端** `AdvancePaymentManageAppMapper.xml:90-99`：`getAdvancePaymentFlowRecordList` SQL 只查了 `fin_payment_reconciliation` 主表，**未 JOIN** `fin_payment_rec_detail` 子表（`pay_enum` 字段在子表中）。
|
||||
**数据库**：`fin_payment_rec_detail` 表有 `pay_enum`（支付类型编码，如现金/支付宝/微信）。
|
||||
|
||||
**涉及文件清单**：
|
||||
|
||||
| 文件 | 修改内容 |
|
||||
|------|---------|
|
||||
| `AdvancePaymentInfoDto.java` | 新增 `ybClassText` 字段 |
|
||||
| `AdvancePaymentManageAppMapper.xml` | `getAdvancePaymentInfo` SQL 加 `ae.yb_class_text` |
|
||||
| `AdvancePaymentFlowRecordDto.java` | 新增 `payEnum` + `payWay` 字段 |
|
||||
| `AdvancePaymentManageAppMapper.xml` | `getAdvancePaymentFlowRecordList` SQL JOIN `fin_payment_rec_detail`，取 `pay_enum` |
|
||||
| `AdvancePaymentManageAppServiceImpl.java` | 流水记录返回后增加 `payWay` 枚举映射 |
|
||||
| `index.vue` | 卡片区域新增"床号"和"费用类型"展示；取消注释支付方式列 |
|
||||
|
||||
---
|
||||
|
||||
## 三、修复方案
|
||||
|
||||
### Step 1：后端 — DTO 新增字段
|
||||
|
||||
**`AdvancePaymentInfoDto.java`**：新增字段
|
||||
```java
|
||||
/** 费用类型（医保类型文本，如：职工医保） */
|
||||
private String ybClassText;
|
||||
```
|
||||
|
||||
**`AdvancePaymentFlowRecordDto.java`**：新增字段
|
||||
```java
|
||||
/** 支付方式编码 */
|
||||
private Integer payEnum;
|
||||
/** 支付方式文本（如：现金、支付宝） */
|
||||
private String payWay;
|
||||
```
|
||||
|
||||
### Step 2：后端 — Mapper XML 修改
|
||||
|
||||
**`AdvancePaymentManageAppMapper.xml`**：
|
||||
|
||||
1. `getAdvancePaymentInfo` 子查询中加 `ae.yb_class_text AS yb_class_text`
|
||||
2. `getAdvancePaymentFlowRecordList` SQL 加 JOIN `fin_payment_rec_detail`，取 `prd.pay_enum`
|
||||
|
||||
### Step 3：后端 — ServiceImpl 枚举映射
|
||||
|
||||
**`AdvancePaymentManageAppServiceImpl.java`**：
|
||||
|
||||
在 `getAdvancePaymentFlowRecord` 方法中增加支付方式枚举映射：
|
||||
```java
|
||||
e.setPayWay(EnumUtils.getInfoByValue(YbPayment.class, e.getPayEnum()));
|
||||
```
|
||||
|
||||
### Step 4：前端 — 页面字段补充
|
||||
|
||||
**`index.vue`**：
|
||||
1. 在"在院科室/病区"行下方（或同行），新增展示：
|
||||
- `床号: {{ patientInfo.bedName }}`（独立标签）
|
||||
- `费用类型: {{ patientInfo.ybClassText }}`
|
||||
2. 取消注释支付方式列，改为：
|
||||
```html
|
||||
<vxe-column field="payWay" title="支付方式" align="center" min-width="100" />
|
||||
```
|
||||
3. 插入位置：在 `paymentEnum_enumText`（票据类型）列之后、`operateTime`（收款时间）列之前
|
||||
|
||||
---
|
||||
|
||||
## 四、路由决策
|
||||
|
||||
**FIXER**: zhaoyun（赵云 — 前端开发）
|
||||
**REASON**: 本次修复核心在于前端页面展示（卡片字段补充 + 表格列取消注释），后端改动量较小（DTO 加 2 字段、SQL 加 2 列、Service 加 1 行映射），属于前后端联动的 UI 展示修复，赵云可一并处理前端和后端轻量改动。无需 DBA 审查（无建表/加字段迁移）。
|
||||
|
||||
---
|
||||
|
||||
## 路由决策
|
||||
- **FIXER_ID**: guanyu
|
||||
- **修复 Agent**: guanyu（后端）
|
||||
- **原因**: LLM 分析决策
|
||||
|
||||
> ⚠️ 修复人员请先验证以上分析是否正确，再执行修复。
|
||||
Reference in New Issue
Block a user