猪群领域其他方法映射到api

This commit is contained in:
2025-10-06 23:22:47 +08:00
parent 632bd20e7d
commit e142405bb3
10 changed files with 2783 additions and 35 deletions

View File

@@ -856,7 +856,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "获取猪批次列表",
"parameters": [
@@ -900,7 +900,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "创建猪批次",
"parameters": [
@@ -943,7 +943,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "从猪批次移除空栏",
"parameters": [
@@ -982,7 +982,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "将猪栏划拨到新批次",
"parameters": [
@@ -1020,7 +1020,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "获取单个猪批次",
"parameters": [
@@ -1062,7 +1062,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "更新猪批次",
"parameters": [
@@ -1110,7 +1110,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "删除猪批次",
"parameters": [
@@ -1142,7 +1142,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "为猪批次分配空栏",
"parameters": [
@@ -1173,6 +1173,47 @@
}
}
},
"/api/v1/pig-batches/{id}/buy-pigs": {
"post": {
"description": "记录猪批次中的猪只购买事件",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "处理买猪的业务逻辑",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "买猪请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.BuyPigsRequest"
}
}
],
"responses": {
"200": {
"description": "买猪成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{id}/move-pigs-into-pen": {
"post": {
"description": "将指定数量的猪只从批次的“虚拟库存”移入一个已分配的猪栏",
@@ -1183,7 +1224,7 @@
"application/json"
],
"tags": [
"猪批次管理"
"猪管理"
],
"summary": "将猪只从“虚拟库存”移入指定猪栏",
"parameters": [
@@ -1214,6 +1255,375 @@
}
}
},
"/api/v1/pig-batches/{id}/record-cull": {
"post": {
"description": "记录猪批次中正常猪只淘汰的数量和发生时间",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "记录正常猪只淘汰事件",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "记录正常猪只淘汰请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RecordCullRequest"
}
}
],
"responses": {
"200": {
"description": "记录成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{id}/record-death": {
"post": {
"description": "记录猪批次中正常猪只死亡的数量和发生时间",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "记录正常猪只死亡事件",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "记录正常猪只死亡请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RecordDeathRequest"
}
}
],
"responses": {
"200": {
"description": "记录成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{id}/record-sick-pig-cull": {
"post": {
"description": "记录猪批次中病猪淘汰的数量、治疗地点和发生时间",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "记录病猪淘汰事件",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "记录病猪淘汰请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RecordSickPigCullRequest"
}
}
],
"responses": {
"200": {
"description": "记录成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{id}/record-sick-pig-death": {
"post": {
"description": "记录猪批次中病猪死亡的数量、治疗地点和发生时间",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "记录病猪死亡事件",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "记录病猪死亡请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RecordSickPigDeathRequest"
}
}
],
"responses": {
"200": {
"description": "记录成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{id}/record-sick-pig-recovery": {
"post": {
"description": "记录猪批次中病猪康复的数量、治疗地点和发生时间",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "记录病猪康复事件",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "记录病猪康复请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RecordSickPigRecoveryRequest"
}
}
],
"responses": {
"200": {
"description": "记录成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{id}/record-sick-pigs": {
"post": {
"description": "记录猪批次中新增病猪的数量、治疗地点和发生时间",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "记录新增病猪事件",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "记录病猪请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RecordSickPigsRequest"
}
}
],
"responses": {
"200": {
"description": "记录成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{id}/sell-pigs": {
"post": {
"description": "记录猪批次中的猪只出售事件",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "处理卖猪的业务逻辑",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "卖猪请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SellPigsRequest"
}
}
],
"responses": {
"200": {
"description": "卖猪成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{id}/transfer-within-batch": {
"post": {
"description": "将指定数量的猪只在同一个猪群的不同猪栏间调动",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "群内调栏",
"parameters": [
{
"type": "integer",
"description": "猪批次ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "群内调栏请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.TransferPigsWithinBatchRequest"
}
}
],
"responses": {
"200": {
"description": "调栏成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-batches/{sourceBatchID}/transfer-across-batches": {
"post": {
"description": "将指定数量的猪只从一个猪群的猪栏调动到另一个猪群的猪栏",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"猪批次管理"
],
"summary": "跨猪群调栏",
"parameters": [
{
"type": "integer",
"description": "源猪批次ID",
"name": "sourceBatchID",
"in": "path",
"required": true
},
{
"description": "跨群调栏请求信息",
"name": "body",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.TransferPigsAcrossBatchesRequest"
}
}
],
"responses": {
"200": {
"description": "调栏成功",
"schema": {
"$ref": "#/definitions/controller.Response"
}
}
}
}
},
"/api/v1/pig-houses": {
"get": {
"description": "获取所有猪舍的列表",
@@ -1919,6 +2329,50 @@
"dto.AssignEmptyPensToBatchRequest": {
"type": "object"
},
"dto.BuyPigsRequest": {
"type": "object",
"required": [
"penID",
"quantity",
"totalPrice",
"tradeDate",
"traderName",
"unitPrice"
],
"properties": {
"penID": {
"description": "猪栏ID",
"type": "integer"
},
"quantity": {
"description": "买入猪只数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
},
"totalPrice": {
"description": "总价",
"type": "number",
"minimum": 0
},
"tradeDate": {
"description": "交易日期",
"type": "string"
},
"traderName": {
"description": "交易方名称",
"type": "string"
},
"unitPrice": {
"description": "单价",
"type": "number",
"minimum": 0
}
}
},
"dto.CreateAreaControllerRequest": {
"type": "object",
"required": [
@@ -2530,6 +2984,248 @@
}
}
},
"dto.RecordCullRequest": {
"type": "object",
"required": [
"happenedAt",
"penID",
"quantity"
],
"properties": {
"happenedAt": {
"description": "发生时间",
"type": "string"
},
"penID": {
"description": "猪栏ID",
"type": "integer"
},
"quantity": {
"description": "淘汰猪数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
}
}
},
"dto.RecordDeathRequest": {
"type": "object",
"required": [
"happenedAt",
"penID",
"quantity"
],
"properties": {
"happenedAt": {
"description": "发生时间",
"type": "string"
},
"penID": {
"description": "猪栏ID",
"type": "integer"
},
"quantity": {
"description": "死亡猪数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
}
}
},
"dto.RecordSickPigCullRequest": {
"type": "object",
"required": [
"happenedAt",
"penID",
"quantity",
"treatmentLocation"
],
"properties": {
"happenedAt": {
"description": "发生时间",
"type": "string"
},
"penID": {
"description": "猪栏ID",
"type": "integer"
},
"quantity": {
"description": "淘汰猪数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
},
"treatmentLocation": {
"description": "治疗地点",
"allOf": [
{
"$ref": "#/definitions/models.PigBatchSickPigTreatmentLocation"
}
]
}
}
},
"dto.RecordSickPigDeathRequest": {
"type": "object",
"required": [
"happenedAt",
"penID",
"quantity",
"treatmentLocation"
],
"properties": {
"happenedAt": {
"description": "发生时间",
"type": "string"
},
"penID": {
"description": "猪栏ID",
"type": "integer"
},
"quantity": {
"description": "死亡猪数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
},
"treatmentLocation": {
"description": "治疗地点",
"allOf": [
{
"$ref": "#/definitions/models.PigBatchSickPigTreatmentLocation"
}
]
}
}
},
"dto.RecordSickPigRecoveryRequest": {
"type": "object",
"required": [
"happenedAt",
"penID",
"quantity",
"treatmentLocation"
],
"properties": {
"happenedAt": {
"description": "发生时间",
"type": "string"
},
"penID": {
"description": "猪栏ID",
"type": "integer"
},
"quantity": {
"description": "康复猪数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
},
"treatmentLocation": {
"description": "治疗地点",
"allOf": [
{
"$ref": "#/definitions/models.PigBatchSickPigTreatmentLocation"
}
]
}
}
},
"dto.RecordSickPigsRequest": {
"type": "object",
"required": [
"happenedAt",
"penID",
"quantity",
"treatmentLocation"
],
"properties": {
"happenedAt": {
"description": "发生时间",
"type": "string"
},
"penID": {
"description": "猪栏ID",
"type": "integer"
},
"quantity": {
"description": "病猪数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
},
"treatmentLocation": {
"description": "治疗地点",
"allOf": [
{
"$ref": "#/definitions/models.PigBatchSickPigTreatmentLocation"
}
]
}
}
},
"dto.SellPigsRequest": {
"type": "object",
"required": [
"penID",
"quantity",
"totalPrice",
"tradeDate",
"traderName",
"unitPrice"
],
"properties": {
"penID": {
"description": "猪栏ID",
"type": "integer"
},
"quantity": {
"description": "卖出猪只数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
},
"totalPrice": {
"description": "总价",
"type": "number",
"minimum": 0
},
"tradeDate": {
"description": "交易日期",
"type": "string"
},
"traderName": {
"description": "交易方名称",
"type": "string"
},
"unitPrice": {
"description": "单价",
"type": "number",
"minimum": 0
}
}
},
"dto.SubPlanResponse": {
"type": "object",
"properties": {
@@ -2620,6 +3316,65 @@
}
}
},
"dto.TransferPigsAcrossBatchesRequest": {
"type": "object",
"required": [
"destBatchID",
"fromPenID",
"quantity",
"toPenID"
],
"properties": {
"destBatchID": {
"description": "目标猪批次ID",
"type": "integer"
},
"fromPenID": {
"description": "源猪栏ID",
"type": "integer"
},
"quantity": {
"description": "调栏猪只数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
},
"toPenID": {
"description": "目标猪栏ID",
"type": "integer"
}
}
},
"dto.TransferPigsWithinBatchRequest": {
"type": "object",
"required": [
"fromPenID",
"quantity",
"toPenID"
],
"properties": {
"fromPenID": {
"description": "源猪栏ID",
"type": "integer"
},
"quantity": {
"description": "调栏猪只数量",
"type": "integer",
"minimum": 1
},
"remarks": {
"description": "备注",
"type": "string"
},
"toPenID": {
"description": "目标猪栏ID",
"type": "integer"
}
}
},
"dto.UpdateAreaControllerRequest": {
"type": "object",
"required": [
@@ -2859,6 +3614,17 @@
"OriginTypePurchased"
]
},
"models.PigBatchSickPigTreatmentLocation": {
"type": "string",
"enum": [
"原地治疗",
"病猪栏治疗"
],
"x-enum-varnames": [
"TreatmentLocationOnSite",
"TreatmentLocationSickBay"
]
},
"models.PigBatchStatus": {
"type": "string",
"enum": [