zyt/MEDICINE_LIBRARY_GUIDE.md

药品库系统安装指南

功能概述

药品库管理系统提供了完整的中药材管理功能，包括：

• 药材名称管理
• 供应商信息管理
• 单位规格管理
• 价格管理（结算价、零售价）
• 库存管理
• 药品图片上传
• 状态管理（启用/停用）
• 备注信息

安装步骤

1. 数据库安装

Windows 系统

双击运行 install_medicine_library.bat 文件，按提示输入数据库信息：

install_medicine_library.bat

Linux/Mac 系统

执行以下命令：

chmod +x install_medicine_library.sh
./install_medicine_library.sh

或者手动导入 SQL 文件：

mysql -h localhost -u root -p your_database < install_medicine_library.sql

2. 后端文件说明

安装脚本会创建以下文件：

server/
├── app/
│   ├── adminapi/
│   │   ├── controller/doctor/
│   │   │   └── MedicineController.php      # 药品控制器
│   │   ├── logic/doctor/
│   │   │   └── MedicineLogic.php           # 药品业务逻辑
│   │   ├── validate/doctor/
│   │   │   └── MedicineValidate.php        # 药品验证器
│   │   └── lists/doctor/
│   │       └── MedicineLists.php           # 药品列表
│   └── common/
│       └── model/doctor/
│           └── Medicine.php                 # 药品模型

3. 前端文件说明

admin/
├── src/
│   ├── api/
│   │   └── medicine.ts                      # 药品API接口
│   └── views/doctor/
│       └── medicine.vue                     # 药品管理页面

4. 数据库表结构

创建的数据表：la_doctor_medicine

字段名	类型	说明
id	int	主键ID
name	varchar(100)	药材名称
supplier	varchar(100)	供应商名称
unit	varchar(20)	单位
settlement_price	decimal(10,2)	结算价
retail_price	decimal(10,2)	零售价
stock	int	库存数量
image	varchar(255)	药品图片
status	tinyint(1)	状态：0=停用，1=启用
remark	varchar(500)	备注
create_time	int	创建时间
update_time	int	更新时间
delete_time	int	删除时间

功能使用

1. 访问药品库

登录后台管理系统后，访问：/doctor/medicine

2. 添加药品

1. 点击右上角"添加药品"按钮
2. 填写药品信息：
   • 药材名称（必填）
   • 供应商名称（必填）
   • 单位（必填，可选择：克、千克、斤、盒、瓶、袋、包、片、粒、支）
   • 结算价（必填）
   • 零售价（必填）
   • 库存数量
   • 药品图片（支持jpg、png格式，大小不超过2MB）
   • 状态（启用/停用）
   • 备注信息
3. 点击"确定"保存

3. 编辑药品

1. 在列表中找到需要编辑的药品
2. 点击"编辑"按钮
3. 修改药品信息
4. 点击"确定"保存

4. 删除药品

1. 在列表中找到需要删除的药品
2. 点击"删除"按钮
3. 确认删除操作

5. 查询药品

支持按以下条件查询：

• 药材名称（模糊搜索）
• 供应商名称（模糊搜索）

6. 库存管理

• 库存为0时显示红色标签（危险）
• 库存小于10时显示黄色标签（警告）
• 库存充足时显示绿色标签（正常）

API 接口说明

1. 获取药品列表

GET /api/doctor.medicine/lists

参数：

• page_no: 页码
• page_size: 每页数量
• name: 药材名称（可选）
• supplier: 供应商名称（可选）

2. 添加药品

POST /api/doctor.medicine/add

参数：

• name: 药材名称
• supplier: 供应商名称
• unit: 单位
• settlement_price: 结算价
• retail_price: 零售价
• stock: 库存
• image: 图片URL
• status: 状态
• remark: 备注

3. 编辑药品

POST /api/doctor.medicine/edit

参数：同添加接口，需额外传入 id

4. 删除药品

POST /api/doctor.medicine/delete

参数：

• id: 药品ID

5. 药品详情

GET /api/doctor.medicine/detail

参数：

• id: 药品ID

示例数据

安装脚本会自动插入5条示例数据：

1. 当归 - 同仁堂
2. 黄芪 - 云南白药
3. 枸杞子 - 宁夏枸杞
4. 人参 - 长白山人参
5. 甘草 - 内蒙古甘草

注意事项

1. 确保数据库连接信息正确
2. 确保有足够的数据库权限
3. 图片上传需要配置正确的上传接口
4. 建议定期备份药品数据
5. 价格字段保留两位小数
6. 库存不能为负数

常见问题

1. 安装失败

• 检查数据库连接信息是否正确
• 检查数据库用户是否有创建表的权限
• 检查数据库是否已存在同名表

2. 图片上传失败

• 检查上传接口配置
• 检查文件大小是否超过限制
• 检查文件格式是否支持

3. 数据保存失败

• 检查必填字段是否填写完整
• 检查价格格式是否正确
• 检查网络连接是否正常

技术支持

如有问题，请联系技术支持团队。