package main import ( "github.com/gofiber/fiber/v2" "go.uber.org/zap" "github.com/break/junhong_cmp_fiber/internal/bootstrap" "github.com/break/junhong_cmp_fiber/internal/handler/admin" "github.com/break/junhong_cmp_fiber/internal/routes" "github.com/break/junhong_cmp_fiber/pkg/openapi" ) // generateOpenAPIDocs 生成 OpenAPI 文档 // outputPath: 文档输出路径 // logger: 日志记录器 // 生成失败时记录错误但不影响程序继续运行 func generateOpenAPIDocs(outputPath string, logger *zap.Logger) { // 1. 创建生成器 adminDoc := openapi.NewGenerator("Admin API", "1.0") // 2. 创建临时 Fiber App 用于路由注册 app := fiber.New() // 3. 创建 Handler(使用 nil 依赖,因为只需要路由结构) accHandler := admin.NewAccountHandler(nil) roleHandler := admin.NewRoleHandler(nil) permHandler := admin.NewPermissionHandler(nil) handlers := &bootstrap.Handlers{ Account: accHandler, Role: roleHandler, Permission: permHandler, } // 4. 注册路由到文档生成器 adminGroup := app.Group("/api/admin") routes.RegisterAdminRoutes(adminGroup, handlers, adminDoc, "/api/admin") // 5. 保存规范到指定路径 if err := adminDoc.Save(outputPath); err != nil { logger.Error("生成 OpenAPI 文档失败", zap.String("path", outputPath), zap.Error(err)) return } logger.Info("OpenAPI 文档生成成功", zap.String("path", outputPath)) }