API 開發與介面整合

請為當前項目設計並實現一套完整的用戶管理 RESTful API。

功能需求：
- 用戶註冊（郵箱 + 密碼，密碼加密存儲）
- 用戶登入（JWT token 認證）
- 獲取用戶信息（需要鑑權）
- 修改用戶資料（需要鑑權）
- 用戶列表（分頁、搜尋、管理員權限）

技術要求：
1. RESTful 風格，正確使用 HTTP 方法和狀態碼
2. 請求參數校驗（用 Joi/Zod/Pydantic，取決於項目語言）
3. 統一回應格式：{ code, data, message }
4. 完整的錯誤處理和日誌記錄
5. 生成 Swagger/OpenAPI 文件
6. 生成 Postman/Insomnia 測試集合

請根據當前項目的技術棧來實現，保持一致的代碼風格。

這是一個第三方服務的 API 文件：

[貼上 Swagger/OpenAPI JSON 或 URL]

請根據這個文件生成一個 TypeScript SDK 客戶端：
1. 為每個接口生成對應的方法（帶完整類型定義）
2. 統一的 HTTP 客戶端（基於 axios/fetch）
3. 請求攔截器：自動帶上 Authorization header
4. 回應攔截器：統一錯誤處理和重試邏輯
5. 支持請求超時和取消
6. 導出所有 TypeScript 類型定義
7. 寫好 README 和使用示例

SDK 要支持 Tree-shaking，按需導入不打包用不到的接口。

請為當前項目的 API 服務添加以下中介軟體：

1. 限流中介軟體（Rate Limiting）：
   - 預設每個 IP 每分鐘 60 次請求
   - 登入接口每個 IP 每分鐘 5 次
   - 傳回 X-RateLimit-* 回應頭
   - 超限傳回 429 + 友善的錯誤信息

2. 鑑權中介軟體（Authentication）：
   - JWT Token 驗證
   - Token 過期自動刷新（Refresh Token 機制）
   - 角色權限檢查（admin / user / guest）

3. 日誌中介軟體（Logging）：
   - 記錄每個請求的方法、路徑、耗時、狀態碼
   - 錯誤請求自動記錄請求體和堆棧
   - 日誌格式適配 ELK 或 CloudWatch

確保中介軟體的執行順序正確，並給出註冊到路由的代碼。