xk-docs/docs/projects/xk-api/modules/special-prescription.md

# 特色处方模块

## 概述

特色处方模块是 XK 系统的特色功能，提供标准化的处方产品，具有独立的 SKU 和定价体系。

---

## 特色处方管理

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `special-prescription/list` | 处方列表 |
| GET | `special-prescription/detail` | 处方详情 |
| POST | `special-prescription/create` | 创建处方 |
| POST | `special-prescription/update` | 更新处方 |
| POST | `special-prescription/status` | 上下架 |
| GET | `special-prescription/sku-list` | SKU 列表 |
| POST | `special-prescription/sku/create` | 创建 SKU |
| POST | `special-prescription/sku/update` | 更新 SKU |
| POST | `special-prescription/sku/delete` | 删除 SKU |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `SpecialPrescriptionController` | `app/Http/Controllers/admin/business/special_prescription/SpecialPrescriptionController.php` | 控制器 |
| `SpecialPrescriptionService` | `app/Service/admin/business/special_prescription/SpecialPrescriptionService.php` | 业务服务 |
| `SpecialPrescriptionPriceConfigService` | `app/Service/admin/business/special_prescription/SpecialPrescriptionPriceConfigService.php` | 价格配置 |
| `SpecialPrescriptionPriceResolver` | `app/Service/admin/business/special_prescription/SpecialPrescriptionPriceResolver.php` | 价格解析 |
| `SpecialPrescriptionPriceDistributor` | `app/Service/admin/business/special_prescription/SpecialPrescriptionPriceDistributor.php` | 价格分发 |
| `SpecialPrescriptionShippingResolver` | `app/Service/admin/business/special_prescription/SpecialPrescriptionShippingResolver.php` | 运费解析 |

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `SpecialPrescriptionModel` | `xk_special_prescription` | 特色处方主表 |
| `SpecialPrescriptionSkuModel` | `xk_special_prescription_sku` | SKU 剂量规格 |
| `SpecialPrescriptionDrugPriceModel` | `xk_special_prescription_drug_price` | 药品分摊价格 |
| `SpecialPrescriptionIntroductionImageModel` | `xk_special_prescription_introduction_images` | 介绍图片 |

### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `prescription_sub_type` | tinyint | 1=中药, 2=西药, 3=颗粒 |
| `name` | varchar | 处方名称 |
| `category_id` | int | 分类 ID |
| `cover_image` | varchar | 封面图 |
| `intro_text` | mediumtext | 介绍文本 |
| `tags` | json | 标签 |
| `price_per_dose` | decimal | 每剂价格 |
| `price_calc_scheme` | tinyint | 1=固定价, 3=门店浮动价 |
| `buy_price_per_dose` | decimal | 每剂采购价 |
| `sale_price_per_dose` | decimal | 每剂销售价 |
| `sales_count` | int | 销量 |
| `status` | tinyint | 状态 |
| `is_free_shipping` | tinyint | 是否包邮 |
| `free_shipping_min_doses` | int | 包邮最小剂量数 |
| `store_id` | int | 门店 ID |

---

## 特色处方分类

### 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `special-prescription-category/list` | 分类列表 |
| POST | `special-prescription-category/create` | 创建分类 |
| POST | `special-prescription-category/update` | 更新分类 |
| POST | `special-prescription-category/delete` | 删除分类 |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `SpecialPrescriptionCategoryController` | `app/Http/Controllers/admin/business/special_prescription/SpecialPrescriptionCategoryController.php` | 控制器 |
| `SpecialPrescriptionCategoryService` | `app/Service/admin/business/special_prescription/SpecialPrescriptionCategoryService.php` | 业务服务 |

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `SpecialPrescriptionCategoryModel` | `xk_special_prescription_category` | 处方分类 |

---

## SKU 管理

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `SpecialPrescriptionSkuModel` | `xk_special_prescription_sku` | SKU 剂量规格 |

### SKU 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `special_prescription_id` | int | 特色处方 ID |
| `store_id` | int | 门店 ID |
| `sku_name` | varchar | SKU 名称（如"7剂"） |
| `dose_count` | int | 剂量数 |
| `status` | tinyint | 状态 |
| `is_free_shipping` | tinyint | 是否包邮 |
| `is_default` | tinyint | 是否默认 SKU |
| `buy_price` | decimal | 采购价 |
| `sale_price` | decimal | 销售价 |
| `sort` | int | 排序 |

---

## 药品分摊价格

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `SpecialPrescriptionDrugPriceModel` | `xk_special_prescription_drug_price` | 药品分摊价格 |

### 分摊逻辑

```mermaid
graph TB
    subgraph 特色处方
        SP[特色处方总价]
    end

    subgraph SKU
        SKU1[SKU1: 7剂 ¥70]
        SKU2[SKU2: 14剂 ¥130]
        SKU3[SKU3: 21剂 ¥189]
    end

    subgraph 药品分摊
        DRUG1[药品A: ¥10/剂]
        DRUG2[药品B: ¥8/剂]
        DRUG3[药品C: ¥5/剂]
        DRUG4[药品D: ¥7/剂]
    end

    SP --> SKU1
    SP --> SKU2
    SP --> SKU3
    SKU1 --> DRUG1
    SKU1 --> DRUG2
    SKU1 --> DRUG3
    SKU1 --> DRUG4
```

---

## 特色处方订单

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `SpecialPrescriptionOrderModel` | `xk_special_prescription_order` | 处方订单快照 |

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `SpecialPrescriptionOrderPricingService` | `app/Service/admin/business/special_prescription/SpecialPrescriptionOrderPricingService.php` | 订单定价 |
| `SpecialPrescriptionPackageOrderItemBuilder` | `app/Service/admin/business/special_prescription/SpecialPrescriptionPackageOrderItemBuilder.php` | 订单项构建 |

---

## 患者处方记录

### 关联模型

| 模型 | 表名 | 说明 |
|------|------|------|
| `SpecialPrescriptionPatientRecordModel` | `xk_special_prescription_patient_record` | 患者处方记录 |

### 状态流转

```mermaid
stateDiagram-v2
    [*] --> 待应用: 患者选择
    待应用 --> 已应用: 应用到处方
    已应用 --> 完成: 购药完成
    待应用 --> 取消: 患者取消
```

---

## 特色处方模板

### 关联类

| 类 | 文件 | 说明 |
|----|------|------|
| `SpecialPrescriptionTemplateService` | `app/Service/admin/business/special_prescription/SpecialPrescriptionTemplateService.php` | 模板服务 |