From ebaaa86f091ef2ccc8b624ce026202e8a99539a7 Mon Sep 17 00:00:00 2001 From: huang <1724659546@qq.com> Date: Sun, 19 Oct 2025 20:41:33 +0800 Subject: [PATCH] swag --- docs/docs.go | 83 +++++++++++++++++++---------------------------- docs/swagger.json | 83 +++++++++++++++++++---------------------------- docs/swagger.yaml | 65 ++++++++++++++----------------------- 3 files changed, 93 insertions(+), 138 deletions(-) diff --git a/docs/docs.go b/docs/docs.go index 72fe31b..0ad65c6 100644 --- a/docs/docs.go +++ b/docs/docs.go @@ -3840,7 +3840,7 @@ const docTemplate = `{ "BearerAuth": [] } ], - "description": "根据用户ID，分页获取该用户的操作审计日志。", + "description": "根据用户ID，分页获取该用户的操作审计日志。支持与通用日志查询接口相同的过滤和排序参数。", "produces": [ "application/json" ], @@ -3856,24 +3856,49 @@ const docTemplate = `{ "in": "path", "required": true }, + { + "type": "string", + "name": "action_type", + "in": "query" + }, + { + "type": "string", + "name": "end_time", + "in": "query" + }, + { + "type": "string", + "name": "order_by", + "in": "query" + }, { "type": "integer", - "default": 1, - "description": "页码", "name": "page", "in": "query" }, { "type": "integer", - "default": 10, - "description": "每页大小", - "name": "page_size", + "name": "pageSize", "in": "query" }, { "type": "string", - "description": "按操作类型过滤", - "name": "action_type", + "name": "start_time", + "in": "query" + }, + { + "type": "string", + "name": "status", + "in": "query" + }, + { + "type": "integer", + "name": "user_id", + "in": "query" + }, + { + "type": "string", + "name": "username", "in": "query" } ], @@ -3889,7 +3914,7 @@ const docTemplate = `{ "type": "object", "properties": { "data": { - "$ref": "#/definitions/dto.ListHistoryResponse" + "$ref": "#/definitions/dto.ListUserActionLogResponse" } } } @@ -4364,31 +4389,6 @@ const docTemplate = `{ } } }, - "dto.HistoryResponse": { - "type": "object", - "properties": { - "action_type": { - "type": "string", - "example": "更新设备" - }, - "description": { - "type": "string", - "example": "设备更新成功" - }, - "target_resource": {}, - "time": { - "type": "string" - }, - "user_id": { - "type": "integer", - "example": 101 - }, - "username": { - "type": "string", - "example": "testuser" - } - } - }, "dto.ListDeviceCommandLogResponse": { "type": "object", "properties": { @@ -4417,21 +4417,6 @@ const docTemplate = `{ } } }, - "dto.ListHistoryResponse": { - "type": "object", - "properties": { - "history": { - "type": "array", - "items": { - "$ref": "#/definitions/dto.HistoryResponse" - } - }, - "total": { - "type": "integer", - "example": 100 - } - } - }, "dto.ListMedicationLogResponse": { "type": "object", "properties": { diff --git a/docs/swagger.json b/docs/swagger.json index f6cca86..039d386 100644 --- a/docs/swagger.json +++ b/docs/swagger.json @@ -3832,7 +3832,7 @@ "BearerAuth": [] } ], - "description": "根据用户ID，分页获取该用户的操作审计日志。", + "description": "根据用户ID，分页获取该用户的操作审计日志。支持与通用日志查询接口相同的过滤和排序参数。", "produces": [ "application/json" ], @@ -3848,24 +3848,49 @@ "in": "path", "required": true }, + { + "type": "string", + "name": "action_type", + "in": "query" + }, + { + "type": "string", + "name": "end_time", + "in": "query" + }, + { + "type": "string", + "name": "order_by", + "in": "query" + }, { "type": "integer", - "default": 1, - "description": "页码", "name": "page", "in": "query" }, { "type": "integer", - "default": 10, - "description": "每页大小", - "name": "page_size", + "name": "pageSize", "in": "query" }, { "type": "string", - "description": "按操作类型过滤", - "name": "action_type", + "name": "start_time", + "in": "query" + }, + { + "type": "string", + "name": "status", + "in": "query" + }, + { + "type": "integer", + "name": "user_id", + "in": "query" + }, + { + "type": "string", + "name": "username", "in": "query" } ], @@ -3881,7 +3906,7 @@ "type": "object", "properties": { "data": { - "$ref": "#/definitions/dto.ListHistoryResponse" + "$ref": "#/definitions/dto.ListUserActionLogResponse" } } } @@ -4356,31 +4381,6 @@ } } }, - "dto.HistoryResponse": { - "type": "object", - "properties": { - "action_type": { - "type": "string", - "example": "更新设备" - }, - "description": { - "type": "string", - "example": "设备更新成功" - }, - "target_resource": {}, - "time": { - "type": "string" - }, - "user_id": { - "type": "integer", - "example": 101 - }, - "username": { - "type": "string", - "example": "testuser" - } - } - }, "dto.ListDeviceCommandLogResponse": { "type": "object", "properties": { @@ -4409,21 +4409,6 @@ } } }, - "dto.ListHistoryResponse": { - "type": "object", - "properties": { - "history": { - "type": "array", - "items": { - "$ref": "#/definitions/dto.HistoryResponse" - } - }, - "total": { - "type": "integer", - "example": 100 - } - } - }, "dto.ListMedicationLogResponse": { "type": "object", "properties": { diff --git a/docs/swagger.yaml b/docs/swagger.yaml index 8f68862..ad1bfce 100644 --- a/docs/swagger.yaml +++ b/docs/swagger.yaml @@ -322,24 +322,6 @@ definitions: remarks: type: string type: object - dto.HistoryResponse: - properties: - action_type: - example: 更新设备 - type: string - description: - example: 设备更新成功 - type: string - target_resource: {} - time: - type: string - user_id: - example: 101 - type: integer - username: - example: testuser - type: string - type: object dto.ListDeviceCommandLogResponse: properties: list: @@ -358,16 +340,6 @@ definitions: pagination: $ref: '#/definitions/dto.PaginationDTO' type: object - dto.ListHistoryResponse: - properties: - history: - items: - $ref: '#/definitions/dto.HistoryResponse' - type: array - total: - example: 100 - type: integer - type: object dto.ListMedicationLogResponse: properties: list: @@ -4055,26 +4027,39 @@ paths: - 用户管理 /api/v1/users/{id}/history: get: - description: 根据用户ID，分页获取该用户的操作审计日志。 + description: 根据用户ID，分页获取该用户的操作审计日志。支持与通用日志查询接口相同的过滤和排序参数。 parameters: - description: 用户ID in: path name: id required: true type: integer - - default: 1 - description: 页码 - in: query + - in: query + name: action_type + type: string + - in: query + name: end_time + type: string + - in: query + name: order_by + type: string + - in: query name: page type: integer - - default: 10 - description: 每页大小 - in: query - name: page_size + - in: query + name: pageSize type: integer - - description: 按操作类型过滤 - in: query - name: action_type + - in: query + name: start_time + type: string + - in: query + name: status + type: string + - in: query + name: user_id + type: integer + - in: query + name: username type: string produces: - application/json @@ -4086,7 +4071,7 @@ paths: - $ref: '#/definitions/controller.Response' - properties: data: - $ref: '#/definitions/dto.ListHistoryResponse' + $ref: '#/definitions/dto.ListUserActionLogResponse' type: object security: - BearerAuth: []