chore: initial commit with CI pipeline, review and tasks docs

This commit is contained in:
Your Name
2025-09-30 16:39:51 +08:00
commit 8a7afc8a00
76 changed files with 5091 additions and 0 deletions

View File

@@ -0,0 +1,32 @@
# 开发任务列表: 004 - 系统能力与集成
基于实施计划,为“系统能力与集成”功能分解出以下开发任务。
## 后端 (Backend)
### 核心服务与数据库
- [ ] **BE-DB-08**: 创建 `processed_callbacks` 表的数据库迁移脚本。
- [ ] **BE-DB-09**: 更新 `invitations` 表的迁移脚本,增加 `ip_address``user_agent` 字段。
- [ ] **BE-DB-10**: 创建 `failed_reward_jobs` 表的数据库迁移脚本。
- [ ] **BE-SETUP-01**: 在项目中安装、配置并初始化消息队列服务(如 RabbitMQ 或 BullMQ
- [ ] **BE-WORKER-01**: 创建奖励发放Worker服务的基本结构并连接到消息队列。
### API & 业务逻辑
- [ ] **BE-API-14**: 开发一个可重用的 `X-API-Key` 认证中间件。
- [ ] **BE-API-15**: 开发一个可重用的、基于Redis的可配置速率限制中间件。
- [ ] **BE-API-16**: 实现 `POST /api/v1/callback/register` 接口的完整逻辑,包括认证、速率限制、幂等性检查和向队列分发任务。
- [ ] **BE-TEST-04**: 为回调API编写完整的测试用例特别是要覆盖幂等性和速率限制的场景。
### 异步任务 Worker
- [ ] **BE-WORKER-02**: 在Worker中实现调用外部奖励API的逻辑使用适配器模式
- [ ] **BE-WORKER-03**: 在Worker中实现任务失败后的重试逻辑指数退避延迟
- [ ] **BE-WORKER-04**: 在Worker中实现任务重试耗尽后将任务存入 `failed_reward_jobs` 表的逻辑。
- [ ] **BE-ALERT-01**: 实现一个简单的通知服务,当有新条目写入 `failed_reward_jobs` 时,向管理员发送警报。
## 前端 (Frontend)
- [ ] **FE-UI-16**: (可选)在管理后台创建一个简单的页面,用于展示和管理失败的奖励发放任务。
- [ ] **FE-API-04**: 可选为上述页面开发一个获取失败任务列表的API请求函数。