- 重构根目录CLAUDE.md为项目总览(60行精简版) - 细化backend模块CLAUDE.md为开发指南 - 新增各子模块CLAUDE.md文件: - api/desc/ - API定义模块 - internal/handler/ - 请求处理器 - internal/logic/ - 业务逻辑层 - internal/model/ - 数据模型层 - internal/middleware/ - 中间件层 - internal/svc/ - 服务上下文 - configs/ - 配置目录 - deploy/ - 部署配置 - pkg/ - 公共库 - scripts/ - 工具脚本 - configs/sql/ - SQL脚本 - 修复PostgreSQL SSL配置参数 - 清理旧的backend-old目录 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
46
backend/internal/middleware/CLAUDE.md
Normal file
46
backend/internal/middleware/CLAUDE.md
Normal file
@ -0,0 +1,46 @@
|
||||
# Middleware层 - 中间件
|
||||
|
||||
## 📋 文件结构
|
||||
```
|
||||
internal/middleware/
|
||||
├── auth.go # JWT认证中间件
|
||||
├── cors.go # 跨域处理中间件
|
||||
├── logger.go # 日志中间件
|
||||
├── error.go # 错误处理中间件
|
||||
└── middleware.go # 中间件管理器
|
||||
```
|
||||
|
||||
## 🎯 中间件职责
|
||||
- **认证授权**: JWT令牌验证
|
||||
- **跨域处理**: CORS配置
|
||||
- **日志记录**: 请求日志
|
||||
- **错误处理**: 统一错误响应
|
||||
- **限流熔断**: 请求限流
|
||||
|
||||
## 🚀 中间件顺序
|
||||
```
|
||||
请求 → Logger → CORS → Auth → RateLimit → Handler
|
||||
```
|
||||
|
||||
## 📊 配置参数
|
||||
| 中间件 | 配置项 | 默认值 |
|
||||
|---|---|---|
|
||||
| **CORS** | 允许域名 | localhost:3000 |
|
||||
| **Logger** | 日志级别 | info |
|
||||
| **Auth** | 过期时间 | 24小时 |
|
||||
|
||||
## 🎯 使用方式
|
||||
```go
|
||||
// 在路由中使用
|
||||
r.Use(middleware.Cors())
|
||||
r.Use(middleware.Logger())
|
||||
r.Use(middleware.Auth())
|
||||
```
|
||||
|
||||
## 🔄 扩展中间件
|
||||
1. **新增文件**: 创建新的中间件文件
|
||||
2. **注册使用**: 在routes.go中添加
|
||||
3. **配置参数**: 在配置文件中设置
|
||||
|
||||
## ⚙️ 配置位置
|
||||
- 配置项: `etc/photography-api.yaml` -> `middleware` 部分
|
||||
Reference in New Issue
Block a user