# 处方管理模块

## 概述

处方管理模块是 XK 系统的核心业务模块，负责处方的开具、审核、转诊、打印等全流程管理。

---

## 处方开具

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `prescription/list` | 处方列表 |
| GET | `prescription/detail` | 处方详情 |
| POST | `prescription/add-chinese` | 创建中药处方 |
| POST | `prescription/add-west` | 创建西药处方 |
| POST | `prescription/add-granular` | 创建颗粒处方 |
| POST | `prescription/add-simple` | 创建简单处方（中成药/服务包/非药品/医疗器械） |
| POST | `prescription/update` | 更新处方 |
| POST | `prescription/delete` | 删除处方 |
| GET | `prescription/print` | 处方打印 |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `PrescriptionController` | `app/Http/Controllers/admin/business/prescription/PrescriptionController.php` | 控制器 |
| `PrescriptionService` | `app/Service/admin/business/prescription/PrescriptionService.php` | 业务服务 |
| `PrescriptionModel` | `app/Models/old/prescription/PrescriptionModel.php` | 主处方模型 |
| `PrescriptionChineseModel` | `app/Models/old/prescription/PrescriptionChineseModel.php` | 中药处方模型 |
| `PrescriptionWestModel` | `app/Models/old/prescription/PrescriptionWestModel.php` | 西药处方模型 |
| `PrescriptionGranularModel` | `app/Models/old/prescription/PrescriptionGranularModel.php` | 颗粒处方模型 |
| `PrescriptionServerModel` | `app/Models/old/prescription/PrescriptionServerModel.php` | 服务包处方模型 |
| `PrescriptionPrintService` | `app/Service/admin/hy/PrescriptionPrintService.php` | 打印服务 |
| `HyRecipeHtmlRenderer` | `app/Service/admin/hy/HyRecipeHtmlRenderer.php` | HTML 渲染 |

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `PrescriptionModel` | `yii_prescription` | 主处方表 |
| `PrescriptionChineseModel` | `yii_prescription_chinese` | 中药处方 |
| `PrescriptionWestModel` | `yii_prescription_west` | 西药处方 |
| `PrescriptionGranularModel` | `yii_prescription_granular` | 颗粒处方 |
| `PrescriptionServerModel` | `yii_prescription_server` | 服务包处方 |

### 处方状态机

```mermaid
stateDiagram-v2
    [*] --> 待审核: 医生开方
    待审核 --> 通过: 医生初审通过
    待审核 --> 未通过: 审核拒绝
    通过 --> 药师复审: 药师审核
    药师复审 --> 生效: 复审通过
    药师复审 --> 未通过: 复审拒绝
    生效 --> 已使用: 患者购药
    生效 --> 已过期: 超时未用
```

### 处方类型

| 类型 | 值 | 说明 |
|------|-----|------|
| 中药 | 1 | 中药饮片处方 |
| 西药 | 2 | 西药处方 |
| 颗粒 | 3 | 配方颗粒处方 |
| 中成药 | 4 | 中成药处方 |
| 产品服务包 | 5 | 服务包处方 |

### 处方状态

| 状态 | 值 | 说明 |
|------|-----|------|
| 待审核 | 0 | 医生已开方，等待审核 |
| 通过 | 1 | 审核通过 |
| 未通过 | 2 | 审核拒绝 |
| 无需审核 | 3 | 免审处方 |

### 处方开具流程

```mermaid
sequenceDiagram
    participant D as 医生
    participant C as PrescriptionController
    participant S as PrescriptionService
    participant M as PrescriptionModel
    participant DB as 数据库

    D->>C: POST prescription/add-chinese
    C->>S: addChinesePrescription(data)
    S->>S: validateData(data)
    S->>M: create(prescription)
    M->>DB: INSERT INTO yii_prescription
    S->>M: createChinese(items)
    M->>DB: INSERT INTO yii_prescription_chinese
    S-->>C: prescription_id
    C-->>D: 处方创建成功
```

---

## 处方审核

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `audit-prescription/list` | 待审处方列表 |
| GET | `audit-prescription/detail` | 处方详情 |
| POST | `audit-prescription/audit` | 审核操作 |
| POST | `audit-prescription/reject` | 拒绝操作 |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `AuditPrescriptionController` | `app/Http/Controllers/admin/business/prescription/AuditPrescriptionController.php` | 控制器 |
| `AuditPrescriptionService` | `app/Service/admin/business/prescription/AuditPrescriptionService.php` | 业务服务 |

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `PrescriptionModel` | `yii_prescription` | 主处方表 |

### 审核流程

```mermaid
sequenceDiagram
    participant A as 审核员
    participant C as AuditPrescriptionController
    participant S as AuditPrescriptionService
    participant M as PrescriptionModel

    A->>C: POST audit-prescription/audit
    C->>S: audit(prescription_id, action)
    S->>M: findById(prescription_id)
    S->>S: checkPermission(audit_user)
    
    alt 医生初审
        S->>M: update(status=1, first_view, first_sign)
    else 药师复审
        S->>M: update(status=1, again_view, again_sign)
    end
    
    S-->>C: audit_result
    C-->>A: 审核成功
```

---

## 转诊处方

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `transfer-prescription/list` | 转诊处方列表 |
| GET | `transfer-prescription/detail` | 转诊详情 |
| POST | `transfer-prescription/create` | 创建转诊 |
| POST | `transfer-prescription/confirm` | 确认转诊 |
| POST | `transfer-prescription/import` | 导入转诊 |
| POST | `transfer-prescription/cancel` | 取消转诊 |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `TransferPrescriptionController` | `app/Http/Controllers/admin/business/prescription/TransferPrescriptionController.php` | 控制器 |
| `TransferPrescriptionService` | `app/Service/admin/business/prescription/TransferPrescriptionService.php` | 业务服务 |
| `TransferPrescriptionModel` | `app/Models/old/prescription/TransferPrescriptionModel.php` | 模型 |
| `TransferQuestionService` | `app/Service/admin/business/prescription/TransferQuestionService.php` | 问题配置 |
| `TransferAssistantConfigService` | `app/Service/admin/business/prescription/TransferAssistantConfigService.php` | 助手配置 |

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `TransferPrescriptionModel` | `yii_transfer_prescription` | 转诊处方 |
| `TransferQuestionModel` | `xk_transfer_question` | 转诊问题 |
| `TransferPrescriptionQuestionModel` | `xk_transfer_prescription_question` | 转诊问答 |
| `TransferAssistantConfigModel` | `xk_transfer_assistant_config` | 转诊助手配置 |

### 转诊流程

```mermaid
sequenceDiagram
    participant O as 转诊方(发起)
    participant R as 接收方(接收)
    participant DB as 数据库

    O->>DB: 创建转诊处方(transfer_prescription)
    O->>O: 设置 is_from_transfer=1
    
    Note over O,R: 转诊方获得 100% 利润
    
    R->>DB: 确认接收
    R->>DB: 导入为注册订单(register)
    R->>DB: 创建处方(prescription)
    R->>DB: 设置 store_id = delegate_store_id
```

### 转诊分账规则

::: warning 关键逻辑
- 转诊方（发起方）获得 **100%** 利润
- 接收方（被转方）获得 **0%** 利润
- 处方来源自动设为接收方门店（`store_id = delegate_store_id`）
:::

---

## 常用处方

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `common-prescription/list` | 常用处方列表 |
| POST | `common-prescription/create` | 创建常用处方 |
| POST | `common-prescription/update` | 更新常用处方 |
| POST | `common-prescription/delete` | 删除常用处方 |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `CommonPrescriptionController` | `app/Http/Controllers/admin/business/doctor/CommonPrescriptionController.php` | 控制器 |
| `CommonPrescriptionService` | `app/Service/admin/business/doctor/CommonPrescriptionService.php` | 业务服务 |

---

## 转诊问题配置

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `transfer-question/list` | 问题列表 |
| POST | `transfer-question/create` | 创建问题 |
| POST | `transfer-question/update` | 更新问题 |
| POST | `transfer-question/delete` | 删除问题 |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `TransferQuestionController` | `app/Http/Controllers/admin/business/prescription/TransferQuestionController.php` | 控制器 |
| `TransferQuestionService` | `app/Service/admin/business/prescription/TransferQuestionService.php` | 业务服务 |

---

## 转诊助手配置

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `transfer-assistant-config/detail` | 助手配置详情 |
| POST | `transfer-assistant-config/update` | 更新助手配置 |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `TransferAssistantConfigController` | `app/Http/Controllers/admin/business/prescription/TransferAssistantConfigController.php` | 控制器 |
| `TransferAssistantConfigService` | `app/Service/admin/business/prescription/TransferAssistantConfigService.php` | 业务服务 |