240 lines
5.0 KiB
Markdown
240 lines
5.0 KiB
Markdown
# 药品库系统安装指南
|
|
|
|
## 功能概述
|
|
|
|
药品库管理系统提供了完整的中药材管理功能，包括：
|
|
|
|
- 药材名称管理
|
|
- 供应商信息管理
|
|
- 单位规格管理
|
|
- 价格管理（结算价、零售价）
|
|
- 库存管理
|
|
- 药品图片上传
|
|
- 状态管理（启用/停用）
|
|
- 备注信息
|
|
|
|
## 安装步骤
|
|
|
|
### 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. 数据保存失败
|
|
|
|
- 检查必填字段是否填写完整
|
|
- 检查价格格式是否正确
|
|
- 检查网络连接是否正常
|
|
|
|
## 技术支持
|
|
|
|
如有问题，请联系技术支持团队。
|