{
  "openapi": "3.0.3",
  "info": {
    "title": "WCS 入库作业与货位分配测试",
    "version": "1.0.0"
  },
  "servers": [
    { "url": "http://localhost:8080" }
  ],
  "tags": [
    { "name": "WCS入库货位分配" }
  ],
  "paths": {
    "/api/external/wcs/inbound/job": {
      "post": {
        "tags": ["WCS入库货位分配"],
        "summary": "1-WCS获取入库作业",
        "operationId": "claimDenseInboundJob",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/WcsDenseInboundJobRequest" },
              "example": { "trayCode": "TEST-TRAY-001", "entranceId": "IN-01", "height": 1 }
            }
          }
        },
        "responses": {
          "200": {
            "description": "业务结果，code=0成功，code=1失败",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WcsResponse" } } }
          }
        }
      }
    },
    "/api/external/wcs/inbound/location/plan": {
      "post": {
        "tags": ["WCS入库货位分配"],
        "summary": "2-WCS选择入库层（Apifox测试请求）",
        "description": "实际请求地址为 /api/external/wcs/inbound/location。此处使用独立文档路径，方便在 Apifox 中保存第一阶段请求。",
        "operationId": "planDenseInboundLayer",
        "servers": [{ "url": "http://localhost:8080" }],
        "x-apifox-folder": "WCS入库货位分配",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/WcsInboundLocationRequest" },
              "example": { "jobId": "替换为获取作业返回的jobId", "height": 1, "availableLayers": [1, 2, 3, 4, 5], "currentLayers": [2], "allocationStage": 1 }
            }
          }
        },
        "responses": { "200": { "description": "成功时data.roadwayId为选中层", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WcsResponse" } } } } },
        "x-apifox-url": "/api/external/wcs/inbound/location"
      }
    },
    "/api/external/wcs/inbound/location/allocate": {
      "post": {
        "tags": ["WCS入库货位分配"],
        "summary": "3-WCS分配具体货位（Apifox测试请求）",
        "description": "实际请求地址为 /api/external/wcs/inbound/location。此处使用独立文档路径，方便在 Apifox 中保存第二阶段请求。",
        "operationId": "allocateDenseInboundLocation",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/WcsInboundLocationRequest" },
              "example": { "jobId": "替换为同一个jobId", "height": 1, "availableLayers": [1, 2, 3, 4, 5], "currentLayers": [2], "allocationStage": 2 }
            }
          }
        },
        "responses": { "200": { "description": "成功时返回cargoSpaceId和cargoSpaceName", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WcsResponse" } } } } },
        "x-apifox-url": "/api/external/wcs/inbound/location"
      }
    }
  },
  "components": {
    "schemas": {
      "WcsDenseInboundJobRequest": {
        "type": "object",
        "required": ["trayCode", "entranceId", "height"],
        "properties": {
          "trayCode": { "type": "string", "description": "03仓已有待领取入库作业的托盘号" },
          "entranceId": { "type": "string", "description": "WCS入口号" },
          "height": { "type": "integer", "enum": [1, 2], "description": "货物高度层级" }
        }
      },
      "WcsInboundLocationRequest": {
        "type": "object",
        "required": ["jobId", "height", "availableLayers", "currentLayers", "allocationStage"],
        "properties": {
          "jobId": { "type": "string" },
          "height": { "type": "integer", "enum": [1, 2] },
          "availableLayers": { "type": "array", "minItems": 1, "items": { "type": "integer", "minimum": 1, "maximum": 5 } },
          "currentLayers": { "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 5 } },
          "allocationStage": { "type": "integer", "enum": [1, 2] }
        }
      },
      "WcsResponse": {
        "type": "object",
        "properties": {
          "code": { "type": "integer", "enum": [0, 1] },
          "msg": { "type": "string" },
          "data": { "type": "object", "nullable": true, "additionalProperties": true }
        }
      }
    }
  }
}