From 48ad0844aebfda75bb7a27cc3934bf3bbbb872b2 Mon Sep 17 00:00:00 2001 From: huang Date: Tue, 31 Mar 2026 09:56:25 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20gendocs=20panic=20=E2=80=94=20config.Get?= =?UTF-8?q?()=20nil=20=E5=AE=88=E5=8D=AB=E9=98=B2=E6=AD=A2=E6=9C=AA?= =?UTF-8?q?=E5=88=9D=E5=A7=8B=E5=8C=96=E6=97=B6=E8=AE=BF=E9=97=AE=20Loggin?= =?UTF-8?q?g.Development?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/admin-openapi.yaml | 137 ++++++++++++------------------------ internal/routes/personal.go | 2 +- 2 files changed, 47 insertions(+), 92 deletions(-) diff --git a/docs/admin-openapi.yaml b/docs/admin-openapi.yaml index 672a395..0306a6d 100644 --- a/docs/admin-openapi.yaml +++ b/docs/admin-openapi.yaml @@ -134,7 +134,7 @@ components: type: object DtoAgentRechargeListResponse: properties: - list: + items: description: 充值记录列表 items: $ref: '#/components/schemas/DtoAgentRechargeResponse' @@ -143,7 +143,7 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页条数 type: integer total: @@ -708,7 +708,7 @@ components: type: object DtoAssetPackageHistoryResponse: properties: - list: + items: description: 套餐历史列表 items: $ref: '#/components/schemas/DtoAssetPackageResponse' @@ -717,7 +717,7 @@ components: page: description: 页码 type: integer - page_size: + size: description: 每页数量 type: integer total: @@ -1118,7 +1118,7 @@ components: type: object DtoAssetWalletTransactionListResponse: properties: - list: + items: description: 流水列表 items: $ref: '#/components/schemas/DtoAssetWalletTransactionItem' @@ -1127,15 +1127,12 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总记录数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoAssignPermissionsParams: properties: @@ -1500,7 +1497,7 @@ components: type: object DtoCarrierPageResult: properties: - list: + items: description: 运营商列表 items: $ref: '#/components/schemas/DtoCarrierResponse' @@ -1509,15 +1506,12 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoCarrierResponse: properties: @@ -1765,7 +1759,7 @@ components: type: object DtoClientOrderListResponse: properties: - list: + items: description: 订单列表 items: $ref: '#/components/schemas/DtoClientOrderListItem' @@ -1774,7 +1768,7 @@ components: page: description: 页码 type: integer - page_size: + size: description: 每页数量 type: integer total: @@ -1922,7 +1916,7 @@ components: type: object DtoClientRechargeListResponse: properties: - list: + items: description: 充值记录列表 items: $ref: '#/components/schemas/DtoClientRechargeListItem' @@ -1931,7 +1925,7 @@ components: page: description: 页码 type: integer - page_size: + size: description: 每页数量 type: integer total: @@ -2922,15 +2916,12 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoDataCleanupLogResp: properties: @@ -3831,7 +3822,7 @@ components: type: object DtoEnterpriseDeviceListResp: properties: - list: + items: description: 设备列表 items: $ref: '#/components/schemas/DtoEnterpriseDeviceItem' @@ -3926,7 +3917,7 @@ components: type: object DtoExchangeListResponse: properties: - list: + items: description: 换货单列表 items: $ref: '#/components/schemas/DtoExchangeOrderResponse' @@ -3935,7 +3926,7 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页数量 type: integer total: @@ -4370,7 +4361,7 @@ components: type: object DtoListAssetAllocationRecordResponse: properties: - list: + items: description: 分配记录列表 items: $ref: '#/components/schemas/DtoAssetAllocationRecordResponse' @@ -4379,15 +4370,12 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoListDeviceCardsResponse: properties: @@ -4400,7 +4388,7 @@ components: type: object DtoListDeviceImportTaskResponse: properties: - list: + items: description: 任务列表 items: $ref: '#/components/schemas/DtoDeviceImportTaskResponse' @@ -4409,19 +4397,16 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoListDeviceResponse: properties: - list: + items: description: 设备列表 items: $ref: '#/components/schemas/DtoDeviceResponse' @@ -4430,19 +4415,16 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoListImportTaskResponse: properties: - list: + items: description: 任务列表 items: $ref: '#/components/schemas/DtoImportTaskResponse' @@ -4451,19 +4433,16 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoListStandaloneIotCardResponse: properties: - list: + items: description: 单卡列表 items: $ref: '#/components/schemas/DtoStandaloneIotCardResponse' @@ -4472,15 +4451,12 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoLoginRequest: properties: @@ -4546,15 +4522,12 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoManualTriggerLogResp: properties: @@ -4789,7 +4762,7 @@ components: type: object DtoOrderListResponse: properties: - list: + items: description: 订单列表 items: $ref: '#/components/schemas/DtoOrderResponse' @@ -4798,15 +4771,12 @@ components: page: description: 当前页码 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoOrderResponse: properties: @@ -4912,7 +4882,7 @@ components: type: object DtoPackagePageResult: properties: - list: + items: description: 套餐列表 items: $ref: '#/components/schemas/DtoPackageResponse' @@ -4921,15 +4891,12 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoPackageResponse: properties: @@ -5021,7 +4988,7 @@ components: type: object DtoPackageSeriesPageResult: properties: - list: + items: description: 套餐系列列表 items: $ref: '#/components/schemas/DtoPackageSeriesResponse' @@ -5030,15 +4997,12 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoPackageSeriesResponse: properties: @@ -5216,15 +5180,12 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoPollingAlertHistoryResp: properties: @@ -5351,7 +5312,7 @@ components: type: object DtoPollingConfigPageResult: properties: - list: + items: description: 配置列表 items: $ref: '#/components/schemas/DtoPollingConfigResponse' @@ -5360,15 +5321,12 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoPollingConfigResponse: properties: @@ -6333,7 +6291,7 @@ components: type: object DtoShopSeriesGrantPageResult: properties: - list: + items: description: 授权列表 items: $ref: '#/components/schemas/DtoShopSeriesGrantListItem' @@ -6342,15 +6300,12 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: description: 总数 type: integer - total_pages: - description: 总页数 - type: integer type: object DtoShopSeriesGrantResponse: properties: @@ -7449,7 +7404,7 @@ components: type: object DtoWalletTransactionListResponse: properties: - list: + items: description: 流水列表 items: $ref: '#/components/schemas/DtoWalletTransactionItem' @@ -7458,7 +7413,7 @@ components: page: description: 页码 type: integer - page_size: + size: description: 每页数量 type: integer total: @@ -7467,7 +7422,7 @@ components: type: object DtoWechatConfigListResponse: properties: - list: + items: description: 配置列表 items: $ref: '#/components/schemas/DtoWechatConfigResponse' @@ -7476,7 +7431,7 @@ components: page: description: 当前页 type: integer - page_size: + size: description: 每页数量 type: integer total: @@ -11187,7 +11142,7 @@ paths: summary: 更新数据清理配置 tags: - 轮询管理-数据清理 - /api/admin/data-cleanup-logs/data-cleanup-logs: + /api/admin/data-cleanup-logs: get: parameters: - description: 表名筛选 @@ -11264,7 +11219,7 @@ paths: summary: 获取数据清理日志列表 tags: - 轮询管理-数据清理 - /api/admin/data-cleanup/preview/data-cleanup/preview: + /api/admin/data-cleanup/preview: get: responses: "200": @@ -11322,7 +11277,7 @@ paths: summary: 预览待清理数据 tags: - 轮询管理-数据清理 - /api/admin/data-cleanup/progress/data-cleanup/progress: + /api/admin/data-cleanup/progress: get: responses: "200": @@ -11380,7 +11335,7 @@ paths: summary: 获取数据清理进度 tags: - 轮询管理-数据清理 - /api/admin/data-cleanup/trigger/data-cleanup/trigger: + /api/admin/data-cleanup/trigger: post: requestBody: content: diff --git a/internal/routes/personal.go b/internal/routes/personal.go index 04ef504..77218be 100644 --- a/internal/routes/personal.go +++ b/internal/routes/personal.go @@ -55,7 +55,7 @@ func RegisterPersonalCustomerRoutes(router fiber.Router, doc *openapi.Generator, }) // 开发模式测试登录接口（仅 logging.development=true 时注册） - if config.Get().Logging.Development { + if cfg := config.Get(); cfg != nil && cfg.Logging.Development { Register(router, doc, basePath, "POST", authBasePath+"/dev-login", handlers.ClientAuth.DevLogin, RouteSpec{ Summary: "开发环境测试登录", Description: "⚠️ 仅开发模式可用。传入资产标识符（ICCID等），自动绑定测试客户并签发 JWT，用于接口测试。",