feat: 重构CLAUDE.md文档体系,实现模块化轻量级设计
Some checks failed
部署后端服务 / 🚀 构建并部署 (push) Failing after 7m20s

- 重构根目录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:
xujiang
2025-07-16 13:16:01 +08:00
parent 28eef98a0b
commit 386666660f
94 changed files with 492 additions and 20878 deletions

View 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` 部分