# 定时任务说明

Docker 部署包含两个定时任务容器，替代原 Windows 环境的 `HttpRequestService.exe` 和 `autorun.cmd`。

---

## syncjob — 实时同步任务

**替代：** Windows `HttpRequestService.exe`（通过 `HttpRequest.exe.json` 配置）

**作用：** 每 30 秒 POST 请求 `dlweb/ext/Synchronize.php`，从游戏数据库 `ct_user_process_log` 表消费未处理日志，将玩家/代理数据同步到代理后台数据库。

**运行方式：** 通过 Docker 内网直连 `http://dlweb/ext/Synchronize.php`，不经过公网域名，零流量消耗。

### 可配置项（`.env`）

```bash
# 轮询间隔（秒），默认 30
SYNC_INTERVAL=30

# 每次处理的日志条数，默认 200
SYNC_PROCESSCOUNT=200
```

### 查看同步日志

```bash
./deploy.sh logs syncjob
# 或实时查看
docker logs -f youle-syncjob
```

### 调整同步频率

```bash
# 修改 .env
SYNC_INTERVAL=15        # 15 秒一次
SYNC_PROCESSCOUNT=500   # 每次处理 500 条

# 重启 syncjob
docker compose restart syncjob
```

---

## cronjob — 每日定时任务

**替代：** Windows 计划任务调用的 `tools-docker/autorun.cmd`

**作用：** 每日凌晨 4:00 执行以下流程（与原 `autorun.cmd` 完全一致）：

| 步骤 | 原 autorun.cmd | Docker cronjob |
|------|---------------|----------------|
| 1. 停止同步服务 | `net stop HttpRequestService` | 创建 `/shared/syncjob.pause` 信号文件 |
| 2. 等待当前请求完成 | （Windows 服务立即停止） | `sleep 5` |
| 3. 同步报表数据 | `HttpRequest.exe POST SynchronizeReportData.php` | `curl POST http://dlweb/ext/SynchronizeReportData.php` |
| 4. 恢复同步服务 | `net start HttpRequestService` | 删除 `/shared/syncjob.pause` 信号文件 |

> **暂停机制：** `syncjob` 和 `cronjob` 通过共享 Docker volume（`shared-signal`）通信。`cronjob` 创建 `/shared/syncjob.pause` 文件时，`syncjob` 会自动跳过轮询，报表同步完成后删除该文件恢复。

### 可配置项（`.env`）

```bash
# cron 表达式，默认凌晨 4:00
CRON_SCHEDULE=0 4 * * *
```

**修改执行时间示例：**

```bash
# 凌晨 3:30 执行
CRON_SCHEDULE=30 3 * * *

# 每天凌晨 2:00 和 14:00 各执行一次
CRON_SCHEDULE=0 2,14 * * *
```

### 查看执行日志

```bash
./deploy.sh logs cronjob
# 或实时查看
docker logs -f youle-cronjob
```

### 手动触发（测试用）

```bash
docker exec youle-cronjob /bin/sh /app/daily-task.sh
```

### 调整每日任务执行时间

```bash
# 修改 .env
CRON_SCHEDULE=30 3 * * *   # 改为凌晨 3:30

# 重启 cronjob
docker compose restart cronjob
```

---

## 临时停止定时任务（维护数据库时）

```bash
docker compose stop syncjob cronjob
# 维护完成后恢复
docker compose up -d syncjob cronjob
```