feat(server): 重构路由模块，优化开发体验

- 提取路由配置到独立的 router 包
- 优化 Makefile 并行启动前后端开发服务器
- 修复 Swagger 文档生成命令

Makefile

@@ -27,16 +27,13 @@ build-server:
 	@echo "Building server..."
 	cd server && go build -o bin/xinfra ./cmd/server
 
-# 启动开发服务器
+# 启动开发服务器（前后端并行）
-run: run-frontend run-server
+run:
-
+	@echo "Starting development servers..."
-run-frontend:
+	@trap 'kill 0' EXIT; \
-	@echo "Starting frontend dev server..."
+	cd frontend && npm run dev & \
-	cd frontend && npm run dev
+	cd server && go run ./cmd/server & \
-
+	wait
-run-server:
-	@echo "Starting server..."
-	cd server && go run ./cmd/server
 
 # 运行测试
 test: test-frontend test-server
@@ -79,7 +76,7 @@ dev-down:
 # Swagger 文档
 swagger:
 	@echo "Generating Swagger documentation..."
-	cd server && swag init -g cmd/server/main.go -o ./docs
+	cd server && swag init -g internal/router/router.go -o ./docs
 	@echo "Swagger docs generated at server/docs/"
 
 # 数据库迁移

server/cmd/server/main.go

@@ -4,74 +4,11 @@ import (
 	"fmt"
 
 	_ "github.com/1024XEngineer/xinfra/server/docs"
-	"github.com/1024XEngineer/xinfra/server/internal/handler"
+	"github.com/1024XEngineer/xinfra/server/internal/router"
-	"github.com/1024XEngineer/xinfra/server/internal/middleware"
-	"github.com/gin-gonic/gin"
-	swaggerFiles "github.com/swaggo/files"
-	ginSwagger "github.com/swaggo/gin-swagger"
 )
 
-// @title           xinfra API
-// @version         1.0
-// @description     xinfra 平台后端 API 文档
-// @termsOfService  http://swagger.io/terms/
-
-// @contact.name   API Support
-// @contact.url    http://www.swagger.io/support
-// @contact.email  support@swagger.io
-
-// @license.name  Apache 2.0
-// @license.url   http://www.apache.org/licenses/LICENSE-2.0.html
-
-// @BasePath  /api/v1
-
-// @securityDefinitions.apikey BearerAuth
-// @in header
-// @name Authorization
-// @description 请输入 Bearer Token（例如：Bearer xxx）
-
 func main() {
-	r := gin.Default()
+	r := router.Setup()
-
-	// 加载中间件
-	r.Use(middleware.Logger())
-	r.Use(middleware.Recovery())
-
-	// Swagger UI
-	r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler, ginSwagger.URL("/swagger/doc.json")))
-
-	// 健康检查
-	r.GET("/api/v1/ping", handler.Ping)
-
-	// 测试路由组 — 用于验证统一响应格式
-	testGroup := r.Group("/api/v1/test")
-	{
-		// 成功响应
-		testGroup.GET("/success", handler.TestSuccess)
-
-		// 业务错误 — 传入错误码
-		// GET /api/v1/test/error/10001 → LDAP 认证失败
-		// GET /api/v1/test/error/10002 → 用户名或密码错误
-		// GET /api/v1/test/error/10003 → Token 已过期
-		// GET /api/v1/test/error/20001 → 任务创建失败
-		// GET /api/v1/test/error/20002 → 任务执行超时
-		testGroup.GET("/error/:code", handler.TestError)
-
-		// HTTP 500 错误
-		testGroup.GET("/500", handler.Test500)
-
-		// HTTP 401 未授权
-		testGroup.GET("/401", handler.Test401)
-
-		// HTTP 403 禁止访问
-		testGroup.GET("/403", handler.Test403)
-
-		// 模拟超时（sleep 超过前端 10s timeout）
-		testGroup.GET("/timeout", handler.TestTimeout)
-
-		// 返回分页数据
-		testGroup.GET("/paginated", handler.TestPaginated)
-	}
 
 	fmt.Println("Server starting on :8080...")
 	if err := r.Run(":8080"); err != nil {

server/internal/router/router.go

@@ -0,0 +1,75 @@
+package router
+
+import (
+	"github.com/1024XEngineer/xinfra/server/internal/handler"
+	"github.com/1024XEngineer/xinfra/server/internal/middleware"
+	"github.com/gin-gonic/gin"
+	swaggerFiles "github.com/swaggo/files"
+	ginSwagger "github.com/swaggo/gin-swagger"
+)
+
+// Setup 初始化路由
+// @title           xinfra API
+// @version         1.0
+// @description     xinfra 平台后端 API 文档
+// @termsOfService  http://swagger.io/terms/
+// @contact.name   API Support
+// @contact.url    http://www.swagger.io/support
+// @contact.email  support@swagger.io
+// @license.name  Apache 2.0
+// @license.url   http://www.apache.org/licenses/LICENSE-2.0.html
+// @BasePath  /api/v1
+// @securityDefinitions.apikey BearerAuth
+// @in header
+// @name Authorization
+// @description 请输入 Bearer Token（例如：Bearer xxx）
+func Setup() *gin.Engine {
+	r := gin.Default()
+
+	// 加载中间件
+	r.Use(middleware.Logger())
+	r.Use(middleware.Recovery())
+
+	// Swagger UI
+	r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler, ginSwagger.URL("/swagger/doc.json")))
+
+	// 健康检查
+	r.GET("/api/v1/ping", handler.Ping)
+
+	// 测试路由组 — 用于验证统一响应格式
+	setupTestRoutes(r)
+
+	return r
+}
+
+// setupTestRoutes 注册测试路由
+func setupTestRoutes(r *gin.Engine) {
+	testGroup := r.Group("/api/v1/test")
+	{
+		// 成功响应
+		testGroup.GET("/success", handler.TestSuccess)
+
+		// 业务错误 — 传入错误码
+		// GET /api/v1/test/error/10001 → LDAP 认证失败
+		// GET /api/v1/test/error/10002 → 用户名或密码错误
+		// GET /api/v1/test/error/10003 → Token 已过期
+		// GET /api/v1/test/error/20001 → 任务创建失败
+		// GET /api/v1/test/error/20002 → 任务执行超时
+		testGroup.GET("/error/:code", handler.TestError)
+
+		// HTTP 500 错误
+		testGroup.GET("/500", handler.Test500)
+
+		// HTTP 401 未授权
+		testGroup.GET("/401", handler.Test401)
+
+		// HTTP 403 禁止访问
+		testGroup.GET("/403", handler.Test403)
+
+		// 模拟超时（sleep 超过前端 10s timeout）
+		testGroup.GET("/timeout", handler.TestTimeout)
+
+		// 返回分页数据
+		testGroup.GET("/paginated", handler.TestPaginated)
+	}
+}