relay-saas/docs/TODO.md

# 项目任务清单

> 本文档记录项目的所有开发任务和进度

---

## 📊 总体进度

- **Phase 1 - 基础架构**：0% (0/4)
- **Phase 2 - 套餐系统**：0% (0/4)
- **Phase 3 - 计费系统**：0% (0/4)
- **Phase 4 - 前端界面**：0% (0/4)
- **Phase 5 - 测试优化**：0% (0/4)

**总进度：** 0% (0/20)

---

## 🎯 Phase 1: 基础架构（预计2周）

### 1.1 数据库设计与实现
- [ ] 创建 `agent_sites` 表结构
- [ ] 创建 `agent_billing_logs` 表结构
- [ ] 编写数据库迁移脚本
- [ ] 测试表创建和索引

**优先级**：🔴 高
**预计工时**：2天
**负责人**：待分配

### 1.2 代理站点模型开发
- [ ] 创建 `model/agent_site.go`
- [ ] 实现 AgentSite 结构体
- [ ] 实现 CRUD 方法
- [ ] 实现站点 API Key 生成逻辑

**优先级**：🔴 高
**预计工时**：1天
**负责人**：待分配
**依赖**：1.1 完成

### 1.3 主系统代理中继接口
- [ ] 创建 `controller/agent_relay.go`
- [ ] 实现站点身份验证
- [ ] 实现额度检查逻辑
- [ ] 实现请求转发到上游渠道
- [ ] 添加路由配置

**优先级**：🔴 高
**预计工时**：3天
**负责人**：待分配
**依赖**：1.2 完成

### 1.4 代理站点转发逻辑
- [ ] 创建 `relay/proxy/master_proxy.go`
- [ ] 实现请求拦截
- [ ] 实现转发到主系统
- [ ] 添加重试和错误处理
- [ ] 配置环境变量支持

**优先级**：🔴 高
**预计工时**：2天
**负责人**：待分配
**依赖**：1.3 完成

---

## 🎯 Phase 2: 套餐系统（预计2周）

### 2.1 Token 表扩展
- [ ] 添加套餐相关字段到 tokens 表
- [ ] 编写数据库迁移脚本
- [ ] 更新 Token 模型结构体
- [ ] 测试字段添加

**优先级**：🟡 中
**预计工时**：1天
**负责人**：待分配

### 2.2 套餐定义和管理
- [ ] 创建 `common/subscription/plans.go`
- [ ] 定义套餐结构体和常量
- [ ] 实现套餐配置加载
- [ ] 创建套餐管理 API 接口

**优先级**：🟡 中
**预计工时**：2天
**负责人**：待分配
**依赖**：2.1 完成

### 2.3 额度检查逻辑
- [ ] 创建 `common/subscription/quota.go`
- [ ] 实现日/周/月额度检查
- [ ] 实现时间重置逻辑
- [ ] 添加到 TokenAuth 中间件
- [ ] 单元测试

**优先级**：🔴 高
**预计工时**：3天
**负责人**：待分配
**依赖**：2.2 完成

### 2.4 自动重置机制
- [ ] 创建定时任务
- [ ] 实现日重置（每日0点）
- [ ] 实现周重置（每周一）
- [ ] 实现月重置（每月1日）
- [ ] 测试跨时区场景

**优先级**：🟡 中
**预计工时**：2天
**负责人**：待分配
**依赖**：2.3 完成

---

## 🎯 Phase 3: 计费系统（预计2周）

### 3.1 代理计费日志表
- [ ] 完善 `agent_billing_logs` 表设计
- [ ] 创建日志模型 `model/agent_billing.go`
- [ ] 实现日志写入方法
- [ ] 添加索引优化查询

**优先级**：🔴 高
**预计工时**：1天
**负责人**：待分配

### 3.2 主系统计费记录
- [ ] 在 agent_relay 中添加计费逻辑
- [ ] 扣除代理站点额度
- [ ] 记录到 agent_billing_logs
- [ ] 实现异步批量写入

**优先级**：🔴 高
**预计工时**：3天
**负责人**：待分配
**依赖**：3.1 完成

### 3.3 额度同步机制
- [ ] 实现代理站点额度查询 API
- [ ] 实现额度同步定时任务
- [ ] 添加 Redis 缓存
- [ ] 测试高并发场景

**优先级**：🟡 中
**预计工时**：2天
**负责人**：待分配
**依赖**：3.2 完成

### 3.4 统计报表接口
- [ ] 创建 `controller/agent_stats.go`
- [ ] 实现代理站点消费统计
- [ ] 实现渠道使用统计
- [ ] 实现时间范围查询

**优先级**：🟢 低
**预计工时**：2天
**负责人**：待分配
**依赖**：3.3 完成

---

## 🎯 Phase 4: 前端界面（预计2周）

### 4.1 代理站点管理页面
- [ ] 创建代理站点列表页面
- [ ] 实现添加/编辑/删除功能
- [ ] 显示额度使用情况
- [ ] API Key 管理

**优先级**：🟡 中
**预计工时**：3天
**负责人**：待分配

### 4.2 套餐令牌管理页面
- [ ] 扩展令牌创建表单
- [ ] 添加套餐选择组件
- [ ] 显示日/周/月使用情况
- [ ] 额度预警提示

**优先级**：🟡 中
**预计工时**：3天
**负责人**：待分配
**依赖**：4.1 完成

### 4.3 计费统计报表页面
- [ ] 创建统计报表页面
- [ ] 实现图表展示（ECharts）
- [ ] 添加时间范围筛选
- [ ] 导出报表功能

**优先级**：🟢 低
**预计工时**：3天
**负责人**：待分配
**依赖**：4.2 完成

### 4.4 用户体验优化
- [ ] 添加加载状态
- [ ] 优化错误提示
- [ ] 响应式布局调整
- [ ] 多语言支持

**优先级**：🟢 低
**预计工时**：2天
**负责人**：待分配
**依赖**：4.3 完成

---

## 🎯 Phase 5: 测试优化（预计2周）

### 5.1 功能测试
- [ ] 编写单元测试
- [ ] 集成测试
- [ ] 端到端测试
- [ ] 测试覆盖率 > 60%

**优先级**：🔴 高
**预计工时**：3天
**负责人**：待分配

### 5.2 压力测试
- [ ] 准备测试数据
- [ ] 并发请求测试（1000 req/s）
- [ ] 数据库性能测试
- [ ] 内存和 CPU 监控

**优先级**：🟡 中
**预计工时**：2天
**负责人**：待分配
**依赖**：5.1 完成

### 5.3 安全加固
- [ ] SQL 注入防护测试
- [ ] XSS 防护测试
- [ ] API Key 安全审计
- [ ] 敏感数据加密

**优先级**：🔴 高
**预计工时**：2天
**负责人**：待分配
**依赖**：5.2 完成

### 5.4 文档完善
- [ ] API 接口文档
- [ ] 部署文档
- [ ] 用户使用手册
- [ ] 运维手册

**优先级**：🟡 中
**预计工时**：2天
**负责人**：待分配
**依赖**：5.3 完成

---

## 🚧 Bug 修复

> 开发过程中发现的 Bug 记录在此

暂无

---

## 💡 功能优化

> 非必需但可以改进的功能

暂无

---

## 📝 备注

- 每个任务完成后更新此文档
- 使用 `[x]` 标记已完成任务
- 优先级：🔴 高 / 🟡 中 / 🟢 低
- 预计工时仅供参考，实际可能有偏差

---

**最后更新**：2025-12-29
**文档版本**：v1.0