csxj2026/junhong_cmp_fiber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

fix: gendocs panic — config.Get() nil 守卫防止未初始化时访问 Logging.Development
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
Details

Browse Source
This commit is contained in:
huang
2026-03-31 09:56:25 +08:00
parent 2ef8b8a705
commit 48ad0844ae
2 changed files with 47 additions and 92 deletions
Download Patch File Download Diff File Expand all files Collapse all files

137
docs/admin-openapi.yaml
View File

@@ -134,7 +134,7 @@ components:
type: object type: object
DtoAgentRechargeListResponse: DtoAgentRechargeListResponse:
properties: properties:
list: items:
description: 充值记录列表 description: 充值记录列表
items: items:
$ref: '#/components/schemas/DtoAgentRechargeResponse' $ref: '#/components/schemas/DtoAgentRechargeResponse'
@@ -143,7 +143,7 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页条数 description: 每页条数
type: integer type: integer
total: total:
@@ -708,7 +708,7 @@ components:
type: object type: object
DtoAssetPackageHistoryResponse: DtoAssetPackageHistoryResponse:
properties: properties:
list: items:
description: 套餐历史列表 description: 套餐历史列表
items: items:
$ref: '#/components/schemas/DtoAssetPackageResponse' $ref: '#/components/schemas/DtoAssetPackageResponse'
@@ -717,7 +717,7 @@ components:
page: page:
description: 页码 description: 页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
@@ -1118,7 +1118,7 @@ components:
type: object type: object
DtoAssetWalletTransactionListResponse: DtoAssetWalletTransactionListResponse:
properties: properties:
list: items:
description: 流水列表 description: 流水列表
items: items:
$ref: '#/components/schemas/DtoAssetWalletTransactionItem' $ref: '#/components/schemas/DtoAssetWalletTransactionItem'
@@ -1127,15 +1127,12 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总记录数 description: 总记录数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoAssignPermissionsParams: DtoAssignPermissionsParams:
properties: properties:
@@ -1500,7 +1497,7 @@ components:
type: object type: object
DtoCarrierPageResult: DtoCarrierPageResult:
properties: properties:
list: items:
description: 运营商列表 description: 运营商列表
items: items:
$ref: '#/components/schemas/DtoCarrierResponse' $ref: '#/components/schemas/DtoCarrierResponse'
@@ -1509,15 +1506,12 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoCarrierResponse: DtoCarrierResponse:
properties: properties:
@@ -1765,7 +1759,7 @@ components:
type: object type: object
DtoClientOrderListResponse: DtoClientOrderListResponse:
properties: properties:
list: items:
description: 订单列表 description: 订单列表
items: items:
$ref: '#/components/schemas/DtoClientOrderListItem' $ref: '#/components/schemas/DtoClientOrderListItem'
@@ -1774,7 +1768,7 @@ components:
page: page:
description: 页码 description: 页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
@@ -1922,7 +1916,7 @@ components:
type: object type: object
DtoClientRechargeListResponse: DtoClientRechargeListResponse:
properties: properties:
list: items:
description: 充值记录列表 description: 充值记录列表
items: items:
$ref: '#/components/schemas/DtoClientRechargeListItem' $ref: '#/components/schemas/DtoClientRechargeListItem'
@@ -1931,7 +1925,7 @@ components:
page: page:
description: 页码 description: 页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
@@ -2922,15 +2916,12 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoDataCleanupLogResp: DtoDataCleanupLogResp:
properties: properties:
@@ -3831,7 +3822,7 @@ components:
type: object type: object
DtoEnterpriseDeviceListResp: DtoEnterpriseDeviceListResp:
properties: properties:
list: items:
description: 设备列表 description: 设备列表
items: items:
$ref: '#/components/schemas/DtoEnterpriseDeviceItem' $ref: '#/components/schemas/DtoEnterpriseDeviceItem'
@@ -3926,7 +3917,7 @@ components:
type: object type: object
DtoExchangeListResponse: DtoExchangeListResponse:
properties: properties:
list: items:
description: 换货单列表 description: 换货单列表
items: items:
$ref: '#/components/schemas/DtoExchangeOrderResponse' $ref: '#/components/schemas/DtoExchangeOrderResponse'
@@ -3935,7 +3926,7 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
@@ -4370,7 +4361,7 @@ components:
type: object type: object
DtoListAssetAllocationRecordResponse: DtoListAssetAllocationRecordResponse:
properties: properties:
list: items:
description: 分配记录列表 description: 分配记录列表
items: items:
$ref: '#/components/schemas/DtoAssetAllocationRecordResponse' $ref: '#/components/schemas/DtoAssetAllocationRecordResponse'
@@ -4379,15 +4370,12 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoListDeviceCardsResponse: DtoListDeviceCardsResponse:
properties: properties:
@@ -4400,7 +4388,7 @@ components:
type: object type: object
DtoListDeviceImportTaskResponse: DtoListDeviceImportTaskResponse:
properties: properties:
list: items:
description: 任务列表 description: 任务列表
items: items:
$ref: '#/components/schemas/DtoDeviceImportTaskResponse' $ref: '#/components/schemas/DtoDeviceImportTaskResponse'
@@ -4409,19 +4397,16 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoListDeviceResponse: DtoListDeviceResponse:
properties: properties:
list: items:
description: 设备列表 description: 设备列表
items: items:
$ref: '#/components/schemas/DtoDeviceResponse' $ref: '#/components/schemas/DtoDeviceResponse'
@@ -4430,19 +4415,16 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoListImportTaskResponse: DtoListImportTaskResponse:
properties: properties:
list: items:
description: 任务列表 description: 任务列表
items: items:
$ref: '#/components/schemas/DtoImportTaskResponse' $ref: '#/components/schemas/DtoImportTaskResponse'
@@ -4451,19 +4433,16 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoListStandaloneIotCardResponse: DtoListStandaloneIotCardResponse:
properties: properties:
list: items:
description: 单卡列表 description: 单卡列表
items: items:
$ref: '#/components/schemas/DtoStandaloneIotCardResponse' $ref: '#/components/schemas/DtoStandaloneIotCardResponse'
@@ -4472,15 +4451,12 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoLoginRequest: DtoLoginRequest:
properties: properties:
@@ -4546,15 +4522,12 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoManualTriggerLogResp: DtoManualTriggerLogResp:
properties: properties:
@@ -4789,7 +4762,7 @@ components:
type: object type: object
DtoOrderListResponse: DtoOrderListResponse:
properties: properties:
list: items:
description: 订单列表 description: 订单列表
items: items:
$ref: '#/components/schemas/DtoOrderResponse' $ref: '#/components/schemas/DtoOrderResponse'
@@ -4798,15 +4771,12 @@ components:
page: page:
description: 当前页码 description: 当前页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoOrderResponse: DtoOrderResponse:
properties: properties:
@@ -4912,7 +4882,7 @@ components:
type: object type: object
DtoPackagePageResult: DtoPackagePageResult:
properties: properties:
list: items:
description: 套餐列表 description: 套餐列表
items: items:
$ref: '#/components/schemas/DtoPackageResponse' $ref: '#/components/schemas/DtoPackageResponse'
@@ -4921,15 +4891,12 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoPackageResponse: DtoPackageResponse:
properties: properties:
@@ -5021,7 +4988,7 @@ components:
type: object type: object
DtoPackageSeriesPageResult: DtoPackageSeriesPageResult:
properties: properties:
list: items:
description: 套餐系列列表 description: 套餐系列列表
items: items:
$ref: '#/components/schemas/DtoPackageSeriesResponse' $ref: '#/components/schemas/DtoPackageSeriesResponse'
@@ -5030,15 +4997,12 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoPackageSeriesResponse: DtoPackageSeriesResponse:
properties: properties:
@@ -5216,15 +5180,12 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoPollingAlertHistoryResp: DtoPollingAlertHistoryResp:
properties: properties:
@@ -5351,7 +5312,7 @@ components:
type: object type: object
DtoPollingConfigPageResult: DtoPollingConfigPageResult:
properties: properties:
list: items:
description: 配置列表 description: 配置列表
items: items:
$ref: '#/components/schemas/DtoPollingConfigResponse' $ref: '#/components/schemas/DtoPollingConfigResponse'
@@ -5360,15 +5321,12 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoPollingConfigResponse: DtoPollingConfigResponse:
properties: properties:
@@ -6333,7 +6291,7 @@ components:
type: object type: object
DtoShopSeriesGrantPageResult: DtoShopSeriesGrantPageResult:
properties: properties:
list: items:
description: 授权列表 description: 授权列表
items: items:
$ref: '#/components/schemas/DtoShopSeriesGrantListItem' $ref: '#/components/schemas/DtoShopSeriesGrantListItem'
@@ -6342,15 +6300,12 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
description: 总数 description: 总数
type: integer type: integer
total_pages:
description: 总页数
type: integer
type: object type: object
DtoShopSeriesGrantResponse: DtoShopSeriesGrantResponse:
properties: properties:
@@ -7449,7 +7404,7 @@ components:
type: object type: object
DtoWalletTransactionListResponse: DtoWalletTransactionListResponse:
properties: properties:
list: items:
description: 流水列表 description: 流水列表
items: items:
$ref: '#/components/schemas/DtoWalletTransactionItem' $ref: '#/components/schemas/DtoWalletTransactionItem'
@@ -7458,7 +7413,7 @@ components:
page: page:
description: 页码 description: 页码
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
@@ -7467,7 +7422,7 @@ components:
type: object type: object
DtoWechatConfigListResponse: DtoWechatConfigListResponse:
properties: properties:
list: items:
description: 配置列表 description: 配置列表
items: items:
$ref: '#/components/schemas/DtoWechatConfigResponse' $ref: '#/components/schemas/DtoWechatConfigResponse'
@@ -7476,7 +7431,7 @@ components:
page: page:
description: 当前页 description: 当前页
type: integer type: integer
page_size: size:
description: 每页数量 description: 每页数量
type: integer type: integer
total: total:
@@ -11187,7 +11142,7 @@ paths:
summary: 更新数据清理配置 summary: 更新数据清理配置
tags: tags:
- 轮询管理-数据清理 - 轮询管理-数据清理
/api/admin/data-cleanup-logs/data-cleanup-logs: /api/admin/data-cleanup-logs:
get: get:
parameters: parameters:
- description: 表名筛选 - description: 表名筛选
@@ -11264,7 +11219,7 @@ paths:
summary: 获取数据清理日志列表 summary: 获取数据清理日志列表
tags: tags:
- 轮询管理-数据清理 - 轮询管理-数据清理
/api/admin/data-cleanup/preview/data-cleanup/preview: /api/admin/data-cleanup/preview:
get: get:
responses: responses:
"200": "200":
@@ -11322,7 +11277,7 @@ paths:
summary: 预览待清理数据 summary: 预览待清理数据
tags: tags:
- 轮询管理-数据清理 - 轮询管理-数据清理
/api/admin/data-cleanup/progress/data-cleanup/progress: /api/admin/data-cleanup/progress:
get: get:
responses: responses:
"200": "200":
@@ -11380,7 +11335,7 @@ paths:
summary: 获取数据清理进度 summary: 获取数据清理进度
tags: tags:
- 轮询管理-数据清理 - 轮询管理-数据清理
/api/admin/data-cleanup/trigger/data-cleanup/trigger: /api/admin/data-cleanup/trigger:
post: post:
requestBody: requestBody:
content: content:

2
internal/routes/personal.go
View File

@@ -55,7 +55,7 @@ func RegisterPersonalCustomerRoutes(router fiber.Router, doc *openapi.Generator,
}) })
// 开发模式测试登录接口（仅 logging.development=true 时注册） // 开发模式测试登录接口（仅 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{ Register(router, doc, basePath, "POST", authBasePath+"/dev-login", handlers.ClientAuth.DevLogin, RouteSpec{
Summary: "开发环境测试登录", Summary: "开发环境测试登录",
Description: "⚠️ 仅开发模式可用。传入资产标识符（ICCID等），自动绑定测试客户并签发 JWT，用于接口测试。", Description: "⚠️ 仅开发模式可用。传入资产标识符（ICCID等），自动绑定测试客户并签发 JWT，用于接口测试。",