feat(backend): 添加 Swagger 文档并优化认证接口

- 在 .env 文件中添加 ENABLE_SWAGGER 环境变量
- 在 app.js 中集成 Swagger UI
- 重构 auth 路由，添加请求参数验证
- 更新 API 文档，遵循 OpenAPI 3.0 规范
-优化认证接口的错误处理和响应格式

backend/src/app.js

@@ -5,6 +5,8 @@ const morgan = require('morgan')
 const rateLimit = require('express-rate-limit')
 const xss = require('xss-clean')
 const hpp = require('hpp')
+const swaggerUi = require('swagger-ui-express')
+const swaggerSpec = require('./config/swagger')
 
 console.log('🔧 初始化Express应用...')
 
@@ -70,6 +72,12 @@ app.use(hpp({ // 防止参数污染
 // 静态文件服务
 app.use('/uploads', express.static('uploads'))
 
+// Swagger文档路由
+if (process.env.NODE_ENV === 'development' || process.env.ENABLE_SWAGGER === 'true') {
+  app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerSpec))
+  console.log('📚 Swagger文档已启用: http://localhost:3001/api-docs')
+}
+
 // 健康检查路由
 app.get('/health', (req, res) => {
   res.status(200).json({