Files
xk-docs/docs/projects/xk-api/modules/drug.md
2026-07-08 15:04:42 +08:00

6.9 KiB

药品管理模块

概述

药品管理模块负责药品目录、分类、定价、仓库管理、价格同步等。


西药/中成药

接口

方法 路径 说明
GET western-medicine/list 药品列表
GET western-medicine/detail 药品详情
POST western-medicine/create 创建药品
POST western-medicine/update 更新药品
POST western-medicine/status 上下架

关联类

文件 说明
WesternMedicineController app/Http/Controllers/admin/business/product/WesternMedicineController.php 控制器
WesternMedicineService app/Service/admin/business/product/WesternMedicineService.php 业务服务

关联模型

模型 表名 说明
DrugModel yii_drug 药品主表
DrugStoreRelationsModel yii_drug_store_relations 药品-门店定价

中药

接口

方法 路径 说明
GET china-medicine/list 中药列表
GET china-medicine/detail 中药详情
POST china-medicine/create 创建中药
POST china-medicine/update 更新中药

关联类

文件 说明
ChinaMedicineController app/Http/Controllers/admin/business/product/ChinaMedicineController.php 控制器
ChinaMedicineService app/Service/admin/business/product/ChinaMedicineService.php 业务服务

关联模型

模型 表名 说明
DrugModel yii_drug 药品主表
DrugNatureModel yii_drug_nature 药品配伍(十八反十九畏)

中药配伍禁忌

类型 常量 说明
十八反 OPPOSITION 相反药物不能同用
十九畏 CONFLICT 相畏药物需谨慎
有毒药材 POISONOUS 有毒性药材

保健食品

接口

方法 路径 说明
GET health-food/list 保健食品列表
POST health-food/create 创建
POST health-food/update 更新

关联类

文件 说明
HealthFoodController app/Http/Controllers/admin/business/product/HealthFoodController.php 控制器
HealthFoodService app/Service/admin/business/product/HealthFoodService.php 业务服务

非药品/医疗器械

接口

方法 路径 说明
GET non-drug/list 非药品列表
POST non-drug/create 创建
GET medical-device/list 医疗器械列表
POST medical-device/create 创建

关联类

文件 说明
NonDrugController app/Http/Controllers/admin/business/product/NonDrugController.php 非药品控制器
MedicalDeviceController app/Http/Controllers/admin/business/product/MedicalDeviceController.php 医疗器械控制器
NonDrugService app/Service/admin/business/product/NonDrugService.php 非药品服务
MedicalDeviceService app/Service/admin/business/product/MedicalDeviceService.php 医疗器械服务

药品分类

接口

方法 路径 说明
GET drug-categories/list 分类列表
POST drug-categories/create 创建分类
POST drug-categories/update 更新分类
POST drug-categories/delete 删除分类

关联类

文件 说明
DrugCategoriesController app/Http/Controllers/admin/business/product/DrugCategoriesController.php 控制器
DrugCategoriesService app/Service/admin/business/product/DrugCategoriesService.php 业务服务

关联模型

模型 表名 说明
DrugCategoriesModel yii_drug_categories 药品分类

仓库管理

接口

方法 路径 说明
GET warehouse-drug-management/list 仓库药品列表
POST warehouse-drug-management/update-price 更新价格
POST warehouse-drug-management/update-status 更新状态
GET warehouse-drug-management-store/list 门店药品列表
POST warehouse-drug-management-store/sync 同步到门店

关联类

文件 说明
WarehouseDrugManagementController app/Http/Controllers/admin/business/warehouseDrugManagement/WarehouseDrugManagementController.php 仓库控制器
WarehouseDrugManagementStoreController app/Http/Controllers/admin/business/warehouseDrugManagement/WarehouseDrugManagementStoreController.php 门店控制器
WarehouseDrugManagementService app/Service/admin/business/warehouseDrugManagement/WarehouseDrugManagementService.php 仓库服务
WarehouseDrugManagementStoreService app/Service/admin/business/warehouseDrugManagement/WarehouseDrugManagementStoreService.php 门店服务

关联模型

模型 表名 说明
DrugStoreModel yii_drugstore 药品仓库
DrugStoreDrugModel yii_drugstore_drug 仓库药品
DrugStoreRelationsModel yii_drug_store_relations 药品-门店定价

价格同步流程

sequenceDiagram
    participant WH as 仓库
    participant API as xk-api
    participant STORE as 门店

    WH->>API: 价格变更
    API->>API: BatchSyncDrugPriceJob
    API->>STORE: 同步采购价(warehouse * z_buy_percent)
    API->>STORE: 同步销售价(warehouse * z_sale_percent)
    STORE->>STORE: 更新 yii_drug_store_relations

关联 Job

Job 文件 说明
BatchSyncDrugPriceJob app/Jobs/admin/store/BatchSyncDrugPriceJob.php 批量同步价格
SyncDrugPriceBySubscribeJob app/Jobs/admin/store/SyncDrugPriceBySubscribeJob.php 订阅同步
SyncSingleDrugPriceBySubscribeJob app/Jobs/admin/store/SyncSingleDrugPriceBySubscribeJob.php 单品同步
UpdateStoreChinesePriceByRatioJob app/Jobs/admin/products/UpdateStoreChinesePriceByRatioJob.php 按比例更新中药价格
UpdateStoreChineseSalePriceJob app/Jobs/admin/products/UpdateStoreChineseSalePriceJob.php 更新中药销售价百分比

加工费管理

接口

方法 路径 说明
GET process/list 加工费列表
POST process/create 创建加工费
POST process/update 更新加工费

关联类

文件 说明
ProsessController app/Http/Controllers/admin/system/ProsessController.php 控制器
ProcessService app/Service/admin/system/ProcessService.php 业务服务

关联模型

模型 表名 说明
ProcessRuleModel yii_process_rule 加工规则
ProcessRuleNoteModel yii_process_rule_note 加工规则说明