[项目管理] 添加开发规范和任务管理文档

- 添加 Claude 项目开发指引 (.claude/project-instructions.md)
- 添加开发记录文档 (docs/DEVELOPMENT.md)
- 添加详细任务清单 (docs/TODO.md)
- 添加部署配置文档 (docs/DEPLOYMENT.md)

包含：开发流程规范、任务追踪、Git工作流、部署指南

docs/TODO.md

@@ -0,0 +1,284 @@
+# 项目任务清单
+
+> 本文档记录项目的所有开发任务和进度
+
+---
+
+## 📊 总体进度
+
+- **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