c741f1751d
- /polling-carrier-params 列表（含默认标记与消费能力）、详情、保存（执行上限不得大于订阅进程 max_in_flight 之和）、删除；/polling-check-scenes 列表与修改（检查类型、递增的确认延迟、冷却）；/polling-failure-alerts 列表、按账户与错误类别汇总、详情、标记已处理；GET /iot-cards/:id/polling-state 单卡轮询状态；GET /polling-stats/carrier-queues 按账户队列与执行监控 - 读取仅超级管理员与平台账号，修改仅超级管理员（告警处理平台账号可用），均写统一审计；新增审计动作与资源 - carrier 模式下重算到期时间写入卡到期信息与账户队列，只提前不推后
68 lines
3.7 KiB
Go
68 lines
3.7 KiB
Go
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"
|
||
apphandler "github.com/break/junhong_cmp_fiber/internal/handler/app"
|
||
"github.com/break/junhong_cmp_fiber/internal/handler/callback"
|
||
"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("君鸿卡管系统 API", "1.0.0")
|
||
|
||
// 2. 创建临时 Fiber App 用于路由注册
|
||
app := fiber.New()
|
||
|
||
// 3. 创建所有 Handler（使用 nil 依赖，因为只需要路由结构）
|
||
// 新增 Handler 必须注册到 openapi.BuildDocHandlers，代理开放接口也从该入口进入文档生成器。
|
||
handlers := openapi.BuildDocHandlers()
|
||
handlers.Audit = admin.NewAuditHandler(nil, nil)
|
||
handlers.AssetPackageBatchOrder = admin.NewAssetPackageBatchOrderHandler(nil, nil)
|
||
handlers.BusinessUserGroup = admin.NewBusinessUserGroupHandler(nil, nil)
|
||
handlers.ShopBusinessOwnerImport = admin.NewShopBusinessOwnerImportHandler(nil)
|
||
handlers.PhoneAssetAssociation = admin.NewPhoneAssetAssociationHandler(nil, nil)
|
||
// 网关限流 Handler 必须同时进入文档工厂，避免新增管理接口遗漏文档注册。
|
||
handlers.GatewayRateLimit = admin.NewGatewayRateLimitHandler(nil, nil, nil)
|
||
handlers.CarrierScheduler = admin.NewCarrierSchedulerHandler(nil, nil)
|
||
// 套餐真流量预警 Handler 必须同时进入文档工厂，避免新增管理接口遗漏文档注册。
|
||
handlers.PackageTrafficAlert = admin.NewPackageTrafficAlertHandler(nil, nil, nil, nil)
|
||
// 资产钱包自动续费配置 Handler 必须同时进入文档工厂，避免新增管理接口遗漏文档注册。
|
||
handlers.AssetAutoRenewal = admin.NewAssetAutoRenewalConfigHandler(nil, nil)
|
||
// 运营报表 Handler 必须同时进入文档工厂，避免新增管理接口遗漏文档注册。
|
||
handlers.OperationsReport = admin.NewOperationsReportHandler(nil, nil, nil)
|
||
handlers.StopResumeRule = admin.NewStopResumeRuleHandler(nil, nil, nil)
|
||
handlers.ClientPopup = apphandler.NewClientPopupHandler(nil, nil, nil)
|
||
handlers.H5PopupConfiguration = admin.NewH5PopupConfigurationHandler(nil, nil, nil)
|
||
// 企业微信 Handler 在此显式装配，避免新增管理接口遗漏文档注册。
|
||
handlers.WeCom = admin.NewWeComHandler(nil, nil)
|
||
handlers.PaymentMerchant = admin.NewPaymentMerchantHandler(nil)
|
||
handlers.EmployeeCollection = admin.NewEmployeeCollectionHandler(nil, nil, nil)
|
||
handlers.AgentDistributionRegistration = admin.NewAgentDistributionRegistrationHandler(nil, nil, nil)
|
||
handlers.WithdrawalQualification = admin.NewWithdrawalQualificationHandler(nil, nil, nil)
|
||
handlers.CMCCRealnameCallback = callback.NewCMCCRealnameHandler(nil, nil, nil, nil, nil, nil, nil)
|
||
handlers.CUCCRealnameCallback = callback.NewCUCCRealnameHandler(nil, nil, nil, nil, nil, nil, nil)
|
||
handlers.CUCCRealnameRemovalCallback = callback.NewCUCCRealnameRemovalHandler(nil, nil, nil, nil, nil)
|
||
handlers.WeComApprovalCallback = callback.NewWeComApprovalHandler(nil)
|
||
|
||
// 4. 注册所有路由到文档生成器
|
||
routes.RegisterRoutesWithDoc(app, handlers, &bootstrap.Middlewares{}, adminDoc)
|
||
|
||
// 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))
|
||
}
|