更新swag

This commit is contained in:
2025-10-31 18:14:31 +08:00
parent 0ff82657ab
commit e704249d75

View File

@@ -771,7 +771,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -850,7 +850,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -929,7 +929,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -993,7 +993,6 @@
}, },
{ {
"enum": [ "enum": [
7,
-1, -1,
0, 0,
1, 1,
@@ -1003,12 +1002,12 @@
5, 5,
-1, -1,
5, 5,
6 6,
7
], ],
"type": "integer", "type": "integer",
"format": "int32", "format": "int32",
"x-enum-varnames": [ "x-enum-varnames": [
"_numLevels",
"DebugLevel", "DebugLevel",
"InfoLevel", "InfoLevel",
"WarnLevel", "WarnLevel",
@@ -1018,7 +1017,8 @@
"FatalLevel", "FatalLevel",
"_minLevel", "_minLevel",
"_maxLevel", "_maxLevel",
"InvalidLevel" "InvalidLevel",
"_numLevels"
], ],
"name": "level", "name": "level",
"in": "query" "in": "query"
@@ -1052,7 +1052,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1151,7 +1151,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1230,7 +1230,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1304,7 +1304,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1388,7 +1388,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1462,7 +1462,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1556,7 +1556,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1635,7 +1635,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1709,7 +1709,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1783,7 +1783,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1867,7 +1867,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -1936,7 +1936,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -2020,7 +2020,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -2099,7 +2099,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -2173,7 +2173,7 @@
}, },
{ {
"type": "integer", "type": "integer",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -3410,7 +3410,7 @@
"BearerAuth": [] "BearerAuth": []
} }
], ],
"description": "创建一个新猪舍", "description": "根据提供的信息创建一个新猪舍",
"consumes": [ "consumes": [
"application/json" "application/json"
], ],
@@ -3613,7 +3613,7 @@
{ {
"type": "integer", "type": "integer",
"description": "每页大小", "description": "每页大小",
"name": "pageSize", "name": "page_size",
"in": "query" "in": "query"
}, },
{ {
@@ -3629,7 +3629,7 @@
"PlanTypeFilterSystem" "PlanTypeFilterSystem"
], ],
"description": "计划类型", "description": "计划类型",
"name": "planType", "name": "plan_type",
"in": "query" "in": "query"
} }
], ],
@@ -3998,97 +3998,6 @@
} }
} }
}, },
"/api/v1/users/{id}/history": {
"get": {
"security": [
{
"BearerAuth": []
}
],
"description": "根据用户ID分页获取该用户的操作审计日志。支持与通用日志查询接口相同的过滤和排序参数。",
"produces": [
"application/json"
],
"tags": [
"用户管理"
],
"summary": "获取指定用户的操作历史",
"parameters": [
{
"type": "integer",
"description": "用户ID",
"name": "id",
"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",
"name": "page",
"in": "query"
},
{
"type": "integer",
"name": "pageSize",
"in": "query"
},
{
"type": "string",
"name": "start_time",
"in": "query"
},
{
"type": "string",
"name": "status",
"in": "query"
},
{
"type": "integer",
"name": "user_id",
"in": "query"
},
{
"type": "string",
"name": "username",
"in": "query"
}
],
"responses": {
"200": {
"description": "业务码为200代表成功获取",
"schema": {
"allOf": [
{
"$ref": "#/definitions/controller.Response"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/definitions/dto.ListUserActionLogResponse"
}
}
}
]
}
}
}
}
},
"/api/v1/users/{id}/notifications/test": { "/api/v1/users/{id}/notifications/test": {
"post": { "post": {
"security": [ "security": [
@@ -4161,7 +4070,7 @@
] ]
}, },
"data": { "data": {
"description": "业务数据" "description": "业务数据, omitempty表示如果为空则不序列化"
}, },
"message": { "message": {
"description": "提示信息", "description": "提示信息",
@@ -4247,20 +4156,38 @@
} }
}, },
"dto.AssignEmptyPensToBatchRequest": { "dto.AssignEmptyPensToBatchRequest": {
"type": "object" "type": "object",
"required": [
"pen_ids"
],
"properties": {
"pen_ids": {
"description": "待分配的猪栏ID列表",
"type": "array",
"minItems": 1,
"items": {
"type": "integer"
},
"example": [
1,
2,
3
]
}
}
}, },
"dto.BuyPigsRequest": { "dto.BuyPigsRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"penID", "pen_id",
"quantity", "quantity",
"totalPrice", "total_price",
"tradeDate", "trade_date",
"traderName", "trader_name",
"unitPrice" "unit_price"
], ],
"properties": { "properties": {
"penID": { "pen_id": {
"description": "猪栏ID", "description": "猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -4273,20 +4200,20 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"totalPrice": { "total_price": {
"description": "总价", "description": "总价",
"type": "number", "type": "number",
"minimum": 0 "minimum": 0
}, },
"tradeDate": { "trade_date": {
"description": "交易日期", "description": "交易日期",
"type": "string" "type": "string"
}, },
"traderName": { "trader_name": {
"description": "交易方名称", "description": "交易方名称",
"type": "string" "type": "string"
}, },
"unitPrice": { "unit_price": {
"description": "单价", "description": "单价",
"type": "number", "type": "number",
"minimum": 0 "minimum": 0
@@ -4423,6 +4350,7 @@
}, },
"execute_num": { "execute_num": {
"type": "integer", "type": "integer",
"minimum": 0,
"example": 10 "example": 10
}, },
"execution_type": { "execution_type": {
@@ -4977,7 +4905,7 @@
"type": "object", "type": "object",
"required": [ "required": [
"quantity", "quantity",
"toPenID" "to_pen_id"
], ],
"properties": { "properties": {
"quantity": { "quantity": {
@@ -4989,7 +4917,7 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"toPenID": { "to_pen_id": {
"description": "目标猪栏ID", "description": "目标猪栏ID",
"type": "integer" "type": "integer"
} }
@@ -5042,7 +4970,7 @@
"page": { "page": {
"type": "integer" "type": "integer"
}, },
"pageSize": { "page_size": {
"type": "integer" "type": "integer"
}, },
"total": { "total": {
@@ -5203,11 +5131,11 @@
"description": "创建时间", "description": "创建时间",
"type": "string" "type": "string"
}, },
"currentTotalPigsInPens": { "current_total_pigs_in_pens": {
"description": "当前存栏总数", "description": "当前存栏总数",
"type": "integer" "type": "integer"
}, },
"currentTotalQuantity": { "current_total_quantity": {
"description": "当前总数", "description": "当前总数",
"type": "integer" "type": "integer"
}, },
@@ -5639,11 +5567,11 @@
"dto.ReclassifyPenToNewBatchRequest": { "dto.ReclassifyPenToNewBatchRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"penID", "pen_id",
"toBatchID" "to_batch_id"
], ],
"properties": { "properties": {
"penID": { "pen_id": {
"description": "待划拨的猪栏ID", "description": "待划拨的猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -5651,7 +5579,7 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"toBatchID": { "to_batch_id": {
"description": "目标猪批次ID", "description": "目标猪批次ID",
"type": "integer" "type": "integer"
} }
@@ -5660,16 +5588,16 @@
"dto.RecordCullRequest": { "dto.RecordCullRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"happenedAt", "happened_at",
"penID", "pen_id",
"quantity" "quantity"
], ],
"properties": { "properties": {
"happenedAt": { "happened_at": {
"description": "发生时间", "description": "发生时间",
"type": "string" "type": "string"
}, },
"penID": { "pen_id": {
"description": "猪栏ID", "description": "猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -5687,16 +5615,16 @@
"dto.RecordDeathRequest": { "dto.RecordDeathRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"happenedAt", "happened_at",
"penID", "pen_id",
"quantity" "quantity"
], ],
"properties": { "properties": {
"happenedAt": { "happened_at": {
"description": "发生时间", "description": "发生时间",
"type": "string" "type": "string"
}, },
"penID": { "pen_id": {
"description": "猪栏ID", "description": "猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -5714,17 +5642,17 @@
"dto.RecordSickPigCullRequest": { "dto.RecordSickPigCullRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"happenedAt", "happened_at",
"penID", "pen_id",
"quantity", "quantity",
"treatmentLocation" "treatment_location"
], ],
"properties": { "properties": {
"happenedAt": { "happened_at": {
"description": "发生时间", "description": "发生时间",
"type": "string" "type": "string"
}, },
"penID": { "pen_id": {
"description": "猪栏ID", "description": "猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -5737,7 +5665,7 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"treatmentLocation": { "treatment_location": {
"description": "治疗地点", "description": "治疗地点",
"allOf": [ "allOf": [
{ {
@@ -5750,17 +5678,17 @@
"dto.RecordSickPigDeathRequest": { "dto.RecordSickPigDeathRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"happenedAt", "happened_at",
"penID", "pen_id",
"quantity", "quantity",
"treatmentLocation" "treatment_location"
], ],
"properties": { "properties": {
"happenedAt": { "happened_at": {
"description": "发生时间", "description": "发生时间",
"type": "string" "type": "string"
}, },
"penID": { "pen_id": {
"description": "猪栏ID", "description": "猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -5773,7 +5701,7 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"treatmentLocation": { "treatment_location": {
"description": "治疗地点", "description": "治疗地点",
"allOf": [ "allOf": [
{ {
@@ -5786,17 +5714,17 @@
"dto.RecordSickPigRecoveryRequest": { "dto.RecordSickPigRecoveryRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"happenedAt", "happened_at",
"penID", "pen_id",
"quantity", "quantity",
"treatmentLocation" "treatment_location"
], ],
"properties": { "properties": {
"happenedAt": { "happened_at": {
"description": "发生时间", "description": "发生时间",
"type": "string" "type": "string"
}, },
"penID": { "pen_id": {
"description": "猪栏ID", "description": "猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -5809,7 +5737,7 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"treatmentLocation": { "treatment_location": {
"description": "治疗地点", "description": "治疗地点",
"allOf": [ "allOf": [
{ {
@@ -5822,17 +5750,17 @@
"dto.RecordSickPigsRequest": { "dto.RecordSickPigsRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"happenedAt", "happened_at",
"penID", "pen_id",
"quantity", "quantity",
"treatmentLocation" "treatment_location"
], ],
"properties": { "properties": {
"happenedAt": { "happened_at": {
"description": "发生时间", "description": "发生时间",
"type": "string" "type": "string"
}, },
"penID": { "pen_id": {
"description": "猪栏ID", "description": "猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -5845,7 +5773,7 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"treatmentLocation": { "treatment_location": {
"description": "治疗地点", "description": "治疗地点",
"allOf": [ "allOf": [
{ {
@@ -5858,15 +5786,15 @@
"dto.SellPigsRequest": { "dto.SellPigsRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"penID", "pen_id",
"quantity", "quantity",
"totalPrice", "total_price",
"tradeDate", "trade_date",
"traderName", "trader_name",
"unitPrice" "unit_price"
], ],
"properties": { "properties": {
"penID": { "pen_id": {
"description": "猪栏ID", "description": "猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -5879,20 +5807,20 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"totalPrice": { "total_price": {
"description": "总价", "description": "总价",
"type": "number", "type": "number",
"minimum": 0 "minimum": 0
}, },
"tradeDate": { "trade_date": {
"description": "交易日期", "description": "交易日期",
"type": "string" "type": "string"
}, },
"traderName": { "trader_name": {
"description": "交易方名称", "description": "交易方名称",
"type": "string" "type": "string"
}, },
"unitPrice": { "unit_price": {
"description": "单价", "description": "单价",
"type": "number", "type": "number",
"minimum": 0 "minimum": 0
@@ -6085,17 +6013,17 @@
"dto.TransferPigsAcrossBatchesRequest": { "dto.TransferPigsAcrossBatchesRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"destBatchID", "dest_batch_id",
"fromPenID", "from_pen_id",
"quantity", "quantity",
"toPenID" "to_pen_id"
], ],
"properties": { "properties": {
"destBatchID": { "dest_batch_id": {
"description": "目标猪批次ID", "description": "目标猪批次ID",
"type": "integer" "type": "integer"
}, },
"fromPenID": { "from_pen_id": {
"description": "源猪栏ID", "description": "源猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -6108,7 +6036,7 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"toPenID": { "to_pen_id": {
"description": "目标猪栏ID", "description": "目标猪栏ID",
"type": "integer" "type": "integer"
} }
@@ -6117,12 +6045,12 @@
"dto.TransferPigsWithinBatchRequest": { "dto.TransferPigsWithinBatchRequest": {
"type": "object", "type": "object",
"required": [ "required": [
"fromPenID", "from_pen_id",
"quantity", "quantity",
"toPenID" "to_pen_id"
], ],
"properties": { "properties": {
"fromPenID": { "from_pen_id": {
"description": "源猪栏ID", "description": "源猪栏ID",
"type": "integer" "type": "integer"
}, },
@@ -6135,7 +6063,7 @@
"description": "备注", "description": "备注",
"type": "string" "type": "string"
}, },
"toPenID": { "to_pen_id": {
"description": "目标猪栏ID", "description": "目标猪栏ID",
"type": "integer" "type": "integer"
} }
@@ -6311,6 +6239,7 @@
}, },
"execute_num": { "execute_num": {
"type": "integer", "type": "integer",
"minimum": 0,
"example": 10 "example": 10
}, },
"execution_type": { "execution_type": {
@@ -6925,7 +6854,6 @@
"type": "integer", "type": "integer",
"format": "int32", "format": "int32",
"enum": [ "enum": [
7,
-1, -1,
0, 0,
1, 1,
@@ -6935,10 +6863,10 @@
5, 5,
-1, -1,
5, 5,
6 6,
7
], ],
"x-enum-varnames": [ "x-enum-varnames": [
"_numLevels",
"DebugLevel", "DebugLevel",
"InfoLevel", "InfoLevel",
"WarnLevel", "WarnLevel",
@@ -6948,7 +6876,8 @@
"FatalLevel", "FatalLevel",
"_minLevel", "_minLevel",
"_maxLevel", "_maxLevel",
"InvalidLevel" "InvalidLevel",
"_numLevels"
] ]
} }
}, },