65 lines
1.9 KiB
Markdown
Executable File
65 lines
1.9 KiB
Markdown
Executable File
# 盒子自动下架功能文档
|
||
|
||
## 功能说明
|
||
|
||
该功能实现了当盒子的利润率低于配置阈值时自动下架盒子，以保证系统的盈利能力。
|
||
|
||
## 实现逻辑
|
||
|
||
1. 当盒子的抽奖次数达到配置的阈值后，系统开始检测该盒子的利润情况
|
||
2. 计算公式：利润率 = (订单总价值 - 出货总价值) / 订单总价值 * 100%
|
||
3. 如果利润率低于配置的下架利润阈值，则自动下架盒子
|
||
4. 下架记录会保存到日志表中
|
||
5. 系统会自动排除测试用户的数据，确保计算结果准确反映真实用户的情况
|
||
|
||
## 安装步骤
|
||
|
||
### 1. 创建日志表
|
||
|
||
执行以下命令创建日志表：
|
||
|
||
```bash
|
||
php think CreateOffshelfLogTable
|
||
```
|
||
|
||
### 2. 添加定时任务
|
||
|
||
将以下定时任务添加到系统的crontab中：
|
||
|
||
```bash
|
||
# 每小时执行一次盒子自动下架检测
|
||
* */1 * * * cd /www/wwwroot/192.168.195.11 && php think AutoGoodsOffshelf >> /www/wwwroot/192.168.195.11/runtime/log/offshelf_$(date +\%Y\%m\%d).log 2>&1
|
||
```
|
||
|
||
## 使用说明
|
||
|
||
### 在盒子编辑/添加页面中配置：
|
||
|
||
1. **自动下架开关**：开启或关闭自动下架功能
|
||
2. **下架利润值(%)**：当利润率低于此值时，盒子将自动下架
|
||
3. **下架抽数阈值**：当盒子抽奖次数达到此阈值后，开始检测利润率
|
||
|
||
### 查看下架记录
|
||
|
||
可以在 `goods_offshelf_log` 表中查看所有自动下架的记录，包含以下信息：
|
||
|
||
- 盒子ID
|
||
- 当前利润率
|
||
- 配置的下架利润阈值
|
||
- 订单总价值
|
||
- 出货总价值
|
||
- 下架时间
|
||
|
||
## 手动执行
|
||
|
||
如需手动执行自动下架检测，可运行以下命令：
|
||
|
||
```bash
|
||
php think AutoGoodsOffshelf
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. 确保盒子配置了正确的下架利润值和抽数阈值
|
||
2. 下架后的盒子状态将变为"已下架"，需要手动重新上架
|
||
3. 日志文件保存在 `runtime/log/` 目录下，文件名格式为 `offshelf_YYYYMMDD.log` |