# 诊单编辑对话框：新增「患者业务订单」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`（5890 行）
- 现有 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()`（line 29-36）：当前 `=` 等值过滤仅含 `prescription_id / fulfillment_status / prescription_audit_status / payment_slip_audit_status`，**未含 `diagnosis_id`**
- `applyPatientKeywordFilter()`（line 768-785）：用 `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）/ 医助（无 chufang）/ 超管 — 看 tab 显隐与数据范围
- 数据：跨诊单同患者、单诊单单订单、无订单 三种场景
- 过滤：聚合开关切换两次响应应不同
- 回归：旧的 `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`（el-tabs 区）
  - `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 条跨诊单）