# 編碼標準
- 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);