# 药品库系统安装指南

## 功能概述

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

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

## 安装步骤

### 1. 数据库安装

#### Windows 系统

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

```bash
install_medicine_library.bat
```

#### Linux/Mac 系统

执行以下命令：

```bash
chmod +x install_medicine_library.sh
./install_medicine_library.sh
```

或者手动导入 SQL 文件：

```bash
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. 数据保存失败

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

## 技术支持

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