swag

docs/swagger.yaml

@@ -132,13 +132,10 @@ definitions:
         type: integer
       pen_number:
         type: string
-      status:
-        $ref: '#/definitions/models.PenStatus'
     required:
     - capacity
     - house_id
     - pen_number
-    - status
     type: object
   dto.CreatePigHouseRequest:
     properties:
@@ -578,13 +575,38 @@ definitions:
       pen_number:
         type: string
       status:
-        $ref: '#/definitions/models.PenStatus'
+        allOf:
+        - $ref: '#/definitions/models.PenStatus'
+        description: 添加oneof校验
+        enum:
+        - 空闲
+        - 使用中
+        - 病猪栏
+        - 康复栏
+        - 清洗消毒
+        - 维修中
     required:
     - capacity
     - house_id
     - pen_number
     - status
     type: object
+  dto.UpdatePenStatusRequest:
+    properties:
+      status:
+        allOf:
+        - $ref: '#/definitions/models.PenStatus'
+        enum:
+        - 空闲
+        - 使用中
+        - 病猪栏
+        - 康复栏
+        - 清洗消毒
+        - 维修中
+        example: 病猪栏
+    required:
+    - status
+    type: object
   dto.UpdatePigHouseRequest:
     properties:
       description:
@@ -634,7 +656,7 @@ definitions:
   models.PenStatus:
     enum:
     - 空闲
-    - 占用
+    - 使用中
     - 病猪栏
     - 康复栏
     - 清洗消毒
@@ -1268,6 +1290,38 @@ paths:
       summary: 更新猪栏
       tags:
       - 猪场管理
+  /api/v1/pens/{id}/status:
+    put:
+      consumes:
+      - application/json
+      description: 更新指定猪栏的当前状态
+      parameters:
+      - description: 猪栏ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      - description: 新的猪栏状态
+        in: body
+        name: body
+        required: true
+        schema:
+          $ref: '#/definitions/dto.UpdatePenStatusRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 更新成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/controller.Response'
+            - properties:
+                data:
+                  $ref: '#/definitions/dto.PenResponse'
+              type: object
+      summary: 更新猪栏状态
+      tags:
+      - 猪场管理
   /api/v1/pig-batches:
     get:
       description: 获取所有猪批次的列表，支持按活跃状态筛选
@@ -1473,7 +1527,7 @@ paths:
           schema:
             $ref: '#/definitions/controller.Response'
         "409":
-          description: 业务逻辑冲突 (如猪栏已被占用)
+          description: 业务逻辑冲突 (如猪栏已被使用)
           schema:
             $ref: '#/definitions/controller.Response'
         "500":