# 盒子自动下架功能文档

## 功能说明

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

## 实现逻辑

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`