oadmin/relay-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
relay-saas/docs/TODO.md
huangzhenpc 91cbf92c13
Some checks failed
CI / Unit tests (push) Has been cancelled
Details
CI / commit_lint (push) Has been cancelled
Details
[项目管理] 添加开发规范和任务管理文档 
- 添加 Claude 项目开发指引 (.claude/project-instructions.md)
- 添加开发记录文档 (docs/DEVELOPMENT.md)
- 添加详细任务清单 (docs/TODO.md)
- 添加部署配置文档 (docs/DEPLOYMENT.md)

包含：开发流程规范、任务追踪、Git工作流、部署指南
2025-12-29 23:02:49 +08:00

6.0 KiB
Raw Permalink Blame History

项目任务清单

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

📊 总体进度

  • 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