@@ -0,0 +1,113 @@
# 诊单编辑对话框：新增「患者业务订单」Tab
## Goal
在「编辑诊单」抽屉对话框（`admin/src/views/tcm/diagnosis/edit.vue` ）中新增一个 tab，一站式查看该患者的**处方业务订单**（含订单编号、金额、医生、医助、创建人、时间）。直接复用 `admin/src/views/consumer/prescription/order_list.vue` 所用接口 `/tcm.prescriptionOrder/lists` ，仅以患者维度过滤。tab 受 `tcm.diagnosis/chufang` 权限控制。
## Decision Log
- **D1（数据源）**：处方业务订单 `tcm_prescription_order` （不是支付单 `zyt_order` ）。用户明确：「订单信息可以参考这个页面，这个页面接口获取的是所有订单 关联到患者就好了」
- **D2（订单范围 / Q1）**：默认跨诊单聚合 + tab 顶部放切换开关，可一键切到"仅本诊单"
- **D3（接口）**：复用 `prescriptionOrderLists` (`@/api/tcm.ts:346` )，不另起新接口
- **D4（列映射 / Q2）**：5 列：订单编号 / 金额 / 医生(`doctor_name` ) / 创建人·医助(`creator_name` ) / 创建时间。**不**单独显示 `assistant_name` ，与创建人合并 → 后端无需新增字段注入
- **D5（行操作 / Q3）**：纯只读，不点击跳转、不弹详情、不挂任何按钮
## What I already know（已查证的事实）
### 前端
- 「编辑诊单」对话框：`admin/src/views/tcm/diagnosis/edit.vue:55` `<el-tabs>` ，已含 12 个 tab，规范统一为 `:disabled="!formData.id" lazy` + `v-if="hasPermission([...])"` ，子组件用 props 接 `diagnosisId / patientId`
- 处方 tab 现用 `tcm.diagnosis/chufang` 权限：`edit.vue:627`
- 参考页面：`admin/src/views/consumer/prescription/order_list.vue` （
- 现有 API： `prescriptionOrderLists` → `/tcm.prescriptionOrder/lists` （ `admin/src/api/tcm.ts:346` ），已支持 `patient_keyword / order_no / prescription_id / fulfillment_status / prescription_audit_status / payment_slip_audit_status / start_time / end_time / doctor_id / assistant_id / express_keyword`
- 列表字段（前端列）：订单号、处方ID、诊单ID、收货人、费用类别、金额、内部成本、处方审核、支付审核、履约、关联支付单、创建时间、**开方人 `doctor_name` **、**创建人 `creator_name` **
### 后端 `server/app/adminapi/lists/tcm/PrescriptionOrderLists.php`
- `setSearch()` （ `=` 等值过滤仅含 `prescription_id / fulfillment_status / prescription_audit_status / payment_slip_audit_status` ， `diagnosis_id` **
- `applyPatientKeywordFilter()` （ `whereExists` 关联 `tcm_diagnosis` ，按 `patient_name LIKE '%kw%' OR phone LIKE '%kw%'` 模糊聚合，**天然跨诊单**，正符合 D2 默认模式
- 响应注入字段（line 436-461）：`creator_name` 、`doctor_name` 、`prescription_phone` 已写入；`assistant_id` 已查出（`$assistantByDiag` line 432-434）但**未写入 item**，需要补
- 返回 `assistant_name` 还需要再 `Admin::whereIn('id', assistant_ids)->column('name','id')` 一次
## Assumptions（待确认）
1. * * 「患者」匹配键**：用 `phone` （手机号）作 `patient_keyword` 。如手机号脱敏不可用，回退用 `patient_name` 。需要避免空 phone 误匹配
2. * * 「仅本诊单」开关 = 传 diagnosis_id**：后端补 `setSearch` `'=' => ['diagnosis_id']` 即可
3. **三列字段映射 ** ：
- 订单编号 → `order_no`
- 金额 → `amount`
- 医生 → `doctor_name` （开方人，已存在）
- 医助 → `assistant_name` （需后端新增注入）
- 创建人 → `creator_name` （已存在）
- 时间 → `create_time`
4. **只读 ** ：tab 内只展示，不嵌业务操作（详情/取消/审核 等都不放）
## Open Questions
（已无阻塞问题，三个 Decision 已落定 D2 / D4 / D5）
## Requirements
- [ ] **后端 ** `server/app/adminapi/lists/tcm/PrescriptionOrderLists.php` ：
- `setSearch()` 在 `'='` 数组里追加 `'diagnosis_id'` ，使前端可传 `diagnosis_id` 做精确等值过滤
- 不动其他过滤、不动响应字段
- [ ] **前端 子组件 ** `admin/src/views/tcm/diagnosis/components/PatientOrderList.vue` ：
- props： `diagnosisId: number` 、`patientPhone?: string` 、`patientName?: string`
- 顶部 `el-radio-group` /`el-segmented` ： `全部历史(默认) | 仅本诊单` 二选一
- 全部历史 → 调 `prescriptionOrderLists({ patient_keyword: phone || patient_name, page_no, page_size })`
- 仅本诊单 → 调 `prescriptionOrderLists({ diagnosis_id, page_no, page_size })`
- 5 列：订单编号(`order_no` ) / 金额(`amount` ) / 医生(`doctor_name` ) / 创建人(`creator_name` ) / 创建时间(`create_time` )
- 分页：默认 size=10，可切 10/20/50
- 空态：`<el-empty>`
- [ ] **前端 入口 ** `admin/src/views/tcm/diagnosis/edit.vue` ：
- 在 `<el-tabs>` 内追加 `<el-tab-pane label="业务订单" name="patientOrders" :disabled="!formData.id" lazy v-if="hasPermission(['tcm.diagnosis/chufang'])">`
- 内部嵌 `<PatientOrderList v-if="formData.id" :diagnosisId="Number(formData.id)" :patientPhone="originalPhone || formData.phone" :patientName="formData.patient_name" />` ，否则 `<el-empty>`
## Acceptance Criteria
- [ ] 有 `tcm.diagnosis/chufang` 权限的角色打开任一已保存诊单 → 看到"业务订单"tab
- [ ] 默认聚合该患者所有诊单的处方业务订单（按 phone 优先，回退 patient_name 模糊匹配）
- [ ] 顶部切换到"仅本诊单"后，列表使用新加的 `diagnosis_id` 等值过滤，仅展示当前诊单的订单
- [ ] 5 列正确：`order_no` / `amount` / `doctor_name` / `creator_name` / `create_time`
- [ ] 无该权限的用户看不见此 tab
- [ ] 新建（未保存）诊单 → tab 不可点
- [ ] 既有「处方业务订单」列表页（`consumer/prescription/order_list.vue` ）行为完全不变（只新增过滤参数，不改既有过滤）
- [ ] 行无任何点击/操作行为
## Implementation Plan
**PR1（小步合并，约 30 行后端 + 200 行前端） **
1. 后端：`PrescriptionOrderLists.php:32` `setSearch()` 在 `'='` 数组追加 `'diagnosis_id'`
2. 前端：新增 `admin/src/views/tcm/diagnosis/components/PatientOrderList.vue`
3. 前端：`edit.vue` 注册 tab + import + 占位
**手动验证（无单测框架） **
- 角色：医生（有 chufang） ）
- 数据：跨诊单同患者、单诊单单订单、无订单 三种场景
- 过滤：聚合开关切换两次响应应不同
- 回归：旧的 `consumer/prescription/order_list.vue` 列表所有过滤项均正常工作
## Definition of Done
- ESLint / vue-tsc 通过；新增字段 TS 类型完整
- 后端无 SQL 注入风险（`diagnosis_id` 走 `setSearch` 自动转 int）
- 不引入 `console.log`
- 既有 `consumer/prescription/order_list.vue` 视觉/交互无回归
## Out of Scope
- 不展示支付单（`zyt_order` ），不在该 tab 内做收款关联
- 不在 tab 内做任何写操作（无审核、改价、取消、退款、发货）
- 不为本 tab 单独建菜单/权限位（沿用 `tcm.diagnosis/chufang` ）
## Technical Notes
- 关键文件：
- `admin/src/views/tcm/diagnosis/edit.vue:55-697` （
- `admin/src/views/consumer/prescription/order_list.vue` （参考）
- `admin/src/api/tcm.ts:346` `prescriptionOrderLists`
- `server/app/adminapi/lists/tcm/PrescriptionOrderLists.php:29-36, 430-465, 768-785`
- 风险：
- `patient_keyword` 是 LIKE 模糊匹配，对短手机号 / 同名同号场景可能误聚合 → 建议优先用完整 11 位手机号
- `assistant_name` 注入需要再发一次 `Admin` 查询（很轻量，已有 admin id 集合）
- 测试：手动验证四种角色（医生/医助/超管/无权限）+ 三种诊单（无订单/有 1 条/有 N 条跨诊单）
