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

确保中间件的执行顺序正确，并给出注册到路由的代码。