swag

docs/swagger.json

@@ -796,6 +796,59 @@
                 }
             }
         },
+        "/api/v1/pens/{id}/status": {
+            "put": {
+                "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.UpdatePenStatusRequest"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "更新成功",
+                        "schema": {
+                            "allOf": [
+                                {
+                                    "$ref": "#/definitions/controller.Response"
+                                },
+                                {
+                                    "type": "object",
+                                    "properties": {
+                                        "data": {
+                                            "$ref": "#/definitions/dto.PenResponse"
+                                        }
+                                    }
+                                }
+                            ]
+                        }
+                    }
+                }
+            }
+        },
         "/api/v1/pig-batches": {
             "get": {
                 "description": "获取所有猪批次的列表，支持按活跃状态筛选",
@@ -1125,7 +1178,7 @@
                         }
                     },
                     "409": {
-                        "description": "业务逻辑冲突 (如猪栏已被占用)",
+                        "description": "业务逻辑冲突 (如猪栏已被使用)",
                         "schema": {
                             "$ref": "#/definitions/controller.Response"
                         }
@@ -1926,8 +1979,7 @@
             "required": [
                 "capacity",
                 "house_id",
-                "pen_number",
-                "status"
+                "pen_number"
             ],
             "properties": {
                 "capacity": {
@@ -1938,9 +1990,6 @@
                 },
                 "pen_number": {
                     "type": "string"
-                },
-                "status": {
-                    "$ref": "#/definitions/models.PenStatus"
                 }
             }
         },
@@ -2605,7 +2654,44 @@
                     "type": "string"
                 },
                 "status": {
-                    "$ref": "#/definitions/models.PenStatus"
+                    "description": "添加oneof校验",
+                    "enum": [
+                        "空闲",
+                        "使用中",
+                        "病猪栏",
+                        "康复栏",
+                        "清洗消毒",
+                        "维修中"
+                    ],
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/models.PenStatus"
+                        }
+                    ]
+                }
+            }
+        },
+        "dto.UpdatePenStatusRequest": {
+            "type": "object",
+            "required": [
+                "status"
+            ],
+            "properties": {
+                "status": {
+                    "enum": [
+                        "空闲",
+                        "使用中",
+                        "病猪栏",
+                        "康复栏",
+                        "清洗消毒",
+                        "维修中"
+                    ],
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/models.PenStatus"
+                        }
+                    ],
+                    "example": "病猪栏"
                 }
             }
         },
@@ -2682,7 +2768,7 @@
             "type": "string",
             "enum": [
                 "空闲",
-                "占用",
+                "使用中",
                 "病猪栏",
                 "康复栏",
                 "清洗消毒",