# 编码标准
- category: coding
- priority: critical

## 概述
项目的核心编码标准和最佳实践。

## Go特定标准
- 遵循Go命名约定（驼峰命名法、帕斯卡命名法）
- 使用 `gofmt` 进行代码格式化
- 显式处理错误，不要忽略
- 使用接口进行抽象

## 错误处理
- 始终检查并处理错误
- 使用结构化错误类型
- 使用 `fmt.Errorf` 包装带有上下文的错误
- 返回有意义的错误消息

## 测试
- 为所有公共函数编写单元测试
- 使用表驱动测试处理多个测试用例
- 实现至少80%的代码覆盖率

# 架构模式
- category: architecture
- priority: critical

## 设计原则
- **单一职责**：每个组件只有一个变更原因
- **依赖倒置**：依赖抽象，而不是具体实现

## 推荐模式

### 存储库模式
- 封装数据访问逻辑
- 为数据操作提供一致的接口
- 支持使用模拟实现进行轻松测试

### 分层架构
┌─────────────────────┐
│   Presentation      │  ← HTTP handlers, CLI
├─────────────────────┤
│   Business Logic    │  ← Domain models, use cases
├─────────────────────┤
│   Data Access       │  ← Repositories, databases
└─────────────────────┘

# API文档
- category: architecture
- tags: api, rest, authentication

## 认证端点

### POST /auth/login
**请求：**
```json
{
  "email": "user@example.com",
  "password": "secure_password"
}

响应：

{
  "token": "jwt_token_here",
  "user": {
    "id": 123,
    "email": "user@example.com",
    "role": "user"
  }
}

GET /auth/me

请求头： Authorization: Bearer <token>

响应：

{
  "user": {
    "id": 123,
    "email": "user@example.com",
    "role": "user"
  }
}

错误处理

所有端点返回的错误格式如下：

{
  "error": "error_code",
  "message": "Human readable message"
}

</details>

---

### ✅ 待办事项文件

> **位置：** `.buddy/todos/`  
> **用途：** 跟踪任务、功能和项目进度

#### 📝 格式要求
- ✅ 使用Markdown格式（`.md`）
- ✅ 使用复选框语法：`- [ ]`（未完成）或 `- [x]`（已完成）
- ✅ 将相关任务分组在清晰的标题下
- ✅ 为每个任务包含上下文和详细信息

#### 🔐 示例：功能开发

<details>
<summary>点击展开功能开发示例</summary>

```markdown
# 认证功能

## 后端实现
- [x] 设置JWT库
- [x] 创建用户模型和数据库迁移
- [x] 使用bcrypt实现密码哈希
- [ ] 创建登录端点
- [ ] 创建注册端点
- [ ] 添加受保护路由的中间件
- [ ] 为认证服务编写单元测试
- [ ] 为认证端点添加集成测试

## 前端实现
- [ ] 创建登录表单组件
- [ ] 创建注册表单组件
- [ ] 实现JWT令牌存储
- [ ] 添加认证上下文
- [ ] 创建受保护路由包装器
- [ ] 处理令牌刷新逻辑

## 安全与测试
- [ ] 为认证端点添加速率限制
- [ ] 实现失败尝试后账户锁定功能
- [ ] 添加密码强度验证
- [ ] 对认证实现进行安全审计
- [ ] 对认证端点进行负载测试

-- 用户表
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    email VARCHAR(255) UNIQUE NOT NULL,
    password_hash VARCHAR(255) NOT NULL,
    role VARCHAR(50) DEFAULT 'user',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 用于JWT黑名单的会话表
CREATE TABLE sessions (
    id SERIAL PRIMARY KEY,
    user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
    token_hash VARCHAR(255) UNIQUE NOT NULL,
    expires_at TIMESTAMP NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 性能索引
CREATE INDEX idx_users_email ON users(email);
CREATE INDEX idx_sessions_token_hash ON sessions(token_hash);
CREATE INDEX idx_sessions_expires_at ON sessions(expires_at);