bindbox-game/docs/优化抖音定时任务/TASK_优化抖音定时任务.md

TASK - 优化抖音定时任务

任务依赖图

graph TD
    T1[Task 1: 修改定时任务调度器] --> T3[Task 3: 测试定时任务]
    T2[Task 2: 新增管理后台接口] --> T4[Task 4: 测试管理接口]
    T3 --> T5[Task 5: 集成测试]
    T4 --> T5
    T5 --> T6[Task 6: 文档更新]

原子任务列表

Task 1: 修改定时任务调度器

文件: internal/service/douyin/scheduler.go

输入契约:

• 前置依赖: 无
• 输入数据: 现有 scheduler.go 代码
• 环境依赖: Go 1.24 编译环境

输出契约:

• 输出数据: 修改后的 scheduler.go
• 交付物:
  • 移除 FetchAndSyncOrders 调用
  • 改为多定时器模式 (5分钟/1小时/2小时)
• 验收标准:
  • 编译通过
  • 定时器逻辑正确
  • 日志输出清晰

实现约束:

• 使用 time.NewTicker
• 使用 select 多路复用
• 保持现有日志格式

依赖关系:

• 后置任务: Task 3
• 并行任务: Task 2

---

Task 2: 新增管理后台接口

文件: internal/api/admin/douyin_admin.go (新建)

输入契约:

• 前置依赖: 无
• 输入数据: douyin.Service 接口定义
• 环境依赖: 现有 admin 中间件

输出契约:

• 输出数据: 新文件 douyin_admin.go
• 交付物:
  • ManualSyncAll 接口
  • ManualSyncRefund 接口
  • ManualGrantPrizes 接口
• 验收标准:
  • 编译通过
  • 接口返回正确的 JSON
  • 权限控制生效

实现约束:

• 复用现有 core.HandlerFunc 模式
• 使用现有 admin 权限中间件
• 返回统一的响应格式

依赖关系:

• 后置任务: Task 4
• 并行任务: Task 1

---

Task 3: 测试定时任务

文件: 手动测试

输入契约:

• 前置依赖: Task 1 完成
• 输入数据: 修改后的 scheduler.go
• 环境依赖: 运行中的服务

输出契约:

• 输出数据: 测试报告
• 交付物:
  • 验证 5 分钟定时器触发
  • 验证 1 小时定时器触发
  • 验证 2 小时定时器触发
• 验收标准:
  • 日志显示正确的触发时间
  • 各任务独立执行
  • 无 panic 或错误

实现约束:

• 观察日志输出
• 可缩短定时器间隔加速测试

依赖关系:

• 前置任务: Task 1
• 后置任务: Task 5

---

Task 4: 测试管理接口

文件: 使用 curl 或 Postman

输入契约:

• 前置依赖: Task 2 完成
• 输入数据: 管理员 token
• 环境依赖: 运行中的服务

输出契约:

• 输出数据: 测试报告
• 交付物:
  • 验证 /sync-all 接口
  • 验证 /sync-refund 接口
  • 验证 /grant-prizes 接口
• 验收标准:
  • 返回正确的 JSON 响应
  • 无权限时返回 401/403
  • 数据库数据正确更新

实现约束:

• 使用真实的管理员 token
• 检查数据库变更

依赖关系:

• 前置任务: Task 2
• 后置任务: Task 5

---

Task 5: 集成测试

文件: 整体功能验证

输入契约:

• 前置依赖: Task 3, Task 4 完成
• 输入数据: 完整系统
• 环境依赖: 运行中的服务 + 数据库

输出契约:

• 输出数据: 集成测试报告
• 交付物:
  • 验证定时任务与手动触发不冲突
  • 验证前端按需同步仍正常
  • 验证 API 调用频率降低
• 验收标准:
  • 所有功能正常
  • 无数据丢失
  • 性能符合预期

实现约束:

• 运行至少 2 小时观察
• 监控日志和数据库

依赖关系:

• 前置任务: Task 3, Task 4
• 后置任务: Task 6

---

Task 6: 文档更新

文件: README 或运维文档

输入契约:

• 前置依赖: Task 5 完成
• 输入数据: 测试结果
• 环境依赖: 无

输出契约:

• 输出数据: 更新后的文档
• 交付物:
  • 定时任务说明
  • 管理接口使用指南
  • 性能优化效果
• 验收标准:
  • 文档清晰易懂
  • 包含示例代码

实现约束:

• Markdown 格式
• 包含 API 示例

依赖关系:

• 前置任务: Task 5
• 后置任务: 无

复杂度评估

任务	复杂度	预计时间	风险等级
Task 1	中	15 分钟	低
Task 2	中	20 分钟	中
Task 3	低	10 分钟	低
Task 4	低	10 分钟	低
Task 5	中	30 分钟	中
Task 6	低	10 分钟	低

总计: 约 95 分钟