package routes import ( "github.com/gofiber/fiber/v2" "github.com/break/junhong_cmp_fiber/internal/handler/admin" "github.com/break/junhong_cmp_fiber/internal/model/dto" "github.com/break/junhong_cmp_fiber/pkg/openapi" ) func registerAssetRoutes(router fiber.Router, handler *admin.AssetHandler, walletHandler *admin.AssetWalletHandler, doc *openapi.Generator, basePath string) { assets := router.Group("/assets") groupPath := basePath + "/assets" Register(assets, doc, groupPath, "GET", "/resolve/:identifier", handler.Resolve, RouteSpec{ Summary: "解析资产", Description: "通过虚拟号/ICCID/IMEI/SN/MSISDN 解析设备或卡的完整详情。企业账号禁止调用。", Tags: []string{"资产管理"}, Input: new(dto.AssetResolveRequest), Output: new(dto.AssetResolveResponse), Auth: true, }) Register(assets, doc, groupPath, "GET", "/:identifier/realtime-status", handler.RealtimeStatus, RouteSpec{ Summary: "资产实时状态", Description: "查询资产实时状态。卡类型:读取 DB/Redis 持久化状态;设备类型:实时调用 Gateway sync-info 接口获取最新数据,Gateway 失败不阻断主流程(DeviceRealtime.gateway_msg 返回失败原因)。", Tags: []string{"资产管理"}, Input: new(dto.AssetIdentifierRequest), Output: new(dto.AssetRealtimeStatusResponse), Auth: true, }) Register(assets, doc, groupPath, "POST", "/:identifier/refresh", handler.Refresh, RouteSpec{ Summary: "刷新资产状态", Description: "主动调网关同步最新状态。设备有30秒冷却期。", Tags: []string{"资产管理"}, Input: new(dto.AssetIdentifierRequest), Output: new(dto.AssetRealtimeStatusResponse), Auth: true, }) Register(assets, doc, groupPath, "GET", "/:identifier/packages", handler.Packages, RouteSpec{ Summary: "资产套餐列表", Description: "查询该资产所有套餐记录,含虚流量换算结果。支持分页。", Tags: []string{"资产管理"}, Input: new(dto.AssetIdentifierRequest), Output: new(dto.AssetPackagesResult), Auth: true, }) Register(assets, doc, groupPath, "GET", "/:identifier/current-package", handler.CurrentPackage, RouteSpec{ Summary: "当前生效套餐", Tags: []string{"资产管理"}, Input: new(dto.AssetIdentifierRequest), Output: new(dto.AssetPackageResponse), Auth: true, }) Register(assets, doc, groupPath, "POST", "/:identifier/stop", handler.Stop, RouteSpec{ Summary: "停机", Description: "设备批量停机设备下所有已实名卡;单卡手动停机。", Tags: []string{"资产管理"}, Input: new(dto.AssetIdentifierRequest), Output: nil, Auth: true, }) Register(assets, doc, groupPath, "POST", "/:identifier/start", handler.Start, RouteSpec{ Summary: "复机", Description: "设备批量复机;单卡手动复机。", Tags: []string{"资产管理"}, Input: new(dto.AssetIdentifierRequest), Output: nil, Auth: true, }) Register(assets, doc, groupPath, "PATCH", "/:identifier/deactivate", handler.Deactivate, RouteSpec{ Summary: "停用资产", Description: "将资产状态设置为停用(不可逆)。仅支持库存中或已售出的资产。", Tags: []string{"资产管理"}, Input: new(dto.AssetIdentifierRequest), Output: nil, Auth: true, }) Register(assets, doc, groupPath, "GET", "/:identifier/wallet", walletHandler.GetWallet, RouteSpec{ Summary: "资产钱包概况", Description: "查询指定卡或设备的钱包余额概况。企业账号禁止调用。", Tags: []string{"资产管理"}, Input: new(dto.AssetIdentifierRequest), Output: new(dto.AssetWalletResponse), Auth: true, }) Register(assets, doc, groupPath, "GET", "/:identifier/wallet/transactions", walletHandler.ListTransactions, RouteSpec{ Summary: "资产钱包流水列表", Description: "分页查询指定资产的钱包收支流水,含充值/扣款来源编号。企业账号禁止调用。", Tags: []string{"资产管理"}, Input: new(dto.AssetWalletTransactionListRequest), Output: new(dto.AssetWalletTransactionListResponse), Auth: true, }) Register(assets, doc, groupPath, "GET", "/:identifier/orders", handler.Orders, RouteSpec{ Summary: "资产历史订单", Description: "查询资产本代历史订单,支持 include_previous=true 参数通过换货链追溯前代订单(最多10代)。", Tags: []string{"资产管理"}, Input: new(dto.AssetOrdersRequest), Output: new(dto.AssetOrdersResponse), Auth: true, }) Register(assets, doc, groupPath, "PATCH", "/:identifier/polling-status", handler.UpdatePollingStatus, RouteSpec{ Summary: "更新资产轮询状态", Description: "启用或禁用指定资产(IoT卡或设备)的定期状态轮询。", Tags: []string{"资产管理"}, Input: new(dto.UpdateAssetPollingStatusRequest), Output: new(dto.UpdateAssetPollingStatusResponse), Auth: true, }) Register(assets, doc, groupPath, "PATCH", "/:identifier/realname-mode", handler.UpdateRealnamePolicy, RouteSpec{ Summary: "更新资产实名认证策略", Description: "更新指定资产(IoT卡或设备)的实名认证策略,支持 none/before_order/after_order 三种模式。", Tags: []string{"资产管理"}, Input: new(dto.UpdateAssetRealnamePolicyRequest), Output: new(dto.UpdateAssetRealnamePolicyResponse), Auth: true, }) }