{
  "swagger": "2.0",
  "info": {
    "title": "订单服务",
    "version": "1.0.0"
  },
  "basePath": "/",
  "paths": {
    "/admin/order/album/file/{albumFileId}": {
      "put": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "编辑文件信息",
        "description": "**关联字典**：\n- album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频\n- album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "updateFileUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "albumFileId",
            "in": "path",
            "description": "相册文件ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/AlbumFileUpdateRequest",
              "originalRef": "AlbumFileUpdateRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«AlbumFileVO»",
              "originalRef": "统一响应结果«AlbumFileVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«AlbumFileVO»",
              "originalRef": "统一响应结果«AlbumFileVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "delete": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "删除文件",
        "description": "删除相册中的单个文件（照片/视频）。仅上传者或超级管理员可操作，删除后C端用户不再可见。",
        "operationId": "deleteFileUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "albumFileId",
            "in": "path",
            "description": "相册文件ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/album/folder/{folderId}": {
      "put": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "编辑相册文件夹",
        "description": "修改文件夹名称或描述。仅创建者或超级管理员可操作",
        "operationId": "updateFolderUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "folderId",
            "in": "path",
            "description": "文件夹ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/AlbumFolderRequest",
              "originalRef": "AlbumFolderRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«AlbumFolderVO»",
              "originalRef": "统一响应结果«AlbumFolderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«AlbumFolderVO»",
              "originalRef": "统一响应结果«AlbumFolderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "delete": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "删除相册文件夹",
        "description": "删除文件夹及其下所有文件。仅创建者或超级管理员可操作。删除后C端用户不再可见",
        "operationId": "deleteFolderUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "folderId",
            "in": "path",
            "description": "文件夹ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/album/folder/{folderId}/cover": {
      "put": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "设置文件夹封面",
        "description": "将文件夹中的指定文件设为封面图，封面图会在文件夹列表中展示。仅上传者或超级管理员可操作。",
        "operationId": "setCoverUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "albumFileId",
            "in": "query",
            "description": "相册文件ID",
            "required": false,
            "type": "integer",
            "format": "int64",
            "allowEmptyValue": false
          },
          {
            "name": "folderId",
            "in": "path",
            "description": "文件夹ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/album/folder/{folderId}/files": {
      "get": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "查询文件夹下的文件列表",
        "description": "**关联字典**：\n- album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频\n- album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "listFilesUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "folderId",
            "in": "path",
            "description": "文件夹ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "page",
            "in": "query",
            "description": "页码",
            "required": false,
            "type": "integer",
            "default": 1,
            "format": "int32",
            "allowEmptyValue": false
          },
          {
            "name": "size",
            "in": "query",
            "description": "每页数量",
            "required": false,
            "type": "integer",
            "default": 20,
            "format": "int32",
            "allowEmptyValue": false
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«AlbumFileVO»»",
              "originalRef": "统一响应结果«分页结果«AlbumFileVO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«AlbumFileVO»»",
              "originalRef": "统一响应结果«分页结果«AlbumFileVO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "post": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "批量添加文件到文件夹",
        "description": "一次添加多个照片/视频到指定文件夹。文件需先通过文件服务上传获取OSS URL\n\n**关联字典**：\n- album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频\n- album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "addFilesUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "folderId",
            "in": "path",
            "description": "文件夹ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/AlbumFileBatchAddRequest",
              "originalRef": "AlbumFileBatchAddRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«AlbumFileVO»»",
              "originalRef": "统一响应结果«List«AlbumFileVO»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«AlbumFileVO»»",
              "originalRef": "统一响应结果«List«AlbumFileVO»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/album/my-uploads": {
      "get": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "我的上传",
        "description": "查询当前管理员上传的所有相册文件（跨订单），方便管理自己上传的内容\n\n**关联字典**：\n- album_file_type（文件类型，返回字段fileType）：IMAGE=图片, VIDEO=视频\n- album_location_type（地点类型，返回字段locationType）：RESOURCE=关联资源, CUSTOM=自定义地点\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "listMyUploadsUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码",
            "required": false,
            "type": "integer",
            "default": 1,
            "format": "int32",
            "allowEmptyValue": false
          },
          {
            "name": "size",
            "in": "query",
            "description": "每页数量",
            "required": false,
            "type": "integer",
            "default": 20,
            "format": "int32",
            "allowEmptyValue": false
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«AlbumFileVO»»",
              "originalRef": "统一响应结果«分页结果«AlbumFileVO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«AlbumFileVO»»",
              "originalRef": "统一响应结果«分页结果«AlbumFileVO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/config/expiry-minutes": {
      "get": {
        "tags": [
          "订单配置接口"
        ],
        "summary": "获取订单过期配置",
        "description": "获取当前的订单未支付自动过期时间（分钟）。\n返回当前值、默认值和配置来源（redis=已自定义, default=使用默认值）",
        "operationId": "getExpiryMinutesUsingGET",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,object»»",
              "originalRef": "统一响应结果«Map«string,object»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,object»»",
              "originalRef": "统一响应结果«Map«string,object»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "put": {
        "tags": [
          "订单配置接口"
        ],
        "summary": "设置订单过期时间（分钟）",
        "description": "修改订单未支付自动取消的等待时间。存储在Redis中，即时生效。\n仅影响新创建的订单，已有订单的过期时间不变",
        "operationId": "setExpiryMinutesUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "expiryRequest",
            "description": "修改订单过期时间请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/修改订单过期时间请求",
              "originalRef": "修改订单过期时间请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/create": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "创建订单（定制师代下单）",
        "description": "创建订单流程：选择产品 → 填写联系人和出行人 → 系统计算报价 → 生成订单(PENDING_PAY状态)\n\n权限：CUSTOM产品仅创建者可下单，CORE/ROUTE产品所有管理员可下单\n\n【关联字典】\n- 请求参数 productType → 字典：product_type（产品类型）\n- 请求参数 travelers[].travelerType → 字典：traveler_type（出行人类型）\n- 请求参数 travelers[].idCardType → 字典：id_card_type（证件类型）\n- 请求参数 travelers[].gender → 字典：gender（性别）\n- 返回字段 status → 字典：order_status（订单状态）\n- 返回字段 processStatus → 字典：order_process_status（订单内部流程状态）\n- 返回字段 productType → 字典：product_type（产品类型）\n- 返回字段 travelers[].travelerType → 字典：traveler_type（出行人类型）\n- 返回字段 travelers[].idCardType → 字典：id_card_type（证件类型）\n- 返回字段 travelers[].gender → 字典：gender（性别）",
        "operationId": "createOrderUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "createRequest",
            "description": "创建订单请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/管理员创建订单请求",
              "originalRef": "管理员创建订单请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«订单详情VO»",
              "originalRef": "统一响应结果«订单详情VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«订单详情VO»",
              "originalRef": "统一响应结果«订单详情VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/early-bird": {
      "post": {
        "tags": [
          "早鸟优惠计划管理"
        ],
        "summary": "创建早鸟优惠计划",
        "description": "创建一个早鸟优惠计划，在指定日期范围内下单且满足最低人数条件的订单可享受优惠。\n下单时系统自动匹配最优的早鸟计划。权限：仅超级管理员(SUPER_ADMIN)",
        "operationId": "createUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "planRequest",
            "description": "创建早鸟计划请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/早鸟优惠计划请求",
              "originalRef": "早鸟优惠计划请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«早鸟优惠计划VO»",
              "originalRef": "统一响应结果«早鸟优惠计划VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«早鸟优惠计划VO»",
              "originalRef": "统一响应结果«早鸟优惠计划VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/early-bird/list": {
      "get": {
        "tags": [
          "早鸟优惠计划管理"
        ],
        "summary": "早鸟优惠计划列表",
        "description": "分页查询所有早鸟优惠计划。权限：仅超级管理员(SUPER_ADMIN)",
        "operationId": "listUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码",
            "required": false,
            "type": "integer",
            "default": 1,
            "format": "int32",
            "allowEmptyValue": false
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "type": "integer",
            "default": 20,
            "format": "int32",
            "allowEmptyValue": false
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«早鸟优惠计划VO»»",
              "originalRef": "统一响应结果«分页结果«早鸟优惠计划VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«早鸟优惠计划VO»»",
              "originalRef": "统一响应结果«分页结果«早鸟优惠计划VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/early-bird/{planId}": {
      "get": {
        "tags": [
          "早鸟优惠计划管理"
        ],
        "summary": "早鸟优惠计划详情",
        "description": "权限：仅超级管理员(SUPER_ADMIN)",
        "operationId": "detailUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "description": "早鸟计划ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«早鸟优惠计划VO»",
              "originalRef": "统一响应结果«早鸟优惠计划VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«早鸟优惠计划VO»",
              "originalRef": "统一响应结果«早鸟优惠计划VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "put": {
        "tags": [
          "早鸟优惠计划管理"
        ],
        "summary": "修改早鸟优惠计划",
        "description": "权限：仅超级管理员(SUPER_ADMIN)。修改不影响已下单的订单优惠",
        "operationId": "updateUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "description": "早鸟计划ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "planRequest",
            "description": "修改早鸟计划请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/早鸟优惠计划请求",
              "originalRef": "早鸟优惠计划请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "delete": {
        "tags": [
          "早鸟优惠计划管理"
        ],
        "summary": "删除早鸟优惠计划",
        "description": "权限：仅超级管理员(SUPER_ADMIN)。删除不影响已下单的订单优惠",
        "operationId": "deleteUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "planId",
            "in": "path",
            "description": "早鸟计划ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/early-bird/{planId}/toggle": {
      "put": {
        "tags": [
          "早鸟优惠计划管理"
        ],
        "summary": "启用/禁用早鸟优惠计划",
        "description": "禁用后该计划不再参与自动匹配。权限：仅超级管理员(SUPER_ADMIN)",
        "operationId": "toggleUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "enabled",
            "in": "query",
            "description": "是否启用",
            "required": false,
            "type": "boolean",
            "allowEmptyValue": false
          },
          {
            "name": "planId",
            "in": "path",
            "description": "早鸟计划ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/list": {
      "get": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "订单列表",
        "description": "支持按关键词（订单号/联系人/产品名）、状态、内部流程状态、产品类型筛选。\n支持按创建时间/出发日期/总价排序。\n\n返回分页结果，包含订单基本信息、状态、支付信息和产品封面\n\n【关联字典】\n- 筛选参数 status → 字典：order_status（订单状态）\n- 筛选参数 processStatus → 字典：order_process_status（订单内部流程状态）\n- 筛选参数 productType → 字典：product_type（产品类型）\n- 返回字段 status → 字典：order_status（订单状态）\n- 返回字段 processStatus → 字典：order_process_status（订单内部流程状态）\n- 返回字段 productType → 字典：product_type（产品类型）",
        "operationId": "listOrdersUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "contactPhone",
            "in": "query",
            "description": "联系电话",
            "required": false,
            "type": "string",
            "x-example": "13800138000"
          },
          {
            "name": "createTimeEnd",
            "in": "query",
            "description": "下单时间结束（yyyy-MM-dd HH:mm:ss）",
            "required": false,
            "type": "string",
            "format": "date-time",
            "x-example": "2026-03-31 23:59:59"
          },
          {
            "name": "createTimeStart",
            "in": "query",
            "description": "下单时间起始（yyyy-MM-dd HH:mm:ss）",
            "required": false,
            "type": "string",
            "format": "date-time",
            "x-example": "2026-03-01 00:00:00"
          },
          {
            "name": "customizerName",
            "in": "query",
            "description": "定制师名称（模糊搜索）",
            "required": false,
            "type": "string",
            "x-example": "王骁"
          },
          {
            "name": "departureDateEnd",
            "in": "query",
            "description": "出发日期结束（yyyy-MM-dd）",
            "required": false,
            "type": "string",
            "format": "date",
            "x-example": "2026-03-31"
          },
          {
            "name": "departureDateStart",
            "in": "query",
            "description": "出发日期起始（yyyy-MM-dd）",
            "required": false,
            "type": "string",
            "format": "date",
            "x-example": "2026-03-01"
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "搜索关键词（订单号/联系人姓名/产品名称）",
            "required": false,
            "type": "string",
            "x-example": "HL2026"
          },
          {
            "name": "mchId",
            "in": "query",
            "description": "商户号（字典：mch_id）",
            "required": false,
            "type": "string",
            "x-example": "shanhe"
          },
          {
            "name": "page",
            "in": "query",
            "description": "页码",
            "required": false,
            "type": "integer",
            "format": "int32",
            "x-example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "type": "integer",
            "format": "int32",
            "x-example": 20
          },
          {
            "name": "processStatus",
            "in": "query",
            "description": "内部流程状态（字典：order_process_status）",
            "required": false,
            "type": "string",
            "x-example": "PENDING_ROOM"
          },
          {
            "name": "productType",
            "in": "query",
            "description": "产品类型（字典：product_type）",
            "required": false,
            "type": "string",
            "x-example": "CORE"
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "排序字段（createTime/departureDate/totalPrice）",
            "required": false,
            "type": "string",
            "x-example": "createTime"
          },
          {
            "name": "sortDir",
            "in": "query",
            "description": "排序方向（desc/asc）",
            "required": false,
            "type": "string",
            "x-example": "desc"
          },
          {
            "name": "status",
            "in": "query",
            "description": "订单状态（字典：order_status，支持逗号分隔多状态）",
            "required": false,
            "type": "string",
            "x-example": "PAID"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«管理员订单列表VO»»",
              "originalRef": "统一响应结果«分页结果«管理员订单列表VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«管理员订单列表VO»»",
              "originalRef": "统一响应结果«分页结果«管理员订单列表VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/quote": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "报价预览",
        "description": "根据产品、出发日期、人数组合实时计算报价。\n返回各资源明细价格和合计金额，前端据此展示报价清单。\n\n注意：报价仅供参考，最终价格以创建订单时为准（价格日历可能变动）",
        "operationId": "quotePreviewUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "quoteRequest",
            "description": "报价预览请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/报价预览请求",
              "originalRef": "报价预览请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,object»»",
              "originalRef": "统一响应结果«Map«string,object»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,object»»",
              "originalRef": "统一响应结果«Map«string,object»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/todo/contract-eligible": {
      "get": {
        "tags": [
          "订单待办接口"
        ],
        "summary": "可签合同订单列表（保险已完成）",
        "description": "查询保险待办已完成、可以进入签合同环节的订单列表。\n用于合同管理页面展示待签合同的订单\n\n【关联字典】\n- 返回字段 todoType → 字典：order_todo_type（订单待办类型）\n- 返回字段 orderStatus → 字典：order_status（订单状态）",
        "operationId": "getContractEligibleOrdersUsingGET",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«订单待办VO»»",
              "originalRef": "统一响应结果«List«订单待办VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«订单待办VO»»",
              "originalRef": "统一响应结果«List«订单待办VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/todo/customizer-list": {
      "get": {
        "tags": [
          "订单待办接口"
        ],
        "summary": "定制师列表",
        "description": "获取所有定制师(CUSTOMIZER角色)的列表，用于更换定制师时选择目标定制师",
        "operationId": "getCustomizerListUsingGET",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«管理员基本信息»»",
              "originalRef": "统一响应结果«List«管理员基本信息»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«管理员基本信息»»",
              "originalRef": "统一响应结果«List«管理员基本信息»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/todo/my-count": {
      "get": {
        "tags": [
          "订单待办接口"
        ],
        "summary": "我的待办数量",
        "description": "返回当前管理员未完成的待办总数，用于首页角标/红点提醒",
        "operationId": "getMyTodosCountUsingGET",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«int»",
              "originalRef": "统一响应结果«int»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«int»",
              "originalRef": "统一响应结果«int»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/todo/my-list": {
      "get": {
        "tags": [
          "订单待办接口"
        ],
        "summary": "我的待办列表",
        "description": "根据当前管理员ID和角色，查询分配给自己的未完成待办。\n超级管理员可看到所有待办，其他角色只能看到对应类型的待办\n\n【关联字典】\n- 返回字段 todoType → 字典：order_todo_type（订单待办类型）\n- 返回字段 orderStatus → 字典：order_status（订单状态）",
        "operationId": "getMyTodosUsingGET",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«订单待办VO»»",
              "originalRef": "统一响应结果«List«订单待办VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«订单待办VO»»",
              "originalRef": "统一响应结果«List«订单待办VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/todo/{todoId}/complete": {
      "put": {
        "tags": [
          "订单待办接口"
        ],
        "summary": "完成待办",
        "description": "将指定待办标记为已完成。\n需要对应角色权限：如配房待办需ROOM_MANAGER角色，配车待办需VEHICLE_MANAGER角色。\n\n完成后系统自动检查是否所有必要待办已完成，若是则推进内部流程\n\n【关联字典】\n- 涉及字段 todoType → 字典：order_todo_type（订单待办类型）",
        "operationId": "completeTodoUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "todoId",
            "in": "path",
            "description": "待办ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/work-order": {
      "post": {
        "tags": [
          "工单管理"
        ],
        "summary": "创建工单",
        "description": "创建旅途中的变更工单，需关联订单ID。\n可指定处理人，未指定则进入待分配状态。可附带差价信息和资源详情JSON\n\n【关联字典】\n- 请求参数 type → 字典：work_order_type（工单类型）\n- 请求参数 priority → 字典：work_order_priority（工单优先级）\n- 返回字段 status → 字典：work_order_status（工单状态）\n- 返回字段 type → 字典：work_order_type（工单类型）\n- 返回字段 priority → 字典：work_order_priority（工单优先级）",
        "operationId": "createUsingPOST_1",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "body",
            "description": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/CreateWorkOrderRequest",
              "originalRef": "CreateWorkOrderRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/work-order/count-by-order/{orderId}": {
      "get": {
        "tags": [
          "工单管理"
        ],
        "summary": "按订单查工单数量",
        "description": "返回指定订单关联的工单总数，用于订单详情页展示工单角标",
        "operationId": "countByOrderUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«int»",
              "originalRef": "统一响应结果«int»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«int»",
              "originalRef": "统一响应结果«int»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/work-order/list": {
      "get": {
        "tags": [
          "工单管理"
        ],
        "summary": "工单列表",
        "description": "分页查询工单，支持按状态/类型/优先级/订单编号/处理人筛选。\n工单用于处理旅行中的突发变更需求（如换房、换车、加景点等）\n\n【关联字典】\n- 筛选参数 status → 字典：work_order_status（工单状态）\n- 筛选参数 type → 字典：work_order_type（工单类型）\n- 筛选参数 priority → 字典：work_order_priority（工单优先级）\n- 返回字段 status → 字典：work_order_status（工单状态）\n- 返回字段 type → 字典：work_order_type（工单类型）\n- 返回字段 priority → 字典：work_order_priority（工单优先级）",
        "operationId": "listUsingGET_1",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "assigneeAdminId",
            "in": "query",
            "description": "处理人ID",
            "required": false,
            "type": "integer",
            "format": "int64",
            "allowEmptyValue": false
          },
          {
            "name": "orderNo",
            "in": "query",
            "description": "订单编号(模糊)",
            "required": false,
            "type": "string",
            "allowEmptyValue": false
          },
          {
            "name": "page",
            "in": "query",
            "description": "页码",
            "required": false,
            "type": "integer",
            "default": 1,
            "format": "int32",
            "allowEmptyValue": false
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "type": "integer",
            "default": 20,
            "format": "int32",
            "allowEmptyValue": false
          },
          {
            "name": "priority",
            "in": "query",
            "description": "优先级: URGENT/NORMAL",
            "required": false,
            "type": "string",
            "allowEmptyValue": false
          },
          {
            "name": "status",
            "in": "query",
            "description": "状态: PENDING/PROCESSING/RESOLVED/REJECTED",
            "required": false,
            "type": "string",
            "allowEmptyValue": false
          },
          {
            "name": "type",
            "in": "query",
            "description": "类型: ROOM_CHANGE/ROOM_ADD/CHECKOUT_CHANGE/HOTEL_ISSUE/VEHICLE_CHANGE/SCENIC_ADD/SCENIC_REMOVE/OTHER",
            "required": false,
            "type": "string",
            "allowEmptyValue": false
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«WorkOrderVO»»",
              "originalRef": "统一响应结果«分页结果«WorkOrderVO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«WorkOrderVO»»",
              "originalRef": "统一响应结果«分页结果«WorkOrderVO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/work-order/stats": {
      "get": {
        "tags": [
          "工单管理"
        ],
        "summary": "工单统计",
        "description": "返回各状态的工单数量和紧急工单数，用于工单管理页面顶部统计卡片\n\n【关联字典】\n- 返回字段中的状态key → 字典：work_order_status（工单状态）",
        "operationId": "getStatsUsingGET",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,object»»",
              "originalRef": "统一响应结果«Map«string,object»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,object»»",
              "originalRef": "统一响应结果«Map«string,object»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/work-order/{workOrderId}": {
      "get": {
        "tags": [
          "工单管理"
        ],
        "summary": "工单详情",
        "description": "返回工单完整信息，包括关联订单、资源详情、处理记录和备注列表\n\n【关联字典】\n- 返回字段 status → 字典：work_order_status（工单状态）\n- 返回字段 type → 字典：work_order_type（工单类型）\n- 返回字段 priority → 字典：work_order_priority（工单优先级）",
        "operationId": "getDetailUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "workOrderId",
            "in": "path",
            "description": "工单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/work-order/{workOrderId}/assign": {
      "put": {
        "tags": [
          "工单管理"
        ],
        "summary": "指派工单",
        "description": "将工单分配给指定管理员处理。被指派人将在待办列表中看到该工单",
        "operationId": "assignUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "assigneeId",
            "in": "query",
            "description": "处理人ID",
            "required": false,
            "type": "integer",
            "format": "int64",
            "allowEmptyValue": false
          },
          {
            "name": "assigneeName",
            "in": "query",
            "description": "处理人姓名",
            "required": false,
            "type": "string",
            "allowEmptyValue": false
          },
          {
            "name": "workOrderId",
            "in": "path",
            "description": "工单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/work-order/{workOrderId}/comment": {
      "post": {
        "tags": [
          "工单管理"
        ],
        "summary": "添加工单备注",
        "description": "在工单中追加备注信息，用于内部沟通和处理过程记录",
        "operationId": "addCommentUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "workOrderId",
            "in": "path",
            "description": "工单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "body",
            "description": "body",
            "required": true,
            "schema": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/work-order/{workOrderId}/process": {
      "put": {
        "tags": [
          "工单管理"
        ],
        "summary": "处理工单（解决/驳回）",
        "description": "解决时需填写处理结果(resolution)，驳回时需填写驳回原因(rejectReason)。\n可调整差价(costDifference)，正数表示加价，负数表示退费\n\n【关联字典】\n- 返回字段 status → 字典：work_order_status（工单状态）",
        "operationId": "processUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "workOrderId",
            "in": "path",
            "description": "工单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "body",
            "description": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/ProcessWorkOrderRequest",
              "originalRef": "ProcessWorkOrderRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«WorkOrderVO»",
              "originalRef": "统一响应结果«WorkOrderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}": {
      "get": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "订单详情",
        "description": "返回订单完整信息，包括：基本信息、产品快照、联系人、出行人列表、支付记录、优惠明细、时间线、内部流程状态等\n\n【关联字典】\n- 返回字段 status → 字典：order_status（订单状态）\n- 返回字段 processStatus → 字典：order_process_status（订单内部流程状态）\n- 返回字段 productType → 字典：product_type（产品类型）\n- 返回字段 travelers[].travelerType → 字典：traveler_type（出行人类型）\n- 返回字段 travelers[].idCardType → 字典：id_card_type（证件类型）\n- 返回字段 travelers[].gender → 字典：gender（性别）\n- 返回字段 timeline[].action → 字典：order_timeline_action（订单操作类型）\n- 返回字段 todos[].todoType → 字典：order_todo_type（订单待办类型）",
        "operationId": "getOrderUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«订单详情VO»",
              "originalRef": "统一响应结果«订单详情VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«订单详情VO»",
              "originalRef": "统一响应结果«订单详情VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "编辑订单",
        "description": "修改订单的联系人、人数、出发日期、售价、成本、备注等信息。\n仅传入需要修改的字段，未传入的字段不会被修改。\n\n如果提供了出行人列表(travelers)，将替换订单的全部出行人。\n已锁定的订单需先调用'申请修改'接口解锁后才能编辑\n\n【关联字典】\n- 请求参数 travelers[].travelerType → 字典：traveler_type（出行人类型）\n- 请求参数 travelers[].idCardType → 字典：id_card_type（证件类型）\n- 请求参数 travelers[].gender → 字典：gender（性别）",
        "operationId": "editOrderUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "updateRequest",
            "description": "编辑订单请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/管理员修改订单请求",
              "originalRef": "管理员修改订单请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "delete": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "删除订单",
        "description": "仅待支付(PENDING_PAY)状态的订单可删除，其他状态不可删除",
        "operationId": "deleteOrderUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/album/folder": {
      "post": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "创建相册文件夹",
        "description": "为订单创建旅行相册文件夹（如'第一天风景'、'合影'等），用于组织旅途照片/视频",
        "operationId": "createFolderUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/AlbumFolderRequest",
              "originalRef": "AlbumFolderRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«AlbumFolderVO»",
              "originalRef": "统一响应结果«AlbumFolderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«AlbumFolderVO»",
              "originalRef": "统一响应结果«AlbumFolderVO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/album/folders": {
      "get": {
        "tags": [
          "管理端相册接口"
        ],
        "summary": "查询订单的文件夹列表",
        "description": "获取指定订单的所有相册文件夹，含文件夹名称、描述、封面图、文件数量等信息。",
        "operationId": "listFoldersUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«AlbumFolderVO»»",
              "originalRef": "统一响应结果«List«AlbumFolderVO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«AlbumFolderVO»»",
              "originalRef": "统一响应结果«List«AlbumFolderVO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/available-hotels": {
      "get": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "配房可选酒店列表",
        "description": "返回所有启用酒店列表，标注该订单产品快照中指定行程天包含的酒店（inSnapshot=true），并将快照酒店排在最前面。\n用于管理员配房时选择酒店，快照中的酒店是产品行程已安排的住宿，应优先选择。\n\n**必须传 dayIndex 参数**（行程第几天，从1开始），因为每天的酒店可能不同。\n\n返回字段说明：\n- hotelId：酒店ID\n- hotelName：酒店名称\n- inSnapshot：是否在该天产品快照中（true=该天行程已安排的酒店）",
        "operationId": "getAvailableHotelsUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "dayIndex",
            "in": "query",
            "description": "行程第几天（从1开始）",
            "required": true,
            "type": "integer",
            "format": "int32",
            "allowEmptyValue": false
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«Map«string,object»»»",
              "originalRef": "统一响应结果«List«Map«string,object»»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«Map«string,object»»»",
              "originalRef": "统一响应结果«List«Map«string,object»»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/balance-pay-method": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "设置尾款支付方式",
        "description": "设置订单尾款的支付方式。ONLINE=线上微信支付，OFFLINE=线下转账（需管理员手动记录尾款到账）",
        "operationId": "setBalancePayMethodUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "balancePayMethod",
            "in": "query",
            "description": "支付方式：ONLINE-线上支付, OFFLINE-线下支付",
            "required": true,
            "type": "string",
            "allowEmptyValue": false
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/cancel": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "取消订单",
        "description": "管理员可取消的状态：待支付、已付定金、已全额支付、已确认、待付尾款\n\n已付款订单取消后需走退款流程",
        "operationId": "cancelOrderUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "cancelRequest",
            "description": "取消订单请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/管理员取消订单请求",
              "originalRef": "管理员取消订单请求"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/confirm": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "确认订单",
        "description": "确认订单后进入内部流程：待配房 → 待配车 → 待核算 → 就绪\n\n前置条件：订单状态为已全额支付(PAID)或已付定金(DEPOSIT_PAID)",
        "operationId": "confirmOrderUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/customizer": {
      "put": {
        "tags": [
          "订单待办接口"
        ],
        "summary": "更换定制师",
        "description": "将订单转派给另一位定制师。更换后原定制师的待办自动转移，订单时间线会记录此操作",
        "operationId": "changeCustomizerUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "body",
            "description": "定制师信息",
            "required": false,
            "schema": {
              "$ref": "#/definitions/更换定制师请求",
              "originalRef": "更换定制师请求"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/deposit": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "修改定金金额",
        "description": "修改订单的定金金额。仅待支付(PENDING_PAY)状态可修改。\n\n定金金额不能超过订单总价，修改后影响用户支付页面显示的应付金额",
        "operationId": "updateDepositUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "depositRequest",
            "description": "修改定金金额请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/修改定金金额请求",
              "originalRef": "修改定金金额请求"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/discount": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "添加优惠项",
        "description": "为订单添加手动优惠（如会员折扣、老客优惠等）。\n添加后系统自动重算订单应付金额。一个订单可添加多个优惠项",
        "operationId": "addDiscountUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "discountRequest",
            "description": "优惠项请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/优惠项请求",
              "originalRef": "优惠项请求"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderDiscount»",
              "originalRef": "统一响应结果«OrderDiscount»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderDiscount»",
              "originalRef": "统一响应结果«OrderDiscount»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/discount/{discountId}": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "修改优惠项",
        "description": "修改已添加的优惠项名称或金额，修改后自动重算订单应付金额",
        "operationId": "updateDiscountUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "discountId",
            "in": "path",
            "description": "优惠项ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "discountRequest",
            "description": "优惠项请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/优惠项请求",
              "originalRef": "优惠项请求"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "delete": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "删除优惠项",
        "description": "删除已添加的优惠项，删除后自动重算订单应付金额",
        "operationId": "removeDiscountUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "discountId",
            "in": "path",
            "description": "优惠项ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/hotel-assignment": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "分配酒店信息",
        "description": "按天按家庭为订单分配具体的酒店房间。\n每天每个家庭一条记录，包含酒店ID、房型ID、日期和备注。\n\n**房型升级自动处理**：如果分配的房型与产品默认房型不同，系统自动计算差价并创建升级记录。\n- 定制师操作：自动确认，差价直接计入总售价\n- 其他角色操作：创建待确认记录（临时计入尾款），通知定制师确认\n- 可通过 upgradePrice 字段手动覆盖系统计算的差价",
        "operationId": "assignHotelUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/酒店分配请求",
              "originalRef": "酒店分配请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/hotel-assignment/preview": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "配房升级差价预览",
        "description": "预览配房时的房型升级差价（不创建记录）。\n逐天比较分配房型与产品默认房型（CORE产品默认标间），返回每天差价明细和汇总。\n前端可据此展示差价信息，用户确认后再调用分配接口。",
        "operationId": "previewHotelAssignmentUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/酒店分配请求",
              "originalRef": "酒店分配请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«配房升级差价预览»",
              "originalRef": "统一响应结果«配房升级差价预览»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«配房升级差价预览»",
              "originalRef": "统一响应结果«配房升级差价预览»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/add": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "新增节点",
        "description": "在某一天的行程中新增一个节点\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "addNodeUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "新增节点请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/新增行程节点请求",
              "originalRef": "新增行程节点请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/add-day": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "新增整天行程",
        "description": "在订单行程中新增一整天（含多个节点）\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：ADD_DAY=新增整天\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "addDayUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/新增行程天请求",
              "originalRef": "新增行程天请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderItineraryEdit»»",
              "originalRef": "统一响应结果«List«OrderItineraryEdit»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderItineraryEdit»»",
              "originalRef": "统一响应结果«List«OrderItineraryEdit»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/add/{editId}": {
      "delete": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "删除新增的节点",
        "description": "删除通过编辑新增的节点\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认",
        "operationId": "removeAddedNodeUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "editId",
            "in": "path",
            "description": "编辑记录ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "撤销原因",
            "required": false,
            "schema": {
              "$ref": "#/definitions/撤销行程编辑请求",
              "originalRef": "撤销行程编辑请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/balance-summary": {
      "get": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "获取尾款调整汇总",
        "description": "返回行程编辑产生的尾款调整明细和总额",
        "operationId": "getBalanceAdjustmentSummaryUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,object»»",
              "originalRef": "统一响应结果«Map«string,object»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,object»»",
              "originalRef": "统一响应结果«Map«string,object»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/confirm-all": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "批量确认所有待确认修改",
        "description": "确认该订单所有待确认的行程编辑\n\n**关联字典**：\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认",
        "operationId": "confirmAllPendingUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«int»",
              "originalRef": "统一响应结果«int»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«int»",
              "originalRef": "统一响应结果«int»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/confirm/{editId}": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "确认单条修改",
        "description": "确认一条待确认的行程编辑\n\n**关联字典**：\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认",
        "operationId": "confirmEditUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "editId",
            "in": "path",
            "description": "编辑记录ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/day/{editId}": {
      "delete": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "删除新增的整天行程",
        "description": "删除通过新增操作添加的整天行程及其所有子节点，已确认的天不允许删除\n\n**关联字典**：\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认",
        "operationId": "removeDayUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "editId",
            "in": "path",
            "description": "ADD_DAY编辑记录ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "删除原因",
            "required": false,
            "schema": {
              "$ref": "#/definitions/撤销行程编辑请求",
              "originalRef": "撤销行程编辑请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/edit/{editId}": {
      "put": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "修改编辑记录",
        "description": "修改待确认状态的编辑记录（如调整价格、名称等）\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "updateEditUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "editId",
            "in": "path",
            "description": "编辑记录ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "updates",
            "description": "updates",
            "required": true,
            "schema": {
              "type": "object"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/edits": {
      "get": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "获取行程编辑记录列表",
        "description": "**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "getEditListUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderItineraryEdit»»",
              "originalRef": "统一响应结果«List«OrderItineraryEdit»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderItineraryEdit»»",
              "originalRef": "统一响应结果«List«OrderItineraryEdit»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/merged": {
      "get": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "获取合并后的行程（原始+编辑）",
        "description": "**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "getMergedItineraryUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«Map«string,object»»»",
              "originalRef": "统一响应结果«List«Map«string,object»»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«Map«string,object»»»",
              "originalRef": "统一响应结果«List«Map«string,object»»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/pending-count": {
      "get": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "获取待确认数量",
        "description": "返回该订单待确认的编辑数量",
        "operationId": "getPendingCountUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«long»",
              "originalRef": "统一响应结果«long»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«long»",
              "originalRef": "统一响应结果«long»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/pending/{editId}": {
      "delete": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "撤回待确认的修改",
        "description": "软删除一条待确认的编辑记录\n\n**关联字典**：\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认",
        "operationId": "withdrawPendingEditUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "editId",
            "in": "path",
            "description": "编辑记录ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": false,
            "schema": {
              "$ref": "#/definitions/撤销行程编辑请求",
              "originalRef": "撤销行程编辑请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/room-type-change": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "房型切换",
        "description": "执行房型切换，自动计算差价，创建待确认记录\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：ROOM_CHANGE=房型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：HOTEL=酒店",
        "operationId": "roomTypeChangeUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/房型变更请求",
              "originalRef": "房型变更请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/room-type-change/preview": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "房型切换差价预览",
        "description": "预览房型切换的差价，不创建记录\n\n**关联字典**：\n- resource_type（资源类型，返回字段resourceType）：HOTEL=酒店",
        "operationId": "previewRoomTypeChangeUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/房型变更请求",
              "originalRef": "房型变更请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«差价计算结果»",
              "originalRef": "统一响应结果«差价计算结果»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«差价计算结果»",
              "originalRef": "统一响应结果«差价计算结果»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/skip": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "跳过节点",
        "description": "将行程中的某个节点标记为跳过（客户不去）\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：SCENIC_SPOT=景区, ACTIVITY=活动, RESTAURANT=餐厅, HOTEL=酒店, VEHICLE=车辆",
        "operationId": "skipNodeUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "跳过节点请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/跳过行程节点请求",
              "originalRef": "跳过行程节点请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/skip/{editId}": {
      "delete": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "恢复跳过的节点",
        "description": "取消跳过，恢复为正常状态\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：SKIP=跳过, ADD=新增节点, ADD_DAY=新增整天, ROOM_CHANGE=房型切换, VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认",
        "operationId": "unskipNodeUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "editId",
            "in": "path",
            "description": "编辑记录ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "撤销原因",
            "required": false,
            "schema": {
              "$ref": "#/definitions/撤销行程编辑请求",
              "originalRef": "撤销行程编辑请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/vehicle-type-change": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "车型切换",
        "description": "执行车型切换，自动计算差价，创建待确认记录\n\n**关联字典**：\n- itinerary_edit_action（操作类型，返回字段action）：VEHICLE_CHANGE=车型切换\n- itinerary_confirm_status（确认状态，返回字段confirmStatus）：PENDING_CONFIRM=待确认, CONFIRMED=已确认\n- resource_type（资源类型，返回字段resourceType）：VEHICLE=车辆",
        "operationId": "vehicleTypeChangeUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/车型变更请求",
              "originalRef": "车型变更请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderItineraryEdit»",
              "originalRef": "统一响应结果«OrderItineraryEdit»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/itinerary/vehicle-type-change/preview": {
      "post": {
        "tags": [
          "管理端订单行程编辑"
        ],
        "summary": "车型切换差价预览",
        "description": "预览车型切换的差价，不创建记录\n\n**关联字典**：\n- resource_type（资源类型，返回字段resourceType）：VEHICLE=车辆",
        "operationId": "previewVehicleTypeChangeUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/车型变更请求",
              "originalRef": "车型变更请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«差价计算结果»",
              "originalRef": "统一响应结果«差价计算结果»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«差价计算结果»",
              "originalRef": "统一响应结果«差价计算结果»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/process-status": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "推进内部流程",
        "description": "内部流程推进顺序：待配房(PENDING_ROOM) → 待配车(PENDING_VEHICLE) → 待核算(PENDING_FINANCE) → 就绪(READY)\n\n仅在订单状态为已确认(CONFIRMED)时有效，每次调用自动推进到下一步\n\n【关联字典】\n- 涉及字段 processStatus → 字典：order_process_status（订单内部流程状态）",
        "operationId": "advanceProcessStatusUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/record-balance": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "记录尾款（线下收取）",
        "description": "管理员确认收到尾款 → 上传凭证。已确认(流程就绪)或待出行状态可操作",
        "operationId": "recordBalanceUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "body",
            "description": "尾款信息",
            "required": false,
            "schema": {
              "$ref": "#/definitions/记录尾款请求",
              "originalRef": "记录尾款请求"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/remark": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "添加备注",
        "description": "向订单时间线添加一条管理员备注。备注会记录操作人和时间，可用于内部沟通和订单跟踪",
        "operationId": "addRemarkUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "remarkRequest",
            "description": "备注请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/管理员备注请求",
              "originalRef": "管理员备注请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/request-unlock": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "申请修改（解锁已锁定订单）",
        "description": "清单确认后订单进入锁定状态，如需修改需先申请解锁\n\n解锁后可重新编辑订单信息并再次确认清单",
        "operationId": "requestUnlockUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "body",
            "description": "解锁原因",
            "required": false,
            "schema": {
              "$ref": "#/definitions/申请解锁订单请求",
              "originalRef": "申请解锁订单请求"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/room-info": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "更新房间信息（仅房务管理员/超级管理员）",
        "description": "更新订单的房间分配信息（房型、房间号、入住安排等）。\n\n**权限**：仅ROOM_MANAGER（房务管理员）或SUPER_ADMIN（超级管理员）可操作。",
        "operationId": "updateRoomInfoUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "roomInfoRequest",
            "description": "房间信息请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/房间信息请求",
              "originalRef": "房间信息请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/room-info/check-diff": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "检测房型一致性",
        "description": "检测当前房间配置是否与产品快照一致。返回 null 表示一致，否则返回不一致描述",
        "operationId": "checkRoomTypeDiffUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "roomInfoJson",
            "description": "roomInfoJson",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«string»",
              "originalRef": "统一响应结果«string»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«string»",
              "originalRef": "统一响应结果«string»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/status": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "更新订单状态",
        "description": "合法状态流转：\n- 待支付 → 已付定金/已全额支付/已取消\n- 已付定金 → 已确认/已取消/售后中\n- 已全额支付 → 已确认/已取消/售后中\n- 已确认 → 待付尾款/待出行/已取消/售后中\n- 待付尾款 → 待出行/已取消/售后中\n- 待出行 → 旅行中/售后中\n- 旅行中 → 已完成\n- 已完成 → 售后中\n- 售后中 → 退款中\n- 退款中 → 已退款\n\n【关联字典】\n- 请求参数 status → 字典：order_status（订单状态）",
        "operationId": "updateStatusUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "statusRequest",
            "description": "更新订单状态请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/更新订单状态请求",
              "originalRef": "更新订单状态请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/surcharge": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "添加费用增加项",
        "description": "为订单添加费用增加项（如升级房型补差价、加座费等）。\n添加后系统自动重算订单尾款金额。\n\n**权限**：仅该订单的定制师或超级管理员(SUPER_ADMIN)可操作",
        "operationId": "addSurchargeUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "surchargeRequest",
            "description": "费用增加项请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/费用增加项请求",
              "originalRef": "费用增加项请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderSurcharge»",
              "originalRef": "统一响应结果«OrderSurcharge»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«OrderSurcharge»",
              "originalRef": "统一响应结果«OrderSurcharge»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/surcharge/{surchargeId}": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "修改费用增加项",
        "description": "修改已添加的费用增加项名称或金额，修改后自动重算订单尾款金额。\n\n**权限**：仅该订单的定制师或超级管理员(SUPER_ADMIN)可操作",
        "operationId": "updateSurchargeUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "surchargeId",
            "in": "path",
            "description": "费用增加项ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "surchargeRequest",
            "description": "费用增加项请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/费用增加项请求",
              "originalRef": "费用增加项请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "delete": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "删除费用增加项",
        "description": "删除已添加的费用增加项，删除后自动重算订单尾款金额。\n\n**权限**：仅该订单的定制师或超级管理员(SUPER_ADMIN)可操作",
        "operationId": "removeSurchargeUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "name": "surchargeId",
            "in": "path",
            "description": "费用增加项ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/todos": {
      "get": {
        "tags": [
          "订单待办接口"
        ],
        "summary": "获取订单待办列表",
        "description": "返回指定订单的所有待办项（含已完成和未完成）。\n待办类型包括：配房、配车、签合同、购保险、核算等，随内部流程自动生成\n\n【关联字典】\n- 返回字段 todoType → 字典：order_todo_type（订单待办类型）",
        "operationId": "getOrderTodosUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderTodo»»",
              "originalRef": "统一响应结果«List«OrderTodo»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderTodo»»",
              "originalRef": "统一响应结果«List«OrderTodo»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/transport": {
      "get": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "查询交通信息",
        "description": "查询订单的所有交通信息（航班/车次），按排序序号和出发时间升序排列",
        "operationId": "getTransportUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderTransportSegment»»",
              "originalRef": "统一响应结果«List«OrderTransportSegment»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderTransportSegment»»",
              "originalRef": "统一响应结果«List«OrderTransportSegment»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "保存交通信息（航班/车次）",
        "description": "为订单保存交通信息，支持多条航班和车次。每次提交为全量替换（先删后增）。\n\n**使用场景**：管理员为订单录入去程/回程的航班号或车次号、出发/到达站点和时间。\n一个订单可以有多条交通记录（如：去程航班+回程航班+市内火车等）。\n\n【关联字典】\n- 请求参数 segments[].transportType → 字典：transport_type（交通类型：FLIGHT-航班, TRAIN-火车）",
        "operationId": "saveTransportUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "transportRequest",
            "description": "交通信息请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/交通信息请求（批量保存）",
              "originalRef": "交通信息请求（批量保存）"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderTransportSegment»»",
              "originalRef": "统一响应结果«List«OrderTransportSegment»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderTransportSegment»»",
              "originalRef": "统一响应结果«List«OrderTransportSegment»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/travelers": {
      "get": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "获取订单出行人列表",
        "description": "返回指定订单的所有出行人信息，用于保险投保时自动填充被保人。\n\n**权限**：需管理员登录\n\n**关联字典**：\n- 返回字段 travelerType → 字典：traveler_type（出行人类型）\n- 返回字段 idCardType → 字典：id_card_type（证件类型）\n- 返回字段 gender → 字典：gender（性别）",
        "operationId": "getOrderTravelersUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderTraveler»»",
              "originalRef": "统一响应结果«List«OrderTraveler»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«OrderTraveler»»",
              "originalRef": "统一响应结果«List«OrderTraveler»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/vehicle-assignment": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "分配车辆信息",
        "description": "为订单分配具体的车辆和司机信息（车型、品牌、车牌号、司机姓名和电话）。\n分配后信息将展示在订单详情和C端行程中",
        "operationId": "assignVehicleUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "request",
            "description": "request",
            "required": true,
            "schema": {
              "$ref": "#/definitions/车辆分配请求",
              "originalRef": "车辆分配请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/vehicle-info": {
      "put": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "更新车辆信息（仅车务管理员/超级管理员）",
        "description": "更新订单的车辆分配信息（车型、车牌号、司机等）。\n\n**权限**：仅VEHICLE_MANAGER（车务管理员）或SUPER_ADMIN（超级管理员）可操作。",
        "operationId": "updateVehicleInfoUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "vehicleInfoRequest",
            "description": "车辆信息请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/车辆信息请求",
              "originalRef": "车辆信息请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/{orderId}/vehicle-info/check-diff": {
      "post": {
        "tags": [
          "管理端订单接口"
        ],
        "summary": "检测车型一致性",
        "description": "检测当前车辆配置是否与产品快照一致。返回 null 表示一致，否则返回不一致描述",
        "operationId": "checkVehicleTypeDiffUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderId",
            "in": "path",
            "description": "订单ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "vehicleInfoJson",
            "description": "vehicleInfoJson",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«string»",
              "originalRef": "统一响应结果«string»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«string»",
              "originalRef": "统一响应结果«string»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund-policy": {
      "post": {
        "tags": [
          "退款政策管理"
        ],
        "summary": "创建退款政策",
        "description": "退款政策定义按距出发天数的退款比例阶梯\n\n例如：出发前30天退90%，前15天退70%，前7天退50%，7天内不可退\n\n创建后需在产品设计时绑定，产品未绑定退款政策时使用默认政策",
        "operationId": "createUsingPOST_2",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "policyRequest",
            "description": "创建退款政策请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/退款政策请求",
              "originalRef": "退款政策请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款政策VO»",
              "originalRef": "统一响应结果«退款政策VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款政策VO»",
              "originalRef": "统一响应结果«退款政策VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund-policy/enabled": {
      "get": {
        "tags": [
          "退款政策管理"
        ],
        "summary": "启用的退款政策列表",
        "description": "仅返回启用状态的政策，供产品设计时选择绑定",
        "operationId": "listEnabledUsingGET",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«退款政策VO»»",
              "originalRef": "统一响应结果«List«退款政策VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«退款政策VO»»",
              "originalRef": "统一响应结果«List«退款政策VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund-policy/list": {
      "get": {
        "tags": [
          "退款政策管理"
        ],
        "summary": "退款政策列表",
        "description": "返回所有退款政策（含禁用），按默认→创建时间倒序",
        "operationId": "listUsingGET_2",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«退款政策VO»»",
              "originalRef": "统一响应结果«List«退款政策VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«退款政策VO»»",
              "originalRef": "统一响应结果«List«退款政策VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund-policy/{policyId}": {
      "get": {
        "tags": [
          "退款政策管理"
        ],
        "summary": "退款政策详情",
        "operationId": "detailUsingGET_1",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "policyId",
            "in": "path",
            "description": "退款政策ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款政策VO»",
              "originalRef": "统一响应结果«退款政策VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款政策VO»",
              "originalRef": "统一响应结果«退款政策VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "put": {
        "tags": [
          "退款政策管理"
        ],
        "summary": "修改退款政策",
        "operationId": "updateUsingPUT_1",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "policyId",
            "in": "path",
            "description": "退款政策ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "policyRequest",
            "description": "修改退款政策请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/退款政策请求",
              "originalRef": "退款政策请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款政策VO»",
              "originalRef": "统一响应结果«退款政策VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款政策VO»",
              "originalRef": "统一响应结果«退款政策VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "delete": {
        "tags": [
          "退款政策管理"
        ],
        "summary": "删除退款政策",
        "description": "软删除。已绑定该政策的产品申请退款时将降级使用默认政策。不影响历史退款申请（已快照）。",
        "operationId": "deleteUsingDELETE_1",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "policyId",
            "in": "path",
            "description": "退款政策ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund-policy/{policyId}/toggle": {
      "put": {
        "tags": [
          "退款政策管理"
        ],
        "summary": "启用/禁用退款政策",
        "description": "禁用后不再出现在产品设计的可选列表中，已绑定的产品申请退款时降级使用默认政策",
        "operationId": "toggleUsingPUT_1",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "enabled",
            "in": "query",
            "description": "是否启用",
            "required": false,
            "type": "boolean",
            "allowEmptyValue": false
          },
          {
            "name": "policyId",
            "in": "path",
            "description": "退款政策ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund/list": {
      "get": {
        "tags": [
          "退款管理"
        ],
        "summary": "退款申请列表",
        "description": "分页查询退款申请，支持按状态筛选。\n状态包括：PENDING(待审批)、APPROVED(已通过)、REJECTED(已拒绝)、REFUNDING(退款中)、REFUNDED(已退款)、CANCELLED(已撤回)、APPEAL(申诉中)\n\n【关联字典】\n- 筛选参数 status → 字典：refund_status（退款状态）\n- 返回字段 status → 字典：refund_status（退款状态）",
        "operationId": "listApplicationsUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "页码",
            "required": false,
            "type": "integer",
            "default": 1,
            "format": "int32",
            "allowEmptyValue": false
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "type": "integer",
            "default": 20,
            "format": "int32",
            "allowEmptyValue": false
          },
          {
            "name": "status",
            "in": "query",
            "description": "状态",
            "required": false,
            "type": "string",
            "allowEmptyValue": false
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«退款申请VO»»",
              "originalRef": "统一响应结果«分页结果«退款申请VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«退款申请VO»»",
              "originalRef": "统一响应结果«分页结果«退款申请VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund/reason": {
      "post": {
        "tags": [
          "退款管理"
        ],
        "summary": "创建退款原因",
        "description": "新增退款原因选项，C端用户申请退款时可选择。按sortOrder排序展示\n\n【关联字典】\n- 请求参数 category → 字典：refund_reason_category（退款原因分类）",
        "operationId": "createReasonUsingPOST",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "createRequest",
            "description": "创建退款原因请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/创建退款原因请求",
              "originalRef": "创建退款原因请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款原因VO»",
              "originalRef": "统一响应结果«退款原因VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款原因VO»",
              "originalRef": "统一响应结果«退款原因VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund/reason/list": {
      "get": {
        "tags": [
          "退款管理"
        ],
        "summary": "退款原因列表",
        "description": "获取所有退款原因选项（含禁用的），用于退款原因管理页面\n\n【关联字典】\n- 返回字段 category → 字典：refund_reason_category（退款原因分类）",
        "operationId": "listReasonsUsingGET",
        "produces": [
          "*/*"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«退款原因VO»»",
              "originalRef": "统一响应结果«List«退款原因VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«List«退款原因VO»»",
              "originalRef": "统一响应结果«List«退款原因VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund/reason/{reasonId}": {
      "put": {
        "tags": [
          "退款管理"
        ],
        "summary": "修改退款原因",
        "description": "修改退款原因的文本、分类或排序，不影响已使用该原因的历史退款申请\n\n【关联字典】\n- 请求参数 category → 字典：refund_reason_category（退款原因分类）",
        "operationId": "updateReasonUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "reasonId",
            "in": "path",
            "description": "退款原因ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "updateRequest",
            "description": "修改退款原因请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/修改退款原因请求",
              "originalRef": "修改退款原因请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款原因VO»",
              "originalRef": "统一响应结果«退款原因VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款原因VO»",
              "originalRef": "统一响应结果«退款原因VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      },
      "delete": {
        "tags": [
          "退款管理"
        ],
        "summary": "删除退款原因",
        "description": "软删除退款原因，删除后C端不再展示。不影响已使用该原因的历史退款申请",
        "operationId": "deleteReasonUsingDELETE",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "reasonId",
            "in": "path",
            "description": "退款原因ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Void»",
              "originalRef": "统一响应结果«Void»"
            }
          },
          "204": {
            "description": "No Content"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund/{applicationId}": {
      "get": {
        "tags": [
          "退款管理"
        ],
        "summary": "退款申请详情",
        "description": "返回退款申请的完整信息，包括退款原因、申请金额、实退金额、审批记录、申诉信息等\n\n【关联字典】\n- 返回字段 status → 字典：refund_status（退款状态）",
        "operationId": "getDetailUsingGET_1",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "applicationId",
            "in": "path",
            "description": "退款申请ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款申请VO»",
              "originalRef": "统一响应结果«退款申请VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款申请VO»",
              "originalRef": "统一响应结果«退款申请VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund/{applicationId}/complete": {
      "put": {
        "tags": [
          "退款管理"
        ],
        "summary": "手动完成退款",
        "description": "用于测试订单或线下退款场景。将处于'退款中'状态的退款申请直接标记为'已退款'",
        "operationId": "manualCompleteUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "applicationId",
            "in": "path",
            "description": "退款申请ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款申请VO»",
              "originalRef": "统一响应结果«退款申请VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款申请VO»",
              "originalRef": "统一响应结果«退款申请VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund/{applicationId}/execute-appeal": {
      "put": {
        "tags": [
          "退款管理"
        ],
        "summary": "申诉通过后执行退款",
        "description": "申诉退款流程：用户发起申诉 → 企微OA审批 → 审批通过后管理员确认实退金额 → 调起微信退款",
        "operationId": "executeAppealUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "in": "body",
            "name": "appealRequest",
            "description": "申诉退款执行请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/申诉退款执行请求",
              "originalRef": "申诉退款执行请求"
            }
          },
          {
            "name": "applicationId",
            "in": "path",
            "description": "退款申请ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款申请VO»",
              "originalRef": "统一响应结果«退款申请VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款申请VO»",
              "originalRef": "统一响应结果«退款申请VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/refund/{applicationId}/review": {
      "put": {
        "tags": [
          "退款管理"
        ],
        "summary": "审批退款申请",
        "description": "退款审批流程：查看退款申请 → 决定通过/拒绝 → 通过时填写实退金额 → 系统自动调起微信退款\n\n拒绝后用户可发起申诉\n\n【关联字典】\n- 返回字段 status → 字典：refund_status（退款状态）",
        "operationId": "reviewUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "applicationId",
            "in": "path",
            "description": "退款申请ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "reviewRequest",
            "description": "审批退款请求",
            "required": false,
            "schema": {
              "$ref": "#/definitions/管理员退款审批请求",
              "originalRef": "管理员退款审批请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款申请VO»",
              "originalRef": "统一响应结果«退款申请VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«退款申请VO»",
              "originalRef": "统一响应结果«退款申请VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/invoice/page": {
      "get": {
        "tags": [
          "发票管理"
        ],
        "summary": "发票分页列表",
        "description": "分页查询发票申请列表，支持按状态、订单号、用户ID筛选。\n\n【关联字典】\n- 筛选参数 status → 字典：invoice_status（发票状态）：PENDING=待开票, ISSUED=已开票, FAILED=开票失败, VOIDED=已作废\n- 返回字段 titleType → 字典：invoice_title_type（抬头类型）：PERSONAL=个人, COMPANY=企业\n- 返回字段 status → 字典：invoice_status（发票状态）",
        "operationId": "pageInvoicesUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "orderNo",
            "in": "query",
            "description": "订单编号（模糊搜索）",
            "required": false,
            "type": "string",
            "x-example": "HL2026"
          },
          {
            "name": "page",
            "in": "query",
            "description": "页码",
            "required": false,
            "type": "integer",
            "format": "int32",
            "x-example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "type": "integer",
            "format": "int32",
            "x-example": 20
          },
          {
            "name": "status",
            "in": "query",
            "description": "发票状态（字典：invoice_status）",
            "required": false,
            "type": "string",
            "x-example": "PENDING"
          },
          {
            "name": "userId",
            "in": "query",
            "description": "用户ID",
            "required": false,
            "type": "integer",
            "format": "int64",
            "x-example": 1760000000000001
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«发票VO»»",
              "originalRef": "统一响应结果«分页结果«发票VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«发票VO»»",
              "originalRef": "统一响应结果«分页结果«发票VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/invoice/upload": {
      "post": {
        "tags": [
          "发票管理"
        ],
        "summary": "上传发票文件",
        "description": "上传发票PDF/图片文件，返回文件访问URL。\n上传成功后，将返回的fileUrl传给「开票完成」接口即可。\n\n【支持格式】PDF、JPG、PNG\n【大小限制】10MB",
        "operationId": "uploadInvoiceFileUsingPOST",
        "consumes": [
          "multipart/form-data"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "file",
            "in": "formData",
            "description": "发票文件（PDF/JPG/PNG）",
            "required": false,
            "type": "file"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,string»»",
              "originalRef": "统一响应结果«Map«string,string»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«Map«string,string»»",
              "originalRef": "统一响应结果«Map«string,string»»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/invoice/{id}": {
      "get": {
        "tags": [
          "发票管理"
        ],
        "summary": "发票详情",
        "description": "获取发票的完整信息，包含开票信息、用户信息、企业信息等。\n\n【关联字典】\n- 返回字段 titleType → 字典：invoice_title_type（抬头类型）\n- 返回字段 status → 字典：invoice_status（发票状态）",
        "operationId": "getInvoiceDetailUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "发票ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«发票VO»",
              "originalRef": "统一响应结果«发票VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«发票VO»",
              "originalRef": "统一响应结果«发票VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/invoice/{id}/fail": {
      "put": {
        "tags": [
          "发票管理"
        ],
        "summary": "开票失败",
        "description": "标记发票开票失败，需填写失败原因。用户可根据原因修正后重新申请。\n只有待开票(PENDING)状态的发票可以操作。",
        "operationId": "failInvoiceUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "发票ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "failRequest",
            "description": "failRequest",
            "required": true,
            "schema": {
              "$ref": "#/definitions/管理员开票失败请求",
              "originalRef": "管理员开票失败请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«发票VO»",
              "originalRef": "统一响应结果«发票VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«发票VO»",
              "originalRef": "统一响应结果«发票VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/invoice/{id}/issue": {
      "put": {
        "tags": [
          "发票管理"
        ],
        "summary": "开票完成",
        "description": "管理员上传发票文件并填写发票号码后，将发票状态改为已开票。\n只有待开票(PENDING)或开票失败(FAILED)状态的发票可以操作。",
        "operationId": "issueInvoiceUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "发票ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "issueRequest",
            "description": "issueRequest",
            "required": true,
            "schema": {
              "$ref": "#/definitions/管理员开票请求",
              "originalRef": "管理员开票请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«发票VO»",
              "originalRef": "统一响应结果«发票VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«发票VO»",
              "originalRef": "统一响应结果«发票VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/invoice/{id}/void": {
      "put": {
        "tags": [
          "发票管理"
        ],
        "summary": "作废发票",
        "description": "将发票标记为已作废。已作废的发票不可重复作废。",
        "operationId": "voidInvoiceUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "发票ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«发票VO»",
              "originalRef": "统一响应结果«发票VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«发票VO»",
              "originalRef": "统一响应结果«发票VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/customize/page": {
      "get": {
        "tags": [
          "私人定制管理"
        ],
        "summary": "定制请求列表",
        "description": "分页查询定制请求，支持关键词搜索、状态筛选、定制师筛选\n\n【关联字典】\n- 筛选参数 status → 字典：customize_request_status（定制请求状态）\n- 返回字段 status → 字典：customize_request_status（定制请求状态）\n- 返回字段 travelPurpose → 字典：travel_purpose（旅游目的）\n- 返回字段 requestType → 字典：customize_request_type（需求类型）\n- 返回字段 budget → 字典：customize_budget（预算范围）",
        "operationId": "pageUsingGET",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "designerId",
            "in": "query",
            "description": "定制师ID",
            "required": false,
            "type": "integer",
            "format": "int64",
            "x-example": 1234567890
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "搜索关键词（联系人/目标地区/需求描述）",
            "required": false,
            "type": "string",
            "x-example": "云南"
          },
          {
            "name": "page",
            "in": "query",
            "description": "页码",
            "required": false,
            "type": "integer",
            "format": "int32",
            "x-example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "每页条数",
            "required": false,
            "type": "integer",
            "format": "int32",
            "x-example": 20
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "排序字段（createTime/startDate）",
            "required": false,
            "type": "string",
            "x-example": "createTime"
          },
          {
            "name": "sortDir",
            "in": "query",
            "description": "排序方向（desc/asc）",
            "required": false,
            "type": "string",
            "x-example": "desc"
          },
          {
            "name": "status",
            "in": "query",
            "description": "状态（字典：customize_request_status）",
            "required": false,
            "type": "string",
            "x-example": "PENDING"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«定制请求列表VO»»",
              "originalRef": "统一响应结果«分页结果«定制请求列表VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«分页结果«定制请求列表VO»»",
              "originalRef": "统一响应结果«分页结果«定制请求列表VO»»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/customize/{requestId}": {
      "get": {
        "tags": [
          "私人定制管理"
        ],
        "summary": "定制请求详情",
        "description": "查看定制请求完整信息\n\n【关联字典】\n- 返回字段 status → 字典：customize_request_status（定制请求状态）\n- 返回字段 travelPurpose → 字典：travel_purpose（旅游目的）\n- 返回字段 requestType → 字典：customize_request_type（需求类型）\n- 返回字段 budget → 字典：customize_budget（预算范围）",
        "operationId": "detailUsingGET_2",
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "requestId",
            "in": "path",
            "description": "定制请求ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«定制请求详情VO»",
              "originalRef": "统一响应结果«定制请求详情VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«定制请求详情VO»",
              "originalRef": "统一响应结果«定制请求详情VO»"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/customize/{requestId}/accept": {
      "put": {
        "tags": [
          "私人定制管理"
        ],
        "summary": "接受定制请求",
        "description": "定制师接受定制请求，状态从待处理变为已接受。如果用户未指定定制师，系统将自动分配当前操作人为定制师",
        "operationId": "acceptUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "requestId",
            "in": "path",
            "description": "定制请求ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«定制请求详情VO»",
              "originalRef": "统一响应结果«定制请求详情VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«定制请求详情VO»",
              "originalRef": "统一响应结果«定制请求详情VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/customize/{requestId}/complete": {
      "put": {
        "tags": [
          "私人定制管理"
        ],
        "summary": "标记完成",
        "description": "将已报价的定制请求标记为已完成（用户已确认方案或已下单）",
        "operationId": "completeUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "requestId",
            "in": "path",
            "description": "定制请求ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«定制请求详情VO»",
              "originalRef": "统一响应结果«定制请求详情VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«定制请求详情VO»",
              "originalRef": "统一响应结果«定制请求详情VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    },
    "/admin/order/customize/{requestId}/reply": {
      "put": {
        "tags": [
          "私人定制管理"
        ],
        "summary": "回复/报价",
        "description": "定制师回复定制请求或提交报价方案。\n- 仅填写回复内容：状态变为「设计中」\n- 同时关联产品ID：状态变为「已报价」\n\n只有已接受或设计中状态可以回复",
        "operationId": "replyUsingPUT",
        "consumes": [
          "application/json"
        ],
        "produces": [
          "*/*"
        ],
        "parameters": [
          {
            "name": "requestId",
            "in": "path",
            "description": "定制请求ID",
            "required": false,
            "type": "integer",
            "format": "int64"
          },
          {
            "in": "body",
            "name": "replyRequest",
            "description": "replyRequest",
            "required": true,
            "schema": {
              "$ref": "#/definitions/定制师回复/报价请求",
              "originalRef": "定制师回复/报价请求"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«定制请求详情VO»",
              "originalRef": "统一响应结果«定制请求详情VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "responsesObject": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/统一响应结果«定制请求详情VO»",
              "originalRef": "统一响应结果«定制请求详情VO»"
            }
          },
          "201": {
            "description": "Created"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false,
        "x-order": "2147483647"
      }
    }
  },
  "definitions": {
    "AlbumFileAddRequest": {
      "type": "object",
      "properties": {
        "customLocation": {
          "type": "string",
          "description": "自定义地点文本（地点类型为CUSTOM时）"
        },
        "description": {
          "type": "string",
          "description": "文件描述"
        },
        "fileId": {
          "type": "integer",
          "format": "int64",
          "description": "文件ID（来自file_info）"
        },
        "fileType": {
          "type": "string",
          "description": "文件类型: IMAGE/VIDEO"
        },
        "locationType": {
          "type": "string",
          "description": "地点类型: RESOURCE/CUSTOM"
        },
        "ossUrl": {
          "type": "string",
          "description": "文件访问URL"
        },
        "resourceId": {
          "type": "integer",
          "format": "int64",
          "description": "资源ID（地点类型为RESOURCE时）"
        },
        "resourceName": {
          "type": "string",
          "description": "资源名称（地点类型为RESOURCE时）"
        },
        "resourceType": {
          "type": "string",
          "description": "资源类型（地点类型为RESOURCE时）"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序号"
        },
        "thumbnailUrl": {
          "type": "string",
          "description": "缩略图URL"
        }
      },
      "title": "AlbumFileAddRequest"
    },
    "AlbumFileBatchAddRequest": {
      "type": "object",
      "properties": {
        "files": {
          "type": "array",
          "description": "文件列表",
          "items": {
            "$ref": "#/definitions/AlbumFileAddRequest",
            "originalRef": "AlbumFileAddRequest"
          }
        }
      },
      "title": "AlbumFileBatchAddRequest"
    },
    "AlbumFileUpdateRequest": {
      "type": "object",
      "properties": {
        "customLocation": {
          "type": "string",
          "description": "自定义地点文本"
        },
        "description": {
          "type": "string",
          "description": "文件描述"
        },
        "locationType": {
          "type": "string",
          "description": "地点类型: RESOURCE/CUSTOM"
        },
        "resourceId": {
          "type": "integer",
          "format": "int64",
          "description": "资源ID"
        },
        "resourceName": {
          "type": "string",
          "description": "资源名称"
        },
        "resourceType": {
          "type": "string",
          "description": "资源类型"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序号"
        }
      },
      "title": "AlbumFileUpdateRequest"
    },
    "AlbumFileVO": {
      "type": "object",
      "properties": {
        "albumFileId": {
          "type": "integer",
          "format": "int64",
          "description": "相册文件ID"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "createdBy": {
          "type": "integer",
          "format": "int64",
          "description": "上传人ID"
        },
        "customLocation": {
          "type": "string",
          "description": "自定义地点文本"
        },
        "description": {
          "type": "string",
          "description": "文件描述"
        },
        "fileId": {
          "type": "integer",
          "format": "int64",
          "description": "文件ID"
        },
        "fileType": {
          "type": "string",
          "description": "文件类型: IMAGE/VIDEO"
        },
        "folderId": {
          "type": "integer",
          "format": "int64",
          "description": "所属文件夹ID"
        },
        "locationText": {
          "type": "string",
          "description": "地点显示文本"
        },
        "locationType": {
          "type": "string",
          "description": "地点类型: RESOURCE/CUSTOM"
        },
        "ossUrl": {
          "type": "string",
          "description": "文件访问URL"
        },
        "resourceId": {
          "type": "integer",
          "format": "int64",
          "description": "资源ID"
        },
        "resourceName": {
          "type": "string",
          "description": "资源名称"
        },
        "resourceType": {
          "type": "string",
          "description": "资源类型"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序号"
        },
        "thumbnailUrl": {
          "type": "string",
          "description": "缩略图URL"
        }
      },
      "title": "AlbumFileVO"
    },
    "AlbumFolderRequest": {
      "type": "object",
      "properties": {
        "folderName": {
          "type": "string",
          "description": "文件夹名称"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序号"
        }
      },
      "title": "AlbumFolderRequest"
    },
    "AlbumFolderVO": {
      "type": "object",
      "properties": {
        "coverThumbnailUrl": {
          "type": "string",
          "description": "封面缩略图URL"
        },
        "coverUrl": {
          "type": "string",
          "description": "封面文件URL"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "createdBy": {
          "type": "integer",
          "format": "int64",
          "description": "创建人ID"
        },
        "fileCount": {
          "type": "integer",
          "format": "int32",
          "description": "文件数量"
        },
        "folderId": {
          "type": "integer",
          "format": "int64",
          "description": "文件夹ID"
        },
        "folderName": {
          "type": "string",
          "description": "文件夹名称"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "关联订单ID"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序号"
        }
      },
      "title": "AlbumFolderVO"
    },
    "CreateWorkOrderRequest": {
      "type": "object",
      "required": [
        "description",
        "orderId",
        "priority",
        "type"
      ],
      "properties": {
        "assigneeAdminId": {
          "type": "integer",
          "format": "int64",
          "description": "指定处理人ID"
        },
        "assigneeName": {
          "type": "string",
          "description": "指定处理人姓名"
        },
        "attachmentUrls": {
          "type": "string",
          "description": "附件URL(JSON数组)"
        },
        "costDifference": {
          "type": "number",
          "description": "差价(正数=客户需补差价, 负数=需退费给客户)"
        },
        "description": {
          "type": "string",
          "description": "问题描述"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "关联订单ID"
        },
        "priority": {
          "type": "string",
          "description": "优先级: URGENT(紧急，如当天出发需处理)/NORMAL(普通)"
        },
        "resourceDetail": {
          "type": "string",
          "description": "资源详情JSON(酒店/车辆/景点信息)"
        },
        "type": {
          "type": "string",
          "description": "工单类型: ROOM_CHANGE(换房)/ROOM_ADD(加房)/CHECKOUT_CHANGE(改退房日期)/HOTEL_ISSUE(酒店问题)/VEHICLE_CHANGE(换车)/SCENIC_ADD(加景点)/SCENIC_REMOVE(减景点)/OTHER(其他)"
        }
      },
      "title": "CreateWorkOrderRequest"
    },
    "Map«string,object»": {
      "type": "object",
      "title": "Map«string,object»",
      "additionalProperties": {
        "type": "object"
      }
    },
    "Map«string,object»_1": {
      "type": "object",
      "title": "Map«string,object»_1",
      "additionalProperties": {
        "type": "object"
      }
    },
    "Map«string,object»_2": {
      "type": "object",
      "title": "Map«string,object»_2",
      "additionalProperties": {
        "type": "object"
      }
    },
    "Map«string,object»_3": {
      "type": "object",
      "title": "Map«string,object»_3",
      "additionalProperties": {
        "type": "object"
      }
    },
    "Map«string,object»_4": {
      "type": "object",
      "title": "Map«string,object»_4",
      "additionalProperties": {
        "type": "object"
      }
    },
    "OrderDiscount": {
      "type": "object",
      "properties": {
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "deletedAt": {
          "type": "string",
          "format": "date-time",
          "description": "删除时间（软删除）"
        },
        "discountAmount": {
          "type": "number",
          "description": "优惠金额"
        },
        "discountId": {
          "type": "integer",
          "format": "int64",
          "description": "优惠ID"
        },
        "discountName": {
          "type": "string",
          "description": "优惠名称"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "OrderDiscount"
    },
    "OrderItineraryEdit": {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "description": "操作类型：SKIP/ADD"
        },
        "balanceAdjustment": {
          "type": "number",
          "description": "尾款调整金额（正数=增加尾款，负数=减少尾款）"
        },
        "changeDays": {
          "type": "integer",
          "format": "int32",
          "description": "变更天数"
        },
        "changeReasonCode": {
          "type": "string",
          "description": "变更原因代码（字典项）"
        },
        "changeReasonLabel": {
          "type": "string",
          "description": "变更原因标签"
        },
        "confirmStatus": {
          "type": "string",
          "description": "确认状态：PENDING_CONFIRM/CONFIRMED"
        },
        "confirmedAt": {
          "type": "string",
          "format": "date-time",
          "description": "确认时间"
        },
        "confirmedBy": {
          "type": "integer",
          "format": "int64",
          "description": "确认人ID"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "dayNumber": {
          "type": "integer",
          "format": "int32",
          "description": "行程天数编号"
        },
        "deletedAt": {
          "type": "string",
          "format": "date-time",
          "description": "删除时间（软删除）"
        },
        "description": {
          "type": "string",
          "description": "节点描述（ADD时）"
        },
        "editId": {
          "type": "integer",
          "format": "int64",
          "description": "编辑ID"
        },
        "newResourceName": {
          "type": "string",
          "description": "新资源名称（房型/车型）"
        },
        "newUnitPrice": {
          "type": "number",
          "description": "新单价（日均）"
        },
        "nodeId": {
          "type": "string",
          "description": "原节点ID（SKIP时必填）"
        },
        "nodeName": {
          "type": "string",
          "description": "节点名称（ADD时）"
        },
        "nodeType": {
          "type": "string",
          "description": "节点类型（ADD时）"
        },
        "operatorId": {
          "type": "integer",
          "format": "int64",
          "description": "操作人ID"
        },
        "operatorName": {
          "type": "string",
          "description": "操作人姓名"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "originalResourceName": {
          "type": "string",
          "description": "原资源名称（房型/车型）"
        },
        "originalUnitPrice": {
          "type": "number",
          "description": "原单价（日均）"
        },
        "reason": {
          "type": "string",
          "description": "修改原因"
        },
        "resourceId": {
          "type": "integer",
          "format": "int64",
          "description": "关联资源ID"
        },
        "resourceType": {
          "type": "string",
          "description": "关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序序号（ADD时）"
        },
        "startTime": {
          "type": "string",
          "description": "开始时间（ADD时）"
        },
        "suggestedAdjustment": {
          "type": "number",
          "description": "系统建议差价"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "OrderItineraryEdit"
    },
    "OrderSurcharge": {
      "type": "object",
      "properties": {
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "deletedAt": {
          "type": "string",
          "format": "date-time",
          "description": "删除时间（软删除）"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "surchargeAmount": {
          "type": "number",
          "description": "费用增加金额"
        },
        "surchargeId": {
          "type": "integer",
          "format": "int64",
          "description": "费用增加项ID"
        },
        "surchargeName": {
          "type": "string",
          "description": "费用增加项名称"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "OrderSurcharge"
    },
    "OrderTimeline": {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "description": "操作动作"
        },
        "actionLabel": {
          "type": "string",
          "description": "操作动作中文标签"
        },
        "content": {
          "type": "string",
          "description": "操作内容"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "deletedAt": {
          "type": "string",
          "format": "date-time",
          "description": "删除时间（软删除）"
        },
        "operatorId": {
          "type": "integer",
          "format": "int64",
          "description": "操作人ID"
        },
        "operatorName": {
          "type": "string",
          "description": "操作人姓名"
        },
        "operatorType": {
          "type": "string",
          "description": "操作人类型：USER=用户 ADMIN=管理员 SYSTEM=系统"
        },
        "operatorTypeLabel": {
          "type": "string",
          "description": "操作人类型中文标签"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "timelineId": {
          "type": "integer",
          "format": "int64",
          "description": "时间线ID"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "OrderTimeline"
    },
    "OrderTodo": {
      "type": "object",
      "properties": {
        "assigneeAdminId": {
          "type": "integer",
          "format": "int64",
          "description": "指派管理员ID"
        },
        "assigneeRoleKey": {
          "type": "string",
          "description": "指派角色Key"
        },
        "assigneeRoleLabel": {
          "type": "string",
          "description": "指派角色中文标签"
        },
        "completedAt": {
          "type": "string",
          "format": "date-time",
          "description": "完成时间"
        },
        "completedBy": {
          "type": "integer",
          "format": "int64",
          "description": "完成人ID"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "deletedAt": {
          "type": "string",
          "format": "date-time",
          "description": "删除时间（软删除）"
        },
        "lastNotifiedAt": {
          "type": "string",
          "format": "date-time",
          "description": "最后通知时间"
        },
        "notificationCount": {
          "type": "integer",
          "format": "int32",
          "description": "通知次数"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "orderNo": {
          "type": "string",
          "description": "订单编号"
        },
        "sequence": {
          "type": "integer",
          "format": "int32",
          "description": "排序序号"
        },
        "status": {
          "type": "string",
          "description": "待办状态"
        },
        "todoId": {
          "type": "integer",
          "format": "int64",
          "description": "待办ID"
        },
        "todoLabel": {
          "type": "string",
          "description": "待办标签"
        },
        "todoType": {
          "type": "string",
          "description": "待办类型"
        },
        "todoTypeLabel": {
          "type": "string",
          "description": "待办类型中文标签"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "OrderTodo"
    },
    "OrderTransportSegment": {
      "type": "object",
      "properties": {
        "arriveStation": {
          "type": "string",
          "description": "到达站/到达机场"
        },
        "arriveTime": {
          "type": "string",
          "format": "date-time",
          "description": "到达时间"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "deletedAt": {
          "type": "string",
          "format": "date-time",
          "description": "删除时间（软删除）"
        },
        "departStation": {
          "type": "string",
          "description": "出发站/出发机场"
        },
        "departTime": {
          "type": "string",
          "format": "date-time",
          "description": "出发时间"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "remark": {
          "type": "string",
          "description": "备注"
        },
        "segmentId": {
          "type": "integer",
          "format": "int64",
          "description": "分段ID"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序序号"
        },
        "transportNo": {
          "type": "string",
          "description": "航班号/车次号"
        },
        "transportType": {
          "type": "string",
          "description": "交通类型（字典：transport_type）: FLIGHT-航班, TRAIN-火车"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "OrderTransportSegment"
    },
    "OrderTraveler": {
      "type": "object",
      "properties": {
        "birthday": {
          "type": "string",
          "format": "date",
          "description": "出生日期"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "deletedAt": {
          "type": "string",
          "format": "date-time",
          "description": "删除时间（软删除）"
        },
        "email": {
          "type": "string",
          "description": "邮箱地址"
        },
        "emergencyContact": {
          "type": "string",
          "description": "紧急联系人姓名"
        },
        "emergencyPhone": {
          "type": "string",
          "description": "紧急联系人电话（加密存储）"
        },
        "gender": {
          "type": "string",
          "description": "性别（字典：gender）"
        },
        "idCardNo": {
          "type": "string",
          "description": "证件号码（加密存储）"
        },
        "idCardType": {
          "type": "string",
          "description": "证件类型（字典：id_card_type）"
        },
        "idCardTypeLabel": {
          "type": "string",
          "description": "证件类型中文标签"
        },
        "insurancePolicies": {
          "type": "array",
          "description": "该出行人的保险保单列表（按人合并，含保障期间和保单号）",
          "items": {
            "$ref": "#/definitions/Map«string,object»",
            "originalRef": "Map«string,object»"
          }
        },
        "name": {
          "type": "string",
          "description": "出行人姓名"
        },
        "nationality": {
          "type": "string",
          "description": "国籍"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "orderTravelerId": {
          "type": "integer",
          "format": "int64",
          "description": "出行人记录ID"
        },
        "phone": {
          "type": "string",
          "description": "手机号码（加密存储）"
        },
        "travelerType": {
          "type": "string",
          "description": "出行人类型（字典：traveler_type）"
        },
        "travelerTypeLabel": {
          "type": "string",
          "description": "出行人类型中文标签"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "OrderTraveler"
    },
    "PrevDayHotel": {
      "type": "object",
      "properties": {
        "hotelId": {
          "type": "integer",
          "format": "int64",
          "description": "酒店ID"
        },
        "hotelName": {
          "type": "string",
          "description": "酒店名称"
        },
        "roomTypeId": {
          "type": "integer",
          "format": "int64",
          "description": "房型ID"
        },
        "roomTypeName": {
          "type": "string",
          "description": "房型名称"
        }
      },
      "title": "PrevDayHotel"
    },
    "ProcessWorkOrderRequest": {
      "type": "object",
      "required": [
        "action"
      ],
      "properties": {
        "action": {
          "type": "string",
          "description": "操作: RESOLVE(解决) / REJECT(驳回)"
        },
        "costDifference": {
          "type": "number",
          "description": "调整后差价"
        },
        "rejectReason": {
          "type": "string",
          "description": "驳回原因(驳回时填写)"
        },
        "resolution": {
          "type": "string",
          "description": "处理结果(解决时填写)"
        }
      },
      "title": "ProcessWorkOrderRequest"
    },
    "WorkOrderVO": {
      "type": "object",
      "properties": {
        "assigneeAdminId": {
          "type": "string",
          "description": "处理人ID"
        },
        "assigneeName": {
          "type": "string",
          "description": "处理人姓名"
        },
        "attachmentUrls": {
          "type": "string",
          "description": "附件URL(JSON数组)"
        },
        "costDifference": {
          "type": "number",
          "description": "差价"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "creatorAdminId": {
          "type": "string",
          "description": "发起人ID"
        },
        "creatorName": {
          "type": "string",
          "description": "发起人姓名"
        },
        "description": {
          "type": "string",
          "description": "问题描述"
        },
        "logs": {
          "type": "array",
          "description": "操作日志列表",
          "items": {
            "$ref": "#/definitions/工单操作日志VO",
            "originalRef": "工单操作日志VO"
          }
        },
        "orderId": {
          "type": "string",
          "description": "关联订单ID"
        },
        "orderNo": {
          "type": "string",
          "description": "关联订单编号"
        },
        "priority": {
          "type": "string",
          "description": "优先级"
        },
        "priorityLabel": {
          "type": "string",
          "description": "优先级标签"
        },
        "rejectReason": {
          "type": "string",
          "description": "驳回原因"
        },
        "resolution": {
          "type": "string",
          "description": "处理结果"
        },
        "resolvedAt": {
          "type": "string",
          "format": "date-time",
          "description": "处理完成时间"
        },
        "resourceDetail": {
          "type": "string",
          "description": "资源详情JSON"
        },
        "status": {
          "type": "string",
          "description": "状态"
        },
        "statusLabel": {
          "type": "string",
          "description": "状态标签"
        },
        "type": {
          "type": "string",
          "description": "工单类型"
        },
        "typeLabel": {
          "type": "string",
          "description": "工单类型标签"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        },
        "workOrderId": {
          "type": "string",
          "description": "工单ID"
        },
        "workOrderNo": {
          "type": "string",
          "description": "工单编号"
        }
      },
      "title": "WorkOrderVO"
    },
    "交通信息请求（批量保存）": {
      "type": "object",
      "required": [
        "segments"
      ],
      "properties": {
        "segments": {
          "type": "array",
          "description": "交通分段列表",
          "items": {
            "$ref": "#/definitions/交通分段项",
            "originalRef": "交通分段项"
          }
        }
      },
      "title": "交通信息请求（批量保存）"
    },
    "交通分段项": {
      "type": "object",
      "required": [
        "transportType"
      ],
      "properties": {
        "arriveStation": {
          "type": "string",
          "example": "广州白云T2",
          "description": "到达站/到达机场"
        },
        "arriveTime": {
          "type": "string",
          "format": "date-time",
          "example": "2026-04-01T11:45:00",
          "description": "到达时间"
        },
        "departStation": {
          "type": "string",
          "example": "北京首都T3",
          "description": "出发站/出发机场"
        },
        "departTime": {
          "type": "string",
          "format": "date-time",
          "example": "2026-04-01T08:30:00",
          "description": "出发时间"
        },
        "remark": {
          "type": "string",
          "example": "请提前2小时到达机场",
          "description": "备注"
        },
        "transportNo": {
          "type": "string",
          "example": "CA1234",
          "description": "航班号/车次号"
        },
        "transportType": {
          "type": "string",
          "example": "FLIGHT",
          "description": "交通类型（字典：transport_type）: FLIGHT-航班, TRAIN-火车"
        }
      },
      "title": "交通分段项"
    },
    "优惠项请求": {
      "type": "object",
      "required": [
        "discountAmount",
        "discountName"
      ],
      "properties": {
        "discountAmount": {
          "type": "number",
          "example": 100.0,
          "description": "优惠金额"
        },
        "discountName": {
          "type": "string",
          "example": "会员折扣",
          "description": "优惠项目名称"
        }
      },
      "title": "优惠项请求"
    },
    "修改定金金额请求": {
      "type": "object",
      "required": [
        "amount"
      ],
      "properties": {
        "amount": {
          "type": "number",
          "example": 500.0,
          "description": "定金金额"
        }
      },
      "title": "修改定金金额请求"
    },
    "修改订单过期时间请求": {
      "type": "object",
      "required": [
        "minutes"
      ],
      "properties": {
        "minutes": {
          "type": "integer",
          "format": "int32",
          "example": 30,
          "description": "过期时间（分钟）"
        }
      },
      "title": "修改订单过期时间请求"
    },
    "出行人信息": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "birthday": {
          "type": "string",
          "format": "date",
          "example": "1990-01-01",
          "description": "出生日期（后端根据此字段自动判断人员类型，未传则默认ADULT）"
        },
        "email": {
          "type": "string",
          "example": "lisi@example.com",
          "description": "电子邮箱"
        },
        "emergencyContact": {
          "type": "string",
          "example": "王五",
          "description": "紧急联系人"
        },
        "emergencyPhone": {
          "type": "string",
          "example": 13800138002,
          "description": "紧急联系电话"
        },
        "gender": {
          "type": "string",
          "example": 1,
          "description": "性别（字典：gender）"
        },
        "idCardNo": {
          "type": "string",
          "example": 110101199001011234,
          "description": "证件号码"
        },
        "idCardType": {
          "type": "string",
          "example": "ID_CARD",
          "description": "证件类型（字典：id_card_type）"
        },
        "name": {
          "type": "string",
          "example": "李四",
          "description": "出行人姓名"
        },
        "nationality": {
          "type": "string",
          "example": "中国",
          "description": "国籍"
        },
        "phone": {
          "type": "string",
          "example": 13800138001,
          "description": "手机号"
        }
      },
      "title": "出行人信息"
    },
    "分页结果«AlbumFileVO»": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "当前页码"
        },
        "pageSize": {
          "type": "integer",
          "format": "int32",
          "example": 20,
          "description": "每页条数"
        },
        "records": {
          "type": "array",
          "description": "数据列表",
          "items": {
            "$ref": "#/definitions/AlbumFileVO",
            "originalRef": "AlbumFileVO"
          }
        },
        "total": {
          "type": "integer",
          "format": "int32",
          "example": 100,
          "description": "总记录数"
        }
      },
      "title": "分页结果«AlbumFileVO»"
    },
    "分页结果«WorkOrderVO»": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "当前页码"
        },
        "pageSize": {
          "type": "integer",
          "format": "int32",
          "example": 20,
          "description": "每页条数"
        },
        "records": {
          "type": "array",
          "description": "数据列表",
          "items": {
            "$ref": "#/definitions/WorkOrderVO",
            "originalRef": "WorkOrderVO"
          }
        },
        "total": {
          "type": "integer",
          "format": "int32",
          "example": 100,
          "description": "总记录数"
        }
      },
      "title": "分页结果«WorkOrderVO»"
    },
    "分页结果«早鸟优惠计划VO»": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "当前页码"
        },
        "pageSize": {
          "type": "integer",
          "format": "int32",
          "example": 20,
          "description": "每页条数"
        },
        "records": {
          "type": "array",
          "description": "数据列表",
          "items": {
            "$ref": "#/definitions/早鸟优惠计划VO",
            "originalRef": "早鸟优惠计划VO"
          }
        },
        "total": {
          "type": "integer",
          "format": "int32",
          "example": 100,
          "description": "总记录数"
        }
      },
      "title": "分页结果«早鸟优惠计划VO»"
    },
    "分页结果«管理员订单列表VO»": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "当前页码"
        },
        "pageSize": {
          "type": "integer",
          "format": "int32",
          "example": 20,
          "description": "每页条数"
        },
        "records": {
          "type": "array",
          "description": "数据列表",
          "items": {
            "$ref": "#/definitions/管理员订单列表VO",
            "originalRef": "管理员订单列表VO"
          }
        },
        "total": {
          "type": "integer",
          "format": "int32",
          "example": 100,
          "description": "总记录数"
        }
      },
      "title": "分页结果«管理员订单列表VO»"
    },
    "单天住宿分配": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "description": "日期（yyyy-MM-dd）"
        },
        "hotelCoverUrl": {
          "type": "string",
          "description": "酒店封面图URL（从产品快照提取，可能为空）"
        },
        "hotelId": {
          "type": "integer",
          "format": "int64",
          "description": "酒店ID"
        },
        "hotelName": {
          "type": "string",
          "description": "酒店名称"
        },
        "remark": {
          "type": "string",
          "description": "备注"
        },
        "roomCount": {
          "type": "integer",
          "format": "int32",
          "description": "房间数量"
        },
        "roomType": {
          "type": "string",
          "description": "房型名称"
        },
        "roomTypeCoverUrl": {
          "type": "string",
          "description": "房型封面图URL（从产品快照提取，可能为空）"
        },
        "roomTypeId": {
          "type": "integer",
          "format": "int64",
          "description": "房型ID"
        }
      },
      "title": "单天住宿分配"
    },
    "单天升级差价明细": {
      "type": "object",
      "properties": {
        "assignedPrice": {
          "type": "number",
          "description": "实际房型当天单价"
        },
        "assignedRoomTypeId": {
          "type": "integer",
          "format": "int64",
          "description": "实际分配房型ID"
        },
        "assignedRoomTypeName": {
          "type": "string",
          "description": "实际分配房型名称"
        },
        "date": {
          "type": "string",
          "description": "日期"
        },
        "dayDiff": {
          "type": "number",
          "description": "当天差价"
        },
        "defaultPrice": {
          "type": "number",
          "description": "默认房型当天单价"
        },
        "defaultRoomTypeId": {
          "type": "integer",
          "format": "int64",
          "description": "产品默认房型ID"
        },
        "defaultRoomTypeName": {
          "type": "string",
          "description": "产品默认房型名称"
        },
        "direction": {
          "type": "string",
          "description": "差价方向"
        },
        "familyIndex": {
          "type": "integer",
          "format": "int32",
          "description": "家庭序号"
        },
        "remark": {
          "type": "string",
          "description": "备注"
        }
      },
      "title": "单天升级差价明细"
    },
    "单天单家庭酒店分配": {
      "type": "object",
      "required": [
        "date",
        "familyIndex",
        "hotelId",
        "hotelName",
        "roomType",
        "roomTypeId"
      ],
      "properties": {
        "date": {
          "type": "string",
          "description": "日期(yyyy-MM-dd)，单天"
        },
        "familyIndex": {
          "type": "integer",
          "format": "int32",
          "description": "家庭序号"
        },
        "hotelId": {
          "type": "integer",
          "format": "int64",
          "description": "酒店ID"
        },
        "hotelName": {
          "type": "string",
          "description": "酒店名称"
        },
        "remark": {
          "type": "string",
          "description": "当天备注"
        },
        "roomType": {
          "type": "string",
          "description": "房型名称"
        },
        "roomTypeId": {
          "type": "integer",
          "format": "int64",
          "description": "房型ID"
        },
        "upgradePrice": {
          "type": "number",
          "description": "手动覆盖升级差价（null=使用系统计算值，仅当房型与产品默认不同时有效）"
        }
      },
      "title": "单天单家庭酒店分配"
    },
    "工单操作日志VO": {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "description": "操作动作"
        },
        "actionLabel": {
          "type": "string",
          "description": "操作动作标签"
        },
        "content": {
          "type": "string",
          "description": "操作内容"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "description": "操作时间"
        },
        "logId": {
          "type": "string",
          "description": "日志ID"
        },
        "operatorName": {
          "type": "string",
          "description": "操作人姓名"
        }
      },
      "title": "工单操作日志VO"
    },
    "差价计算结果": {
      "type": "object",
      "properties": {
        "changeDays": {
          "type": "integer",
          "format": "int32",
          "description": "变更天数"
        },
        "description": {
          "type": "string",
          "description": "差价描述（中文说明）"
        },
        "direction": {
          "type": "string",
          "description": "差价方向：UPGRADE=升级加价, DOWNGRADE=降级减价, SAME=价格不变"
        },
        "newName": {
          "type": "string",
          "description": "新资源名称"
        },
        "newUnitPrice": {
          "type": "number",
          "description": "新单价（日均）"
        },
        "originalName": {
          "type": "string",
          "description": "原资源名称"
        },
        "originalUnitPrice": {
          "type": "number",
          "description": "原单价（日均）"
        },
        "priceDiff": {
          "type": "number",
          "description": "差价金额（正数=需补款，负数=可退款）"
        }
      },
      "title": "差价计算结果"
    },
    "房型变更请求": {
      "type": "object",
      "required": [
        "dayNumber",
        "newRoomTypeId",
        "originalRoomTypeId",
        "reason"
      ],
      "properties": {
        "balanceAdjustment": {
          "type": "number",
          "example": 200.0,
          "description": "尾款调整金额（可选，覆盖系统建议差价；正数=增加尾款，负数=减少尾款）"
        },
        "changeReasonCode": {
          "type": "string",
          "description": "变更原因代码（字典项 order_change_reason）"
        },
        "dayNumber": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "行程天数编号"
        },
        "newRoomTypeId": {
          "type": "integer",
          "format": "int64",
          "description": "新房型ID"
        },
        "originalRoomTypeId": {
          "type": "integer",
          "format": "int64",
          "description": "原房型ID"
        },
        "reason": {
          "type": "string",
          "example": "客户要求升级房型",
          "description": "变更原因"
        },
        "roomCount": {
          "type": "integer",
          "format": "int32",
          "example": 2,
          "description": "房间数量"
        }
      },
      "title": "房型变更请求"
    },
    "房间信息请求": {
      "type": "object",
      "required": [
        "roomInfo"
      ],
      "properties": {
        "roomInfo": {
          "type": "string",
          "example": "标准双人间2间，大床房1间",
          "description": "房间信息"
        }
      },
      "title": "房间信息请求"
    },
    "报价预览请求": {
      "type": "object",
      "required": [
        "departureDate",
        "productId"
      ],
      "properties": {
        "adultCount": {
          "type": "integer",
          "format": "int32",
          "example": 2,
          "description": "成人数"
        },
        "babyCount": {
          "type": "integer",
          "format": "int32",
          "example": 0,
          "description": "幼童数"
        },
        "childCount": {
          "type": "integer",
          "format": "int32",
          "example": 0,
          "description": "儿童数"
        },
        "childNeedBed": {
          "type": "boolean",
          "example": false,
          "description": "儿童是否需要床位"
        },
        "departureDate": {
          "type": "string",
          "format": "date",
          "example": "2026-05-01",
          "description": "出发日期"
        },
        "productId": {
          "type": "integer",
          "format": "int64",
          "example": 1760000000000001,
          "description": "产品ID"
        },
        "youngChildCount": {
          "type": "integer",
          "format": "int32",
          "example": 0,
          "description": "小童数"
        }
      },
      "title": "报价预览请求"
    },
    "撤销行程编辑请求": {
      "type": "object",
      "required": [
        "reason"
      ],
      "properties": {
        "reason": {
          "type": "string",
          "example": "客户改主意了",
          "description": "撤销原因"
        }
      },
      "title": "撤销行程编辑请求"
    },
    "新增行程天请求": {
      "type": "object",
      "required": [
        "dayNumber",
        "dayTitle",
        "reason"
      ],
      "properties": {
        "dayNumber": {
          "type": "integer",
          "format": "int32",
          "example": 3,
          "description": "行程天数编号（插入位置，后续天数自动顺延）"
        },
        "dayTitle": {
          "type": "string",
          "example": "第三天：丽江古城自由行",
          "description": "天标题"
        },
        "nodes": {
          "type": "array",
          "description": "该天的行程节点列表",
          "items": {
            "$ref": "#/definitions/新增行程节点请求",
            "originalRef": "新增行程节点请求"
          }
        },
        "prevDayHotel": {
          "description": "前一天住宿配置（原最后一天无住宿，新增天数后需配置）",
          "$ref": "#/definitions/PrevDayHotel",
          "originalRef": "PrevDayHotel"
        },
        "reason": {
          "type": "string",
          "example": "客户要求增加一天自由行",
          "description": "变更原因"
        }
      },
      "title": "新增行程天请求"
    },
    "新增行程节点请求": {
      "type": "object",
      "required": [
        "nodeName",
        "nodeType"
      ],
      "properties": {
        "balanceAdjustment": {
          "type": "number",
          "example": 200.0,
          "description": "尾款调整金额（正数=增加尾款，负数=减少尾款）"
        },
        "dayNumber": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "行程天数编号（独立调用时必填，addDay子节点时自动继承）"
        },
        "description": {
          "type": "string",
          "description": "节点描述"
        },
        "nodeName": {
          "type": "string",
          "description": "节点名称"
        },
        "nodeType": {
          "type": "string",
          "description": "节点类型：SCENIC/HOTEL/RESTAURANT/ACTIVITY/VEHICLE/SERVICE/FREE/NOTE"
        },
        "reason": {
          "type": "string",
          "example": "客户要求增加该景点",
          "description": "修改原因（独立调用时必填，addDay子节点时自动继承）"
        },
        "resourceId": {
          "type": "integer",
          "format": "int64",
          "description": "关联资源ID"
        },
        "resourceType": {
          "type": "string",
          "description": "关联资源类型：SCENIC_SPOT/ACTIVITY/RESTAURANT/HOTEL/VEHICLE"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序序号（插入位置，默认追加到末尾）"
        },
        "startTime": {
          "type": "string",
          "description": "开始时间"
        }
      },
      "title": "新增行程节点请求"
    },
    "早鸟优惠计划VO": {
      "type": "object",
      "properties": {
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "createdBy": {
          "type": "integer",
          "format": "int64",
          "description": "创建人ID"
        },
        "discountAmount": {
          "type": "number",
          "description": "优惠金额"
        },
        "enabled": {
          "type": "boolean",
          "description": "是否启用"
        },
        "endDate": {
          "type": "string",
          "format": "date",
          "description": "生效结束日期"
        },
        "minPeople": {
          "type": "integer",
          "format": "int32",
          "description": "最低人数"
        },
        "planId": {
          "type": "integer",
          "format": "int64",
          "description": "计划ID"
        },
        "planName": {
          "type": "string",
          "description": "计划名称"
        },
        "productIds": {
          "type": "array",
          "description": "适用产品ID列表（空表示适用全部CORE/GROUP产品）",
          "items": {
            "type": "integer",
            "format": "int64"
          }
        },
        "productNames": {
          "type": "array",
          "description": "适用产品名称列表（空表示适用全部）",
          "items": {
            "type": "string"
          }
        },
        "remark": {
          "type": "string",
          "description": "备注"
        },
        "startDate": {
          "type": "string",
          "format": "date",
          "description": "生效开始日期"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "早鸟优惠计划VO"
    },
    "早鸟优惠计划请求": {
      "type": "object",
      "required": [
        "discountAmount",
        "endDate",
        "minPeople",
        "planName",
        "startDate"
      ],
      "properties": {
        "discountAmount": {
          "type": "number",
          "example": 200.0,
          "description": "优惠金额（从订单总价中扣减的固定金额）"
        },
        "endDate": {
          "type": "string",
          "format": "date",
          "example": "2026-04-15",
          "description": "生效结束日期"
        },
        "minPeople": {
          "type": "integer",
          "format": "int32",
          "example": 2,
          "description": "最低出行人数（含成人+儿童），订单人数>=此值才能享受优惠"
        },
        "planName": {
          "type": "string",
          "example": "五一早鸟优惠",
          "description": "计划名称"
        },
        "productIds": {
          "type": "array",
          "example": [
            "1760000000000001",
            "1760000000000002"
          ],
          "description": "适用产品ID列表（仅CORE/GROUP类型），为空或null表示适用全部核心产品和小蒙马",
          "items": {
            "type": "integer",
            "format": "int64"
          }
        },
        "remark": {
          "type": "string",
          "example": "仅限新用户",
          "description": "备注"
        },
        "startDate": {
          "type": "string",
          "format": "date",
          "example": "2026-03-01",
          "description": "生效开始日期"
        }
      },
      "title": "早鸟优惠计划请求"
    },
    "更换定制师请求": {
      "type": "object",
      "required": [
        "customizerId"
      ],
      "properties": {
        "customizerId": {
          "type": "integer",
          "format": "int64",
          "description": "定制师ID"
        }
      },
      "title": "更换定制师请求"
    },
    "更新订单状态请求": {
      "type": "object",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "type": "string",
          "example": "CONFIRMED",
          "description": "目标状态。可选值：PENDING_PAY(待支付)/DEPOSIT_PAID(已付定金)/PAID(已全额支付)/CONFIRMED(已确认)/PENDING_BALANCE(待付尾款)/PENDING_DEPARTURE(待出行)/TRAVELLING(旅行中)/COMPLETED(已完成)/AFTER_SALE(售后中)/REFUNDING(退款中)/REFUNDED(已退款)/CANCELLED(已取消)"
        }
      },
      "title": "更新订单状态请求"
    },
    "申请解锁订单请求": {
      "type": "object",
      "properties": {
        "reason": {
          "type": "string",
          "description": "解锁原因"
        }
      },
      "title": "申请解锁订单请求"
    },
    "管理员修改订单请求": {
      "type": "object",
      "properties": {
        "adultCount": {
          "type": "integer",
          "format": "int32",
          "example": 2,
          "description": "成人数"
        },
        "babyCount": {
          "type": "integer",
          "format": "int32",
          "example": 0,
          "description": "幼童数"
        },
        "childCount": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "儿童数"
        },
        "contactName": {
          "type": "string",
          "example": "张三",
          "description": "联系人姓名"
        },
        "contactPhone": {
          "type": "string",
          "example": 13800138000,
          "description": "联系人电话"
        },
        "customizerId": {
          "type": "integer",
          "format": "int64",
          "example": 123456,
          "description": "定制师ID（切换定制师）"
        },
        "departureDate": {
          "type": "string",
          "format": "date",
          "example": "2026-05-01",
          "description": "出发日期"
        },
        "depositAmount": {
          "type": "number",
          "example": 2000.0,
          "description": "定金金额"
        },
        "mchId": {
          "type": "string",
          "example": 1246532201,
          "description": "商户号（微信支付商户号，多商户场景使用）"
        },
        "remark": {
          "type": "string",
          "example": "客户要求安排靠窗座位",
          "description": "备注"
        },
        "totalCost": {
          "type": "number",
          "example": 5000.0,
          "description": "总成本"
        },
        "totalPrice": {
          "type": "number",
          "example": 8000.0,
          "description": "总售价"
        },
        "travelers": {
          "type": "array",
          "description": "出行人列表（如提供则替换全部出行人，不传则不修改出行人）",
          "items": {
            "$ref": "#/definitions/出行人信息",
            "originalRef": "出行人信息"
          }
        },
        "youngChildCount": {
          "type": "integer",
          "format": "int32",
          "example": 0,
          "description": "小童数"
        }
      },
      "title": "管理员修改订单请求"
    },
    "管理员创建订单请求": {
      "type": "object",
      "required": [
        "contactName",
        "contactPhone",
        "productId"
      ],
      "properties": {
        "adultCount": {
          "type": "integer",
          "format": "int32",
          "example": 2,
          "description": "成人数"
        },
        "babyCount": {
          "type": "integer",
          "format": "int32",
          "example": 0,
          "description": "幼童数"
        },
        "childCount": {
          "type": "integer",
          "format": "int32",
          "example": 0,
          "description": "儿童数"
        },
        "childNeedBed": {
          "type": "boolean",
          "example": false,
          "description": "儿童是否需要床位（影响房间分配和报价计算）"
        },
        "contactName": {
          "type": "string",
          "example": "张三",
          "description": "联系人姓名"
        },
        "contactPhone": {
          "type": "string",
          "example": 13800138000,
          "description": "联系人电话"
        },
        "customizerId": {
          "type": "integer",
          "format": "int64",
          "example": 1760000000000010,
          "description": "定制师ID（可选，默认为创建人）"
        },
        "departureDate": {
          "type": "string",
          "format": "date",
          "example": "2026-05-01",
          "description": "出发日期(GROUP产品可不传，从团期获取)"
        },
        "expiryMinutes": {
          "type": "integer",
          "format": "int32",
          "example": 30,
          "description": "支付时限（分钟），不传则使用全局默认值。超时未支付订单自动取消"
        },
        "groupBatchId": {
          "type": "integer",
          "format": "int64",
          "description": "团期ID(GROUP产品必填)"
        },
        "productId": {
          "type": "integer",
          "format": "int64",
          "example": 1760000000000001,
          "description": "产品ID"
        },
        "remark": {
          "type": "string",
          "example": "客户VIP",
          "description": "备注"
        },
        "roomCount": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "房间数(GROUP产品，默认1)"
        },
        "travelers": {
          "type": "array",
          "description": "出行人列表",
          "items": {
            "$ref": "#/definitions/出行人信息",
            "originalRef": "出行人信息"
          }
        },
        "userPhone": {
          "type": "string",
          "example": 13800138000,
          "description": "用户手机号（可选，用于关联C端用户）。如匹配到已注册用户则自动绑定订单"
        },
        "youngChildCount": {
          "type": "integer",
          "format": "int32",
          "example": 0,
          "description": "小童数"
        }
      },
      "title": "管理员创建订单请求"
    },
    "管理员取消订单请求": {
      "type": "object",
      "required": [
        "reason"
      ],
      "properties": {
        "reason": {
          "type": "string",
          "example": "客户主动取消",
          "description": "取消原因"
        },
        "refundAmount": {
          "type": "number",
          "example": 500.0,
          "description": "退款金额（可选，不传则按退款政策自动计算；传0表示不退款）"
        }
      },
      "title": "管理员取消订单请求"
    },
    "管理员基本信息": {
      "type": "object",
      "properties": {
        "adminId": {
          "type": "integer",
          "format": "int64",
          "description": "管理员ID"
        },
        "avatarUrl": {
          "type": "string",
          "description": "头像URL"
        },
        "username": {
          "type": "string",
          "description": "用户名"
        },
        "wechatName": {
          "type": "string",
          "description": "企微用户名称"
        },
        "wechatUserid": {
          "type": "string",
          "description": "企微用户ID"
        }
      },
      "title": "管理员基本信息"
    },
    "管理员备注请求": {
      "type": "object",
      "required": [
        "content"
      ],
      "properties": {
        "content": {
          "type": "string",
          "example": "客户要求加急处理",
          "description": "备注内容"
        }
      },
      "title": "管理员备注请求"
    },
    "管理员订单列表VO": {
      "type": "object",
      "properties": {
        "adultCount": {
          "type": "integer",
          "format": "int32",
          "description": "成人数"
        },
        "babyCount": {
          "type": "integer",
          "format": "int32",
          "description": "幼童数"
        },
        "balanceAmount": {
          "type": "number",
          "description": "尾款金额（DEPOSIT模式：总售价-定金-优惠）"
        },
        "checklistConfirmed": {
          "type": "boolean",
          "description": "是否已锁单（清单确认后锁定）"
        },
        "childCount": {
          "type": "integer",
          "format": "int32",
          "description": "儿童数"
        },
        "contactName": {
          "type": "string",
          "description": "联系人姓名"
        },
        "contactPhone": {
          "type": "string",
          "description": "联系人电话"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "creatorAdminId": {
          "type": "integer",
          "format": "int64",
          "description": "创建人管理员ID"
        },
        "customizerName": {
          "type": "string",
          "description": "定制师名称"
        },
        "daysUntilDeparture": {
          "type": "integer",
          "format": "int32",
          "description": "距出发天数（负数表示已出发）"
        },
        "departureDate": {
          "type": "string",
          "format": "date",
          "description": "出发日期"
        },
        "depositAmount": {
          "type": "number",
          "description": "定金金额"
        },
        "discountAmount": {
          "type": "number",
          "description": "优惠金额"
        },
        "mchId": {
          "type": "string",
          "description": "商户号"
        },
        "mchName": {
          "type": "string",
          "description": "商户名称"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "orderNo": {
          "type": "string",
          "description": "订单号"
        },
        "paidAmount": {
          "type": "number",
          "description": "已付金额"
        },
        "paymentMode": {
          "type": "string",
          "description": "支付模式（字典：payment_mode）"
        },
        "processStatus": {
          "type": "string",
          "description": "内部流程状态（字典：order_process_status）"
        },
        "processStatusLabel": {
          "type": "string",
          "description": "内部流程状态标签（字典：order_process_status 翻译）"
        },
        "productCoverUrl": {
          "type": "string",
          "description": "产品封面图URL"
        },
        "productId": {
          "type": "integer",
          "format": "int64",
          "description": "产品ID"
        },
        "productName": {
          "type": "string",
          "description": "产品名称"
        },
        "productType": {
          "type": "string",
          "description": "产品类型（字典：product_type）"
        },
        "status": {
          "type": "string",
          "description": "订单状态（字典：order_status）"
        },
        "statusLabel": {
          "type": "string",
          "description": "订单状态标签（字典：order_status 翻译）"
        },
        "surchargeAmount": {
          "type": "number",
          "description": "费用增加总额"
        },
        "totalPrice": {
          "type": "number",
          "description": "总售价"
        },
        "tripDays": {
          "type": "integer",
          "format": "int32",
          "description": "行程天数"
        },
        "tripNights": {
          "type": "integer",
          "format": "int32",
          "description": "行程晚数"
        },
        "userId": {
          "type": "integer",
          "format": "int64",
          "description": "用户ID"
        },
        "youngChildCount": {
          "type": "integer",
          "format": "int32",
          "description": "小童数"
        }
      },
      "title": "管理员订单列表VO"
    },
    "统一响应结果«AlbumFileVO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/AlbumFileVO",
          "originalRef": "AlbumFileVO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«AlbumFileVO»"
    },
    "统一响应结果«AlbumFolderVO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/AlbumFolderVO",
          "originalRef": "AlbumFolderVO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«AlbumFolderVO»"
    },
    "统一响应结果«List«AlbumFileVO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/AlbumFileVO",
            "originalRef": "AlbumFileVO"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«AlbumFileVO»»"
    },
    "统一响应结果«List«AlbumFolderVO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/AlbumFolderVO",
            "originalRef": "AlbumFolderVO"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«AlbumFolderVO»»"
    },
    "统一响应结果«List«Map«string,object»»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/Map«string,object»",
            "originalRef": "Map«string,object»"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«Map«string,object»»»"
    },
    "统一响应结果«List«OrderItineraryEdit»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/OrderItineraryEdit",
            "originalRef": "OrderItineraryEdit"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«OrderItineraryEdit»»"
    },
    "统一响应结果«List«OrderTodo»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/OrderTodo",
            "originalRef": "OrderTodo"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«OrderTodo»»"
    },
    "统一响应结果«List«OrderTransportSegment»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/OrderTransportSegment",
            "originalRef": "OrderTransportSegment"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«OrderTransportSegment»»"
    },
    "统一响应结果«List«OrderTraveler»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/OrderTraveler",
            "originalRef": "OrderTraveler"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«OrderTraveler»»"
    },
    "统一响应结果«List«管理员基本信息»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/管理员基本信息",
            "originalRef": "管理员基本信息"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«管理员基本信息»»"
    },
    "统一响应结果«List«订单待办VO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/订单待办VO",
            "originalRef": "订单待办VO"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«订单待办VO»»"
    },
    "统一响应结果«Map«string,object»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "object",
          "description": "响应数据"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«Map«string,object»»"
    },
    "统一响应结果«OrderDiscount»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/OrderDiscount",
          "originalRef": "OrderDiscount"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«OrderDiscount»"
    },
    "统一响应结果«OrderItineraryEdit»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/OrderItineraryEdit",
          "originalRef": "OrderItineraryEdit"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«OrderItineraryEdit»"
    },
    "统一响应结果«OrderSurcharge»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/OrderSurcharge",
          "originalRef": "OrderSurcharge"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«OrderSurcharge»"
    },
    "统一响应结果«Void»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«Void»"
    },
    "统一响应结果«WorkOrderVO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/WorkOrderVO",
          "originalRef": "WorkOrderVO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«WorkOrderVO»"
    },
    "统一响应结果«int»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "integer",
          "format": "int32",
          "description": "响应数据"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«int»"
    },
    "统一响应结果«long»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "integer",
          "format": "int64",
          "description": "响应数据"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«long»"
    },
    "统一响应结果«string»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "string",
          "description": "响应数据"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«string»"
    },
    "统一响应结果«分页结果«AlbumFileVO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/分页结果«AlbumFileVO»",
          "originalRef": "分页结果«AlbumFileVO»"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«分页结果«AlbumFileVO»»"
    },
    "统一响应结果«分页结果«WorkOrderVO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/分页结果«WorkOrderVO»",
          "originalRef": "分页结果«WorkOrderVO»"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«分页结果«WorkOrderVO»»"
    },
    "统一响应结果«分页结果«早鸟优惠计划VO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/分页结果«早鸟优惠计划VO»",
          "originalRef": "分页结果«早鸟优惠计划VO»"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«分页结果«早鸟优惠计划VO»»"
    },
    "统一响应结果«分页结果«管理员订单列表VO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/分页结果«管理员订单列表VO»",
          "originalRef": "分页结果«管理员订单列表VO»"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«分页结果«管理员订单列表VO»»"
    },
    "统一响应结果«差价计算结果»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/差价计算结果",
          "originalRef": "差价计算结果"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«差价计算结果»"
    },
    "统一响应结果«早鸟优惠计划VO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/早鸟优惠计划VO",
          "originalRef": "早鸟优惠计划VO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«早鸟优惠计划VO»"
    },
    "统一响应结果«订单详情VO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/订单详情VO",
          "originalRef": "订单详情VO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«订单详情VO»"
    },
    "统一响应结果«配房升级差价预览»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/配房升级差价预览",
          "originalRef": "配房升级差价预览"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«配房升级差价预览»"
    },
    "订单待办VO": {
      "type": "object",
      "properties": {
        "assigneeAdminId": {
          "type": "integer",
          "format": "int64",
          "description": "负责管理员ID"
        },
        "assigneeRoleKey": {
          "type": "string",
          "description": "负责角色标识"
        },
        "blocked": {
          "type": "boolean",
          "description": "是否阻塞"
        },
        "blockedReason": {
          "type": "string",
          "description": "阻塞原因"
        },
        "completedAt": {
          "type": "string",
          "format": "date-time",
          "description": "完成时间"
        },
        "completedBy": {
          "type": "integer",
          "format": "int64",
          "description": "完成人ID"
        },
        "contactName": {
          "type": "string",
          "description": "联系人姓名（关联查询）"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "departureDate": {
          "type": "string",
          "format": "date",
          "description": "出发日期（关联查询）"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "orderNo": {
          "type": "string",
          "description": "订单号"
        },
        "orderStatus": {
          "type": "string",
          "description": "订单状态（关联查询）"
        },
        "productName": {
          "type": "string",
          "description": "产品名称（关联查询）"
        },
        "sequence": {
          "type": "integer",
          "format": "int32",
          "description": "排序序号"
        },
        "status": {
          "type": "string",
          "description": "待办状态"
        },
        "todoId": {
          "type": "integer",
          "format": "int64",
          "description": "待办ID"
        },
        "todoLabel": {
          "type": "string",
          "description": "待办名称"
        },
        "todoType": {
          "type": "string",
          "description": "待办类型"
        }
      },
      "title": "订单待办VO"
    },
    "订单详情VO": {
      "type": "object",
      "properties": {
        "adultCount": {
          "type": "integer",
          "format": "int32",
          "description": "成人数"
        },
        "babyCount": {
          "type": "integer",
          "format": "int32",
          "description": "幼童数"
        },
        "balanceAmount": {
          "type": "number",
          "description": "尾款金额（总售价-定金）"
        },
        "balancePayMethod": {
          "type": "string",
          "description": "尾款支付方式: ONLINE=线上微信支付 OFFLINE=线下转账"
        },
        "balanceProofUrl": {
          "type": "string",
          "description": "尾款凭证URL"
        },
        "cancelReason": {
          "type": "string",
          "description": "取消原因"
        },
        "cancelledAt": {
          "type": "string",
          "format": "date-time",
          "description": "取消时间"
        },
        "checklistConfirmed": {
          "type": "boolean",
          "description": "清单确认状态"
        },
        "childCount": {
          "type": "integer",
          "format": "int32",
          "description": "儿童数"
        },
        "completedAt": {
          "type": "string",
          "format": "date-time",
          "description": "完成时间"
        },
        "confirmedAt": {
          "type": "string",
          "format": "date-time",
          "description": "确认时间"
        },
        "contactName": {
          "type": "string",
          "description": "联系人姓名"
        },
        "contactPhone": {
          "type": "string",
          "description": "联系人电话"
        },
        "contracts": {
          "type": "array",
          "description": "合同列表（含signUrl/fileUrl/status等）",
          "items": {
            "$ref": "#/definitions/Map«string,object»",
            "originalRef": "Map«string,object»"
          }
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "creatorAdminId": {
          "type": "integer",
          "format": "int64",
          "description": "创建人管理员ID"
        },
        "creatorName": {
          "type": "string",
          "description": "创建人姓名"
        },
        "customizerId": {
          "type": "integer",
          "format": "int64",
          "description": "定制师ID"
        },
        "customizerName": {
          "type": "string",
          "description": "定制师姓名"
        },
        "departureDate": {
          "type": "string",
          "format": "date",
          "description": "出发日期"
        },
        "depositAmount": {
          "type": "number",
          "description": "定金金额"
        },
        "depositRatio": {
          "type": "integer",
          "format": "int32",
          "description": "定金比例"
        },
        "discountAmount": {
          "type": "number",
          "description": "优惠金额"
        },
        "discountReason": {
          "type": "string",
          "description": "优惠原因"
        },
        "discounts": {
          "type": "array",
          "description": "优惠列表",
          "items": {
            "$ref": "#/definitions/OrderDiscount",
            "originalRef": "OrderDiscount"
          }
        },
        "displayStatus": {
          "type": "string",
          "description": "前端显示状态（字典：order_display_status）"
        },
        "displayStatusLabel": {
          "type": "string",
          "description": "前端显示状态标签（字典：order_display_status 翻译）"
        },
        "expiryMinutes": {
          "type": "integer",
          "format": "int32",
          "description": "支付时限（分钟）"
        },
        "expiryTime": {
          "type": "string",
          "format": "date-time",
          "description": "支付截止时间"
        },
        "hotelAssignmentDetails": {
          "type": "array",
          "description": "酒店分配详情（按家庭分组，含封面图）",
          "items": {
            "$ref": "#/definitions/酒店分配详情（按家庭分组）",
            "originalRef": "酒店分配详情（按家庭分组）"
          }
        },
        "hotelAssignments": {
          "type": "string",
          "description": "酒店分配信息JSON（原始数据）"
        },
        "insurances": {
          "type": "array",
          "description": "保险订单列表（含productName/extPolicyNo/status/startDate/endDate等）",
          "items": {
            "$ref": "#/definitions/Map«string,object»",
            "originalRef": "Map«string,object»"
          }
        },
        "mchId": {
          "type": "string",
          "description": "商户号"
        },
        "mchName": {
          "type": "string",
          "description": "商户名称"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "orderNo": {
          "type": "string",
          "description": "订单号"
        },
        "paidAmount": {
          "type": "number",
          "description": "已付金额"
        },
        "paidAt": {
          "type": "string",
          "format": "date-time",
          "description": "支付时间"
        },
        "payMethodLabel": {
          "type": "string",
          "description": "支付方式标签（如：微信支付、定金微信+尾款线下）"
        },
        "paymentMode": {
          "type": "string",
          "description": "支付模式（字典：payment_mode）"
        },
        "paymentModeLabel": {
          "type": "string",
          "description": "支付模式中文标签（DEPOSIT=定金+尾款, FULL=全款）"
        },
        "pendingUpgradeAmount": {
          "type": "number",
          "description": "待确认差价总额（配房/配车升级未确认的差价）"
        },
        "processStatus": {
          "type": "string",
          "description": "内部流程状态（字典：order_process_status）"
        },
        "processStatusLabel": {
          "type": "string",
          "description": "内部流程状态标签（字典：order_process_status 翻译）"
        },
        "productCoverUrl": {
          "type": "string",
          "description": "产品封面图URL"
        },
        "productId": {
          "type": "integer",
          "format": "int64",
          "description": "产品ID"
        },
        "productName": {
          "type": "string",
          "description": "产品名称"
        },
        "productSnapshot": {
          "type": "string",
          "description": "产品快照JSON"
        },
        "productType": {
          "type": "string",
          "description": "产品类型（字典：product_type）"
        },
        "productTypeLabel": {
          "type": "string",
          "description": "产品类型中文标签（CORE=核心产品, CUSTOM=私人定制, GROUP=小蒙马, ROUTE=路书产品）"
        },
        "readyAt": {
          "type": "string",
          "format": "date-time",
          "description": "就绪时间"
        },
        "refundAmount": {
          "type": "number",
          "description": "退款金额（实退金额）"
        },
        "refundPolicy": {
          "description": "退款政策（含政策名称和退款规则列表）",
          "$ref": "#/definitions/退款政策VO",
          "originalRef": "退款政策VO"
        },
        "remark": {
          "type": "string",
          "description": "备注"
        },
        "returnDate": {
          "type": "string",
          "format": "date",
          "description": "返程日期（出发日期 + 行程天数 - 1）"
        },
        "reviewed": {
          "type": "boolean",
          "description": "是否已评价"
        },
        "roomInfo": {
          "type": "string",
          "description": "房间信息"
        },
        "sharerOpenid": {
          "type": "string",
          "description": "分享人微信openid"
        },
        "status": {
          "type": "string",
          "description": "订单状态（字典：order_status）"
        },
        "statusLabel": {
          "type": "string",
          "description": "订单状态标签（字典：order_status 翻译）"
        },
        "surchargeAmount": {
          "type": "number",
          "description": "费用增加总额"
        },
        "surcharges": {
          "type": "array",
          "description": "费用增加项列表",
          "items": {
            "$ref": "#/definitions/OrderSurcharge",
            "originalRef": "OrderSurcharge"
          }
        },
        "timeline": {
          "type": "array",
          "description": "时间线列表",
          "items": {
            "$ref": "#/definitions/OrderTimeline",
            "originalRef": "OrderTimeline"
          }
        },
        "todos": {
          "type": "array",
          "description": "待办列表",
          "items": {
            "$ref": "#/definitions/OrderTodo",
            "originalRef": "OrderTodo"
          }
        },
        "totalCost": {
          "type": "number",
          "description": "总成本（仅管理员可见）"
        },
        "totalPrice": {
          "type": "number",
          "description": "总售价"
        },
        "transportSegments": {
          "type": "array",
          "description": "交通信息列表（航班/车次，含transportType/transportNo/departStation/arriveStation/departTime/arriveTime等）",
          "items": {
            "$ref": "#/definitions/OrderTransportSegment",
            "originalRef": "OrderTransportSegment"
          }
        },
        "travelers": {
          "type": "array",
          "description": "出行人列表",
          "items": {
            "$ref": "#/definitions/OrderTraveler",
            "originalRef": "OrderTraveler"
          }
        },
        "tripDays": {
          "type": "integer",
          "format": "int32",
          "description": "行程天数"
        },
        "tripNights": {
          "type": "integer",
          "format": "int32",
          "description": "行程晚数"
        },
        "unlockRequestedAt": {
          "type": "string",
          "format": "date-time",
          "description": "解锁请求时间"
        },
        "userId": {
          "type": "integer",
          "format": "int64",
          "description": "用户ID"
        },
        "vehicleInfo": {
          "type": "string",
          "description": "车辆信息"
        },
        "youngChildCount": {
          "type": "integer",
          "format": "int32",
          "description": "小童数"
        }
      },
      "title": "订单详情VO"
    },
    "记录尾款请求": {
      "type": "object",
      "properties": {
        "proofUrl": {
          "type": "string",
          "description": "支付凭证URL"
        },
        "remark": {
          "type": "string",
          "description": "备注"
        }
      },
      "title": "记录尾款请求"
    },
    "费用增加项请求": {
      "type": "object",
      "required": [
        "surchargeAmount",
        "surchargeName"
      ],
      "properties": {
        "surchargeAmount": {
          "type": "number",
          "example": 200.0,
          "description": "费用增加金额"
        },
        "surchargeName": {
          "type": "string",
          "example": "升级房型补差价",
          "description": "费用增加项名称"
        }
      },
      "title": "费用增加项请求"
    },
    "跳过行程节点请求": {
      "type": "object",
      "required": [
        "dayNumber",
        "nodeId",
        "reason"
      ],
      "properties": {
        "balanceAdjustment": {
          "type": "number",
          "example": -120.0,
          "description": "尾款调整金额（正数=增加尾款，负数=减少尾款）"
        },
        "dayNumber": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "行程天数编号"
        },
        "nodeId": {
          "type": "string",
          "description": "节点ID"
        },
        "nodeName": {
          "type": "string",
          "example": "蒙古族小型冰雪那达慕",
          "description": "节点名称"
        },
        "reason": {
          "type": "string",
          "example": "客户不想去该景点",
          "description": "修改原因"
        }
      },
      "title": "跳过行程节点请求"
    },
    "车型变更请求": {
      "type": "object",
      "required": [
        "newVehicleId",
        "originalVehicleId",
        "reason"
      ],
      "properties": {
        "balanceAdjustment": {
          "type": "number",
          "example": 300.0,
          "description": "尾款调整金额（可选，覆盖系统建议差价；正数=增加尾款，负数=减少尾款）"
        },
        "changeReasonCode": {
          "type": "string",
          "description": "变更原因代码（字典项 order_change_reason）"
        },
        "newVehicleId": {
          "type": "integer",
          "format": "int64",
          "description": "新车辆ID"
        },
        "originalVehicleId": {
          "type": "integer",
          "format": "int64",
          "description": "原车辆ID"
        },
        "reason": {
          "type": "string",
          "example": "原车辆已被预订",
          "description": "变更原因"
        }
      },
      "title": "车型变更请求"
    },
    "车辆信息请求": {
      "type": "object",
      "required": [
        "vehicleInfo"
      ],
      "properties": {
        "vehicleInfo": {
          "type": "string",
          "example": "7座商务车1辆，司机张师傅",
          "description": "车辆信息"
        }
      },
      "title": "车辆信息请求"
    },
    "车辆分配请求": {
      "type": "object",
      "required": [
        "vehicleModel"
      ],
      "properties": {
        "driverName": {
          "type": "string",
          "description": "司机姓名"
        },
        "driverPhone": {
          "type": "string",
          "description": "司机电话"
        },
        "plateNumber": {
          "type": "string",
          "description": "车牌号"
        },
        "vehicleBrand": {
          "type": "string",
          "description": "品牌（选填，不传则从车型名称中提取）"
        },
        "vehicleModel": {
          "type": "string",
          "description": "车型"
        }
      },
      "title": "车辆分配请求"
    },
    "退款政策VO": {
      "type": "object",
      "properties": {
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "createdBy": {
          "type": "integer",
          "format": "int64",
          "description": "创建人ID"
        },
        "enabled": {
          "type": "boolean",
          "description": "是否启用"
        },
        "policyId": {
          "type": "integer",
          "format": "int64",
          "description": "政策ID"
        },
        "policyName": {
          "type": "string",
          "description": "政策名称"
        },
        "remark": {
          "type": "string",
          "description": "备注"
        },
        "rules": {
          "type": "array",
          "description": "退款规则列表",
          "items": {
            "$ref": "#/definitions/退款规则VO",
            "originalRef": "退款规则VO"
          }
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "退款政策VO"
    },
    "退款规则VO": {
      "type": "object",
      "properties": {
        "minDays": {
          "type": "integer",
          "format": "int32",
          "description": "距出发最少天数"
        },
        "refundRatio": {
          "type": "integer",
          "format": "int32",
          "description": "退款比例（百分比）"
        },
        "ruleId": {
          "type": "integer",
          "format": "int64",
          "description": "规则ID"
        }
      },
      "title": "退款规则VO"
    },
    "配房升级差价预览": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "description": "描述"
        },
        "details": {
          "type": "array",
          "description": "各天差价明细",
          "items": {
            "$ref": "#/definitions/单天升级差价明细",
            "originalRef": "单天升级差价明细"
          }
        },
        "direction": {
          "type": "string",
          "description": "差价方向：UPGRADE=升级加价, DOWNGRADE=降级减价, SAME=价格不变, MIXED=部分升级部分降级"
        },
        "totalDiff": {
          "type": "number",
          "description": "差价合计（正数=需补款，负数=可退款）"
        }
      },
      "title": "配房升级差价预览"
    },
    "酒店分配详情（按家庭分组）": {
      "type": "object",
      "properties": {
        "days": {
          "type": "array",
          "description": "每天的住宿分配列表",
          "items": {
            "$ref": "#/definitions/单天住宿分配",
            "originalRef": "单天住宿分配"
          }
        },
        "familyIndex": {
          "type": "integer",
          "format": "int32",
          "description": "家庭序号（从1开始）"
        },
        "familyLabel": {
          "type": "string",
          "description": "家庭标签（如：家庭1、家庭2）"
        }
      },
      "title": "酒店分配详情（按家庭分组）"
    },
    "酒店分配请求": {
      "type": "object",
      "required": [
        "assignments"
      ],
      "properties": {
        "assignments": {
          "type": "array",
          "description": "酒店分配列表（按天粒度，每天每个家庭一条记录）",
          "items": {
            "$ref": "#/definitions/单天单家庭酒店分配",
            "originalRef": "单天单家庭酒店分配"
          }
        }
      },
      "title": "酒店分配请求"
    },
    "修改退款原因请求": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string",
          "example": "用户原因",
          "description": "分类"
        },
        "reasonText": {
          "type": "string",
          "example": "行程有变",
          "description": "退款原因文本"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "排序号"
        }
      },
      "title": "修改退款原因请求"
    },
    "分页结果«退款申请VO»": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "当前页码"
        },
        "pageSize": {
          "type": "integer",
          "format": "int32",
          "example": 20,
          "description": "每页条数"
        },
        "records": {
          "type": "array",
          "description": "数据列表",
          "items": {
            "$ref": "#/definitions/退款申请VO",
            "originalRef": "退款申请VO"
          }
        },
        "total": {
          "type": "integer",
          "format": "int32",
          "example": 100,
          "description": "总记录数"
        }
      },
      "title": "分页结果«退款申请VO»"
    },
    "创建退款原因请求": {
      "type": "object",
      "required": [
        "reasonText"
      ],
      "properties": {
        "category": {
          "type": "string",
          "example": "用户原因",
          "description": "分类"
        },
        "reasonText": {
          "type": "string",
          "example": "行程有变",
          "description": "退款原因文本"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "排序号"
        }
      },
      "title": "创建退款原因请求"
    },
    "申诉退款执行请求": {
      "type": "object",
      "required": [
        "actualAmount"
      ],
      "properties": {
        "actualAmount": {
          "type": "number",
          "example": 1500.0,
          "description": "实际退款金额"
        },
        "remark": {
          "type": "string",
          "example": "申诉通过，按协商金额退款",
          "description": "备注"
        }
      },
      "title": "申诉退款执行请求"
    },
    "管理员退款审批请求": {
      "type": "object",
      "required": [
        "action"
      ],
      "properties": {
        "action": {
          "type": "string",
          "example": "APPROVE",
          "description": "审批结果：APPROVE=通过（自动调起微信退款）、REJECT=拒绝（用户可发起申诉）"
        },
        "actualAmount": {
          "type": "number",
          "example": 1500.0,
          "description": "实际退款金额（审批通过时可调整，不传则使用申请金额）。不能超过订单已付金额"
        },
        "remark": {
          "type": "string",
          "example": "同意全额退款",
          "description": "审批备注"
        }
      },
      "title": "管理员退款审批请求"
    },
    "统一响应结果«List«退款原因VO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/退款原因VO",
            "originalRef": "退款原因VO"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«退款原因VO»»"
    },
    "统一响应结果«List«退款政策VO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "array",
          "description": "响应数据",
          "items": {
            "$ref": "#/definitions/退款政策VO",
            "originalRef": "退款政策VO"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«List«退款政策VO»»"
    },
    "统一响应结果«分页结果«退款申请VO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/分页结果«退款申请VO»",
          "originalRef": "分页结果«退款申请VO»"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«分页结果«退款申请VO»»"
    },
    "统一响应结果«退款原因VO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/退款原因VO",
          "originalRef": "退款原因VO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«退款原因VO»"
    },
    "统一响应结果«退款政策VO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/退款政策VO",
          "originalRef": "退款政策VO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«退款政策VO»"
    },
    "统一响应结果«退款申请VO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/退款申请VO",
          "originalRef": "退款申请VO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«退款申请VO»"
    },
    "退款原因VO": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string",
          "description": "原因分类"
        },
        "enabled": {
          "type": "boolean",
          "description": "是否启用"
        },
        "reasonId": {
          "type": "integer",
          "format": "int64",
          "description": "原因ID"
        },
        "reasonText": {
          "type": "string",
          "description": "原因描述"
        },
        "sortOrder": {
          "type": "integer",
          "format": "int32",
          "description": "排序序号"
        }
      },
      "title": "退款原因VO"
    },
    "退款政策请求": {
      "type": "object",
      "required": [
        "policyName",
        "rules"
      ],
      "properties": {
        "policyName": {
          "type": "string",
          "example": "国内游退款政策",
          "description": "政策名称"
        },
        "remark": {
          "type": "string",
          "example": "适用于所有国内游产品",
          "description": "备注"
        },
        "rules": {
          "type": "array",
          "description": "退款规则列表",
          "items": {
            "$ref": "#/definitions/退款规则项",
            "originalRef": "退款规则项"
          }
        }
      },
      "title": "退款政策请求"
    },
    "退款申请VO": {
      "type": "object",
      "properties": {
        "actualAmount": {
          "type": "number",
          "description": "实际退款金额"
        },
        "appealAmount": {
          "type": "number",
          "description": "申诉退款金额"
        },
        "appealReason": {
          "type": "string",
          "description": "申诉原因"
        },
        "appealStatus": {
          "type": "integer",
          "format": "int32",
          "description": "申诉状态: 1-处理中 2-通过 3-驳回"
        },
        "appealStatusLabel": {
          "type": "string",
          "description": "申诉状态标签"
        },
        "appealedAt": {
          "type": "string",
          "format": "date-time",
          "description": "申诉时间"
        },
        "applicantId": {
          "type": "integer",
          "format": "int64",
          "description": "申请人ID"
        },
        "applicantName": {
          "type": "string",
          "description": "申请人姓名"
        },
        "applicantType": {
          "type": "string",
          "description": "申请人类型（USER/ADMIN）"
        },
        "applicationId": {
          "type": "integer",
          "format": "int64",
          "description": "申请ID"
        },
        "approvalNo": {
          "type": "string",
          "description": "审批编号"
        },
        "calculatedAmount": {
          "type": "number",
          "description": "计算退款金额"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "daysBeforeDept": {
          "type": "integer",
          "format": "int32",
          "description": "距出发天数"
        },
        "departureDate": {
          "type": "string",
          "format": "date",
          "description": "出发日期"
        },
        "orderId": {
          "type": "integer",
          "format": "int64",
          "description": "订单ID"
        },
        "orderNo": {
          "type": "string",
          "description": "订单号"
        },
        "paidAmount": {
          "type": "number",
          "description": "已付金额"
        },
        "policyId": {
          "type": "integer",
          "format": "int64",
          "description": "退款政策ID"
        },
        "policyName": {
          "type": "string",
          "description": "退款政策名称"
        },
        "productName": {
          "type": "string",
          "description": "产品名称"
        },
        "reasonDetail": {
          "type": "string",
          "description": "补充说明"
        },
        "reasonId": {
          "type": "integer",
          "format": "int64",
          "description": "退款原因ID"
        },
        "reasonText": {
          "type": "string",
          "description": "退款原因"
        },
        "refundRatio": {
          "type": "integer",
          "format": "int32",
          "description": "退款比例（百分比）"
        },
        "refundType": {
          "type": "string",
          "description": "退款类型（字典：refund_type）"
        },
        "refundTypeLabel": {
          "type": "string",
          "description": "退款类型标签（字典：refund_type 翻译）"
        },
        "refundedAt": {
          "type": "string",
          "format": "date-time",
          "description": "退款完成时间"
        },
        "reviewAdminId": {
          "type": "integer",
          "format": "int64",
          "description": "审批管理员ID"
        },
        "reviewAdminName": {
          "type": "string",
          "description": "审批管理员姓名"
        },
        "reviewRemark": {
          "type": "string",
          "description": "审批备注"
        },
        "reviewedAt": {
          "type": "string",
          "format": "date-time",
          "description": "审批时间"
        },
        "status": {
          "type": "string",
          "description": "退款状态（字典：refund_status）"
        },
        "statusLabel": {
          "type": "string",
          "description": "退款状态标签（字典：refund_status 翻译）"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        }
      },
      "title": "退款申请VO"
    },
    "退款规则项": {
      "type": "object",
      "required": [
        "minDays",
        "refundRatio"
      ],
      "properties": {
        "minDays": {
          "type": "integer",
          "format": "int32",
          "example": 7,
          "description": "距出发最少天数（含当天）。例如：minDays=7表示出发前7天及以上适用此规则"
        },
        "refundRatio": {
          "type": "integer",
          "format": "int32",
          "example": 80,
          "description": "退款比例（百分比，0-100）。例如：80表示退已付金额的80%"
        }
      },
      "title": "退款规则项"
    },
    "Map«string,string»": {
      "type": "object",
      "title": "Map«string,string»",
      "additionalProperties": {
        "type": "string"
      }
    },
    "分页结果«发票VO»": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "当前页码"
        },
        "pageSize": {
          "type": "integer",
          "format": "int32",
          "example": 20,
          "description": "每页条数"
        },
        "records": {
          "type": "array",
          "description": "数据列表",
          "items": {
            "$ref": "#/definitions/发票VO",
            "originalRef": "发票VO"
          }
        },
        "total": {
          "type": "integer",
          "format": "int32",
          "example": 100,
          "description": "总记录数"
        }
      },
      "title": "分页结果«发票VO»"
    },
    "发票VO": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "string",
          "description": "金额"
        },
        "bankAccount": {
          "type": "string",
          "description": "银行账号（企业发票）"
        },
        "bankName": {
          "type": "string",
          "description": "开户行（企业发票）"
        },
        "companyAddress": {
          "type": "string",
          "description": "企业地址（企业发票）"
        },
        "companyPhone": {
          "type": "string",
          "description": "企业电话（企业发票）"
        },
        "contactPhone": {
          "type": "string",
          "description": "联系电话"
        },
        "createdAt": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "email": {
          "type": "string",
          "description": "接收邮箱"
        },
        "failReason": {
          "type": "string",
          "description": "失败原因"
        },
        "fileUrl": {
          "type": "string",
          "description": "发票文件URL"
        },
        "id": {
          "type": "string",
          "description": "发票ID"
        },
        "invoiceContent": {
          "type": "string",
          "description": "发票内容"
        },
        "invoiceNo": {
          "type": "string",
          "description": "发票号码"
        },
        "invoiceTitle": {
          "type": "string",
          "description": "发票抬头"
        },
        "invoiceType": {
          "type": "string",
          "description": "发票类型"
        },
        "issuedAt": {
          "type": "string",
          "format": "date-time",
          "description": "开票时间"
        },
        "issuedBy": {
          "type": "string",
          "description": "开票操作人ID"
        },
        "orderId": {
          "type": "string",
          "description": "订单ID"
        },
        "orderNo": {
          "type": "string",
          "description": "订单号"
        },
        "originalInvoiceId": {
          "type": "string",
          "description": "原发票ID(换开时关联)"
        },
        "reissueCount": {
          "type": "integer",
          "format": "int32",
          "description": "换开次数"
        },
        "remark": {
          "type": "string",
          "description": "备注信息"
        },
        "status": {
          "type": "string",
          "description": "发票状态"
        },
        "taxNumber": {
          "type": "string",
          "description": "税号"
        },
        "titleType": {
          "type": "string",
          "description": "抬头类型（personal=个人/company=企业）"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        },
        "userId": {
          "type": "string",
          "description": "用户ID"
        }
      },
      "title": "发票VO"
    },
    "管理员开票失败请求": {
      "type": "object",
      "required": [
        "failReason"
      ],
      "properties": {
        "failReason": {
          "type": "string",
          "example": "发票信息有误，请核实后重新申请",
          "description": "失败原因"
        }
      },
      "title": "管理员开票失败请求"
    },
    "管理员开票请求": {
      "type": "object",
      "required": [
        "fileUrl",
        "invoiceNo"
      ],
      "properties": {
        "fileUrl": {
          "type": "string",
          "example": "https://oss.example.com/invoice/xxx.pdf",
          "description": "发票文件URL"
        },
        "invoiceNo": {
          "type": "string",
          "example": "012345678901",
          "description": "发票号码"
        }
      },
      "title": "管理员开票请求"
    },
    "统一响应结果«Map«string,string»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "type": "object",
          "description": "响应数据",
          "additionalProperties": {
            "type": "string"
          }
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«Map«string,string»»"
    },
    "统一响应结果«分页结果«发票VO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/分页结果«发票VO»",
          "originalRef": "分页结果«发票VO»"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«分页结果«发票VO»»"
    },
    "统一响应结果«发票VO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/发票VO",
          "originalRef": "发票VO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«发票VO»"
    },
    "分页结果«定制请求列表VO»": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer",
          "format": "int32",
          "example": 1,
          "description": "当前页码"
        },
        "pageSize": {
          "type": "integer",
          "format": "int32",
          "example": 20,
          "description": "每页条数"
        },
        "records": {
          "type": "array",
          "description": "数据列表",
          "items": {
            "$ref": "#/definitions/定制请求列表VO",
            "originalRef": "定制请求列表VO"
          }
        },
        "total": {
          "type": "integer",
          "format": "int32",
          "example": 100,
          "description": "总记录数"
        }
      },
      "title": "分页结果«定制请求列表VO»"
    },
    "定制师回复/报价请求": {
      "type": "object",
      "required": [
        "reply"
      ],
      "properties": {
        "productId": {
          "type": "integer",
          "format": "int64",
          "example": 1234567890,
          "description": "关联产品ID（定制产品已创建时传入）"
        },
        "reply": {
          "type": "string",
          "example": "已为您设计3天2晚大理深度游方案",
          "description": "回复内容"
        }
      },
      "title": "定制师回复/报价请求"
    },
    "定制请求列表VO": {
      "type": "object",
      "properties": {
        "adultCount": {
          "type": "integer",
          "format": "int32",
          "description": "成人数"
        },
        "budget": {
          "type": "string",
          "description": "预算范围（字典：customize_budget）"
        },
        "childCount": {
          "type": "integer",
          "format": "int32",
          "description": "儿童数"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "days": {
          "type": "integer",
          "format": "int32",
          "description": "期望天数"
        },
        "designerAvatar": {
          "type": "string",
          "description": "定制师头像"
        },
        "designerName": {
          "type": "string",
          "description": "定制师姓名"
        },
        "destination": {
          "type": "string",
          "description": "目标地区"
        },
        "requestId": {
          "type": "integer",
          "format": "int64",
          "description": "请求ID"
        },
        "requestType": {
          "type": "string",
          "description": "需求类型（字典：customize_request_type）"
        },
        "startDate": {
          "type": "string",
          "format": "date",
          "description": "期望出发日期"
        },
        "status": {
          "type": "string",
          "description": "状态（字典：customize_request_status）"
        },
        "statusLabel": {
          "type": "string",
          "description": "状态标签"
        },
        "travelPurpose": {
          "type": "string",
          "description": "旅游目的（字典：travel_purpose）"
        },
        "userId": {
          "type": "integer",
          "format": "int64",
          "description": "用户ID"
        }
      },
      "title": "定制请求列表VO"
    },
    "定制请求详情VO": {
      "type": "object",
      "properties": {
        "adultCount": {
          "type": "integer",
          "format": "int32",
          "description": "成人数"
        },
        "budget": {
          "type": "string",
          "description": "预算范围（字典：customize_budget）"
        },
        "childCount": {
          "type": "integer",
          "format": "int32",
          "description": "儿童数"
        },
        "contactName": {
          "type": "string",
          "description": "联系人"
        },
        "contactPhone": {
          "type": "string",
          "description": "联系电话"
        },
        "createTime": {
          "type": "string",
          "format": "date-time",
          "description": "创建时间"
        },
        "days": {
          "type": "integer",
          "format": "int32",
          "description": "期望天数"
        },
        "designerAvatar": {
          "type": "string",
          "description": "定制师头像"
        },
        "designerId": {
          "type": "integer",
          "format": "int64",
          "description": "指定定制师ID"
        },
        "designerName": {
          "type": "string",
          "description": "定制师姓名"
        },
        "destination": {
          "type": "string",
          "description": "目标地区"
        },
        "endDate": {
          "type": "string",
          "format": "date",
          "description": "期望结束日期"
        },
        "productId": {
          "type": "integer",
          "format": "int64",
          "description": "关联产品ID"
        },
        "repliedAt": {
          "type": "string",
          "format": "date-time",
          "description": "回复时间"
        },
        "reply": {
          "type": "string",
          "description": "定制师回复"
        },
        "requestId": {
          "type": "integer",
          "format": "int64",
          "description": "请求ID"
        },
        "requestType": {
          "type": "string",
          "description": "需求类型（字典：customize_request_type）"
        },
        "requirements": {
          "type": "string",
          "description": "详细需求描述"
        },
        "startDate": {
          "type": "string",
          "format": "date",
          "description": "期望出发日期"
        },
        "status": {
          "type": "string",
          "description": "状态（字典：customize_request_status）"
        },
        "statusLabel": {
          "type": "string",
          "description": "状态标签"
        },
        "travelPurpose": {
          "type": "string",
          "description": "旅游目的（字典：travel_purpose）"
        },
        "updateTime": {
          "type": "string",
          "format": "date-time",
          "description": "更新时间"
        },
        "userId": {
          "type": "integer",
          "format": "int64",
          "description": "用户ID"
        }
      },
      "title": "定制请求详情VO"
    },
    "统一响应结果«分页结果«定制请求列表VO»»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/分页结果«定制请求列表VO»",
          "originalRef": "分页结果«定制请求列表VO»"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«分页结果«定制请求列表VO»»"
    },
    "统一响应结果«定制请求详情VO»": {
      "type": "object",
      "properties": {
        "code": {
          "type": "integer",
          "format": "int32",
          "example": 200,
          "description": "状态码"
        },
        "data": {
          "description": "响应数据",
          "$ref": "#/definitions/定制请求详情VO",
          "originalRef": "定制请求详情VO"
        },
        "message": {
          "type": "string",
          "example": "成功",
          "description": "响应消息"
        }
      },
      "title": "统一响应结果«定制请求详情VO»"
    }
  }
}