manghe/README_AUTO_OFFSHELF.md

盒子自动下架功能文档

功能说明

该功能实现了当盒子的利润率低于配置阈值时自动下架盒子，以保证系统的盈利能力。

实现逻辑

1. 当盒子的抽奖次数达到配置的阈值后，系统开始检测该盒子的利润情况
2. 计算公式：利润率 = (订单总价值 - 出货总价值) / 订单总价值 * 100%
3. 如果利润率低于配置的下架利润阈值，则自动下架盒子
4. 下架记录会保存到日志表中
5. 系统会自动排除测试用户的数据，确保计算结果准确反映真实用户的情况

安装步骤

1. 创建日志表

执行以下命令创建日志表：

php think CreateOffshelfLogTable

2. 添加定时任务

将以下定时任务添加到系统的crontab中：

# 每小时执行一次盒子自动下架检测
* */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
• 当前利润率
• 配置的下架利润阈值
• 订单总价值
• 出货总价值
• 下架时间

手动执行

如需手动执行自动下架检测，可运行以下命令：

php think AutoGoodsOffshelf

注意事项

1. 确保盒子配置了正确的下架利润值和抽数阈值
2. 下架后的盒子状态将变为"已下架"，需要手动重新上架
3. 日志文件保存在 runtime/log/ 目录下，文件名格式为 offshelf_YYYYMMDD.log