{ "swagger": "2.0", "info": { "title": "资源服务", "version": "1.0.0" }, "basePath": "/", "paths": { "/admin/scenic/spot": { "post": { "tags": [ "景区管理" ], "summary": "创建景区", "description": "新建一个景区资源，初始状态为下架(status=0)。创建后需通过「提交启用审批」接口走企微OA审批流程才能上架。支持富文本字段（featureIntro/detailContent等），素材ID从素材库获取。\n\n**关联字典**：\n- scenic_facility：景区设施（表单多选）\n- scenic_honor：景区荣誉（表单多选）", "operationId": "createSpotUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "景区创建请求", "required": false, "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/scenic/spot/{scenicId}": { "get": { "tags": [ "景区管理" ], "summary": "景区详情", "description": "获取景区完整信息，包含富文本内容、素材URL、标签列表、季节内容等。素材ID会自动解析为OSS访问地址。\n\n**关联字典**：\n- scenic_facility：景区设施（详情显示）\n- scenic_honor：景区荣誉（详情显示）", "operationId": "getSpotUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "scenicId", "in": "path", "description": "景区ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«景区详情»", "originalRef": "统一响应结果«景区详情»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«景区详情»", "originalRef": "统一响应结果«景区详情»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "景区管理" ], "summary": "更新景区", "description": "更新景区基本信息和富文本内容。更新不会改变当前状态。如果景区已上架，修改后仍保持上架状态，无需重新审批。\n\n**关联字典**：\n- scenic_facility：景区设施（表单多选）\n- scenic_honor：景区荣誉（表单多选）", "operationId": "updateSpotUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "景区更新请求", "required": false, "schema": { "$ref": "#/definitions/景区更新请求", "originalRef": "景区更新请求" } }, { "name": "scenicId", "in": "path", "description": "景区ID", "required": false, "type": "integer", "format": "int64" } ], "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" }, "delete": { "tags": [ "景区管理" ], "summary": "删除景区", "description": "软删除景区（设置deleted_at）。仅SUPER_ADMIN角色或创建者本人可删除。已上架的景区需先下架再删除。删除后会同时清理关联的素材引用。", "operationId": "deleteSpotUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "scenicId", "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/scenic/spot/{scenicId}/prices": { "get": { "tags": [ "景区价格日历" ], "summary": "查询价格日历", "description": "按月查询景区的每日价格和可售状态。返回指定年月中所有已设置价格的日期，未设置的日期不返回。用于前端日历组件渲染。", "operationId": "getPriceCalendarUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "month", "in": "query", "description": "月份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false }, { "name": "scenicId", "in": "path", "description": "景区ID", "required": false, "type": "integer", "format": "int64" }, { "name": "year", "in": "query", "description": "年份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«价格日历月视图»", "originalRef": "统一响应结果«价格日历月视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«价格日历月视图»", "originalRef": "统一响应结果«价格日历月视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "景区价格日历" ], "summary": "批量设置价格", "description": "在指定日期范围内批量设置成本价、库存和可售状态。支持weekdayOnly/weekendOnly/selectedWeekdays过滤特定星期，支持excludeDates排除特定日期。已有价格的日期会被覆盖更新。", "operationId": "batchSetPricesUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历设置请求", "required": false, "schema": { "$ref": "#/definitions/价格日历批量设置请求", "originalRef": "价格日历批量设置请求" } }, { "name": "scenicId", "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": "删除指定日期范围内的所有价格记录。删除后该日期范围将显示为未设置状态。日期格式：yyyy-MM-dd。", "operationId": "deletePricesUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "endDate", "in": "query", "description": "结束日期", "required": false, "type": "string", "allowEmptyValue": false }, { "name": "scenicId", "in": "path", "description": "景区ID", "required": false, "type": "integer", "format": "int64" }, { "name": "startDate", "in": "query", "description": "开始日期", "required": false, "type": "string", "allowEmptyValue": false } ], "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/scenic/spot/{scenicId}/prices/status": { "put": { "tags": [ "景区价格日历" ], "summary": "批量修改可售状态", "description": "批量修改指定日期范围内的可售状态，不影响价格和库存。status=0不可售，status=1可售。用于临时关闭/开放某些日期的售卖。", "operationId": "batchUpdateStatusUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历状态请求", "required": false, "schema": { "$ref": "#/definitions/价格日历状态变更请求", "originalRef": "价格日历状态变更请求" } }, { "name": "scenicId", "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/scenic/spot/{scenicId}/season/{seasonType}": { "put": { "tags": [ "景区季节内容" ], "summary": "保存/更新季节内容", "description": "创建或更新指定景区的季节内容。seasonType为季节标识（如spring/summer/autumn/winter）。如果该季节已存在则更新，不存在则创建。支持设置季节别名（如「樱花季」）、月份范围、独立封面和轮播图。", "operationId": "saveSeasonUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "季节内容保存请求", "required": false, "schema": { "$ref": "#/definitions/景区季节保存请求", "originalRef": "景区季节保存请求" } }, { "name": "scenicId", "in": "path", "description": "景区ID", "required": false, "type": "integer", "format": "int64" }, { "name": "seasonType", "in": "path", "description": "季节类型", "required": false, "type": "string" } ], "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" }, "delete": { "tags": [ "景区季节内容" ], "summary": "删除季节内容", "description": "删除指定景区的某个季节内容，同时清理关联的素材引用。", "operationId": "deleteSeasonUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "scenicId", "in": "path", "description": "景区ID", "required": false, "type": "integer", "format": "int64" }, { "name": "seasonType", "in": "path", "description": "季节类型", "required": false, "type": "string" } ], "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/scenic/spot/{scenicId}/seasons": { "get": { "tags": [ "景区季节内容" ], "summary": "获取景区全部季节内容", "description": "返回景区的所有季节内容列表（春/夏/秋/冬）。季节内容是景区独有功能，其他资源类型没有此概念。每个季节可设置独立的封面、轮播图、亮点描述和游玩攻略。", "operationId": "getSeasonsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "scenicId", "in": "path", "description": "景区ID", "required": false, "type": "integer", "format": "int64" } ], "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/scenic/spot/{scenicId}/status": { "put": { "tags": [ "景区管理" ], "summary": "上下架切换", "description": "直接修改景区状态（跳过审批流程），仅限SUPER_ADMIN使用。普通管理员应使用「提交启用/禁用审批」接口。状态值：0=下架，1=上架。", "operationId": "updateStatusUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "景区状态请求", "required": false, "schema": { "$ref": "#/definitions/景区状态变更请求", "originalRef": "景区状态变更请求" } }, { "name": "scenicId", "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/scenic/spot/{scenicId}/submit-approval": { "post": { "tags": [ "景区管理" ], "summary": "提交启用/禁用审批", "description": "向企微OA提交审批申请。targetStatus=1表示申请上架，targetStatus=2表示申请下架。提交后景区进入PENDING_APPROVAL状态，企微审批通过/拒绝后通过回调自动更新状态。返回企微审批单号spNo。同一景区不可重复提交未完成的审批。", "operationId": "submitApprovalUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "审批提交请求", "required": false, "schema": { "$ref": "#/definitions/审批提交请求", "originalRef": "审批提交请求" } }, { "name": "scenicId", "in": "path", "description": "景区ID", "required": false, "type": "integer", "format": "int64" } ], "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/scenic/spot/{scenicId}/tags": { "put": { "tags": [ "景区标签管理" ], "summary": "更新景区标签", "description": "全量替换指定景区的标签列表。传入tagIds为该景区最终要关联的标签ID列表，为空则清除所有标签。", "operationId": "updateScenicTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "景区标签更新请求", "required": false, "schema": { "$ref": "#/definitions/景区标签更新请求", "originalRef": "景区标签更新请求" } }, { "name": "scenicId", "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/scenic/spots": { "get": { "tags": [ "景区管理" ], "summary": "景区列表", "description": "分页查询景区列表，支持按名称关键词、状态(0下架/1上架)、城市等条件筛选。返回列表摘要信息（不含富文本详情），按sortOrder倒序+创建时间倒序排列。\n\n**关联字典**：\n- scenic_facility：景区设施（列表显示）\n- scenic_honor：景区荣誉（列表显示）", "operationId": "listSpotsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "city", "in": "query", "description": "城市筛选（行政区划）", "required": false, "type": "string", "x-example": "杭州市" }, { "name": "cityKeyword", "in": "query", "description": "城市/区域关键词模糊搜索（匹配城市名、省份、地址）", "required": false, "type": "string", "x-example": "海拉尔" }, { "name": "cityName", "in": "query", "description": "城市名称筛选（展示用）", "required": false, "type": "string", "x-example": "杭州" }, { "name": "facility", "in": "query", "description": "设施编码筛选", "required": false, "type": "string", "x-example": "parking" }, { "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": "province", "in": "query", "description": "省份筛选", "required": false, "type": "string", "x-example": "浙江省" }, { "name": "sortBy", "in": "query", "description": "排序字段：name/rating/viewCount/sortOrder/createdAt", "required": false, "type": "string", "x-example": "sortOrder" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc/desc", "required": false, "type": "string", "x-example": "desc" }, { "name": "status", "in": "query", "description": "状态筛选：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "tagId", "in": "query", "description": "标签ID筛选（单个）", "required": false, "type": "integer", "format": "int64" }, { "name": "tagIds", "in": "query", "description": "标签ID筛选（多个，逗号分隔）", "required": false, "type": "string", "x-example": "1,2,3" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«景区列表项»»", "originalRef": "统一响应结果«分页结果«景区列表项»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«景区列表项»»", "originalRef": "统一响应结果«分页结果«景区列表项»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/scenic/spots/batch": { "delete": { "tags": [ "景区管理" ], "summary": "批量删除", "description": "批量软删除多个景区。权限校验同单个删除：仅SUPER_ADMIN或创建者可操作。部分失败不影响其他景区的删除。", "operationId": "batchDeleteUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "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/scenic/spots/batch/status": { "put": { "tags": [ "景区管理" ], "summary": "批量上下架", "description": "批量修改多个景区的状态。scenicIds为景区ID列表（字符串格式），status为目标状态。跳过审批流程，适用于批量管理场景。", "operationId": "batchUpdateStatusUsingPUT_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/scenic/spots/batch/tags": { "put": { "tags": [ "景区标签管理" ], "summary": "批量打标签", "description": "对多个景区批量添加或移除标签。addTagIds为要添加的标签，removeTagIds为要移除的标签，两者可同时使用。增量操作，不影响未指定的标签。", "operationId": "batchUpdateTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/scenic/tag": { "post": { "tags": [ "景区标签管理" ], "summary": "创建管理标签", "description": "创建预设标签，标签名不可重复。可指定颜色(tagColor)，默认为#409EFF。预设标签在标签管理页面展示和维护。", "operationId": "createTagUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签创建请求", "required": false, "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/scenic/tag/adhoc": { "post": { "tags": [ "景区标签管理" ], "summary": "解析自定义标签", "description": "输入标签名称，如果已存在则直接返回，不存在则自动创建。用于景区编辑时快速输入新标签，避免先到标签管理页面创建。", "operationId": "resolveAdHocTagUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签创建请求", "required": false, "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/scenic/tag/{tagId}": { "put": { "tags": [ "景区标签管理" ], "summary": "编辑标签", "description": "修改标签名称或颜色。修改后所有关联此标签的景区会自动生效。", "operationId": "updateTagUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签更新请求", "required": false, "schema": { "$ref": "#/definitions/标签更新请求", "originalRef": "标签更新请求" } }, { "name": "tagId", "in": "path", "description": "标签ID", "required": false, "type": "integer", "format": "int64" } ], "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" }, "delete": { "tags": [ "景区标签管理" ], "summary": "删除标签", "description": "删除标签并自动解除所有景区与该标签的关联关系。", "operationId": "deleteTagUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "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/scenic/tags": { "get": { "tags": [ "景区标签管理" ], "summary": "获取管理标签列表（分页）", "description": "分页查询景区标签库中的所有标签，支持按关键词搜索。标签分为预设标签（管理员创建）和自定义标签（adhoc接口创建），此接口返回全部类型。", "operationId": "listManagedTagsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "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 } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«景区标签»»", "originalRef": "统一响应结果«分页结果«景区标签»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«景区标签»»", "originalRef": "统一响应结果«分页结果«景区标签»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/scenic/tags/all": { "get": { "tags": [ "景区标签管理" ], "summary": "获取全部标签", "description": "不分页返回所有标签，用于景区编辑时的标签选择下拉列表。", "operationId": "listAllTagsUsingGET", "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/restaurant/item": { "post": { "tags": [ "餐厅管理" ], "summary": "创建餐厅", "description": "新建餐厅资源，初始状态为下架(status=0)。餐厅没有价格日历，费用通过产品报价中的费用项管理。需走企微审批流程上架。\n\n**关联字典**：\n- restaurant_category：餐厅分类（表单选择）\n- cuisine_type：菜系类型（表单多选）\n- environment_type：环境类型（表单多选）\n- restaurant_facility：餐厅设施（表单多选）\n\n**纯文本字段**：\n- cityName：城市名称（手动输入，如「拉萨」「海拉尔」，非字典）", "operationId": "createRestaurantUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "餐厅创建请求", "required": false, "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/restaurant/item/{restaurantId}": { "get": { "tags": [ "餐厅管理" ], "summary": "餐厅详情", "description": "获取餐厅完整信息，包含素材URL、标签、富文本介绍等。\n\n**关联字典**：\n- restaurant_category：餐厅分类（详情显示）\n- cuisine_type：菜系类型（详情显示）\n- environment_type：环境类型（详情显示）\n- restaurant_facility：餐厅设施（详情显示）", "operationId": "getRestaurantUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "restaurantId", "in": "path", "description": "餐厅ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«餐厅详情视图»", "originalRef": "统一响应结果«餐厅详情视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«餐厅详情视图»", "originalRef": "统一响应结果«餐厅详情视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "餐厅管理" ], "summary": "更新餐厅", "description": "更新餐厅基本信息，不改变当前状态。\n\n**关联字典**：\n- restaurant_category：餐厅分类（表单选择）\n- cuisine_type：菜系类型（表单多选）\n- environment_type：环境类型（表单多选）\n- restaurant_facility：餐厅设施（表单多选）\n\n**纯文本字段**：\n- cityName：城市名称（手动输入，非字典）", "operationId": "updateRestaurantUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "餐厅更新请求", "required": false, "schema": { "$ref": "#/definitions/餐厅更新请求", "originalRef": "餐厅更新请求" } }, { "name": "restaurantId", "in": "path", "description": "餐厅ID", "required": false, "type": "integer", "format": "int64" } ], "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" }, "delete": { "tags": [ "餐厅管理" ], "summary": "删除餐厅", "description": "软删除餐厅。仅SUPER_ADMIN或创建者可操作。", "operationId": "deleteRestaurantUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "restaurantId", "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/restaurant/item/{restaurantId}/status": { "put": { "tags": [ "餐厅管理" ], "summary": "上下架切换", "description": "直接修改状态（跳过审批），仅限SUPER_ADMIN。状态值：0=下架，1=上架。", "operationId": "updateStatusUsingPUT_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "餐厅状态请求", "required": false, "schema": { "$ref": "#/definitions/餐厅状态变更请求", "originalRef": "餐厅状态变更请求" } }, { "name": "restaurantId", "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/restaurant/item/{restaurantId}/submit-approval": { "post": { "tags": [ "餐厅管理" ], "summary": "提交启用/禁用审批", "description": "向企微OA提交审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。", "operationId": "submitApprovalUsingPOST_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "审批提交请求", "required": false, "schema": { "$ref": "#/definitions/餐厅审批提交请求", "originalRef": "餐厅审批提交请求" } }, { "name": "restaurantId", "in": "path", "description": "餐厅ID", "required": false, "type": "integer", "format": "int64" } ], "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/restaurant/item/{restaurantId}/tags": { "put": { "tags": [ "餐厅标签管理" ], "summary": "更新餐厅标签", "description": "全量替换指定餐厅的标签列表。传入tagIds为最终关联的标签ID列表，为空则清除所有标签。", "operationId": "updateRestaurantTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "餐厅标签更新请求", "required": false, "schema": { "$ref": "#/definitions/餐厅标签更新请求_1", "originalRef": "餐厅标签更新请求_1" } }, { "name": "restaurantId", "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/restaurant/items": { "get": { "tags": [ "餐厅管理" ], "summary": "餐厅列表", "description": "分页查询餐厅列表，支持按名称、状态、分类、城市等条件筛选。\n\n**关联字典**：\n- restaurant_category：餐厅分类（筛选+列表显示）\n- cuisine_type：菜系类型（列表显示）\n- environment_type：环境类型（列表显示）\n- restaurant_facility：餐厅设施（列表显示）", "operationId": "listRestaurantsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "categoryCode", "in": "query", "description": "分类编码", "required": false, "type": "string", "x-example": "TIBETAN" }, { "name": "city", "in": "query", "description": "城市", "required": false, "type": "string", "x-example": "拉萨市" }, { "name": "cityName", "in": "query", "description": "城市名称筛选（纯文本）", "required": false, "type": "string", "x-example": "拉萨" }, { "name": "cuisineType", "in": "query", "description": "菜系类型", "required": false, "type": "string", "x-example": "TIBETAN" }, { "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": "province", "in": "query", "description": "省份", "required": false, "type": "string", "x-example": "西藏自治区" }, { "name": "recommended", "in": "query", "description": "是否推荐：0=否 1=是", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "sortBy", "in": "query", "description": "排序字段", "required": false, "type": "string", "x-example": "createdAt" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc=升序 desc=降序", "required": false, "type": "string", "x-example": "desc" }, { "name": "status", "in": "query", "description": "状态：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "tagId", "in": "query", "description": "标签ID", "required": false, "type": "integer", "format": "int64", "x-example": 100 }, { "name": "tagIds", "in": "query", "description": "标签ID列表（逗号分隔）", "required": false, "type": "string", "x-example": "100,101,102" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«餐厅列表视图»»", "originalRef": "统一响应结果«分页结果«餐厅列表视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«餐厅列表视图»»", "originalRef": "统一响应结果«分页结果«餐厅列表视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/restaurant/items/batch": { "delete": { "tags": [ "餐厅管理" ], "summary": "批量删除", "description": "批量软删除多个餐厅。仅SUPER_ADMIN或创建者可操作。", "operationId": "batchDeleteUsingDELETE_1", "produces": [ "*/*" ], "parameters": [ { "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/restaurant/items/batch/status": { "put": { "tags": [ "餐厅管理" ], "summary": "批量上下架", "description": "批量修改多个餐厅的状态，跳过审批流程。", "operationId": "batchUpdateStatusUsingPUT_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/restaurant/items/batch/tags": { "put": { "tags": [ "餐厅标签管理" ], "summary": "批量打标签", "description": "对多个餐厅批量添加/移除标签。增量操作，不影响未指定的标签。", "operationId": "batchUpdateTagsUsingPUT_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/restaurant/tag": { "post": { "tags": [ "餐厅标签管理" ], "summary": "创建管理标签", "description": "创建预设标签，标签名不可重复。可指定颜色(tagColor)，默认#409EFF。", "operationId": "createTagUsingPOST_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签创建请求", "required": false, "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/restaurant/tag/adhoc": { "post": { "tags": [ "餐厅标签管理" ], "summary": "解析自定义标签", "description": "按名称查找或自动创建标签。用于餐厅编辑时快速输入新标签。", "operationId": "resolveAdHocTagUsingPOST_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签创建请求", "required": false, "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/restaurant/tag/{tagId}": { "put": { "tags": [ "餐厅标签管理" ], "summary": "编辑标签", "description": "修改标签名称或颜色，所有关联餐厅自动生效。", "operationId": "updateTagUsingPUT_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签更新请求", "required": false, "schema": { "$ref": "#/definitions/餐厅标签更新请求", "originalRef": "餐厅标签更新请求" } }, { "name": "tagId", "in": "path", "description": "标签ID", "required": false, "type": "integer", "format": "int64" } ], "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" }, "delete": { "tags": [ "餐厅标签管理" ], "summary": "删除标签", "description": "删除标签并解除所有餐厅与该标签的关联。", "operationId": "deleteTagUsingDELETE_1", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "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/restaurant/tags": { "get": { "tags": [ "餐厅标签管理" ], "summary": "获取管理标签列表（分页）", "description": "分页查询餐厅标签库，支持按关键词搜索。包含预设标签和自定义标签。", "operationId": "listManagedTagsUsingGET_1", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "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 } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«餐厅标签视图»»", "originalRef": "统一响应结果«分页结果«餐厅标签视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«餐厅标签视图»»", "originalRef": "统一响应结果«分页结果«餐厅标签视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/restaurant/tags/all": { "get": { "tags": [ "餐厅标签管理" ], "summary": "获取全部标签", "description": "不分页返回所有标签，用于餐厅编辑时的标签选择下拉。", "operationId": "listAllTagsUsingGET_1", "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/supplies/item": { "post": { "tags": [ "备品管理" ], "summary": "创建备品", "description": "新建备品资源（帐篷、睡袋、炊具等物资），初始状态为下架(status=0)。需走企微审批上架。支持按件(PER_ITEM)和按人(PER_PERSON)计费。\n\n**关联字典**：\n- supplies_category：备品分类（表单选择）\n- billing_type：计费方式（表单选择）", "operationId": "createSuppliesUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "备品创建请求", "required": false, "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/supplies/item/{suppliesId}": { "get": { "tags": [ "备品管理" ], "summary": "备品详情", "description": "获取备品完整信息，包含素材URL、标签等。\n\n**关联字典**：\n- supplies_category：备品分类（详情显示）\n- billing_type：计费方式（详情显示）", "operationId": "getSuppliesUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "suppliesId", "in": "path", "description": "备品ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«备品详情视图»", "originalRef": "统一响应结果«备品详情视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«备品详情视图»", "originalRef": "统一响应结果«备品详情视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "备品管理" ], "summary": "更新备品", "description": "更新备品基本信息，不改变当前状态。\n\n**关联字典**：\n- supplies_category：备品分类（表单选择）\n- billing_type：计费方式（表单选择）", "operationId": "updateSuppliesUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "备品更新请求", "required": false, "schema": { "$ref": "#/definitions/备品更新请求", "originalRef": "备品更新请求" } }, { "name": "suppliesId", "in": "path", "description": "备品ID", "required": false, "type": "integer", "format": "int64" } ], "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" }, "delete": { "tags": [ "备品管理" ], "summary": "删除备品", "description": "软删除备品。仅SUPER_ADMIN或创建者可操作。", "operationId": "deleteSuppliesUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "suppliesId", "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/supplies/item/{suppliesId}/status": { "put": { "tags": [ "备品管理" ], "summary": "上下架切换", "description": "直接修改状态（跳过审批），仅限SUPER_ADMIN。状态值：0=下架，1=上架。", "operationId": "updateStatusUsingPUT_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "备品状态请求", "required": false, "schema": { "$ref": "#/definitions/备品状态变更请求", "originalRef": "备品状态变更请求" } }, { "name": "suppliesId", "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/supplies/item/{suppliesId}/submit-approval": { "post": { "tags": [ "备品管理" ], "summary": "提交启用/禁用审批", "description": "向企微OA提交审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。", "operationId": "submitApprovalUsingPOST_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "审批提交请求", "required": false, "schema": { "$ref": "#/definitions/备品审批提交请求", "originalRef": "备品审批提交请求" } }, { "name": "suppliesId", "in": "path", "description": "备品ID", "required": false, "type": "integer", "format": "int64" } ], "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/supplies/item/{suppliesId}/tags": { "put": { "tags": [ "备品标签管理" ], "summary": "更新备品标签", "description": "全量替换指定备品的标签列表。", "operationId": "updateSuppliesTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "备品标签更新请求", "required": false, "schema": { "$ref": "#/definitions/备品标签更新请求_1", "originalRef": "备品标签更新请求_1" } }, { "name": "suppliesId", "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/supplies/items": { "get": { "tags": [ "备品管理" ], "summary": "备品列表", "description": "分页查询备品列表，支持按名称、状态、分类等条件筛选。\n\n**关联字典**：\n- supplies_category：备品分类（筛选+列表显示）\n- billing_type：计费方式（列表显示）", "operationId": "listSuppliesUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "billingType", "in": "query", "description": "计费方式：PER_ITEM=按件 PER_DAY=按天", "required": false, "type": "string", "x-example": "PER_ITEM" }, { "name": "categoryCode", "in": "query", "description": "分类编码", "required": false, "type": "string", "x-example": "OUTDOOR_GEAR" }, { "name": "keyword", "in": "query", "description": "搜索关键词（名称/副标题模糊搜索）", "required": false, "type": "string", "x-example": "登山杖" }, { "name": "maxPrice", "in": "query", "description": "最高价格", "required": false, "type": "number", "x-example": 500.0 }, { "name": "minPrice", "in": "query", "description": "最低价格", "required": false, "type": "number", "x-example": 10.0 }, { "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": "recommended", "in": "query", "description": "是否推荐：0=否 1=是", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "sortBy", "in": "query", "description": "排序字段", "required": false, "type": "string", "x-example": "createdAt" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc=升序 desc=降序", "required": false, "type": "string", "x-example": "desc" }, { "name": "status", "in": "query", "description": "状态：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "tagId", "in": "query", "description": "标签ID", "required": false, "type": "integer", "format": "int64", "x-example": 100 }, { "name": "tagIds", "in": "query", "description": "标签ID列表（逗号分隔）", "required": false, "type": "string", "x-example": "100,101,102" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«备品列表视图»»", "originalRef": "统一响应结果«分页结果«备品列表视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«备品列表视图»»", "originalRef": "统一响应结果«分页结果«备品列表视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/supplies/items/batch": { "delete": { "tags": [ "备品管理" ], "summary": "批量删除", "description": "批量软删除多个备品。仅SUPER_ADMIN或创建者可操作。", "operationId": "batchDeleteUsingDELETE_2", "produces": [ "*/*" ], "parameters": [ { "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/supplies/items/batch/status": { "put": { "tags": [ "备品管理" ], "summary": "批量上下架", "description": "批量修改多个备品的状态，跳过审批流程。", "operationId": "batchUpdateStatusUsingPUT_3", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/supplies/items/batch/tags": { "put": { "tags": [ "备品标签管理" ], "summary": "批量打标签", "description": "对多个备品批量添加/移除标签。增量操作。", "operationId": "batchUpdateTagsUsingPUT_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/supplies/tag": { "post": { "tags": [ "备品标签管理" ], "summary": "创建管理标签", "description": "创建预设标签，标签名不可重复。", "operationId": "createTagUsingPOST_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签创建请求", "required": false, "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/supplies/tag/adhoc": { "post": { "tags": [ "备品标签管理" ], "summary": "解析自定义标签", "description": "按名称查找或自动创建标签。", "operationId": "resolveAdHocTagUsingPOST_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签创建请求", "required": false, "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/supplies/tag/{tagId}": { "put": { "tags": [ "备品标签管理" ], "summary": "编辑标签", "description": "修改标签名称或颜色，所有关联备品自动生效。", "operationId": "updateTagUsingPUT_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签更新请求", "required": false, "schema": { "$ref": "#/definitions/备品标签更新请求", "originalRef": "备品标签更新请求" } }, { "name": "tagId", "in": "path", "description": "标签ID", "required": false, "type": "integer", "format": "int64" } ], "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" }, "delete": { "tags": [ "备品标签管理" ], "summary": "删除标签", "description": "删除标签并解除所有备品与该标签的关联。", "operationId": "deleteTagUsingDELETE_2", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "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/supplies/tags": { "get": { "tags": [ "备品标签管理" ], "summary": "获取管理标签列表（分页）", "description": "分页查询备品标签库，支持按关键词搜索。", "operationId": "listManagedTagsUsingGET_2", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "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 } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«备品标签视图»»", "originalRef": "统一响应结果«分页结果«备品标签视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«备品标签视图»»", "originalRef": "统一响应结果«分页结果«备品标签视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/supplies/tags/all": { "get": { "tags": [ "备品标签管理" ], "summary": "获取全部标签", "description": "不分页返回所有标签，用于备品编辑时的标签选择下拉。", "operationId": "listAllTagsUsingGET_2", "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/activity/item": { "post": { "tags": [ "游玩项目管理" ], "summary": "创建游玩项目", "description": "新建游玩项目资源（如漂流、骑行、篝火晚会等），初始状态为下架(status=0)。需通过「提交启用/禁用审批」走企微审批后上架。支持按项收费(PER_ITEM)和按人收费(PER_PERSON)两种计费方式。\n\n**关联字典**：\n- activity_category：活动分类（表单选择）\n- activity_billing_type：计费方式（表单选择）", "operationId": "createActivityUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "游玩项目创建请求", "required": false, "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/activity/item/{activityId}": { "get": { "tags": [ "游玩项目管理" ], "summary": "游玩项目详情", "description": "获取游玩项目完整信息，包含富文本内容、素材URL、标签、价格日历等。\n\n**关联字典**：\n- activity_category：活动分类（详情显示）\n- activity_billing_type：计费方式（详情显示）", "operationId": "getActivityUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "in": "path", "description": "游玩项目ID", "required": false, "type": "integer", "format": "int64" } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«活动项目详情视图»", "originalRef": "统一响应结果«活动项目详情视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«活动项目详情视图»", "originalRef": "统一响应结果«活动项目详情视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "游玩项目管理" ], "summary": "更新游玩项目", "description": "更新游玩项目基本信息，不改变当前状态。已上架的项目修改后仍保持上架。\n\n**关联字典**：\n- activity_category：活动分类（表单选择）\n- activity_billing_type：计费方式（表单选择）", "operationId": "updateActivityUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "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/统一响应结果«活动项目详情视图»", "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" }, "delete": { "tags": [ "游玩项目管理" ], "summary": "删除游玩项目", "description": "软删除游玩项目。仅SUPER_ADMIN或创建者可操作。删除后关联的素材引用会被清理。", "operationId": "deleteActivityUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "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/activity/item/{activityId}/prices": { "get": { "tags": [ "游玩项目价格日历" ], "summary": "查询价格日历", "description": "按月查询游玩项目的每日价格和可接待状态。", "operationId": "getPriceCalendarUsingGET_1", "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "in": "path", "description": "游玩项目ID", "required": false, "type": "integer", "format": "int64" }, { "name": "month", "in": "query", "description": "月份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false }, { "name": "year", "in": "query", "description": "年份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«活动价格日历视图»", "originalRef": "统一响应结果«活动价格日历视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«活动价格日历视图»", "originalRef": "统一响应结果«活动价格日历视图»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" }, "put": { "tags": [ "游玩项目价格日历" ], "summary": "批量设置价格", "description": "在指定日期范围内批量设置成本价和可接待状态。支持按星期过滤和排除特定日期。", "operationId": "batchSetPricesUsingPUT_1", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "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»" } }, "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": "删除指定日期范围内的所有价格记录。日期格式：yyyy-MM-dd。", "operationId": "deletePricesUsingDELETE_1", "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "in": "path", "description": "游玩项目ID", "required": false, "type": "integer", "format": "int64" }, { "name": "endDate", "in": "query", "description": "结束日期", "required": false, "type": "string", "allowEmptyValue": false }, { "name": "startDate", "in": "query", "description": "开始日期", "required": false, "type": "string", "allowEmptyValue": false } ], "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/activity/item/{activityId}/prices/batch-status": { "put": { "tags": [ "游玩项目价格日历" ], "summary": "批量修改可接待状态", "description": "批量修改指定日期范围内的可接待状态，不影响价格。", "operationId": "batchUpdateStatusUsingPUT_5", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "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»" } }, "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/activity/item/{activityId}/status": { "put": { "tags": [ "游玩项目管理" ], "summary": "启用/禁用切换", "description": "直接修改状态（跳过审批），仅限SUPER_ADMIN。状态值：0=下架，1=上架。", "operationId": "updateStatusUsingPUT_3", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "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»" } }, "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/activity/item/{activityId}/submit-approval": { "post": { "tags": [ "游玩项目管理" ], "summary": "提交启用/禁用审批", "description": "向企微OA提交审批。targetStatus=1申请上架，targetStatus=2申请下架。审批通过后自动更新状态，返回审批单号spNo。", "operationId": "submitApprovalUsingPOST_3", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "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/统一响应结果«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/activity/item/{activityId}/tags": { "put": { "tags": [ "游玩项目标签管理" ], "summary": "更新项目标签", "description": "全量替换指定项目的标签列表。传入tagIds为最终关联的标签ID列表，为空则清除所有标签。", "operationId": "updateActivityTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "activityId", "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»" } }, "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/activity/items": { "get": { "tags": [ "游玩项目管理" ], "summary": "游玩项目列表", "description": "分页查询游玩项目列表，支持按名称、状态、分类等条件筛选。返回摘要信息，按sortOrder倒序+创建时间倒序排列。\n\n**关联字典**：\n- activity_category：活动分类（筛选+列表显示）\n- activity_billing_type：计费方式（列表显示）", "operationId": "listActivitiesUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "billingType", "in": "query", "description": "计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时", "required": false, "type": "string", "x-example": "PER_PERSON" }, { "name": "categoryCode", "in": "query", "description": "分类编码", "required": false, "type": "string", "x-example": "OUTDOOR" }, { "name": "city", "in": "query", "description": "城市", "required": false, "type": "string", "x-example": "拉萨市" }, { "name": "cityKeyword", "in": "query", "description": "城市/区域关键词模糊搜索（匹配城市名、省份、地址）", "required": false, "type": "string", "x-example": "海拉尔" }, { "name": "environmentType", "in": "query", "description": "环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外", "required": false, "type": "string", "x-example": "OUTDOOR" }, { "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": "physicalLevel", "in": "query", "description": "体力要求：LOW=低 MEDIUM=中 HIGH=高", "required": false, "type": "string", "x-example": "MEDIUM" }, { "name": "sortBy", "in": "query", "description": "排序字段", "required": false, "type": "string", "x-example": "createdAt" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc=升序 desc=降序", "required": false, "type": "string", "x-example": "desc" }, { "name": "status", "in": "query", "description": "状态：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "tagId", "in": "query", "description": "标签ID", "required": false, "type": "integer", "format": "int64", "x-example": 100 }, { "name": "tagIds", "in": "query", "description": "标签ID列表（逗号分隔）", "required": false, "type": "string", "x-example": "100,101,102" }, { "name": "weatherDependent", "in": "query", "description": "是否受天气影响：0=否 1=是", "required": false, "type": "integer", "format": "int32", "x-example": 1 } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«活动项目列表视图»»", "originalRef": "统一响应结果«分页结果«活动项目列表视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«活动项目列表视图»»", "originalRef": "统一响应结果«分页结果«活动项目列表视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/activity/items/batch": { "delete": { "tags": [ "游玩项目管理" ], "summary": "批量删除", "description": "批量软删除多个游玩项目。仅SUPER_ADMIN或创建者可操作。", "operationId": "batchDeleteUsingDELETE_3", "produces": [ "*/*" ], "parameters": [ { "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/activity/items/batch/status": { "put": { "tags": [ "游玩项目管理" ], "summary": "批量启用/禁用", "description": "批量修改多个游玩项目的状态，跳过审批流程。", "operationId": "batchUpdateStatusUsingPUT_4", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/activity/items/batch/tags": { "put": { "tags": [ "游玩项目标签管理" ], "summary": "批量打标签", "description": "对多个项目批量添加/移除标签。增量操作，不影响未指定的标签。", "operationId": "batchUpdateTagsUsingPUT_3", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/activity/tag": { "post": { "tags": [ "游玩项目标签管理" ], "summary": "创建管理标签", "description": "创建预设标签，标签名不可重复。可指定颜色(tagColor)，默认#409EFF。", "operationId": "createTagUsingPOST_3", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签创建请求", "required": false, "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/activity/tag/adhoc": { "post": { "tags": [ "游玩项目标签管理" ], "summary": "解析自定义标签", "description": "按名称查找或自动创建标签。用于项目编辑时快速输入新标签。", "operationId": "resolveAdHocTagUsingPOST_3", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签创建请求", "required": false, "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/activity/tag/{tagId}": { "put": { "tags": [ "游玩项目标签管理" ], "summary": "编辑标签", "description": "修改标签名称或颜色，所有关联项目自动生效。", "operationId": "updateTagUsingPUT_3", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签更新请求", "required": false, "schema": { "$ref": "#/definitions/活动标签更新请求", "originalRef": "活动标签更新请求" } }, { "name": "tagId", "in": "path", "description": "标签ID", "required": false, "type": "integer", "format": "int64" } ], "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" }, "delete": { "tags": [ "游玩项目标签管理" ], "summary": "删除标签", "description": "删除标签并自动解除所有项目与该标签的关联。", "operationId": "deleteTagUsingDELETE_3", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "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/activity/tags": { "get": { "tags": [ "游玩项目标签管理" ], "summary": "获取管理标签列表（分页）", "description": "分页查询游玩项目标签库，支持按关键词搜索。包含预设标签和自定义标签。", "operationId": "listManagedTagsUsingGET_3", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "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 } ], "responses": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«活动标签视图»»", "originalRef": "统一响应结果«分页结果«活动标签视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "responsesObject": { "200": { "description": "OK", "schema": { "$ref": "#/definitions/统一响应结果«分页结果«活动标签视图»»", "originalRef": "统一响应结果«分页结果«活动标签视图»»" } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "404": { "description": "Not Found" } }, "deprecated": false, "x-order": "2147483647" } }, "/admin/activity/tags/all": { "get": { "tags": [ "游玩项目标签管理" ], "summary": "获取全部标签", "description": "不分页返回所有标签，用于项目编辑时的标签选择下拉。", "operationId": "listAllTagsUsingGET_3", "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/hotel/item": { "post": { "tags": [ "住宿管理" ], "summary": "创建住宿", "description": "新建住宿资源（酒店/民宿/营地等），初始状态为下架(status=0)。创建后需通过「提交启用/禁用审批」走企微OA审批流程才能上架。住宿下可继续创建房型（RoomType），房型有独立的价格日历。\n\n**关联字典**：\n- hotel_type：住宿类型（表单选择）\n- hotel_star_level：酒店星级（表单选择）\n- hotel_facility：酒店设施（表单多选）", "operationId": "createHotelUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/hotel/item/{hotelId}": { "get": { "tags": [ "住宿管理" ], "summary": "住宿详情", "description": "获取住宿完整信息，包含素材URL、标签列表、房型列表等。素材ID会自动解析为OSS访问地址。\n\n**关联字典**：\n- hotel_type：住宿类型（详情显示）\n- hotel_star_level：酒店星级（详情显示）\n- hotel_facility：酒店设施（详情显示）", "operationId": "getHotelUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "hotelId", "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- hotel_type：住宿类型（表单选择）\n- hotel_star_level：酒店星级（表单选择）\n- hotel_facility：酒店设施（表单多选）", "operationId": "updateHotelUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "hotelId", "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/统一响应结果«酒店详情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": "软删除住宿。仅房务管理员(ROOM_MANAGER)或超级管理员可操作，且只能删除未启用(下架)的住宿。删除住宿会同时删除其下所有房型和价格日历数据。", "operationId": "deleteHotelUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "hotelId", "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/hotel/item/{hotelId}/status": { "put": { "tags": [ "住宿管理" ], "summary": "启用/禁用切换", "description": "直接修改住宿状态（跳过审批），仅限SUPER_ADMIN使用。状态值：0=下架，1=上架。", "operationId": "updateStatusUsingPUT_4", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "hotelId", "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»" } }, "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/hotel/item/{hotelId}/submit-approval": { "post": { "tags": [ "住宿管理" ], "summary": "提交启用/禁用审批", "description": "向企微OA提交住宿启用/禁用审批。targetStatus=1申请上架，targetStatus=2申请下架。审批通过后自动更新状态。返回企微审批单号spNo。", "operationId": "submitApprovalUsingPOST_4", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "hotelId", "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/统一响应结果«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/hotel/item/{hotelId}/tags": { "put": { "tags": [ "住宿标签管理" ], "summary": "设置住宿标签", "description": "全量替换指定住宿的标签列表。", "operationId": "updateHotelTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "hotelId", "in": "path", "description": "住宿ID", "required": false, "type": "integer", "format": "int64" }, { "in": "body", "name": "request", "description": "住宿标签更新请求", "required": false, "schema": { "$ref": "#/definitions/酒店标签更新请求_1", "originalRef": "酒店标签更新请求_1" } } ], "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/hotel/items": { "get": { "tags": [ "住宿管理" ], "summary": "住宿列表", "description": "分页查询住宿列表，支持按名称关键词、状态、住宿类型等条件筛选。返回列表摘要信息，按sortOrder倒序+创建时间倒序排列。\n\n**关联字典**：\n- hotel_type：住宿类型（筛选+列表显示）\n- hotel_star_level：酒店星级（筛选+列表显示）\n- hotel_facility：酒店设施（列表显示）", "operationId": "listHotelsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "city", "in": "query", "description": "城市筛选", "required": false, "type": "string", "x-example": "丽江市" }, { "name": "cityKeyword", "in": "query", "description": "城市/区域关键词模糊搜索（匹配城市名、省份、地址）", "required": false, "type": "string", "x-example": "海拉尔" }, { "name": "hotelType", "in": "query", "description": "住宿类型筛选", "required": false, "type": "string", "x-example": "HOTEL" }, { "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": "排序字段", "required": false, "type": "string", "x-example": "createdAt" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc/desc", "required": false, "type": "string", "x-example": "desc" }, { "name": "starLevel", "in": "query", "description": "星级筛选（字典: hotel_star_level）", "required": false, "type": "string", "x-example": "FIVE_STAR" }, { "name": "status", "in": "query", "description": "状态筛选：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "tagId", "in": "query", "description": "标签ID（单个）", "required": false, "type": "integer", "format": "int64" }, { "name": "tagIds", "in": "query", "description": "标签ID列表（逗号分隔）", "required": false, "type": "string", "x-example": "1,2,3" } ], "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/hotel/items/all-simple": { "get": { "tags": [ "住宿管理" ], "summary": "所有启用的住宿（不分页，仅ID和名称）", "description": "返回所有已上架(status=1)的住宿简要信息，用于下拉选择框。每项只含hotelId和name字段。适用于房型管理时选择所属住宿、产品编排时绑定住宿资源等场景。", "operationId": "listAllSimpleUsingGET", "produces": [ "*/*" ], "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/hotel/items/batch": { "delete": { "tags": [ "住宿管理" ], "summary": "批量删除", "description": "批量软删除多个住宿及其关联的房型和价格日历。仅房务管理员(ROOM_MANAGER)或超级管理员可操作，且只能删除未启用(下架)的住宿。", "operationId": "batchDeleteUsingDELETE_4", "produces": [ "*/*" ], "parameters": [ { "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/hotel/items/batch/status": { "put": { "tags": [ "住宿管理" ], "summary": "批量启用/禁用", "description": "批量修改多个住宿的状态，跳过审批流程。hotelIds为住宿ID列表（字符串格式）。", "operationId": "batchUpdateStatusUsingPUT_6", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/hotel/items/batch/tags": { "put": { "tags": [ "住宿标签管理" ], "summary": "批量添加/移除标签", "description": "对多个住宿批量添加/移除标签。增量操作，不影响未指定的标签。", "operationId": "batchUpdateTagsUsingPUT_4", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/hotel/room-type/{roomTypeId}": { "get": { "tags": [ "房型管理" ], "summary": "房型详情", "description": "获取房型完整信息，包含价格、入住人数、素材等。\n\n**关联字典**：\n- room_category：房型分类（列表/详情显示）\n- bed_type：床型（列表/详情显示）\n- window_type：窗户类型（列表/详情显示）\n- bathroom_type：卫浴类型（列表/详情显示）\n- room_facility：房间设施（列表/详情显示）", "operationId": "getRoomTypeUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "roomTypeId", "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- room_category：房型分类（表单选择）\n- bed_type：床型（表单选择）\n- window_type：窗户类型（表单选择）\n- bathroom_type：卫浴类型（表单选择）\n- room_facility：房间设施（表单多选）", "operationId": "updateRoomTypeUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "房型更新请求", "required": false, "schema": { "$ref": "#/definitions/房型更新请求", "originalRef": "房型更新请求" } }, { "name": "roomTypeId", "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" }, "delete": { "tags": [ "房型管理" ], "summary": "删除房型", "description": "软删除房型及其价格日历数据。", "operationId": "deleteRoomTypeUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "roomTypeId", "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/hotel/room-type/{roomTypeId}/prices": { "get": { "tags": [ "房型价格日历" ], "summary": "查询价格日历", "description": "按月查询房型的每日价格和可售状态。每个房型有独立的价格日历。", "operationId": "getPriceCalendarUsingGET_2", "produces": [ "*/*" ], "parameters": [ { "name": "month", "in": "query", "description": "月份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false }, { "name": "roomTypeId", "in": "path", "description": "房型ID", "required": false, "type": "integer", "format": "int64" }, { "name": "year", "in": "query", "description": "年份", "required": false, "type": "integer", "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" }, "put": { "tags": [ "房型价格日历" ], "summary": "批量设置价格日历", "description": "在指定日期范围内批量设置房型的成本价和可售状态。支持按星期过滤和排除特定日期。", "operationId": "batchSetPricesUsingPUT_2", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历设置请求", "required": false, "schema": { "$ref": "#/definitions/酒店房型价格日历设置请求", "originalRef": "酒店房型价格日历设置请求" } }, { "name": "roomTypeId", "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": "删除指定日期范围内房型的所有价格记录。日期格式：yyyy-MM-dd。", "operationId": "deletePricesUsingDELETE_2", "produces": [ "*/*" ], "parameters": [ { "name": "endDate", "in": "query", "description": "结束日期", "required": false, "type": "string", "allowEmptyValue": false }, { "name": "roomTypeId", "in": "path", "description": "房型ID", "required": false, "type": "integer", "format": "int64" }, { "name": "startDate", "in": "query", "description": "开始日期", "required": false, "type": "string", "allowEmptyValue": false } ], "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/hotel/room-type/{roomTypeId}/prices/batch-status": { "put": { "tags": [ "房型价格日历" ], "summary": "批量修改日期可售状态", "description": "批量修改指定日期范围内房型的可售状态，不影响价格。", "operationId": "batchUpdateStatusUsingPUT_7", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历状态请求", "required": false, "schema": { "$ref": "#/definitions/酒店房型价格日历状态变更请求", "originalRef": "酒店房型价格日历状态变更请求" } }, { "name": "roomTypeId", "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/hotel/room-type/{roomTypeId}/status": { "put": { "tags": [ "房型管理" ], "summary": "启用/禁用房型", "description": "直接修改房型状态（跳过审批）。status=0禁用，status=1启用。禁用后该房型不会出现在C端展示中。", "operationId": "updateRoomTypeStatusUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "房型状态请求", "required": false, "schema": { "$ref": "#/definitions/房型状态变更请求", "originalRef": "房型状态变更请求" } }, { "name": "roomTypeId", "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/hotel/room-type/{roomTypeId}/submit-approval": { "post": { "tags": [ "房型管理" ], "summary": "提交房型启用/禁用审批", "description": "向企微OA提交房型启用/禁用审批。审批流程与住宿共享同一模板。返回审批单号spNo。", "operationId": "submitRoomTypeApprovalUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "审批提交请求", "required": false, "schema": { "$ref": "#/definitions/酒店审批提交请求", "originalRef": "酒店审批提交请求" } }, { "name": "roomTypeId", "in": "path", "description": "房型ID", "required": false, "type": "integer", "format": "int64" } ], "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/hotel/tag": { "post": { "tags": [ "住宿标签管理" ], "summary": "创建标签", "description": "创建预设标签，标签名不可重复。", "operationId": "createTagUsingPOST_4", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/hotel/tag/adhoc": { "post": { "tags": [ "住宿标签管理" ], "summary": "查找或创建自定义标签", "description": "按名称查找标签，不存在则自动创建。用于住宿编辑时快速输入新标签。", "operationId": "resolveAdHocTagUsingPOST_4", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/hotel/tag/{tagId}": { "put": { "tags": [ "住宿标签管理" ], "summary": "更新标签", "description": "修改标签名称或颜色，所有关联住宿自动生效。", "operationId": "updateTagUsingPUT_4", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签更新请求", "required": false, "schema": { "$ref": "#/definitions/酒店标签更新请求", "originalRef": "酒店标签更新请求" } }, { "name": "tagId", "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" }, "delete": { "tags": [ "住宿标签管理" ], "summary": "删除标签", "description": "删除标签并解除所有住宿与该标签的关联。", "operationId": "deleteTagUsingDELETE_4", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "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/hotel/tags": { "get": { "tags": [ "住宿标签管理" ], "summary": "预设标签列表（分页）", "description": "分页查询住宿标签库，支持按关键词搜索。", "operationId": "listManagedTagsUsingGET_4", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "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 } ], "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/hotel/tags/all": { "get": { "tags": [ "住宿标签管理" ], "summary": "所有标签列表", "description": "不分页返回所有标签，用于住宿编辑时的标签选择。", "operationId": "listAllTagsUsingGET_4", "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/hotel/{hotelId}/room-type": { "post": { "tags": [ "房型管理" ], "summary": "创建房型", "description": "在指定住宿下创建房型（如标准间、大床房、套房等）。每个房型有独立的价格日历、最大入住人数(maxOccupancy)和基础价格(basePrice)。房型初始状态为下架(status=0)，需独立审批后才能启用。创建后可通过「提交房型启用审批」接口提交企微OA审批。\n\n**关联字典**：\n- room_category：房型分类（表单选择）\n- bed_type：床型（表单选择）\n- window_type：窗户类型（表单选择）\n- bathroom_type：卫浴类型（表单选择）\n- room_facility：房间设施（表单多选）", "operationId": "createRoomTypeUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "hotelId", "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/统一响应结果«房型详情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/hotel/{hotelId}/room-types": { "get": { "tags": [ "房型管理" ], "summary": "房型列表", "description": "获取指定住宿下的所有房型列表（不分页），按sortOrder排序。\n\n**关联字典**：\n- room_category：房型分类（列表/详情显示）\n- bed_type：床型（列表/详情显示）\n- window_type：窗户类型（列表/详情显示）\n- bathroom_type：卫浴类型（列表/详情显示）\n- room_facility：房间设施（列表/详情显示）", "operationId": "listRoomTypesUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "hotelId", "in": "path", "description": "住宿ID", "required": false, "type": "integer", "format": "int64" } ], "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/service/item": { "post": { "tags": [ "增值服务管理" ], "summary": "创建增值服务", "description": "新建增值服务项目（如保险、签证代办、接送机等），初始状态为下架(status=0)。支持免费(isPaid=false)和付费两种模式，付费服务有独立的价格日历。需走企微审批上架。\n\n**关联字典**：\n- service_category：服务分类（表单选择）\n- billing_type_service：服务计费方式（表单选择）\n- service_unit：服务计量单位（表单选择）", "operationId": "createServiceItemUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/service/item/{serviceId}": { "get": { "tags": [ "增值服务管理" ], "summary": "增值服务详情", "description": "获取增值服务完整信息，包含素材URL、标签、计费方式等。\n\n**关联字典**：\n- service_category：服务分类（详情显示）\n- billing_type_service：服务计费方式（详情显示）\n- service_unit：服务计量单位（详情显示）", "operationId": "getServiceItemUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "serviceId", "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- service_category：服务分类（表单选择）\n- billing_type_service：服务计费方式（表单选择）\n- service_unit：服务计量单位（表单选择）", "operationId": "updateServiceItemUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "服务更新请求", "required": false, "schema": { "$ref": "#/definitions/服务项更新请求", "originalRef": "服务项更新请求" } }, { "name": "serviceId", "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" }, "delete": { "tags": [ "增值服务管理" ], "summary": "删除增值服务", "description": "软删除增值服务。仅SUPER_ADMIN或创建者可操作。", "operationId": "deleteServiceItemUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "serviceId", "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/service/item/{serviceId}/prices": { "get": { "tags": [ "服务价格日历" ], "summary": "查询价格日历", "description": "按月查询增值服务的每日价格和可售状态。仅付费服务(isPaid=true)需要设置价格日历。", "operationId": "getPriceCalendarUsingGET_3", "produces": [ "*/*" ], "parameters": [ { "name": "month", "in": "query", "description": "月份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false }, { "name": "serviceId", "in": "path", "description": "服务ID", "required": false, "type": "integer", "format": "int64" }, { "name": "year", "in": "query", "description": "年份", "required": false, "type": "integer", "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" }, "put": { "tags": [ "服务价格日历" ], "summary": "批量设置价格", "description": "在指定日期范围内批量设置服务的成本价和可售状态。", "operationId": "batchSetPricesUsingPUT_3", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历设置请求", "required": false, "schema": { "$ref": "#/definitions/服务项价格日历设置请求", "originalRef": "服务项价格日历设置请求" } }, { "name": "serviceId", "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": "删除指定日期范围内的价格记录。日期格式：yyyy-MM-dd。", "operationId": "deletePricesUsingDELETE_3", "produces": [ "*/*" ], "parameters": [ { "name": "endDate", "in": "query", "description": "结束日期", "required": false, "type": "string", "allowEmptyValue": false }, { "name": "serviceId", "in": "path", "description": "服务ID", "required": false, "type": "integer", "format": "int64" }, { "name": "startDate", "in": "query", "description": "开始日期", "required": false, "type": "string", "allowEmptyValue": false } ], "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/service/item/{serviceId}/prices/batch-status": { "put": { "tags": [ "服务价格日历" ], "summary": "批量修改可售状态", "description": "批量修改日期范围内的可售状态，不影响价格。", "operationId": "batchUpdateStatusUsingPUT_9", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历状态请求", "required": false, "schema": { "$ref": "#/definitions/服务项价格日历状态变更请求", "originalRef": "服务项价格日历状态变更请求" } }, { "name": "serviceId", "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/service/item/{serviceId}/status": { "put": { "tags": [ "增值服务管理" ], "summary": "启用/禁用切换", "description": "直接修改状态（跳过审批），仅限SUPER_ADMIN。状态值：0=下架，1=上架。", "operationId": "updateStatusUsingPUT_5", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "服务状态请求", "required": false, "schema": { "$ref": "#/definitions/服务项状态变更请求", "originalRef": "服务项状态变更请求" } }, { "name": "serviceId", "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/service/item/{serviceId}/submit-approval": { "post": { "tags": [ "增值服务管理" ], "summary": "提交启用/禁用审批", "description": "向企微OA提交审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。", "operationId": "submitApprovalUsingPOST_5", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "审批提交请求", "required": false, "schema": { "$ref": "#/definitions/服务项审批提交请求", "originalRef": "服务项审批提交请求" } }, { "name": "serviceId", "in": "path", "description": "服务ID", "required": false, "type": "integer", "format": "int64" } ], "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/service/item/{serviceId}/tags": { "put": { "tags": [ "服务标签管理" ], "summary": "更新服务标签", "description": "全量替换指定服务的标签列表。", "operationId": "updateServiceTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "服务标签更新请求", "required": false, "schema": { "$ref": "#/definitions/服务项标签更新请求", "originalRef": "服务项标签更新请求" } }, { "name": "serviceId", "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/service/items": { "get": { "tags": [ "增值服务管理" ], "summary": "增值服务列表", "description": "分页查询增值服务列表，支持按名称、状态、分类等条件筛选。\n\n**关联字典**：\n- service_category：服务分类（筛选+列表显示）\n- billing_type_service：服务计费方式（列表显示）\n- service_unit：服务计量单位（列表显示）", "operationId": "listServiceItemsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "billingType", "in": "query", "description": "计费方式筛选", "required": false, "type": "string", "x-example": "PER_DAY" }, { "name": "categoryCode", "in": "query", "description": "分类编码筛选", "required": false, "type": "string", "x-example": "GUIDE" }, { "name": "city", "in": "query", "description": "城市筛选", "required": false, "type": "string", "x-example": "丽江市" }, { "name": "cityKeyword", "in": "query", "description": "城市/区域关键词模糊搜索（匹配城市名、省份、地址）", "required": false, "type": "string", "x-example": "海拉尔" }, { "name": "instantConfirm", "in": "query", "description": "是否即时确认筛选：0=否 1=是", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "isPaid", "in": "query", "description": "是否收费筛选：0=免费 1=收费", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "keyword", "in": "query", "description": "搜索关键词（名称模糊匹配）", "required": false, "type": "string", "x-example": "导游" }, { "name": "maxPrice", "in": "query", "description": "最高价格筛选", "required": false, "type": "number", "x-example": 1000.0 }, { "name": "minPrice", "in": "query", "description": "最低价格筛选", "required": false, "type": "number", "x-example": 100.0 }, { "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": "排序字段", "required": false, "type": "string", "x-example": "createdAt" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc/desc", "required": false, "type": "string", "x-example": "desc" }, { "name": "status", "in": "query", "description": "状态筛选：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "tagId", "in": "query", "description": "标签ID（单个）", "required": false, "type": "integer", "format": "int64" }, { "name": "tagIds", "in": "query", "description": "标签ID列表（逗号分隔）", "required": false, "type": "string", "x-example": "1,2,3" }, { "name": "vehicleType", "in": "query", "description": "配套车型筛选", "required": false, "type": "string", "x-example": "商务车" } ], "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/service/items/batch": { "delete": { "tags": [ "增值服务管理" ], "summary": "批量删除", "description": "批量软删除多个增值服务。仅SUPER_ADMIN或创建者可操作。", "operationId": "batchDeleteUsingDELETE_5", "produces": [ "*/*" ], "parameters": [ { "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/service/items/batch/status": { "put": { "tags": [ "增值服务管理" ], "summary": "批量启用/禁用", "description": "批量修改多个增值服务的状态，跳过审批流程。", "operationId": "batchUpdateStatusUsingPUT_8", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/service/items/batch/tags": { "put": { "tags": [ "服务标签管理" ], "summary": "批量打标签", "description": "对多个服务批量添加/移除标签。增量操作。", "operationId": "batchUpdateTagsUsingPUT_5", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/service/tag": { "post": { "tags": [ "服务标签管理" ], "summary": "创建管理标签", "description": "创建预设标签，标签名不可重复。", "operationId": "createTagUsingPOST_5", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/service/tag/adhoc": { "post": { "tags": [ "服务标签管理" ], "summary": "解析自定义标签", "description": "按名称查找或自动创建标签。", "operationId": "resolveAdHocTagUsingPOST_5", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/service/tag/{tagId}": { "put": { "tags": [ "服务标签管理" ], "summary": "编辑标签", "description": "修改标签名称或颜色，所有关联服务自动生效。", "operationId": "updateTagUsingPUT_5", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签更新请求", "required": false, "schema": { "$ref": "#/definitions/服务标签更新请求", "originalRef": "服务标签更新请求" } }, { "name": "tagId", "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" }, "delete": { "tags": [ "服务标签管理" ], "summary": "删除标签", "description": "删除标签并解除所有服务与该标签的关联。", "operationId": "deleteTagUsingDELETE_5", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "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/service/tags": { "get": { "tags": [ "服务标签管理" ], "summary": "获取管理标签列表（分页）", "description": "分页查询增值服务标签库，支持按关键词搜索。", "operationId": "listManagedTagsUsingGET_5", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "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 } ], "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/service/tags/all": { "get": { "tags": [ "服务标签管理" ], "summary": "获取全部标签", "description": "不分页返回所有标签，用于服务编辑时的标签选择。", "operationId": "listAllTagsUsingGET_5", "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/vehicle/model": { "post": { "tags": [ "车型管理" ], "summary": "创建车型", "description": "新建车型资源（如7座商务车、14座中巴等），初始状态为下架(status=0)。车型有独立的价格日历用于报价计算。需走企微审批上架。\n\n**关联字典**：\n- vehicle_type：车辆类型（表单选择）", "operationId": "createVehicleUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/vehicle/model/{vehicleId}": { "get": { "tags": [ "车型管理" ], "summary": "车型详情", "description": "获取车型完整信息，包含座位数、品牌、素材URL、标签等。\n\n**关联字典**：\n- vehicle_type：车辆类型（详情显示）", "operationId": "getVehicleUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "vehicleId", "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- vehicle_type：车辆类型（表单选择）", "operationId": "updateVehicleUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "车型更新请求", "required": false, "schema": { "$ref": "#/definitions/车型更新请求", "originalRef": "车型更新请求" } }, { "name": "vehicleId", "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" }, "delete": { "tags": [ "车型管理" ], "summary": "删除车型", "description": "软删除车型。仅SUPER_ADMIN或创建者可操作。", "operationId": "deleteVehicleUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "vehicleId", "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/vehicle/model/{vehicleId}/prices": { "get": { "tags": [ "车型价格日历" ], "summary": "查询价格日历", "description": "按月查询车型的每日租赁价格和可调度状态。", "operationId": "getPriceCalendarUsingGET_4", "produces": [ "*/*" ], "parameters": [ { "name": "month", "in": "query", "description": "月份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false }, { "name": "vehicleId", "in": "path", "description": "车型ID", "required": false, "type": "integer", "format": "int64" }, { "name": "year", "in": "query", "description": "年份", "required": false, "type": "integer", "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" }, "put": { "tags": [ "车型价格日历" ], "summary": "批量设置价格", "description": "在指定日期范围内批量设置车型的租赁成本价和可调度状态。", "operationId": "batchSetPricesUsingPUT_4", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历设置请求", "required": false, "schema": { "$ref": "#/definitions/车型价格日历设置请求", "originalRef": "车型价格日历设置请求" } }, { "name": "vehicleId", "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": "删除指定日期范围内车型的价格记录。日期格式：yyyy-MM-dd。", "operationId": "deletePricesUsingDELETE_4", "produces": [ "*/*" ], "parameters": [ { "name": "endDate", "in": "query", "description": "结束日期", "required": false, "type": "string", "format": "date", "allowEmptyValue": false }, { "name": "startDate", "in": "query", "description": "开始日期", "required": false, "type": "string", "format": "date", "allowEmptyValue": false }, { "name": "vehicleId", "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/vehicle/model/{vehicleId}/prices/batch-status": { "put": { "tags": [ "车型价格日历" ], "summary": "批量修改调度状态", "description": "批量修改日期范围内车型的可调度状态，不影响价格。", "operationId": "batchUpdateStatusUsingPUT_11", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历状态请求", "required": false, "schema": { "$ref": "#/definitions/车型价格日历状态变更请求", "originalRef": "车型价格日历状态变更请求" } }, { "name": "vehicleId", "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/vehicle/model/{vehicleId}/status": { "put": { "tags": [ "车型管理" ], "summary": "更新状态", "description": "直接修改车型状态（跳过审批），仅限SUPER_ADMIN。状态值：0=下架，1=上架。", "operationId": "updateStatusUsingPUT_6", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "状态请求体", "required": false, "schema": { "$ref": "#/definitions/车型状态请求", "originalRef": "车型状态请求" } }, { "name": "vehicleId", "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/vehicle/model/{vehicleId}/submit-approval": { "post": { "tags": [ "车型管理" ], "summary": "提交审批", "description": "向企微OA提交车型启用/禁用审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。", "operationId": "submitApprovalUsingPOST_6", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "审批提交请求体", "required": false, "schema": { "$ref": "#/definitions/车型审批提交请求", "originalRef": "车型审批提交请求" } }, { "name": "vehicleId", "in": "path", "description": "车型ID", "required": false, "type": "integer", "format": "int64" } ], "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/vehicle/model/{vehicleId}/tags": { "put": { "tags": [ "车型标签管理" ], "summary": "设置车型标签", "description": "全量替换指定车型的标签列表。", "operationId": "updateVehicleTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签ID列表请求", "required": false, "schema": { "$ref": "#/definitions/设置车型标签请求", "originalRef": "设置车型标签请求" } }, { "name": "vehicleId", "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/vehicle/models": { "get": { "tags": [ "车型管理" ], "summary": "车型列表", "description": "分页查询车型列表，支持按名称、状态、车辆类型等条件筛选。\n\n**关联字典**：\n- vehicle_type：车辆类型（筛选+列表显示）", "operationId": "listVehiclesUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "brand", "in": "query", "description": "品牌筛选", "required": false, "type": "string", "x-example": "别克" }, { "name": "keyword", "in": "query", "description": "搜索关键词（名称/品牌模糊匹配）", "required": false, "type": "string", "x-example": "别克" }, { "name": "maxPrice", "in": "query", "description": "最高价格筛选", "required": false, "type": "number", "x-example": 2000.0 }, { "name": "maxSeatCount", "in": "query", "description": "最多座位数筛选", "required": false, "type": "integer", "format": "int32", "x-example": 15 }, { "name": "minPrice", "in": "query", "description": "最低价格筛选", "required": false, "type": "number", "x-example": 500.0 }, { "name": "minSeatCount", "in": "query", "description": "最少座位数筛选", "required": false, "type": "integer", "format": "int32", "x-example": 5 }, { "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": "排序字段", "required": false, "type": "string", "x-example": "createdAt" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc/desc", "required": false, "type": "string", "x-example": "desc" }, { "name": "status", "in": "query", "description": "状态筛选：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "tagId", "in": "query", "description": "标签ID（单个）", "required": false, "type": "integer", "format": "int64" }, { "name": "tagIds", "in": "query", "description": "标签ID列表（逗号分隔）", "required": false, "type": "string", "x-example": "1,2,3" }, { "name": "vehicleType", "in": "query", "description": "车型分类筛选", "required": false, "type": "string", "x-example": "MPV" } ], "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/vehicle/models/all": { "get": { "tags": [ "车型管理" ], "summary": "车型全量列表（不分页，用于下拉选择）", "description": "返回所有车型列表，可选按状态筛选。适用于产品编排时选择车型的下拉选择框。不分页返回全部数据。\n\n**关联字典**：\n- vehicle_type：车辆类型（列表显示）", "operationId": "listAllVehiclesUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "status", "in": "query", "description": "状态筛选：1=上架", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false } ], "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/vehicle/models/batch": { "delete": { "tags": [ "车型管理" ], "summary": "批量删除", "description": "批量软删除多个车型。仅SUPER_ADMIN或创建者可操作。", "operationId": "batchDeleteUsingDELETE_6", "produces": [ "*/*" ], "parameters": [ { "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/vehicle/models/batch/status": { "put": { "tags": [ "车型管理" ], "summary": "批量更新状态", "description": "批量修改多个车型的状态，跳过审批流程。", "operationId": "batchUpdateStatusUsingPUT_10", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/vehicle/models/batch/tags": { "put": { "tags": [ "车型标签管理" ], "summary": "批量添加/移除标签", "description": "对多个车型批量添加/移除标签。增量操作。", "operationId": "batchUpdateTagsUsingPUT_6", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/vehicle/tag": { "post": { "tags": [ "车型标签管理" ], "summary": "创建标签", "description": "创建预设标签，标签名不可重复。", "operationId": "createTagUsingPOST_6", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/vehicle/tag/adhoc": { "post": { "tags": [ "车型标签管理" ], "summary": "解析自定义标签", "description": "按名称查找或自动创建标签。", "operationId": "resolveAdHocTagUsingPOST_6", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/vehicle/tag/{tagId}": { "put": { "tags": [ "车型标签管理" ], "summary": "更新标签", "description": "修改标签名称或颜色。", "operationId": "updateTagUsingPUT_6", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签更新请求", "required": false, "schema": { "$ref": "#/definitions/车辆标签更新请求", "originalRef": "车辆标签更新请求" } }, { "name": "tagId", "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" }, "delete": { "tags": [ "车型标签管理" ], "summary": "删除标签", "description": "删除标签并解除所有车型与该标签的关联。", "operationId": "deleteTagUsingDELETE_6", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "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/vehicle/tags": { "get": { "tags": [ "车型标签管理" ], "summary": "预设标签列表（分页）", "description": "分页查询车型标签库，支持按关键词搜索。", "operationId": "listManagedTagsUsingGET_6", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "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 } ], "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/vehicle/tags/all": { "get": { "tags": [ "车型标签管理" ], "summary": "全部标签列表", "description": "不分页返回所有标签，用于车型编辑时的标签选择。", "operationId": "listAllTagsUsingGET_6", "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/cost/item": { "post": { "tags": [ "费用项管理" ], "summary": "创建费用项", "description": "新建费用项（如门票成本、餐费、保险费等），用于产品报价计算。费用项有独立的价格日历，价格变更会记录变更日志。创建后需走企微审批上架。\n\n**关联字典**：\n- cost_category：费用分类（表单选择）\n- cost_apply_role：适用角色（表单选择）\n- cost_unit：计量单位（表单选择）", "operationId": "createCostItemUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/cost/item/{costId}": { "get": { "tags": [ "费用项管理" ], "summary": "费用项详情", "description": "获取费用项完整信息，包含当前价格、引用计数等。\n\n**关联字典**：\n- cost_category：费用分类（详情显示）\n- cost_apply_role：适用角色（详情显示）\n- cost_unit：计量单位（详情显示）", "operationId": "getCostItemUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "costId", "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- cost_category：费用分类（表单选择）\n- cost_apply_role：适用角色（表单选择）\n- cost_unit：计量单位（表单选择）", "operationId": "updateCostItemUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "costId", "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/统一响应结果«费用项详情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": "软删除费用项。仅SUPER_ADMIN或创建者可操作。被产品引用(refCount>0)的费用项不建议删除。", "operationId": "deleteCostItemUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "costId", "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/cost/item/{costId}/price-logs": { "get": { "tags": [ "费用项管理" ], "summary": "费用项价格变更记录", "description": "查询费用项的历史价格变更记录，按时间倒序排列。用于追溯价格调整历史。", "operationId": "getPriceLogsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "costId", "in": "path", "description": "费用项ID", "required": false, "type": "integer", "format": "int64" } ], "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/cost/item/{costId}/prices": { "get": { "tags": [ "费用项价格日历" ], "summary": "查询价格日历", "description": "按月查询费用项的每日价格。费用项价格日历用于产品报价计算时按日期获取成本价。", "operationId": "getPriceCalendarUsingGET_5", "produces": [ "*/*" ], "parameters": [ { "name": "costId", "in": "path", "description": "费用项ID", "required": false, "type": "integer", "format": "int64" }, { "name": "month", "in": "query", "description": "月份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false }, { "name": "year", "in": "query", "description": "年份", "required": false, "type": "integer", "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" }, "put": { "tags": [ "费用项价格日历" ], "summary": "批量设置价格", "description": "在指定日期范围内批量设置费用项的成本价。", "operationId": "batchSetPricesUsingPUT_5", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "costId", "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»" } }, "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": "删除指定日期范围内费用项的价格记录。日期格式：yyyy-MM-dd。", "operationId": "deletePricesUsingDELETE_5", "produces": [ "*/*" ], "parameters": [ { "name": "costId", "in": "path", "description": "费用项ID", "required": false, "type": "integer", "format": "int64" }, { "name": "endDate", "in": "query", "description": "结束日期", "required": false, "type": "string", "format": "date", "allowEmptyValue": false }, { "name": "startDate", "in": "query", "description": "开始日期", "required": false, "type": "string", "format": "date", "allowEmptyValue": false } ], "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/cost/item/{costId}/submit-approval": { "post": { "tags": [ "费用项管理" ], "summary": "提交审批", "description": "向企微OA提交费用项启用/禁用审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。", "operationId": "submitApprovalUsingPOST_7", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "name": "costId", "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/统一响应结果«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/cost/items": { "get": { "tags": [ "费用项管理" ], "summary": "费用项列表", "description": "分页查询费用项列表，支持按名称、状态等条件筛选。\n\n**关联字典**：\n- cost_category：费用分类（筛选+列表显示）\n- cost_apply_role：适用角色（筛选+列表显示）\n- cost_unit：计量单位（列表显示）", "operationId": "listCostItemsUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "applyRole", "in": "query", "description": "适用角色筛选", "required": false, "type": "string", "x-example": "ADULT" }, { "name": "categoryCode", "in": "query", "description": "费用分类编码筛选", "required": false, "type": "string", "x-example": "GUIDE" }, { "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": "排序字段", "required": false, "type": "string", "x-example": "createdAt" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc/desc", "required": false, "type": "string", "x-example": "desc" }, { "name": "status", "in": "query", "description": "状态筛选：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 } ], "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/cost/items/enabled": { "get": { "tags": [ "费用项管理" ], "summary": "启用的费用项列表", "description": "查询所有已启用(status=1)的费用项，不分页。用于产品编排时选择费用项的下拉列表。\n\n**关联字典**：\n- cost_category：费用分类（列表显示）\n- cost_apply_role：适用角色（列表显示）\n- cost_unit：计量单位（列表显示）", "operationId": "listEnabledCostItemsUsingGET", "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/staff": { "post": { "tags": [ "服务人员管理" ], "summary": "创建服务人员", "description": "新建服务人员（导游/领队/摄影师/助理等）。人员类型(staffType)决定了其在价格日历中的归类。需走企微审批上架后才能被产品引用。\n\n**关联字典**：\n- staff_type：人员类型（表单选择）\n- guide_level：导游等级（表单选择）\n- driver_license_type：驾照类型（表单选择）\n- language：语言能力（表单多选）\n- guide_specialty：导游专长（表单多选）\n- guide_service_area：服务区域（表单多选）", "operationId": "createStaffUsingPOST", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/staff/batch": { "delete": { "tags": [ "服务人员管理" ], "summary": "批量删除", "description": "批量软删除多个服务人员。仅SUPER_ADMIN或创建者可操作。", "operationId": "batchDeleteUsingDELETE_7", "produces": [ "*/*" ], "parameters": [ { "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/staff/batch-basic": { "get": { "tags": [ "服务人员管理" ], "summary": "批量查人员简要信息", "description": "根据ID列表批量查人员简要信息（ID+姓名+类型），用于备选人员回显。", "operationId": "batchBriefUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "staffIds", "in": "query", "description": "人员ID列表（逗号分隔）", "required": false, "type": "string", "allowEmptyValue": false } ], "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/staff/batch-brief": { "get": { "tags": [ "服务人员管理" ], "summary": "批量查人员简要信息", "description": "根据ID列表批量查人员简要信息（ID+姓名+类型），用于备选人员回显。", "operationId": "batchBriefUsingGET_1", "produces": [ "*/*" ], "parameters": [ { "name": "staffIds", "in": "query", "description": "人员ID列表（逗号分隔）", "required": false, "type": "string", "allowEmptyValue": false } ], "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/staff/batch/status": { "put": { "tags": [ "服务人员管理" ], "summary": "批量更新状态", "description": "批量修改多个服务人员的状态，跳过审批流程。", "operationId": "batchUpdateStatusUsingPUT_12", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/staff/batch/tags": { "put": { "tags": [ "服务人员标签管理" ], "summary": "批量添加/移除标签", "description": "对多个人员批量添加/移除标签。增量操作。", "operationId": "batchUpdateTagsUsingPUT_7", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/staff/list": { "get": { "tags": [ "服务人员管理" ], "summary": "服务人员列表", "description": "分页查询服务人员列表，支持按姓名、状态、人员类型等条件筛选。\n\n**关联字典**：\n- staff_type：人员类型（筛选+列表显示）\n- guide_level：导游等级（列表显示）\n- driver_license_type：驾照类型（列表显示）\n- language：语言能力（列表显示）\n- guide_specialty：导游专长（列表显示）\n- guide_service_area：服务区域（列表显示）", "operationId": "listStaffUsingGET", "produces": [ "*/*" ], "parameters": [ { "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": "排序字段", "required": false, "type": "string", "x-example": "createdAt" }, { "name": "sortDir", "in": "query", "description": "排序方向：asc/desc", "required": false, "type": "string", "x-example": "desc" }, { "name": "staffType", "in": "query", "description": "人员类型筛选", "required": false, "type": "string", "x-example": "GUIDE" }, { "name": "status", "in": "query", "description": "状态筛选：0=下架 1=上架", "required": false, "type": "integer", "format": "int32", "x-example": 1 }, { "name": "tagId", "in": "query", "description": "标签ID（单个）", "required": false, "type": "integer", "format": "int64" }, { "name": "tagIds", "in": "query", "description": "标签ID列表（逗号分隔）", "required": false, "type": "string", "x-example": "1,2,3" } ], "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/staff/tag": { "post": { "tags": [ "服务人员标签管理" ], "summary": "创建标签", "description": "创建预设标签，标签名不可重复。", "operationId": "createTagUsingPOST_7", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/staff/tag/adhoc": { "post": { "tags": [ "服务人员标签管理" ], "summary": "解析自定义标签", "description": "按名称查找或自动创建标签。", "operationId": "resolveAdHocTagUsingPOST_7", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "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/staff/tag/{tagId}": { "put": { "tags": [ "服务人员标签管理" ], "summary": "更新标签", "description": "修改标签名称或颜色。", "operationId": "updateTagUsingPUT_7", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签更新请求", "required": false, "schema": { "$ref": "#/definitions/服务人员标签更新请求", "originalRef": "服务人员标签更新请求" } }, { "name": "tagId", "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" }, "delete": { "tags": [ "服务人员标签管理" ], "summary": "删除标签", "description": "删除标签并解除所有人员与该标签的关联。", "operationId": "deleteTagUsingDELETE_7", "produces": [ "*/*" ], "parameters": [ { "name": "tagId", "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/staff/tags": { "get": { "tags": [ "服务人员标签管理" ], "summary": "预设标签列表（分页）", "description": "分页查询服务人员标签库，支持按关键词搜索。", "operationId": "listManagedTagsUsingGET_7", "produces": [ "*/*" ], "parameters": [ { "name": "keyword", "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 } ], "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/staff/tags/all": { "get": { "tags": [ "服务人员标签管理" ], "summary": "全部标签列表", "description": "不分页返回所有标签，用于人员编辑时的标签选择。", "operationId": "listAllTagsUsingGET_7", "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/staff/type/{staffType}/prices": { "get": { "tags": [ "服务人员价格日历" ], "summary": "查询价格日历（按人员类型）", "description": "按月查询指定人员类型的每日服务费用和可调度状态。注意：价格日历按人员类型维度管理，非按个人维度。同一类型的所有人员共享同一套价格。\n\n**关联字典**：\n- staff_type（人员类型）→ staffType路径参数", "operationId": "getPriceCalendarUsingGET_6", "produces": [ "*/*" ], "parameters": [ { "name": "month", "in": "query", "description": "月份", "required": false, "type": "integer", "format": "int32", "allowEmptyValue": false }, { "name": "staffType", "in": "path", "description": "人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER", "required": false, "type": "string" }, { "name": "year", "in": "query", "description": "年份", "required": false, "type": "integer", "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" }, "put": { "tags": [ "服务人员价格日历" ], "summary": "批量设置价格（按人员类型）", "description": "在指定日期范围内批量设置该类型人员的服务成本价和可调度状态。\n\n**关联字典**：\n- staff_type（人员类型）→ staffType路径参数", "operationId": "batchSetPricesUsingPUT_6", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历设置请求", "required": false, "schema": { "$ref": "#/definitions/服务人员价格日历设置请求", "originalRef": "服务人员价格日历设置请求" } }, { "name": "staffType", "in": "path", "description": "人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER", "required": false, "type": "string" } ], "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": "删除指定日期范围内该类型人员的价格记录。日期格式：yyyy-MM-dd。\n\n**关联字典**：\n- staff_type（人员类型）→ staffType路径参数", "operationId": "deletePricesUsingDELETE_6", "produces": [ "*/*" ], "parameters": [ { "name": "endDate", "in": "query", "description": "结束日期", "required": false, "type": "string", "format": "date", "allowEmptyValue": false }, { "name": "staffType", "in": "path", "description": "人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER", "required": false, "type": "string" }, { "name": "startDate", "in": "query", "description": "开始日期", "required": false, "type": "string", "format": "date", "allowEmptyValue": false } ], "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/staff/type/{staffType}/prices/batch-status": { "put": { "tags": [ "服务人员价格日历" ], "summary": "批量修改调度状态（按人员类型）", "description": "批量修改日期范围内的可调度状态，不影响价格。\n\n**关联字典**：\n- staff_type（人员类型）→ staffType路径参数", "operationId": "batchUpdateStatusUsingPUT_13", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "价格日历状态请求", "required": false, "schema": { "$ref": "#/definitions/服务人员价格日历状态变更请求", "originalRef": "服务人员价格日历状态变更请求" } }, { "name": "staffType", "in": "path", "description": "人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER", "required": false, "type": "string" } ], "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/staff/{staffId}": { "get": { "tags": [ "服务人员管理" ], "summary": "服务人员详情", "description": "获取服务人员完整信息，包含素材URL、标签、技能描述等。\n\n**关联字典**：\n- staff_type：人员类型（详情显示）\n- guide_level：导游等级（详情显示）\n- driver_license_type：驾照类型（详情显示）\n- language：语言能力（详情显示）\n- guide_specialty：导游专长（详情显示）\n- guide_service_area：服务区域（详情显示）", "operationId": "getStaffUsingGET", "produces": [ "*/*" ], "parameters": [ { "name": "staffId", "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- staff_type：人员类型（表单选择）\n- guide_level：导游等级（表单选择）\n- driver_license_type：驾照类型（表单选择）\n- language：语言能力（表单多选）\n- guide_specialty：导游专长（表单多选）\n- guide_service_area：服务区域（表单多选）", "operationId": "updateStaffUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "服务人员更新请求", "required": false, "schema": { "$ref": "#/definitions/服务人员更新请求", "originalRef": "服务人员更新请求" } }, { "name": "staffId", "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" }, "delete": { "tags": [ "服务人员管理" ], "summary": "删除服务人员", "description": "软删除服务人员。仅SUPER_ADMIN或创建者可操作。", "operationId": "deleteStaffUsingDELETE", "produces": [ "*/*" ], "parameters": [ { "name": "staffId", "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/staff/{staffId}/status": { "put": { "tags": [ "服务人员管理" ], "summary": "更新状态", "description": "直接修改人员状态（跳过审批），仅限SUPER_ADMIN。状态值：0=下架，1=上架。", "operationId": "updateStatusUsingPUT_7", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "状态请求体", "required": false, "schema": { "$ref": "#/definitions/人员状态请求", "originalRef": "人员状态请求" } }, { "name": "staffId", "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/staff/{staffId}/submit-approval": { "post": { "tags": [ "服务人员管理" ], "summary": "提交审批", "description": "向企微OA提交人员启用/禁用审批。targetStatus=1申请启用，targetStatus=2申请禁用。返回审批单号spNo。", "operationId": "submitApprovalUsingPOST_8", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "审批提交请求体", "required": false, "schema": { "$ref": "#/definitions/人员审批提交请求", "originalRef": "人员审批提交请求" } }, { "name": "staffId", "in": "path", "description": "人员ID", "required": false, "type": "integer", "format": "int64" } ], "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/staff/{staffId}/tags": { "put": { "tags": [ "服务人员标签管理" ], "summary": "设置人员标签", "description": "全量替换指定人员的标签列表。", "operationId": "updateStaffTagsUsingPUT", "consumes": [ "application/json" ], "produces": [ "*/*" ], "parameters": [ { "in": "body", "name": "request", "description": "标签ID列表请求", "required": false, "schema": { "$ref": "#/definitions/设置人员标签请求", "originalRef": "设置人员标签请求" } }, { "name": "staffId", "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" } } }, "definitions": { "Map«string,string»": { "type": "object", "title": "Map«string,string»", "additionalProperties": { "type": "string" } }, "价格日历批量设置请求": { "type": "object", "required": [ "costPrice", "endDate", "startDate" ], "properties": { "costPrice": { "type": "number", "example": 150.0, "description": "成本价（元）" }, "endDate": { "type": "string", "example": "2026-03-31", "description": "结束日期" }, "excludeDates": { "type": "array", "example": [ "2026-03-08", "2026-03-15" ], "description": "排除的日期列表", "items": { "type": "string" } }, "remark": { "type": "string", "example": "春季特价", "description": "备注" }, "selectedWeekdays": { "type": "array", "example": [ 1, 2, 3, 4, 5 ], "description": "选中的星期（1=周一...7=周日），为空时不做过滤", "items": { "type": "integer", "format": "int32" } }, "startDate": { "type": "string", "example": "2026-03-01", "description": "开始日期" }, "status": { "type": "string", "example": "AVAILABLE", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "example": 100, "description": "库存数量" }, "weekdayOnly": { "type": "boolean", "example": false, "description": "仅工作日" }, "weekendOnly": { "type": "boolean", "example": false, "description": "仅周末" } }, "title": "价格日历批量设置请求" }, "价格日历日数据": { "type": "object", "properties": { "costPrice": { "type": "number", "description": "成本价（元）" }, "date": { "type": "string", "format": "date", "description": "日期" }, "remark": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "description": "总库存" }, "stockUsed": { "type": "integer", "format": "int32", "description": "已用库存" } }, "title": "价格日历日数据" }, "价格日历月视图": { "type": "object", "properties": { "month": { "type": "integer", "format": "int32", "description": "月份" }, "prices": { "type": "array", "description": "每日价格列表", "items": { "$ref": "#/definitions/价格日历日数据", "originalRef": "价格日历日数据" } }, "scenicId": { "type": "string", "description": "景区ID" }, "scenicName": { "type": "string", "description": "景区名称" }, "stockEnabled": { "type": "boolean", "description": "是否启用库存管理" }, "year": { "type": "integer", "format": "int32", "description": "年份" } }, "title": "价格日历月视图" }, "价格日历状态变更请求": { "type": "object", "required": [ "endDate", "startDate", "status" ], "properties": { "endDate": { "type": "string", "example": "2026-03-31", "description": "结束日期" }, "remark": { "type": "string", "description": "备注" }, "startDate": { "type": "string", "example": "2026-03-01", "description": "开始日期" }, "status": { "type": "string", "example": "CLOSED", "description": "目标状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" } }, "title": "价格日历状态变更请求" }, "分页结果«景区列表项»": { "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/景区列表项", "originalRef": "景区列表项" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«景区列表项»" }, "分页结果«景区标签»": { "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/景区标签", "originalRef": "景区标签" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«景区标签»" }, "审批提交请求": { "type": "object", "required": [ "reason", "targetStatus" ], "properties": { "reason": { "type": "string", "example": "内容审核完毕，申请上架", "description": "审批理由" }, "targetStatus": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "审批提交请求" }, "景区列表项": { "type": "object", "properties": { "approvalNo": { "type": "string", "description": "审批编号（审批中时有值）" }, "cityName": { "type": "string", "description": "所在城市" }, "contactPerson": { "type": "string", "description": "联系人姓名" }, "contactPhone": { "type": "string", "description": "联系人电话" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "highlights": { "type": "string", "description": "亮点简介" }, "honors": { "type": "array", "description": "荣誉称号列表", "items": { "type": "string" } }, "latitude": { "type": "number", "description": "纬度" }, "longitude": { "type": "number", "description": "经度" }, "name": { "type": "string", "description": "景区名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "rating": { "type": "number", "description": "评分" }, "reviewCount": { "type": "integer", "format": "int32", "description": "评论数" }, "scenicId": { "type": "string", "description": "景区ID" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/景区标签", "originalRef": "景区标签" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "景区列表项" }, "景区创建请求": { "type": "object", "required": [ "city", "cityName", "latitude", "longitude", "name", "province" ], "properties": { "address": { "type": "string", "example": "西湖风景名胜区", "description": "详细地址" }, "arrangement": { "type": "string", "description": "行程安排（富文本JSON）" }, "backupContactPerson": { "type": "string", "description": "备用联系人姓名" }, "backupContactPhone": { "type": "string", "description": "备用联系人电话" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "city": { "type": "string", "example": "杭州市", "description": "城市（行政区划）" }, "cityName": { "type": "string", "example": "杭州", "description": "所在城市（展示用）" }, "closedDay": { "type": "string", "example": "每周一", "description": "闭园日" }, "contactPerson": { "type": "string", "example": "张三", "description": "联系人姓名" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系人电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "cultureExperience": { "type": "string", "description": "文化体验（富文本JSON）" }, "description": { "type": "string", "description": "景区描述" }, "detailContent": { "type": "string", "description": "详情内容（富文本JSON）" }, "district": { "type": "string", "example": "西湖区", "description": "区/县" }, "facilities": { "type": "array", "example": [ "parking", "wifi", "toilet" ], "description": "设施编码列表", "items": { "type": "string" } }, "featureIntro": { "type": "string", "description": "特色介绍（富文本JSON）" }, "highlightSpots": { "type": "string", "description": "亮点景点（富文本JSON）" }, "highlights": { "type": "string", "example": "湖光山色，人间天堂", "description": "亮点简介" }, "honors": { "type": "array", "example": [ "5A级景区", "世界遗产" ], "description": "荣誉称号列表", "items": { "type": "string" } }, "interactiveExperience": { "type": "string", "description": "互动体验（富文本JSON）" }, "latitude": { "type": "number", "example": 30.2617, "description": "纬度" }, "longitude": { "type": "number", "example": 120.1536, "description": "经度" }, "name": { "type": "string", "example": "杭州西湖", "description": "景区名称" }, "openTime": { "type": "string", "example": "08:00-17:30", "description": "开放时间" }, "photographyGuide": { "type": "string", "description": "摄影指南（富文本JSON）" }, "province": { "type": "string", "example": "浙江省", "description": "省份" }, "sceneryExperience": { "type": "string", "description": "风景体验（富文本JSON）" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，越大越靠前" }, "status": { "type": "integer", "format": "int32", "example": 0, "description": "状态：0=下架 1=上架" }, "travelPrep": { "type": "string", "description": "出行准备（富文本JSON）" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "景区创建请求" }, "景区季节保存请求": { "type": "object", "required": [ "monthEnd", "monthStart" ], "properties": { "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "季节描述" }, "highlights": { "type": "string", "description": "季节亮点" }, "monthEnd": { "type": "integer", "format": "int32", "example": 5, "description": "结束月份（1-12）" }, "monthStart": { "type": "integer", "format": "int32", "example": 3, "description": "开始月份（1-12）" }, "playGuide": { "type": "string", "description": "游玩攻略（富文本JSON）" }, "seasonName": { "type": "string", "example": "樱花季", "description": "季节别名" }, "tips": { "type": "string", "description": "温馨提示" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "景区季节保存请求" }, "景区季节内容": { "type": "object", "properties": { "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "轮播图URL列表", "items": { "type": "string" } }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "description": { "type": "string", "description": "季节描述" }, "highlights": { "type": "string", "description": "季节亮点" }, "monthEnd": { "type": "integer", "format": "int32", "description": "结束月份" }, "monthStart": { "type": "integer", "format": "int32", "description": "开始月份" }, "playGuide": { "type": "string", "description": "游玩攻略（富文本JSON）" }, "scenicId": { "type": "string", "description": "景区ID" }, "seasonId": { "type": "string", "description": "季节ID" }, "seasonName": { "type": "string", "description": "季节别名" }, "seasonType": { "type": "string", "description": "季节类型：spring/summer/autumn/winter" }, "tips": { "type": "string", "description": "温馨提示" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } } }, "title": "景区季节内容" }, "景区批量删除请求": { "type": "object", "required": [ "scenicIds" ], "properties": { "scenicIds": { "type": "array", "description": "景区ID列表", "items": { "type": "string" } } }, "title": "景区批量删除请求" }, "景区批量标签操作请求": { "type": "object", "required": [ "scenicIds" ], "properties": { "addTagIds": { "type": "array", "description": "要添加的标签ID列表", "items": { "type": "string" } }, "removeTagIds": { "type": "array", "description": "要移除的标签ID列表", "items": { "type": "string" } }, "scenicIds": { "type": "array", "description": "景区ID列表", "items": { "type": "string" } } }, "title": "景区批量标签操作请求" }, "景区更新请求": { "type": "object", "properties": { "address": { "type": "string", "description": "详细地址" }, "arrangement": { "type": "string", "description": "行程安排（富文本JSON）" }, "backupContactPerson": { "type": "string", "description": "备用联系人姓名" }, "backupContactPhone": { "type": "string", "description": "备用联系人电话" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "city": { "type": "string", "example": "杭州市", "description": "城市（行政区划）" }, "cityName": { "type": "string", "example": "杭州", "description": "所在城市（展示用）" }, "closedDay": { "type": "string", "example": "每周一", "description": "闭园日" }, "contactPerson": { "type": "string", "description": "联系人姓名" }, "contactPhone": { "type": "string", "description": "联系人电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "cultureExperience": { "type": "string", "description": "文化体验（富文本JSON）" }, "description": { "type": "string", "description": "景区描述" }, "detailContent": { "type": "string", "description": "详情内容（富文本JSON）" }, "district": { "type": "string", "example": "西湖区", "description": "区/县" }, "facilities": { "type": "array", "description": "设施编码列表", "items": { "type": "string" } }, "featureIntro": { "type": "string", "description": "特色介绍（富文本JSON）" }, "highlightSpots": { "type": "string", "description": "亮点景点（富文本JSON）" }, "highlights": { "type": "string", "description": "亮点简介" }, "honors": { "type": "array", "description": "荣誉称号列表", "items": { "type": "string" } }, "interactiveExperience": { "type": "string", "description": "互动体验（富文本JSON）" }, "latitude": { "type": "number", "example": 30.2617, "description": "纬度" }, "longitude": { "type": "number", "example": 120.1536, "description": "经度" }, "name": { "type": "string", "example": "杭州西湖", "description": "景区名称" }, "openTime": { "type": "string", "example": "08:00-17:30", "description": "开放时间" }, "photographyGuide": { "type": "string", "description": "摄影指南（富文本JSON）" }, "province": { "type": "string", "example": "浙江省", "description": "省份" }, "sceneryExperience": { "type": "string", "description": "风景体验（富文本JSON）" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重，越大越靠前" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "travelPrep": { "type": "string", "description": "出行准备（富文本JSON）" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "景区更新请求" }, "景区标签": { "type": "object", "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色（十六进制）" }, "tagId": { "type": "string", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：0=自定义 1=系统预设" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "景区标签" }, "景区标签更新请求": { "type": "object", "properties": { "tagIds": { "type": "array", "description": "标签ID列表（全量替换）", "items": { "type": "string" } } }, "title": "景区标签更新请求" }, "景区状态变更请求": { "type": "object", "required": [ "status" ], "properties": { "scenicIds": { "type": "array", "description": "景区ID列表", "items": { "type": "string" } }, "status": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "景区状态变更请求" }, "景区详情": { "type": "object", "properties": { "address": { "type": "string", "description": "详细地址" }, "arrangement": { "type": "string", "description": "行程安排（富文本JSON）" }, "backupContactPerson": { "type": "string", "description": "备用联系人姓名" }, "backupContactPhone": { "type": "string", "description": "备用联系人电话" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "轮播图URL列表", "items": { "type": "string" } }, "city": { "type": "string", "description": "城市（行政区划）" }, "cityName": { "type": "string", "description": "所在城市（展示用）" }, "closedDay": { "type": "string", "description": "闭园日" }, "contactPerson": { "type": "string", "description": "联系人姓名" }, "contactPhone": { "type": "string", "description": "联系人电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建人ID" }, "createdByName": { "type": "string", "description": "创建人姓名" }, "cultureExperience": { "type": "string", "description": "文化体验（富文本JSON）" }, "description": { "type": "string", "description": "景区描述" }, "detailContent": { "type": "string", "description": "详情内容（富文本JSON）" }, "district": { "type": "string", "description": "区/县" }, "facilities": { "type": "array", "description": "设施编码列表", "items": { "type": "string" } }, "facilityNames": { "type": "array", "description": "设施名称列表", "items": { "type": "string" } }, "featureIntro": { "type": "string", "description": "特色介绍（富文本JSON）" }, "highlightSpots": { "type": "string", "description": "亮点景点（富文本JSON）" }, "highlights": { "type": "string", "description": "亮点简介" }, "honors": { "type": "array", "description": "荣誉称号列表", "items": { "type": "string" } }, "interactiveExperience": { "type": "string", "description": "互动体验（富文本JSON）" }, "latitude": { "type": "number", "description": "纬度" }, "longitude": { "type": "number", "description": "经度" }, "name": { "type": "string", "description": "景区名称" }, "openTime": { "type": "string", "description": "开放时间" }, "photographyGuide": { "type": "string", "description": "摄影指南（富文本JSON）" }, "province": { "type": "string", "description": "省份" }, "rating": { "type": "number", "description": "评分" }, "reviewCount": { "type": "integer", "format": "int32", "description": "评论数" }, "sceneryExperience": { "type": "string", "description": "风景体验（富文本JSON）" }, "scenicId": { "type": "string", "description": "景区ID" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/景区标签", "originalRef": "景区标签" } }, "travelPrep": { "type": "string", "description": "出行准备（富文本JSON）" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "景区详情" }, "标签创建请求": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "example": "#409EFF", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "热门", "description": "标签名称" } }, "title": "标签创建请求" }, "标签更新请求": { "type": "object", "properties": { "tagColor": { "type": "string", "example": "#409EFF", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "热门", "description": "标签名称" } }, "title": "标签更新请求" }, "统一响应结果«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«景区标签»»": { "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«景区标签»»" }, "统一响应结果«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»»" }, "统一响应结果«Void»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«Void»" }, "统一响应结果«价格日历月视图»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/价格日历月视图", "originalRef": "价格日历月视图" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«价格日历月视图»" }, "统一响应结果«分页结果«景区列表项»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«景区列表项»", "originalRef": "分页结果«景区列表项»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«景区列表项»»" }, "统一响应结果«分页结果«景区标签»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«景区标签»", "originalRef": "分页结果«景区标签»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«景区标签»»" }, "统一响应结果«景区季节内容»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/景区季节内容", "originalRef": "景区季节内容" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«景区季节内容»" }, "统一响应结果«景区标签»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/景区标签", "originalRef": "景区标签" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«景区标签»" }, "统一响应结果«景区详情»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/景区详情", "originalRef": "景区详情" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«景区详情»" }, "分页结果«餐厅列表视图»": { "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/餐厅列表视图", "originalRef": "餐厅列表视图" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«餐厅列表视图»" }, "分页结果«餐厅标签视图»": { "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/餐厅标签视图", "originalRef": "餐厅标签视图" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«餐厅标签视图»" }, "统一响应结果«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«餐厅标签视图»»" }, "统一响应结果«分页结果«餐厅列表视图»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«餐厅列表视图»", "originalRef": "分页结果«餐厅列表视图»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«餐厅列表视图»»" }, "统一响应结果«分页结果«餐厅标签视图»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«餐厅标签视图»", "originalRef": "分页结果«餐厅标签视图»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«餐厅标签视图»»" }, "统一响应结果«餐厅标签视图»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/餐厅标签视图", "originalRef": "餐厅标签视图" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«餐厅标签视图»" }, "统一响应结果«餐厅详情视图»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/餐厅详情视图", "originalRef": "餐厅详情视图" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«餐厅详情视图»" }, "餐厅列表视图": { "type": "object", "properties": { "approvalNo": { "type": "string", "description": "审批编号" }, "categoryCode": { "type": "string", "description": "分类编码" }, "categoryName": { "type": "string", "description": "分类名称" }, "cityName": { "type": "string", "description": "城市名称（纯文本）" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "cuisineType": { "type": "string", "description": "菜系类型编码" }, "cuisineTypeName": { "type": "string", "description": "菜系类型名称" }, "highlights": { "type": "string", "description": "亮点摘要" }, "name": { "type": "string", "description": "餐厅名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "pricePerPerson": { "type": "number", "description": "人均消费（元）" }, "rating": { "type": "number", "description": "评分" }, "recommended": { "type": "integer", "format": "int32", "description": "是否推荐：0=否 1=是" }, "restaurantId": { "type": "string", "description": "餐厅ID" }, "reviewCount": { "type": "integer", "format": "int32", "description": "评论数" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/餐厅标签视图", "originalRef": "餐厅标签视图" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "餐厅列表视图" }, "餐厅创建请求": { "type": "object", "required": [ "categoryCode", "city", "cityName", "latitude", "longitude", "name", "province" ], "properties": { "address": { "type": "string", "example": "北京中路100号", "description": "详细地址" }, "arrangement": { "type": "string", "description": "座位布局说明" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "businessHours": { "type": "string", "example": "10:00-22:00", "description": "营业时间" }, "capacity": { "type": "integer", "format": "int32", "example": 80, "description": "容纳人数" }, "categoryCode": { "type": "string", "example": "TIBETAN", "description": "分类编码" }, "city": { "type": "string", "example": "拉萨市", "description": "城市" }, "cityName": { "type": "string", "example": "拉萨", "description": "城市名称（纯文本输入）" }, "closedDay": { "type": "string", "example": "每周一", "description": "休息日" }, "coverMaterialId": { "type": "string", "example": 1001, "description": "封面素材ID" }, "cuisineType": { "type": "string", "example": "TIBETAN", "description": "菜系类型" }, "description": { "type": "string", "description": "餐厅描述" }, "district": { "type": "string", "example": "城关区", "description": "区县" }, "environmentType": { "type": "string", "example": "INDOOR", "description": "环境类型" }, "facilities": { "type": "array", "description": "设施列表", "items": { "type": "string" } }, "featureIntro": { "type": "string", "description": "图文详情（JSON格式）" }, "featuredMenu": { "type": "string", "description": "招牌菜单（JSON格式）" }, "groupSizeMax": { "type": "integer", "format": "int32", "example": 20, "description": "最多接待人数" }, "groupSizeMin": { "type": "integer", "format": "int32", "example": 1, "description": "最少成行人数" }, "hasPrivateRoom": { "type": "integer", "format": "int32", "example": 1, "description": "是否有包间：0=无 1=有" }, "highlights": { "type": "string", "example": "地道藏餐、酥油茶、糌粑", "description": "亮点摘要" }, "latitude": { "type": "number", "example": 29.66, "description": "纬度" }, "longitude": { "type": "number", "example": 91.132, "description": "经度" }, "minAdvanceHours": { "type": "integer", "format": "int32", "example": 2, "description": "最少提前预约小时数" }, "name": { "type": "string", "example": "云端藏餐", "description": "餐厅名称" }, "phone": { "type": "string", "example": "0891-6812345", "description": "联系电话" }, "pricePerPerson": { "type": "number", "example": 88.0, "description": "人均消费（元）" }, "province": { "type": "string", "example": "西藏自治区", "description": "省份" }, "recommended": { "type": "integer", "format": "int32", "example": 0, "description": "是否推荐：0=否 1=是" }, "reservationRequired": { "type": "integer", "format": "int32", "example": 0, "description": "是否需要预约：0=否 1=是" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重（数字越大越靠前）" }, "subtitle": { "type": "string", "example": "正宗藏式风味体验", "description": "副标题" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "餐厅创建请求" }, "餐厅审批提交请求": { "type": "object", "required": [ "reason", "targetStatus" ], "properties": { "reason": { "type": "string", "example": "餐厅信息已完善，申请上架", "description": "审批理由" }, "targetStatus": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "餐厅审批提交请求" }, "餐厅批量删除请求": { "type": "object", "required": [ "restaurantIds" ], "properties": { "restaurantIds": { "type": "array", "example": [ "1", "2", "3" ], "description": "餐厅ID列表", "items": { "type": "string" } } }, "title": "餐厅批量删除请求" }, "餐厅批量标签操作请求": { "type": "object", "required": [ "restaurantIds" ], "properties": { "addTagIds": { "type": "array", "example": [ "10", "11" ], "description": "要添加的标签ID列表", "items": { "type": "string" } }, "removeTagIds": { "type": "array", "example": [ "12" ], "description": "要移除的标签ID列表", "items": { "type": "string" } }, "restaurantIds": { "type": "array", "example": [ "1", "2" ], "description": "餐厅ID列表", "items": { "type": "string" } } }, "title": "餐厅批量标签操作请求" }, "餐厅更新请求": { "type": "object", "properties": { "address": { "type": "string", "example": "北京中路100号", "description": "详细地址" }, "arrangement": { "type": "string", "description": "座位布局说明" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "businessHours": { "type": "string", "example": "10:00-22:00", "description": "营业时间" }, "capacity": { "type": "integer", "format": "int32", "example": 80, "description": "容纳人数" }, "categoryCode": { "type": "string", "example": "TIBETAN", "description": "分类编码" }, "city": { "type": "string", "example": "拉萨市", "description": "城市" }, "cityName": { "type": "string", "example": "拉萨", "description": "城市名称（纯文本输入）" }, "closedDay": { "type": "string", "example": "每周一", "description": "休息日" }, "coverMaterialId": { "type": "string", "example": 1001, "description": "封面素材ID" }, "cuisineType": { "type": "string", "example": "TIBETAN", "description": "菜系类型" }, "description": { "type": "string", "description": "餐厅描述" }, "district": { "type": "string", "example": "城关区", "description": "区县" }, "environmentType": { "type": "string", "example": "INDOOR", "description": "环境类型" }, "facilities": { "type": "array", "description": "设施列表", "items": { "type": "string" } }, "featureIntro": { "type": "string", "description": "图文详情（JSON格式）" }, "featuredMenu": { "type": "string", "description": "招牌菜单（JSON格式）" }, "groupSizeMax": { "type": "integer", "format": "int32", "example": 20, "description": "最多接待人数" }, "groupSizeMin": { "type": "integer", "format": "int32", "example": 1, "description": "最少成行人数" }, "hasPrivateRoom": { "type": "integer", "format": "int32", "example": 1, "description": "是否有包间：0=无 1=有" }, "highlights": { "type": "string", "example": "地道藏餐、酥油茶、糌粑", "description": "亮点摘要" }, "latitude": { "type": "number", "example": 29.66, "description": "纬度" }, "longitude": { "type": "number", "example": 91.132, "description": "经度" }, "minAdvanceHours": { "type": "integer", "format": "int32", "example": 2, "description": "最少提前预约小时数" }, "name": { "type": "string", "example": "云端藏餐", "description": "餐厅名称" }, "phone": { "type": "string", "example": "0891-6812345", "description": "联系电话" }, "pricePerPerson": { "type": "number", "example": 88.0, "description": "人均消费（元）" }, "province": { "type": "string", "example": "西藏自治区", "description": "省份" }, "recommended": { "type": "integer", "format": "int32", "example": 0, "description": "是否推荐：0=否 1=是" }, "reservationRequired": { "type": "integer", "format": "int32", "example": 0, "description": "是否需要预约：0=否 1=是" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重（数字越大越靠前）" }, "status": { "type": "integer", "format": "int32", "example": 1, "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "example": "正宗藏式风味体验", "description": "副标题" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "餐厅更新请求" }, "餐厅标签创建请求": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "example": "#FF5733", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "藏餐", "description": "标签名称" } }, "title": "餐厅标签创建请求" }, "餐厅标签更新请求": { "type": "object", "properties": { "tagColor": { "type": "string", "example": "#FF5733", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "藏餐", "description": "标签名称" } }, "title": "餐厅标签更新请求" }, "餐厅标签更新请求_1": { "type": "object", "properties": { "tagIds": { "type": "array", "description": "标签ID列表", "items": { "type": "string" } } }, "title": "餐厅标签更新请求_1" }, "餐厅标签视图": { "type": "object", "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色" }, "tagId": { "type": "string", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：1=系统标签 2=自定义标签" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "餐厅标签视图" }, "餐厅状态变更请求": { "type": "object", "required": [ "status" ], "properties": { "restaurantIds": { "type": "array", "description": "餐厅ID列表（批量操作）", "items": { "type": "string" } }, "status": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "餐厅状态变更请求" }, "餐厅详情视图": { "type": "object", "properties": { "address": { "type": "string", "description": "详细地址" }, "arrangement": { "type": "string", "description": "座位布局说明" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "轮播图URL列表", "items": { "type": "string" } }, "businessHours": { "type": "string", "description": "营业时间" }, "capacity": { "type": "integer", "format": "int32", "description": "容纳人数" }, "categoryCode": { "type": "string", "description": "分类编码" }, "categoryName": { "type": "string", "description": "分类名称" }, "city": { "type": "string", "description": "城市" }, "cityName": { "type": "string", "description": "城市名称（纯文本）" }, "closedDay": { "type": "string", "description": "休息日" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建人ID" }, "createdByName": { "type": "string", "description": "创建人姓名" }, "cuisineType": { "type": "string", "description": "菜系类型编码" }, "cuisineTypeName": { "type": "string", "description": "菜系类型名称" }, "description": { "type": "string", "description": "餐厅描述" }, "district": { "type": "string", "description": "区县" }, "environmentType": { "type": "string", "description": "环境类型" }, "facilities": { "type": "array", "description": "设施编码列表", "items": { "type": "string" } }, "facilityNames": { "type": "array", "description": "设施名称列表", "items": { "type": "string" } }, "featureIntro": { "type": "string", "description": "图文详情（JSON格式）" }, "featuredMenu": { "type": "string", "description": "招牌菜单（JSON格式）" }, "groupSizeMax": { "type": "integer", "format": "int32", "description": "最多接待人数" }, "groupSizeMin": { "type": "integer", "format": "int32", "description": "最少成行人数" }, "hasPrivateRoom": { "type": "integer", "format": "int32", "description": "是否有包间：0=无 1=有" }, "highlights": { "type": "string", "description": "亮点摘要" }, "latitude": { "type": "number", "description": "纬度" }, "longitude": { "type": "number", "description": "经度" }, "minAdvanceHours": { "type": "integer", "format": "int32", "description": "最少提前预约小时数" }, "name": { "type": "string", "description": "餐厅名称" }, "phone": { "type": "string", "description": "联系电话" }, "pricePerPerson": { "type": "number", "description": "人均消费（元）" }, "province": { "type": "string", "description": "省份" }, "rating": { "type": "number", "description": "评分" }, "recommended": { "type": "integer", "format": "int32", "description": "是否推荐：0=否 1=是" }, "reservationRequired": { "type": "integer", "format": "int32", "description": "是否需要预约：0=否 1=是" }, "restaurantId": { "type": "string", "description": "餐厅ID" }, "reviewCount": { "type": "integer", "format": "int32", "description": "评论数" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/餐厅标签视图", "originalRef": "餐厅标签视图" } }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "餐厅详情视图" }, "分页结果«备品列表视图»": { "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/备品列表视图", "originalRef": "备品列表视图" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«备品列表视图»" }, "分页结果«备品标签视图»": { "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/备品标签视图", "originalRef": "备品标签视图" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«备品标签视图»" }, "备品列表视图": { "type": "object", "properties": { "approvalNo": { "type": "string", "description": "审批编号" }, "basePrice": { "type": "number", "description": "基础单价（元）" }, "billingType": { "type": "string", "description": "计费方式编码" }, "billingTypeName": { "type": "string", "description": "计费方式名称" }, "categoryCode": { "type": "string", "description": "分类编码" }, "categoryName": { "type": "string", "description": "分类名称" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "highlights": { "type": "string", "description": "亮点摘要" }, "name": { "type": "string", "description": "备品名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "recommended": { "type": "integer", "format": "int32", "description": "是否推荐：0=否 1=是" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "suppliesId": { "type": "string", "description": "备品ID" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/备品标签视图", "originalRef": "备品标签视图" } }, "unit": { "type": "string", "description": "计量单位" }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "备品列表视图" }, "备品创建请求": { "type": "object", "required": [ "basePrice", "billingType", "categoryCode", "name" ], "properties": { "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "example": 25.0, "description": "基础单价（元）" }, "billingType": { "type": "string", "example": "PER_ITEM", "description": "计费方式：PER_ITEM=按件 PER_DAY=按天" }, "brand": { "type": "string", "example": "Black Diamond", "description": "品牌" }, "categoryCode": { "type": "string", "example": "OUTDOOR_GEAR", "description": "分类编码" }, "coverMaterialId": { "type": "string", "example": 1001, "description": "封面素材ID" }, "description": { "type": "string", "description": "备品描述" }, "featureIntro": { "type": "string", "description": "图文详情（JSON格式）" }, "highlights": { "type": "string", "example": "超轻碳纤维材质，可折叠收纳", "description": "亮点摘要" }, "includes": { "type": "array", "description": "包含物品清单", "items": { "type": "string" } }, "model": { "type": "string", "example": "Trail Ergo Cork", "description": "型号" }, "name": { "type": "string", "example": "登山杖", "description": "备品名称" }, "recommended": { "type": "integer", "format": "int32", "example": 0, "description": "是否推荐：0=否 1=是" }, "sizeOptions": { "type": "array", "description": "可选尺码列表", "items": { "type": "string" } }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重（数字越大越靠前）" }, "specifications": { "type": "string", "description": "规格参数（JSON格式）" }, "subtitle": { "type": "string", "example": "碳纤维轻量登山杖", "description": "副标题" }, "unit": { "type": "string", "example": "根", "description": "计量单位" }, "usageNotes": { "type": "string", "description": "使用注意事项" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "weight": { "type": "number", "example": 0.35, "description": "重量（kg）" } }, "title": "备品创建请求" }, "备品审批提交请求": { "type": "object", "required": [ "reason", "targetStatus" ], "properties": { "reason": { "type": "string", "example": "备品信息已完善，申请上架", "description": "审批理由" }, "targetStatus": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "备品审批提交请求" }, "备品批量删除请求": { "type": "object", "required": [ "suppliesIds" ], "properties": { "suppliesIds": { "type": "array", "example": [ "1", "2", "3" ], "description": "备品ID列表", "items": { "type": "string" } } }, "title": "备品批量删除请求" }, "备品批量标签操作请求": { "type": "object", "required": [ "suppliesIds" ], "properties": { "addTagIds": { "type": "array", "example": [ "10", "11" ], "description": "要添加的标签ID列表", "items": { "type": "string" } }, "removeTagIds": { "type": "array", "example": [ "12" ], "description": "要移除的标签ID列表", "items": { "type": "string" } }, "suppliesIds": { "type": "array", "example": [ "1", "2" ], "description": "备品ID列表", "items": { "type": "string" } } }, "title": "备品批量标签操作请求" }, "备品更新请求": { "type": "object", "properties": { "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "example": 25.0, "description": "基础单价（元）" }, "billingType": { "type": "string", "example": "PER_ITEM", "description": "计费方式：PER_ITEM=按件 PER_DAY=按天" }, "brand": { "type": "string", "example": "Black Diamond", "description": "品牌" }, "categoryCode": { "type": "string", "example": "OUTDOOR_GEAR", "description": "分类编码" }, "coverMaterialId": { "type": "string", "example": 1001, "description": "封面素材ID" }, "description": { "type": "string", "description": "备品描述" }, "featureIntro": { "type": "string", "description": "图文详情（JSON格式）" }, "highlights": { "type": "string", "example": "超轻碳纤维材质，可折叠收纳", "description": "亮点摘要" }, "includes": { "type": "array", "description": "包含物品清单", "items": { "type": "string" } }, "model": { "type": "string", "example": "Trail Ergo Cork", "description": "型号" }, "name": { "type": "string", "example": "登山杖", "description": "备品名称" }, "recommended": { "type": "integer", "format": "int32", "example": 0, "description": "是否推荐：0=否 1=是" }, "sizeOptions": { "type": "array", "description": "可选尺码列表", "items": { "type": "string" } }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重（数字越大越靠前）" }, "specifications": { "type": "string", "description": "规格参数（JSON格式）" }, "status": { "type": "integer", "format": "int32", "example": 1, "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "example": "碳纤维轻量登山杖", "description": "副标题" }, "unit": { "type": "string", "example": "根", "description": "计量单位" }, "usageNotes": { "type": "string", "description": "使用注意事项" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "weight": { "type": "number", "example": 0.35, "description": "重量（kg）" } }, "title": "备品更新请求" }, "备品标签创建请求": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "example": "#FF5733", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "户外装备", "description": "标签名称" } }, "title": "备品标签创建请求" }, "备品标签更新请求": { "type": "object", "properties": { "tagColor": { "type": "string", "example": "#FF5733", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "户外装备", "description": "标签名称" } }, "title": "备品标签更新请求" }, "备品标签更新请求_1": { "type": "object", "properties": { "tagIds": { "type": "array", "description": "标签ID列表", "items": { "type": "string" } } }, "title": "备品标签更新请求_1" }, "备品标签视图": { "type": "object", "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色" }, "tagId": { "type": "string", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：1=系统标签 2=自定义标签" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "备品标签视图" }, "备品状态变更请求": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" }, "suppliesIds": { "type": "array", "description": "备品ID列表（批量操作）", "items": { "type": "string" } } }, "title": "备品状态变更请求" }, "备品详情视图": { "type": "object", "properties": { "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "轮播图URL列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "description": "基础单价（元）" }, "billingType": { "type": "string", "description": "计费方式编码" }, "billingTypeName": { "type": "string", "description": "计费方式名称" }, "brand": { "type": "string", "description": "品牌" }, "categoryCode": { "type": "string", "description": "分类编码" }, "categoryName": { "type": "string", "description": "分类名称" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建人ID" }, "createdByName": { "type": "string", "description": "创建人姓名" }, "description": { "type": "string", "description": "备品描述" }, "featureIntro": { "type": "string", "description": "图文详情（JSON格式）" }, "highlights": { "type": "string", "description": "亮点摘要" }, "includes": { "type": "array", "description": "包含物品清单", "items": { "type": "string" } }, "model": { "type": "string", "description": "型号" }, "name": { "type": "string", "description": "备品名称" }, "recommended": { "type": "integer", "format": "int32", "description": "是否推荐：0=否 1=是" }, "sizeOptions": { "type": "array", "description": "可选尺码列表", "items": { "type": "string" } }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "specifications": { "type": "string", "description": "规格参数（JSON格式）" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "suppliesId": { "type": "string", "description": "备品ID" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/备品标签视图", "originalRef": "备品标签视图" } }, "unit": { "type": "string", "description": "计量单位" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "usageNotes": { "type": "string", "description": "使用注意事项" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" }, "weight": { "type": "number", "description": "重量（kg）" } }, "title": "备品详情视图" }, "统一响应结果«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«备品标签视图»»" }, "统一响应结果«分页结果«备品列表视图»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«备品列表视图»", "originalRef": "分页结果«备品列表视图»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«备品列表视图»»" }, "统一响应结果«分页结果«备品标签视图»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«备品标签视图»", "originalRef": "分页结果«备品标签视图»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«备品标签视图»»" }, "统一响应结果«备品标签视图»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/备品标签视图", "originalRef": "备品标签视图" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«备品标签视图»" }, "统一响应结果«备品详情视图»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/备品详情视图", "originalRef": "备品详情视图" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«备品详情视图»" }, "分页结果«活动标签视图»": { "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/活动标签视图", "originalRef": "活动标签视图" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«活动标签视图»" }, "分页结果«活动项目列表视图»": { "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/活动项目列表视图", "originalRef": "活动项目列表视图" } }, "total": { "type": "integer", "format": "int32", "example": 100, "description": "总记录数" } }, "title": "分页结果«活动项目列表视图»" }, "活动价格日历日视图": { "type": "object", "properties": { "costPrice": { "type": "number", "description": "成本价（元）" }, "date": { "type": "string", "format": "date", "description": "日期" }, "remark": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "description": "库存数量" }, "stockUsed": { "type": "integer", "format": "int32", "description": "已用库存" } }, "title": "活动价格日历日视图" }, "活动价格日历状态变更请求": { "type": "object", "required": [ "endDate", "startDate", "status" ], "properties": { "endDate": { "type": "string", "example": "2026-03-31", "description": "结束日期" }, "remark": { "type": "string", "example": "临时关闭", "description": "备注" }, "startDate": { "type": "string", "example": "2026-03-01", "description": "开始日期" }, "status": { "type": "string", "example": "CLOSED", "description": "目标状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" } }, "title": "活动价格日历状态变更请求" }, "活动价格日历视图": { "type": "object", "properties": { "activityId": { "type": "string", "description": "活动项目ID" }, "activityName": { "type": "string", "description": "活动项目名称" }, "month": { "type": "integer", "format": "int32", "description": "月份" }, "prices": { "type": "array", "description": "价格日历每日数据列表", "items": { "$ref": "#/definitions/活动价格日历日视图", "originalRef": "活动价格日历日视图" } }, "stockEnabled": { "type": "boolean", "description": "是否启用库存管理" }, "year": { "type": "integer", "format": "int32", "description": "年份" } }, "title": "活动价格日历视图" }, "活动价格日历设置请求": { "type": "object", "required": [ "costPrice", "endDate", "startDate" ], "properties": { "costPrice": { "type": "number", "example": 150.0, "description": "成本价（元）" }, "endDate": { "type": "string", "example": "2026-03-31", "description": "结束日期" }, "excludeDates": { "type": "array", "example": [ "2026-03-08", "2026-03-15" ], "description": "排除日期列表", "items": { "type": "string" } }, "remark": { "type": "string", "example": "旺季价格", "description": "备注" }, "selectedWeekdays": { "type": "array", "example": [ 1, 2, 3, 4, 5 ], "description": "指定星期几（1=周一 7=周日）", "items": { "type": "integer", "format": "int32" } }, "startDate": { "type": "string", "example": "2026-03-01", "description": "开始日期" }, "status": { "type": "string", "example": "AVAILABLE", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "example": 50, "description": "库存数量" }, "weekdayOnly": { "type": "boolean", "example": false, "description": "是否仅工作日" }, "weekendOnly": { "type": "boolean", "example": false, "description": "是否仅周末" } }, "title": "活动价格日历设置请求" }, "活动标签创建请求": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "example": "#FF5733", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "户外探险", "description": "标签名称" } }, "title": "活动标签创建请求" }, "活动标签更新请求": { "type": "object", "properties": { "tagColor": { "type": "string", "example": "#FF5733", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "户外探险", "description": "标签名称" } }, "title": "活动标签更新请求" }, "活动标签视图": { "type": "object", "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色" }, "tagId": { "type": "string", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：1=系统标签 2=自定义标签" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "活动标签视图" }, "活动项目列表视图": { "type": "object", "properties": { "activityId": { "type": "string", "description": "活动项目ID" }, "approvalNo": { "type": "string", "description": "审批编号" }, "billingType": { "type": "string", "description": "计费方式编码" }, "categoryCode": { "type": "string", "description": "分类编码" }, "city": { "type": "string", "description": "城市" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "durationMinutes": { "type": "integer", "format": "int32", "description": "体验时长（分钟）" }, "environmentType": { "type": "string", "description": "环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外" }, "highlights": { "type": "string", "description": "项目亮点" }, "latitude": { "type": "number", "description": "纬度" }, "longitude": { "type": "number", "description": "经度" }, "name": { "type": "string", "description": "项目名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "physicalLevel": { "type": "string", "description": "体力要求：LOW=低 MEDIUM=中 HIGH=高" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/活动标签视图", "originalRef": "活动标签视图" } }, "unit": { "type": "string", "description": "计量单位" }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" }, "weatherDependent": { "type": "integer", "format": "int32", "description": "是否受天气影响：0=否 1=是" } }, "title": "活动项目列表视图" }, "活动项目创建请求": { "type": "object", "required": [ "billingType", "categoryCode", "name" ], "properties": { "address": { "type": "string", "example": "拉萨河谷骑马基地", "description": "详细地址" }, "ageMax": { "type": "integer", "format": "int32", "example": 65, "description": "最大年龄限制" }, "ageMin": { "type": "integer", "format": "int32", "example": 8, "description": "最小年龄限制" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "bestSeason": { "type": "string", "example": "5月-10月", "description": "最佳季节" }, "billingType": { "type": "string", "example": "PER_PERSON", "description": "计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时" }, "categoryCode": { "type": "string", "example": "OUTDOOR", "description": "分类编码" }, "city": { "type": "string", "example": "拉萨市", "description": "城市" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系电话" }, "coverMaterialId": { "type": "string", "example": 1001, "description": "封面素材ID" }, "dailyCapacity": { "type": "integer", "format": "int32", "example": 50, "description": "每日接待上限" }, "description": { "type": "string", "description": "项目描述" }, "district": { "type": "string", "example": "城关区", "description": "区县" }, "durationMinutes": { "type": "integer", "format": "int32", "example": 120, "description": "体验时长（分钟）" }, "environmentType": { "type": "string", "example": "OUTDOOR", "description": "环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外" }, "groupSizeMax": { "type": "integer", "format": "int32", "example": 10, "description": "单次最多人数" }, "groupSizeMin": { "type": "integer", "format": "int32", "example": 2, "description": "最少成行人数" }, "healthNotes": { "type": "string", "description": "健康须知" }, "highlights": { "type": "string", "example": "专业马术教练全程指导", "description": "项目亮点" }, "latitude": { "type": "number", "example": 29.66, "description": "纬度" }, "longitude": { "type": "number", "example": 91.132, "description": "经度" }, "name": { "type": "string", "example": "高原骑马体验", "description": "项目名称" }, "physicalLevel": { "type": "string", "example": "MEDIUM", "description": "体力要求：LOW=低 MEDIUM=中 HIGH=高" }, "providedEquipment": { "type": "string", "description": "提供装备说明" }, "province": { "type": "string", "example": "西藏自治区", "description": "省份" }, "requiredEquipment": { "type": "string", "description": "需自备装备说明" }, "safetyNotes": { "type": "string", "description": "安全须知" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重（数字越大越靠前）" }, "subtitle": { "type": "string", "example": "策马奔腾在雪域高原", "description": "副标题" }, "unit": { "type": "string", "example": "人/次", "description": "计量单位" }, "usageNotes": { "type": "string", "description": "使用注意事项" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "weatherDependent": { "type": "integer", "format": "int32", "example": 1, "description": "是否受天气影响：0=否 1=是" }, "whatExcluded": { "type": "string", "description": "费用不包含说明" }, "whatIncluded": { "type": "string", "description": "费用包含说明" } }, "title": "活动项目创建请求" }, "活动项目审批提交请求": { "type": "object", "required": [ "reason", "targetStatus" ], "properties": { "reason": { "type": "string", "example": "活动信息已完善，申请上架", "description": "审批理由" }, "targetStatus": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "活动项目审批提交请求" }, "活动项目批量删除请求": { "type": "object", "required": [ "activityIds" ], "properties": { "activityIds": { "type": "array", "example": [ "1", "2", "3" ], "description": "活动项目ID列表", "items": { "type": "string" } } }, "title": "活动项目批量删除请求" }, "活动项目批量标签操作请求": { "type": "object", "required": [ "activityIds" ], "properties": { "activityIds": { "type": "array", "example": [ "1", "2" ], "description": "活动项目ID列表", "items": { "type": "string" } }, "addTagIds": { "type": "array", "example": [ "10", "11" ], "description": "要添加的标签ID列表", "items": { "type": "string" } }, "removeTagIds": { "type": "array", "example": [ "12" ], "description": "要移除的标签ID列表", "items": { "type": "string" } } }, "title": "活动项目批量标签操作请求" }, "活动项目更新请求": { "type": "object", "properties": { "address": { "type": "string", "example": "拉萨河谷骑马基地", "description": "详细地址" }, "ageMax": { "type": "integer", "format": "int32", "example": 65, "description": "最大年龄限制" }, "ageMin": { "type": "integer", "format": "int32", "example": 8, "description": "最小年龄限制" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "bestSeason": { "type": "string", "example": "5月-10月", "description": "最佳季节" }, "billingType": { "type": "string", "example": "PER_PERSON", "description": "计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时" }, "categoryCode": { "type": "string", "example": "OUTDOOR", "description": "分类编码" }, "city": { "type": "string", "example": "拉萨市", "description": "城市" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系电话" }, "coverMaterialId": { "type": "string", "example": 1001, "description": "封面素材ID" }, "dailyCapacity": { "type": "integer", "format": "int32", "example": 50, "description": "每日接待上限" }, "description": { "type": "string", "description": "项目描述" }, "district": { "type": "string", "example": "城关区", "description": "区县" }, "durationMinutes": { "type": "integer", "format": "int32", "example": 120, "description": "体验时长（分钟）" }, "environmentType": { "type": "string", "example": "OUTDOOR", "description": "环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外" }, "groupSizeMax": { "type": "integer", "format": "int32", "example": 10, "description": "单次最多人数" }, "groupSizeMin": { "type": "integer", "format": "int32", "example": 2, "description": "最少成行人数" }, "healthNotes": { "type": "string", "description": "健康须知" }, "highlights": { "type": "string", "example": "专业马术教练全程指导", "description": "项目亮点" }, "latitude": { "type": "number", "example": 29.66, "description": "纬度" }, "longitude": { "type": "number", "example": 91.132, "description": "经度" }, "name": { "type": "string", "example": "高原骑马体验", "description": "项目名称" }, "physicalLevel": { "type": "string", "example": "MEDIUM", "description": "体力要求：LOW=低 MEDIUM=中 HIGH=高" }, "providedEquipment": { "type": "string", "description": "提供装备说明" }, "province": { "type": "string", "example": "西藏自治区", "description": "省份" }, "requiredEquipment": { "type": "string", "description": "需自备装备说明" }, "safetyNotes": { "type": "string", "description": "安全须知" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重（数字越大越靠前）" }, "subtitle": { "type": "string", "example": "策马奔腾在雪域高原", "description": "副标题" }, "unit": { "type": "string", "example": "人/次", "description": "计量单位" }, "usageNotes": { "type": "string", "description": "使用注意事项" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "weatherDependent": { "type": "integer", "format": "int32", "example": 1, "description": "是否受天气影响：0=否 1=是" }, "whatExcluded": { "type": "string", "description": "费用不包含说明" }, "whatIncluded": { "type": "string", "description": "费用包含说明" } }, "title": "活动项目更新请求" }, "活动项目标签更新请求": { "type": "object", "properties": { "tagIds": { "type": "array", "description": "标签ID列表", "items": { "type": "string" } } }, "title": "活动项目标签更新请求" }, "活动项目状态变更请求": { "type": "object", "required": [ "status" ], "properties": { "activityIds": { "type": "array", "description": "活动项目ID列表（批量操作）", "items": { "type": "string" } }, "status": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "活动项目状态变更请求" }, "活动项目详情视图": { "type": "object", "properties": { "activityId": { "type": "string", "description": "活动项目ID" }, "address": { "type": "string", "description": "详细地址" }, "ageMax": { "type": "integer", "format": "int32", "description": "最大年龄限制" }, "ageMin": { "type": "integer", "format": "int32", "description": "最小年龄限制" }, "bannerMaterialIds": { "type": "array", "description": "轮播图素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "轮播图URL列表", "items": { "type": "string" } }, "bestSeason": { "type": "string", "description": "最佳季节" }, "billingType": { "type": "string", "description": "计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时" }, "categoryCode": { "type": "string", "description": "分类编码" }, "city": { "type": "string", "description": "城市" }, "contactPhone": { "type": "string", "description": "联系电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建人ID" }, "dailyCapacity": { "type": "integer", "format": "int32", "description": "每日接待上限" }, "description": { "type": "string", "description": "项目描述" }, "district": { "type": "string", "description": "区县" }, "durationMinutes": { "type": "integer", "format": "int32", "description": "体验时长（分钟）" }, "environmentType": { "type": "string", "description": "环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外" }, "groupSizeMax": { "type": "integer", "format": "int32", "description": "单次最多人数" }, "groupSizeMin": { "type": "integer", "format": "int32", "description": "最少成行人数" }, "healthNotes": { "type": "string", "description": "健康须知" }, "highlights": { "type": "string", "description": "项目亮点" }, "latitude": { "type": "number", "description": "纬度" }, "longitude": { "type": "number", "description": "经度" }, "name": { "type": "string", "description": "项目名称" }, "physicalLevel": { "type": "string", "description": "体力要求：LOW=低 MEDIUM=中 HIGH=高" }, "providedEquipment": { "type": "string", "description": "提供装备说明" }, "province": { "type": "string", "description": "省份" }, "requiredEquipment": { "type": "string", "description": "需自备装备说明" }, "safetyNotes": { "type": "string", "description": "安全须知" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/活动标签视图", "originalRef": "活动标签视图" } }, "unit": { "type": "string", "description": "计量单位" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "usageNotes": { "type": "string", "description": "使用注意事项" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" }, "weatherDependent": { "type": "integer", "format": "int32", "description": "是否受天气影响：0=否 1=是" }, "whatExcluded": { "type": "string", "description": "费用不包含说明" }, "whatIncluded": { "type": "string", "description": "费用包含说明" } }, "title": "活动项目详情视图" }, "统一响应结果«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«活动标签视图»»" }, "统一响应结果«分页结果«活动标签视图»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«活动标签视图»", "originalRef": "分页结果«活动标签视图»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«活动标签视图»»" }, "统一响应结果«分页结果«活动项目列表视图»»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/分页结果«活动项目列表视图»", "originalRef": "分页结果«活动项目列表视图»" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«分页结果«活动项目列表视图»»" }, "统一响应结果«活动价格日历视图»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/活动价格日历视图", "originalRef": "活动价格日历视图" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«活动价格日历视图»" }, "统一响应结果«活动标签视图»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/活动标签视图", "originalRef": "活动标签视图" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«活动标签视图»" }, "统一响应结果«活动项目详情视图»": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/活动项目详情视图", "originalRef": "活动项目详情视图" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«活动项目详情视图»" }, "Map«string,object»": { "type": "object", "title": "Map«string,object»", "additionalProperties": { "type": "object" } }, "分页结果«酒店列表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", "required": [ "bedType", "name", "roomCategory" ], "properties": { "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "example": 580.0, "description": "基础成本价（元）" }, "bathroomType": { "type": "string", "example": "独立卫浴", "description": "卫浴类型" }, "bedCount": { "type": "integer", "format": "int32", "example": 1, "description": "床位数量" }, "bedSize": { "type": "string", "example": "1.8m*2.0m", "description": "床尺寸" }, "bedType": { "type": "string", "example": "大床", "description": "床型" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "房型描述" }, "floorInfo": { "type": "string", "example": "3-8层", "description": "楼层信息" }, "maxOccupancy": { "type": "integer", "format": "int32", "example": 2, "description": "最多入住人数" }, "name": { "type": "string", "example": "豪华大床房", "description": "房型名称" }, "roomArea": { "type": "number", "example": 45.0, "description": "房间面积（平方米）" }, "roomCategory": { "type": "string", "example": "STANDARD", "description": "房型分类" }, "roomFacilities": { "type": "string", "description": "房间设施（JSON）" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "totalRooms": { "type": "integer", "format": "int32", "example": 20, "description": "总房间数" }, "videoMaterialId": { "type": "string", "description": "视频素材ID" }, "windowType": { "type": "string", "example": "落地窗", "description": "窗型" } }, "title": "房型创建请求" }, "房型更新请求": { "type": "object", "properties": { "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "example": 580.0, "description": "基础成本价（元）" }, "bathroomType": { "type": "string", "example": "独立卫浴", "description": "卫浴类型" }, "bedCount": { "type": "integer", "format": "int32", "example": 1, "description": "床位数量" }, "bedSize": { "type": "string", "example": "1.8m*2.0m", "description": "床尺寸" }, "bedType": { "type": "string", "example": "大床", "description": "床型" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "房型描述" }, "floorInfo": { "type": "string", "example": "3-8层", "description": "楼层信息" }, "maxOccupancy": { "type": "integer", "format": "int32", "example": 2, "description": "最多入住人数" }, "name": { "type": "string", "example": "豪华大床房", "description": "房型名称" }, "roomArea": { "type": "number", "example": 45.0, "description": "房间面积（平方米）" }, "roomCategory": { "type": "string", "example": "STANDARD", "description": "房型分类" }, "roomFacilities": { "type": "string", "description": "房间设施（JSON）" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "totalRooms": { "type": "integer", "format": "int32", "example": 20, "description": "总房间数" }, "videoMaterialId": { "type": "string", "description": "视频素材ID" }, "windowType": { "type": "string", "example": "落地窗", "description": "窗型" } }, "title": "房型更新请求" }, "房型状态变更请求": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "integer", "format": "int32", "example": 1, "description": "状态：0=下架 1=上架" } }, "title": "房型状态变更请求" }, "房型详情VO": { "type": "object", "properties": { "approvalNo": { "type": "string", "description": "审批单号" }, "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "横幅图URL列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "description": "基础成本价（元）" }, "bathroomType": { "type": "string", "description": "卫浴类型" }, "bedCount": { "type": "integer", "format": "int32", "description": "床位数量" }, "bedSize": { "type": "string", "description": "床尺寸" }, "bedType": { "type": "string", "description": "床型" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "description": { "type": "string", "description": "房型描述" }, "floorInfo": { "type": "string", "description": "楼层信息" }, "hotelId": { "type": "string", "description": "所属酒店ID" }, "maxOccupancy": { "type": "integer", "format": "int32", "description": "最多入住人数" }, "name": { "type": "string", "description": "房型名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "roomArea": { "type": "number", "description": "房间面积（平方米）" }, "roomCategory": { "type": "string", "description": "房型分类" }, "roomFacilities": { "type": "string", "description": "房间设施（JSON）" }, "roomTypeId": { "type": "string", "description": "房型ID" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "totalRooms": { "type": "integer", "format": "int32", "description": "总房间数" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "videoMaterialId": { "type": "string", "description": "视频素材ID" }, "videoUrl": { "type": "string", "description": "视频URL" }, "windowType": { "type": "string", "description": "窗型" } }, "title": "房型详情VO" }, "统一响应结果«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«房型详情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": { "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": { "approvalNo": { "type": "string", "description": "审批单号" }, "city": { "type": "string", "description": "城市" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "diamondLevel": { "type": "integer", "format": "int32", "description": "钻级：0-5" }, "hotelId": { "type": "string", "description": "酒店ID" }, "hotelType": { "type": "string", "description": "住宿类型" }, "name": { "type": "string", "description": "酒店名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "roomTypeCount": { "type": "integer", "format": "int32", "description": "房型数量" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "starLevel": { "type": "string", "description": "星级（字典: hotel_star_level）" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/酒店标签VO", "originalRef": "酒店标签VO" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "酒店列表VO" }, "酒店创建请求": { "type": "object", "required": [ "address", "hotelType", "latitude", "longitude", "name" ], "properties": { "address": { "type": "string", "example": "束河古镇悦榕路1号", "description": "详细地址" }, "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "checkInNotes": { "type": "string", "description": "入住须知" }, "checkInTime": { "type": "string", "example": "14:00", "description": "入住时间" }, "checkOutTime": { "type": "string", "example": "12:00", "description": "退房时间" }, "city": { "type": "string", "example": "丽江市", "description": "城市" }, "contactPerson": { "type": "string", "example": "张经理", "description": "联系人姓名" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "酒店描述" }, "diamondLevel": { "type": "integer", "format": "int32", "example": 0, "description": "钻级：0-5" }, "district": { "type": "string", "example": "古城区", "description": "区县" }, "facilities": { "type": "string", "description": "设施配置（JSON）" }, "highlights": { "type": "string", "description": "酒店亮点（JSON）" }, "hotelType": { "type": "string", "example": "HOTEL", "description": "住宿类型" }, "latitude": { "type": "number", "example": 26.8721, "description": "纬度" }, "longitude": { "type": "number", "example": 100.2134, "description": "经度" }, "luggageInfo": { "type": "string", "description": "行李服务说明" }, "name": { "type": "string", "example": "丽江悦榕庄", "description": "酒店名称" }, "parkingInfo": { "type": "string", "description": "停车信息" }, "province": { "type": "string", "example": "云南省", "description": "省份" }, "roomSharePhone": { "type": "string", "example": 13800138002, "description": "合房电话" }, "salesPhone": { "type": "string", "example": 13800138001, "description": "销售电话" }, "shuttleInfo": { "type": "string", "description": "接驳服务说明" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "starLevel": { "type": "string", "example": "FIVE_STAR", "description": "星级（字典: hotel_star_level）" }, "subtitle": { "type": "string", "example": "古城边的世外桃源", "description": "副标题" }, "usageNotes": { "type": "string", "description": "使用须知" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "酒店创建请求" }, "酒店审批提交请求": { "type": "object", "required": [ "reason", "targetStatus" ], "properties": { "reason": { "type": "string", "example": "信息已核实，申请上架", "description": "审批理由" }, "targetStatus": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "酒店审批提交请求" }, "酒店房型价格日历VO": { "type": "object", "properties": { "hotelId": { "type": "string", "description": "酒店ID" }, "month": { "type": "integer", "format": "int32", "description": "月份" }, "prices": { "type": "array", "description": "价格日历明细列表", "items": { "$ref": "#/definitions/酒店房型价格日历日VO", "originalRef": "酒店房型价格日历日VO" } }, "roomTypeId": { "type": "string", "description": "房型ID" }, "roomTypeName": { "type": "string", "description": "房型名称" }, "stockEnabled": { "type": "boolean", "description": "是否启用库存管理" }, "year": { "type": "integer", "format": "int32", "description": "年份" } }, "title": "酒店房型价格日历VO" }, "酒店房型价格日历日VO": { "type": "object", "properties": { "costPrice": { "type": "number", "description": "成本价（元）" }, "date": { "type": "string", "format": "date", "description": "日期" }, "remark": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "description": "库存数量" }, "stockUsed": { "type": "integer", "format": "int32", "description": "已用库存" } }, "title": "酒店房型价格日历日VO" }, "酒店房型价格日历状态变更请求": { "type": "object", "required": [ "endDate", "startDate", "status" ], "properties": { "endDate": { "type": "string", "example": "2026-03-31", "description": "结束日期（yyyy-MM-dd）" }, "remark": { "type": "string", "example": "临时关闭预订", "description": "备注" }, "startDate": { "type": "string", "example": "2026-03-01", "description": "开始日期（yyyy-MM-dd）" }, "status": { "type": "string", "example": "CLOSED", "description": "目标状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" } }, "title": "酒店房型价格日历状态变更请求" }, "酒店房型价格日历设置请求": { "type": "object", "required": [ "costPrice", "endDate", "startDate" ], "properties": { "costPrice": { "type": "number", "example": 580.0, "description": "成本价（元）" }, "endDate": { "type": "string", "example": "2026-03-31", "description": "结束日期（yyyy-MM-dd）" }, "excludeDates": { "type": "array", "example": [ "2026-03-08", "2026-03-15" ], "description": "排除日期列表", "items": { "type": "string" } }, "remark": { "type": "string", "example": "旺季价格", "description": "备注" }, "selectedWeekdays": { "type": "array", "example": [ 1, 2, 3, 4, 5 ], "description": "指定星期几（1=周一 7=周日）", "items": { "type": "integer", "format": "int32" } }, "startDate": { "type": "string", "example": "2026-03-01", "description": "开始日期（yyyy-MM-dd）" }, "status": { "type": "string", "example": "AVAILABLE", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "example": 10, "description": "库存数量" }, "weekdayOnly": { "type": "boolean", "example": false, "description": "是否仅工作日" }, "weekendOnly": { "type": "boolean", "example": false, "description": "是否仅周末" } }, "title": "酒店房型价格日历设置请求" }, "酒店批量删除请求": { "type": "object", "required": [ "hotelIds" ], "properties": { "hotelIds": { "type": "array", "example": [ "1", "2", "3" ], "description": "酒店ID列表", "items": { "type": "string" } } }, "title": "酒店批量删除请求" }, "酒店批量标签操作请求": { "type": "object", "required": [ "hotelIds" ], "properties": { "addTagIds": { "type": "array", "example": [ "10", "11" ], "description": "要添加的标签ID列表", "items": { "type": "string" } }, "hotelIds": { "type": "array", "example": [ "1", "2", "3" ], "description": "酒店ID列表", "items": { "type": "string" } }, "removeTagIds": { "type": "array", "example": [ "12" ], "description": "要移除的标签ID列表", "items": { "type": "string" } } }, "title": "酒店批量标签操作请求" }, "酒店更新请求": { "type": "object", "properties": { "address": { "type": "string", "example": "束河古镇悦榕路1号", "description": "详细地址" }, "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "checkInNotes": { "type": "string", "description": "入住须知" }, "checkInTime": { "type": "string", "example": "14:00", "description": "入住时间" }, "checkOutTime": { "type": "string", "example": "12:00", "description": "退房时间" }, "city": { "type": "string", "example": "丽江市", "description": "城市" }, "contactPerson": { "type": "string", "example": "张经理", "description": "联系人姓名" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "酒店描述" }, "diamondLevel": { "type": "integer", "format": "int32", "example": 0, "description": "钻级：0-5" }, "district": { "type": "string", "example": "古城区", "description": "区县" }, "facilities": { "type": "string", "description": "设施配置（JSON）" }, "highlights": { "type": "string", "description": "酒店亮点（JSON）" }, "hotelType": { "type": "string", "example": "HOTEL", "description": "住宿类型" }, "latitude": { "type": "number", "example": 26.8721, "description": "纬度" }, "longitude": { "type": "number", "example": 100.2134, "description": "经度" }, "luggageInfo": { "type": "string", "description": "行李服务说明" }, "name": { "type": "string", "example": "丽江悦榕庄", "description": "酒店名称" }, "parkingInfo": { "type": "string", "description": "停车信息" }, "province": { "type": "string", "example": "云南省", "description": "省份" }, "roomSharePhone": { "type": "string", "example": 13800138002, "description": "合房电话" }, "salesPhone": { "type": "string", "example": 13800138001, "description": "销售电话" }, "shuttleInfo": { "type": "string", "description": "接驳服务说明" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "starLevel": { "type": "string", "example": "FIVE_STAR", "description": "星级（字典: hotel_star_level）" }, "subtitle": { "type": "string", "example": "古城边的世外桃源", "description": "副标题" }, "usageNotes": { "type": "string", "description": "使用须知" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "酒店更新请求" }, "酒店标签VO": { "type": "object", "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色（十六进制）" }, "tagId": { "type": "string", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：0=自定义 1=系统" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "酒店标签VO" }, "酒店标签创建请求": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "example": "#FF6600", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "温泉酒店", "description": "标签名称" } }, "title": "酒店标签创建请求" }, "酒店标签更新请求": { "type": "object", "properties": { "tagColor": { "type": "string", "example": "#FF6600", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "温泉酒店", "description": "标签名称" } }, "title": "酒店标签更新请求" }, "酒店标签更新请求_1": { "type": "object", "properties": { "tagIds": { "type": "array", "description": "标签ID列表（全量替换）", "items": { "type": "string" } } }, "title": "酒店标签更新请求_1" }, "酒店状态变更请求": { "type": "object", "required": [ "status" ], "properties": { "hotelIds": { "type": "array", "description": "酒店ID列表（批量操作时使用）", "items": { "type": "string" } }, "status": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "酒店状态变更请求" }, "酒店详情VO": { "type": "object", "properties": { "address": { "type": "string", "description": "详细地址" }, "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "横幅图URL列表", "items": { "type": "string" } }, "checkInNotes": { "type": "string", "description": "入住须知" }, "checkInTime": { "type": "string", "description": "入住时间" }, "checkOutTime": { "type": "string", "description": "退房时间" }, "city": { "type": "string", "description": "城市" }, "contactPerson": { "type": "string", "description": "联系人姓名" }, "contactPhone": { "type": "string", "description": "联系电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建者ID" }, "description": { "type": "string", "description": "酒店描述" }, "diamondLevel": { "type": "integer", "format": "int32", "description": "钻级：0-5" }, "district": { "type": "string", "description": "区县" }, "facilities": { "type": "string", "description": "设施配置（JSON）" }, "highlights": { "type": "string", "description": "酒店亮点（JSON）" }, "hotelId": { "type": "string", "description": "酒店ID" }, "hotelType": { "type": "string", "description": "住宿类型" }, "latitude": { "type": "number", "description": "纬度" }, "longitude": { "type": "number", "description": "经度" }, "luggageInfo": { "type": "string", "description": "行李服务说明" }, "name": { "type": "string", "description": "酒店名称" }, "parkingInfo": { "type": "string", "description": "停车信息" }, "province": { "type": "string", "description": "省份" }, "roomSharePhone": { "type": "string", "description": "合房电话" }, "roomTypeCount": { "type": "integer", "format": "int32", "description": "房型数量" }, "roomTypes": { "type": "array", "description": "房型列表（C端详情返回，仅包含已启用房型）", "items": { "$ref": "#/definitions/房型详情VO", "originalRef": "房型详情VO" } }, "salesPhone": { "type": "string", "description": "销售电话" }, "shuttleInfo": { "type": "string", "description": "接驳服务说明" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "starLevel": { "type": "string", "description": "星级（字典: hotel_star_level）" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/酒店标签VO", "originalRef": "酒店标签VO" } }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "usageNotes": { "type": "string", "description": "使用须知" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } }, "viewCount": { "type": "integer", "format": "int32", "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»" }, "分页结果«服务项列表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": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色（十六进制）" }, "tagId": { "type": "string", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：0=自定义 1=系统" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "服务标签VO" }, "服务标签创建请求": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "example": "#FF6600", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "精品服务", "description": "标签名称" } }, "title": "服务标签创建请求" }, "服务标签更新请求": { "type": "object", "properties": { "tagColor": { "type": "string", "example": "#FF6600", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "精品服务", "description": "标签名称" } }, "title": "服务标签更新请求" }, "服务项价格日历VO": { "type": "object", "properties": { "month": { "type": "integer", "format": "int32", "description": "月份" }, "prices": { "type": "array", "description": "价格日历明细列表", "items": { "$ref": "#/definitions/服务项价格日历日VO", "originalRef": "服务项价格日历日VO" } }, "serviceId": { "type": "string", "description": "服务项ID" }, "serviceName": { "type": "string", "description": "服务项名称" }, "stockEnabled": { "type": "boolean", "description": "是否启用库存管理" }, "year": { "type": "integer", "format": "int32", "description": "年份" } }, "title": "服务项价格日历VO" }, "服务项价格日历日VO": { "type": "object", "properties": { "costPrice": { "type": "number", "description": "成本价（元）" }, "date": { "type": "string", "format": "date", "description": "日期" }, "remark": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "description": "库存数量" }, "stockUsed": { "type": "integer", "format": "int32", "description": "已用库存" } }, "title": "服务项价格日历日VO" }, "服务项价格日历状态变更请求": { "type": "object", "required": [ "endDate", "startDate", "status" ], "properties": { "endDate": { "type": "string", "example": "2026-03-31", "description": "结束日期（yyyy-MM-dd）" }, "remark": { "type": "string", "example": "临时关闭预订", "description": "备注" }, "startDate": { "type": "string", "example": "2026-03-01", "description": "开始日期（yyyy-MM-dd）" }, "status": { "type": "string", "example": "CLOSED", "description": "目标状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" } }, "title": "服务项价格日历状态变更请求" }, "服务项价格日历设置请求": { "type": "object", "required": [ "costPrice", "endDate", "startDate" ], "properties": { "costPrice": { "type": "number", "example": 200.0, "description": "成本价（元）" }, "endDate": { "type": "string", "example": "2026-03-31", "description": "结束日期（yyyy-MM-dd）" }, "excludeDates": { "type": "array", "example": [ "2026-03-08", "2026-03-15" ], "description": "排除日期列表", "items": { "type": "string" } }, "remark": { "type": "string", "example": "旺季价格", "description": "备注" }, "selectedWeekdays": { "type": "array", "example": [ 1, 2, 3, 4, 5 ], "description": "指定星期几（1=周一 7=周日）", "items": { "type": "integer", "format": "int32" } }, "startDate": { "type": "string", "example": "2026-03-01", "description": "开始日期（yyyy-MM-dd）" }, "status": { "type": "string", "example": "AVAILABLE", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "example": 50, "description": "库存数量" }, "weekdayOnly": { "type": "boolean", "example": false, "description": "是否仅工作日" }, "weekendOnly": { "type": "boolean", "example": false, "description": "是否仅周末" } }, "title": "服务项价格日历设置请求" }, "服务项列表VO": { "type": "object", "properties": { "approvalNo": { "type": "string", "description": "审批单号" }, "basePrice": { "type": "number", "description": "基础价格（元）" }, "billingType": { "type": "string", "description": "计费方式" }, "categoryCode": { "type": "string", "description": "分类编码" }, "city": { "type": "string", "description": "城市" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "durationHours": { "type": "number", "description": "服务时长（小时）" }, "highlights": { "type": "string", "description": "服务亮点" }, "instantConfirm": { "type": "integer", "format": "int32", "description": "是否即时确认：0=否 1=是" }, "isPaid": { "type": "integer", "format": "int32", "description": "是否收费：0=免费 1=收费" }, "latitude": { "type": "number", "description": "纬度" }, "longitude": { "type": "number", "description": "经度" }, "name": { "type": "string", "description": "服务名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "serviceId": { "type": "string", "description": "服务项ID" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/服务标签VO", "originalRef": "服务标签VO" } }, "unit": { "type": "string", "description": "计价单位" }, "vehicleType": { "type": "string", "description": "配套车型" }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "服务项列表VO" }, "服务项创建请求": { "type": "object", "required": [ "categoryCode", "isPaid", "name" ], "properties": { "address": { "type": "string", "example": "丽江古城区", "description": "详细地址" }, "advanceBookingHours": { "type": "integer", "format": "int32", "example": 24, "description": "提前预订时间（小时）" }, "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "example": 500.0, "description": "基础价格（元）" }, "billingType": { "type": "string", "example": "PER_DAY", "description": "计费方式" }, "cancellationPolicy": { "type": "string", "description": "取消政策说明" }, "capacityMax": { "type": "integer", "format": "int32", "example": 10, "description": "最多服务人数" }, "capacityMin": { "type": "integer", "format": "int32", "example": 1, "description": "最少服务人数" }, "categoryCode": { "type": "string", "example": "GUIDE", "description": "分类编码" }, "city": { "type": "string", "example": "丽江市", "description": "城市" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "服务描述" }, "durationHours": { "type": "number", "example": 8.0, "description": "服务时长（小时）" }, "equipmentList": { "type": "string", "description": "设备清单（JSON）" }, "freeCancelHours": { "type": "integer", "format": "int32", "example": 48, "description": "免费取消期限（小时）" }, "highlights": { "type": "string", "description": "服务亮点" }, "includedItems": { "type": "string", "description": "包含项目说明" }, "instantConfirm": { "type": "integer", "format": "int32", "example": 1, "description": "是否即时确认：0=否 1=是" }, "isPaid": { "type": "integer", "format": "int32", "example": 1, "description": "是否收费：0=免费 1=收费" }, "languageSupport": { "type": "string", "example": "中文,英文", "description": "语言支持" }, "latitude": { "type": "number", "example": 26.8721, "description": "纬度" }, "longitude": { "type": "number", "example": 100.2134, "description": "经度" }, "name": { "type": "string", "example": "专属导游服务", "description": "服务名称" }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "province": { "type": "string", "example": "云南省", "description": "省份" }, "serviceHours": { "type": "string", "example": "08:00-18:00", "description": "服务时段" }, "serviceProcess": { "type": "string", "description": "服务流程说明" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "staffCount": { "type": "integer", "format": "int32", "example": 1, "description": "服务人员数量" }, "subtitle": { "type": "string", "example": "资深导游全程陪同", "description": "副标题" }, "unit": { "type": "string", "example": "天", "description": "计价单位" }, "usageNotes": { "type": "string", "description": "使用须知" }, "vehicleType": { "type": "string", "example": "商务车", "description": "配套车型" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "服务项创建请求" }, "服务项审批提交请求": { "type": "object", "required": [ "reason", "targetStatus" ], "properties": { "reason": { "type": "string", "example": "信息已核实，申请上架", "description": "审批理由" }, "targetStatus": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "服务项审批提交请求" }, "服务项批量删除请求": { "type": "object", "required": [ "serviceIds" ], "properties": { "serviceIds": { "type": "array", "example": [ "1", "2", "3" ], "description": "服务ID列表", "items": { "type": "string" } } }, "title": "服务项批量删除请求" }, "服务项批量标签操作请求": { "type": "object", "required": [ "serviceIds" ], "properties": { "addTagIds": { "type": "array", "example": [ "10", "11" ], "description": "要添加的标签ID列表", "items": { "type": "string" } }, "removeTagIds": { "type": "array", "example": [ "12" ], "description": "要移除的标签ID列表", "items": { "type": "string" } }, "serviceIds": { "type": "array", "example": [ "1", "2", "3" ], "description": "服务ID列表", "items": { "type": "string" } } }, "title": "服务项批量标签操作请求" }, "服务项更新请求": { "type": "object", "properties": { "address": { "type": "string", "example": "丽江古城区", "description": "详细地址" }, "advanceBookingHours": { "type": "integer", "format": "int32", "example": 24, "description": "提前预订时间（小时）" }, "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "example": 500.0, "description": "基础价格（元）" }, "billingType": { "type": "string", "example": "PER_DAY", "description": "计费方式" }, "cancellationPolicy": { "type": "string", "description": "取消政策说明" }, "capacityMax": { "type": "integer", "format": "int32", "example": 10, "description": "最多服务人数" }, "capacityMin": { "type": "integer", "format": "int32", "example": 1, "description": "最少服务人数" }, "categoryCode": { "type": "string", "example": "GUIDE", "description": "分类编码" }, "city": { "type": "string", "example": "丽江市", "description": "城市" }, "contactPhone": { "type": "string", "example": 13800138000, "description": "联系电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "服务描述" }, "durationHours": { "type": "number", "example": 8.0, "description": "服务时长（小时）" }, "equipmentList": { "type": "string", "description": "设备清单（JSON）" }, "freeCancelHours": { "type": "integer", "format": "int32", "example": 48, "description": "免费取消期限（小时）" }, "highlights": { "type": "string", "description": "服务亮点" }, "includedItems": { "type": "string", "description": "包含项目说明" }, "instantConfirm": { "type": "integer", "format": "int32", "example": 1, "description": "是否即时确认：0=否 1=是" }, "isPaid": { "type": "integer", "format": "int32", "example": 1, "description": "是否收费：0=免费 1=收费" }, "languageSupport": { "type": "string", "example": "中文,英文", "description": "语言支持" }, "latitude": { "type": "number", "example": 26.8721, "description": "纬度" }, "longitude": { "type": "number", "example": 100.2134, "description": "经度" }, "name": { "type": "string", "example": "专属导游服务", "description": "服务名称" }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "province": { "type": "string", "example": "云南省", "description": "省份" }, "serviceHours": { "type": "string", "example": "08:00-18:00", "description": "服务时段" }, "serviceProcess": { "type": "string", "description": "服务流程说明" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "staffCount": { "type": "integer", "format": "int32", "example": 1, "description": "服务人员数量" }, "subtitle": { "type": "string", "example": "资深导游全程陪同", "description": "副标题" }, "unit": { "type": "string", "example": "天", "description": "计价单位" }, "usageNotes": { "type": "string", "description": "使用须知" }, "vehicleType": { "type": "string", "example": "商务车", "description": "配套车型" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "服务项更新请求" }, "服务项标签更新请求": { "type": "object", "properties": { "tagIds": { "type": "array", "description": "标签ID列表（全量替换）", "items": { "type": "string" } } }, "title": "服务项标签更新请求" }, "服务项状态变更请求": { "type": "object", "required": [ "status" ], "properties": { "serviceIds": { "type": "array", "description": "服务ID列表（批量操作时使用）", "items": { "type": "string" } }, "status": { "type": "integer", "format": "int32", "example": 1, "description": "目标状态：0=下架 1=上架" } }, "title": "服务项状态变更请求" }, "服务项详情VO": { "type": "object", "properties": { "address": { "type": "string", "description": "详细地址" }, "advanceBookingHours": { "type": "integer", "format": "int32", "description": "提前预订时间（小时）" }, "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "横幅图URL列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "description": "基础价格（元）" }, "billingType": { "type": "string", "description": "计费方式" }, "cancellationPolicy": { "type": "string", "description": "取消政策说明" }, "capacityMax": { "type": "integer", "format": "int32", "description": "最多服务人数" }, "capacityMin": { "type": "integer", "format": "int32", "description": "最少服务人数" }, "categoryCode": { "type": "string", "description": "分类编码" }, "city": { "type": "string", "description": "城市" }, "contactPhone": { "type": "string", "description": "联系电话" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建者ID" }, "description": { "type": "string", "description": "服务描述" }, "durationHours": { "type": "number", "description": "服务时长（小时）" }, "equipmentList": { "type": "string", "description": "设备清单（JSON）" }, "freeCancelHours": { "type": "integer", "format": "int32", "description": "免费取消期限（小时）" }, "highlights": { "type": "string", "description": "服务亮点" }, "includedItems": { "type": "string", "description": "包含项目说明" }, "instantConfirm": { "type": "integer", "format": "int32", "description": "是否即时确认：0=否 1=是" }, "isPaid": { "type": "integer", "format": "int32", "description": "是否收费：0=免费 1=收费" }, "languageSupport": { "type": "string", "description": "语言支持" }, "latitude": { "type": "number", "description": "纬度" }, "longitude": { "type": "number", "description": "经度" }, "name": { "type": "string", "description": "服务名称" }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "province": { "type": "string", "description": "省份" }, "serviceHours": { "type": "string", "description": "服务时段" }, "serviceId": { "type": "string", "description": "服务项ID" }, "serviceProcess": { "type": "string", "description": "服务流程说明" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "staffCount": { "type": "integer", "format": "int32", "description": "服务人员数量" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/服务标签VO", "originalRef": "服务标签VO" } }, "unit": { "type": "string", "description": "计价单位" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "usageNotes": { "type": "string", "description": "使用须知" }, "vehicleType": { "type": "string", "description": "配套车型" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "服务项详情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": { "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»" }, "分页结果«车辆标签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»" }, "统一响应结果«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": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/车辆标签VO", "originalRef": "车辆标签VO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«车辆标签VO»" }, "设置车型标签请求": { "type": "object", "required": [ "tagIds" ], "properties": { "tagIds": { "type": "array", "description": "标签ID列表", "items": { "type": "integer", "format": "int64" } } }, "title": "设置车型标签请求" }, "车型价格日历VO": { "type": "object", "properties": { "month": { "type": "integer", "format": "int32", "description": "月份" }, "prices": { "type": "array", "description": "价格日历明细列表", "items": { "$ref": "#/definitions/车型价格日历日VO", "originalRef": "车型价格日历日VO" } }, "stockEnabled": { "type": "boolean", "description": "是否启用库存管理" }, "vehicleId": { "type": "string", "description": "车型ID" }, "vehicleName": { "type": "string", "description": "车型名称" }, "year": { "type": "integer", "format": "int32", "description": "年份" } }, "title": "车型价格日历VO" }, "车型价格日历日VO": { "type": "object", "properties": { "costPrice": { "type": "number", "description": "日租价（元）" }, "date": { "type": "string", "format": "date", "description": "日期" }, "remark": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "description": "库存数量" }, "stockUsed": { "type": "integer", "format": "int32", "description": "已用库存" } }, "title": "车型价格日历日VO" }, "车型价格日历状态变更请求": { "type": "object", "required": [ "endDate", "startDate", "status" ], "properties": { "endDate": { "type": "string", "format": "date", "example": "2026-03-31", "description": "结束日期" }, "remark": { "type": "string", "example": "临时停租", "description": "备注" }, "startDate": { "type": "string", "format": "date", "example": "2026-03-01", "description": "开始日期" }, "status": { "type": "string", "example": "CLOSED", "description": "目标状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" } }, "title": "车型价格日历状态变更请求" }, "车型价格日历设置请求": { "type": "object", "required": [ "costPrice", "endDate", "startDate" ], "properties": { "costPrice": { "type": "number", "example": 800.0, "description": "日租价（元）" }, "endDate": { "type": "string", "format": "date", "example": "2026-03-31", "description": "结束日期" }, "excludeDates": { "type": "array", "description": "排除日期列表", "items": { "$ref": "#/definitions/LocalDate", "originalRef": "LocalDate" } }, "remark": { "type": "string", "example": "旺季价格", "description": "备注" }, "selectedWeekdays": { "type": "array", "example": [ 1, 2, 3, 4, 5 ], "description": "指定星期几（1=周一 7=周日）", "items": { "type": "integer", "format": "int32" } }, "startDate": { "type": "string", "format": "date", "example": "2026-03-01", "description": "开始日期" }, "status": { "type": "string", "example": "AVAILABLE", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "example": 5, "description": "库存数量" }, "weekdayOnly": { "type": "boolean", "example": false, "description": "是否仅工作日" }, "weekendOnly": { "type": "boolean", "example": false, "description": "是否仅周末" } }, "title": "车型价格日历设置请求" }, "车型列表VO": { "type": "object", "properties": { "approvalNo": { "type": "string", "description": "审批单号" }, "basePrice": { "type": "number", "description": "基础日租价（元）" }, "brand": { "type": "string", "description": "品牌" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "highlights": { "type": "string", "description": "车型亮点" }, "modelSeries": { "type": "string", "description": "车系" }, "name": { "type": "string", "description": "车型名称" }, "passengerCount": { "type": "integer", "format": "int32", "description": "可乘坐人数" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "seatCount": { "type": "integer", "format": "int32", "description": "座位数" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/车辆标签VO", "originalRef": "车辆标签VO" } }, "vehicleId": { "type": "string", "description": "车型ID" }, "vehicleType": { "type": "string", "description": "车型分类" }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "车型列表VO" }, "车型创建请求": { "type": "object", "required": [ "brand", "name", "passengerCount", "seatCount", "vehicleType" ], "properties": { "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "example": 800.0, "description": "基础日租价（元）" }, "brand": { "type": "string", "example": "别克", "description": "品牌" }, "comfortFeatures": { "type": "string", "description": "舒适配置（JSON）" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "车型描述" }, "driveType": { "type": "string", "example": "前驱", "description": "驱动方式" }, "engineType": { "type": "string", "example": "汽油", "description": "动力类型" }, "highlights": { "type": "string", "description": "车型亮点" }, "luggageCapacity": { "type": "string", "example": "可放3个28寸行李箱", "description": "行李容量描述" }, "modelSeries": { "type": "string", "example": "GL8", "description": "车系" }, "modelYear": { "type": "integer", "format": "int32", "example": 2025, "description": "年款" }, "name": { "type": "string", "example": "别克GL8 ES", "description": "车型名称" }, "passengerCount": { "type": "integer", "format": "int32", "example": 6, "description": "可乘坐人数" }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "seatCount": { "type": "integer", "format": "int32", "example": 7, "description": "座位数" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "subtitle": { "type": "string", "example": "商务出行首选", "description": "副标题" }, "transmission": { "type": "string", "example": "自动", "description": "变速箱类型" }, "usageNotes": { "type": "string", "description": "使用须知" }, "vehicleType": { "type": "string", "example": "MPV", "description": "车型分类" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "车型创建请求" }, "车型审批提交请求": { "type": "object", "required": [ "targetStatus" ], "properties": { "reason": { "type": "string", "description": "审批原因" }, "targetStatus": { "type": "integer", "format": "int32", "description": "目标状态" } }, "title": "车型审批提交请求" }, "车型批量删除请求": { "type": "object", "required": [ "vehicleIds" ], "properties": { "vehicleIds": { "type": "array", "description": "车型ID列表", "items": { "type": "integer", "format": "int64" } } }, "title": "车型批量删除请求" }, "车型批量标签操作请求": { "type": "object", "required": [ "vehicleIds" ], "properties": { "addTagIds": { "type": "array", "description": "要添加的标签ID列表", "items": { "type": "integer", "format": "int64" } }, "removeTagIds": { "type": "array", "description": "要移除的标签ID列表", "items": { "type": "integer", "format": "int64" } }, "vehicleIds": { "type": "array", "description": "车型ID列表", "items": { "type": "integer", "format": "int64" } } }, "title": "车型批量标签操作请求" }, "车型更新请求": { "type": "object", "properties": { "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "example": 800.0, "description": "基础日租价（元）" }, "brand": { "type": "string", "example": "别克", "description": "品牌" }, "comfortFeatures": { "type": "string", "description": "舒适配置（JSON）" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "车型描述" }, "driveType": { "type": "string", "example": "前驱", "description": "驱动方式" }, "engineType": { "type": "string", "example": "汽油", "description": "动力类型" }, "highlights": { "type": "string", "description": "车型亮点" }, "luggageCapacity": { "type": "string", "example": "可放3个28寸行李箱", "description": "行李容量描述" }, "modelSeries": { "type": "string", "example": "GL8", "description": "车系" }, "modelYear": { "type": "integer", "format": "int32", "example": 2025, "description": "年款" }, "name": { "type": "string", "example": "别克GL8 ES", "description": "车型名称" }, "passengerCount": { "type": "integer", "format": "int32", "example": 6, "description": "可乘坐人数" }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "seatCount": { "type": "integer", "format": "int32", "example": 7, "description": "座位数" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "subtitle": { "type": "string", "example": "商务出行首选", "description": "副标题" }, "transmission": { "type": "string", "example": "自动", "description": "变速箱类型" }, "usageNotes": { "type": "string", "description": "使用须知" }, "vehicleType": { "type": "string", "example": "MPV", "description": "车型分类" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } } }, "title": "车型更新请求" }, "车型状态请求": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "integer", "format": "int32", "description": "目标状态：0=下架 1=上架" }, "vehicleIds": { "type": "array", "description": "车型ID列表（批量操作时使用）", "items": { "type": "integer", "format": "int64" } } }, "title": "车型状态请求" }, "车型详情VO": { "type": "object", "properties": { "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "横幅图URL列表", "items": { "type": "string" } }, "basePrice": { "type": "number", "description": "基础日租价（元）" }, "brand": { "type": "string", "description": "品牌" }, "comfortFeatures": { "type": "string", "description": "舒适配置（JSON）" }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建者ID" }, "description": { "type": "string", "description": "车型描述" }, "driveType": { "type": "string", "description": "驱动方式" }, "engineType": { "type": "string", "description": "动力类型" }, "highlights": { "type": "string", "description": "车型亮点" }, "luggageCapacity": { "type": "string", "description": "行李容量描述" }, "modelSeries": { "type": "string", "description": "车系" }, "modelYear": { "type": "integer", "format": "int32", "description": "年款" }, "name": { "type": "string", "description": "车型名称" }, "passengerCount": { "type": "integer", "format": "int32", "description": "可乘坐人数" }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "seatCount": { "type": "integer", "format": "int32", "description": "座位数" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "subtitle": { "type": "string", "description": "副标题" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/车辆标签VO", "originalRef": "车辆标签VO" } }, "transmission": { "type": "string", "description": "变速箱类型" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "usageNotes": { "type": "string", "description": "使用须知" }, "vehicleId": { "type": "string", "description": "车型ID" }, "vehicleType": { "type": "string", "description": "车型分类" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "车型详情VO" }, "车辆标签VO": { "type": "object", "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色（十六进制）" }, "tagId": { "type": "string", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：0=自定义 1=系统" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "车辆标签VO" }, "车辆标签创建请求": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "example": "#3366FF", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "商务车", "description": "标签名称" } }, "title": "车辆标签创建请求" }, "车辆标签更新请求": { "type": "object", "properties": { "tagColor": { "type": "string", "example": "#3366FF", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "商务车", "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»" }, "统一响应结果«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": { "changeReason": { "type": "string", "description": "变更原因" }, "changedAt": { "type": "string", "format": "date-time", "description": "变更时间" }, "changedBy": { "type": "string", "description": "变更人ID" }, "costId": { "type": "string", "description": "费用项ID" }, "id": { "type": "integer", "format": "int64", "description": "日志ID" }, "newPrice": { "type": "number", "description": "变更后价格（元）" }, "oldPrice": { "type": "number", "description": "变更前价格（元）" } }, "title": "费用项价格变更日志VO" }, "费用项价格日历VO": { "type": "object", "properties": { "days": { "type": "array", "description": "价格日历明细列表", "items": { "$ref": "#/definitions/费用项价格日历日VO", "originalRef": "费用项价格日历日VO" } }, "yearMonth": { "type": "string", "description": "年月（yyyy-MM）" } }, "title": "费用项价格日历VO" }, "费用项价格日历日VO": { "type": "object", "properties": { "date": { "type": "string", "description": "日期（yyyy-MM-dd）" }, "remark": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "unitPrice": { "type": "number", "description": "单价（元）" } }, "title": "费用项价格日历日VO" }, "费用项价格日历设置请求": { "type": "object", "required": [ "endDate", "startDate", "unitPrice" ], "properties": { "dayFilter": { "type": "string", "example": "weekday", "description": "日期过滤：weekday=仅工作日 weekend=仅周末" }, "endDate": { "type": "string", "format": "date", "example": "2026-03-31", "description": "结束日期" }, "excludeDates": { "type": "array", "description": "排除日期列表", "items": { "$ref": "#/definitions/LocalDate", "originalRef": "LocalDate" } }, "remark": { "type": "string", "example": "旺季价格", "description": "备注" }, "selectedWeekdays": { "type": "array", "example": [ 1, 2, 3, 4, 5 ], "description": "指定星期几（1=周一 7=周日）", "items": { "type": "integer", "format": "int32" } }, "startDate": { "type": "string", "format": "date", "example": "2026-03-01", "description": "开始日期" }, "unitPrice": { "type": "number", "example": 200.0, "description": "单价（元）" } }, "title": "费用项价格日历设置请求" }, "费用项列表VO": { "type": "object", "properties": { "applyRole": { "type": "string", "description": "适用角色编码（字典：cost_apply_role）" }, "applyRoleLabel": { "type": "string", "description": "适用角色中文标签" }, "approvalNo": { "type": "string", "description": "审批单号" }, "categoryCode": { "type": "string", "description": "费用分类编码（字典：cost_category）" }, "categoryLabel": { "type": "string", "description": "费用分类中文标签" }, "costId": { "type": "string", "description": "费用项ID" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "name": { "type": "string", "description": "费用名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "refCount": { "type": "integer", "format": "int32", "description": "引用次数" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "unit": { "type": "string", "description": "计价单位" }, "unitPrice": { "type": "number", "description": "单价（元）" } }, "title": "费用项列表VO" }, "费用项创建请求": { "type": "object", "required": [ "applyRole", "categoryCode", "name", "unitPrice" ], "properties": { "applyRole": { "type": "string", "example": "ADULT", "description": "适用角色" }, "calcHint": { "type": "string", "example": "按人头*天数计算", "description": "计算提示" }, "categoryCode": { "type": "string", "example": "GUIDE", "description": "费用分类编码" }, "defaultFormula": { "type": "string", "example": "人数*天数*单价", "description": "默认计算公式" }, "description": { "type": "string", "description": "费用描述" }, "name": { "type": "string", "example": "导游服务费", "description": "费用名称" }, "remark": { "type": "string", "description": "备注" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "unit": { "type": "string", "example": "人/天", "description": "计价单位" }, "unitPrice": { "type": "number", "example": 200.0, "description": "单价（元）" } }, "title": "费用项创建请求" }, "费用项审批提交请求": { "type": "object", "required": [ "targetStatus" ], "properties": { "reason": { "type": "string", "description": "审批原因" }, "targetStatus": { "type": "integer", "format": "int32", "description": "目标状态" } }, "title": "费用项审批提交请求" }, "费用项更新请求": { "type": "object", "properties": { "applyRole": { "type": "string", "example": "ADULT", "description": "适用角色" }, "calcHint": { "type": "string", "example": "按人头*天数计算", "description": "计算提示" }, "categoryCode": { "type": "string", "example": "GUIDE", "description": "费用分类编码" }, "changeReason": { "type": "string", "example": "供应商调价", "description": "价格变更原因（修改单价时必填）" }, "defaultFormula": { "type": "string", "example": "人数*天数*单价", "description": "默认计算公式" }, "description": { "type": "string", "description": "费用描述" }, "name": { "type": "string", "example": "导游服务费", "description": "费用名称" }, "remark": { "type": "string", "description": "备注" }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "unit": { "type": "string", "example": "人/天", "description": "计价单位" }, "unitPrice": { "type": "number", "example": 250.0, "description": "单价（元）" } }, "title": "费用项更新请求" }, "费用项详情VO": { "type": "object", "properties": { "applyRole": { "type": "string", "description": "适用角色编码（字典：cost_apply_role）" }, "applyRoleLabel": { "type": "string", "description": "适用角色中文标签" }, "approvalNo": { "type": "string", "description": "审批单号" }, "calcHint": { "type": "string", "description": "计算提示" }, "categoryCode": { "type": "string", "description": "费用分类编码（字典：cost_category）" }, "categoryLabel": { "type": "string", "description": "费用分类中文标签" }, "costId": { "type": "string", "description": "费用项ID" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建者ID" }, "defaultFormula": { "type": "string", "description": "默认计算公式" }, "description": { "type": "string", "description": "费用描述" }, "name": { "type": "string", "description": "费用名称" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "refCount": { "type": "integer", "format": "int32", "description": "引用次数" }, "remark": { "type": "string", "description": "备注" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "unit": { "type": "string", "description": "计价单位" }, "unitPrice": { "type": "number", "description": "单价（元）" }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" } }, "title": "费用项详情VO" }, "Map«string,string»_1": { "type": "object", "title": "Map«string,string»_1", "additionalProperties": { "type": "string" } }, "Map«string,string»_2": { "type": "object", "title": "Map«string,string»_2", "additionalProperties": { "type": "string" } }, "Map«string,string»_3": { "type": "object", "title": "Map«string,string»_3", "additionalProperties": { "type": "string" } }, "Map«string,string»_4": { "type": "object", "title": "Map«string,string»_4", "additionalProperties": { "type": "string" } }, "人员审批提交请求": { "type": "object", "required": [ "targetStatus" ], "properties": { "reason": { "type": "string", "description": "审批原因" }, "targetStatus": { "type": "integer", "format": "int32", "description": "目标状态" } }, "title": "人员审批提交请求" }, "人员批量删除请求": { "type": "object", "required": [ "staffIds" ], "properties": { "staffIds": { "type": "array", "description": "人员ID列表", "items": { "type": "integer", "format": "int64" } } }, "title": "人员批量删除请求" }, "人员批量标签操作请求": { "type": "object", "required": [ "staffIds" ], "properties": { "addTagIds": { "type": "array", "description": "要添加的标签ID列表", "items": { "type": "integer", "format": "int64" } }, "removeTagIds": { "type": "array", "description": "要移除的标签ID列表", "items": { "type": "integer", "format": "int64" } }, "staffIds": { "type": "array", "description": "人员ID列表", "items": { "type": "integer", "format": "int64" } } }, "title": "人员批量标签操作请求" }, "人员状态请求": { "type": "object", "required": [ "status" ], "properties": { "staffIds": { "type": "array", "description": "人员ID列表（批量操作时使用）", "items": { "type": "integer", "format": "int64" } }, "status": { "type": "integer", "format": "int32", "description": "目标状态：0=下架 1=上架" } }, "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»" }, "分页结果«服务人员标签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": { "month": { "type": "integer", "format": "int32", "description": "月份" }, "prices": { "type": "array", "description": "价格日历明细列表", "items": { "$ref": "#/definitions/服务人员价格日历日VO", "originalRef": "服务人员价格日历日VO" } }, "staffType": { "type": "string", "description": "人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER" }, "staffTypeName": { "type": "string", "description": "人员类型名称" }, "stockEnabled": { "type": "boolean", "description": "是否启用库存管理" }, "year": { "type": "integer", "format": "int32", "description": "年份" } }, "title": "服务人员价格日历VO" }, "服务人员价格日历日VO": { "type": "object", "properties": { "costPrice": { "type": "number", "description": "日薪（元）" }, "date": { "type": "string", "format": "date", "description": "日期" }, "remark": { "type": "string", "description": "备注" }, "status": { "type": "string", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "description": "库存数量" }, "stockUsed": { "type": "integer", "format": "int32", "description": "已用库存" } }, "title": "服务人员价格日历日VO" }, "服务人员价格日历状态变更请求": { "type": "object", "required": [ "endDate", "startDate", "status" ], "properties": { "endDate": { "type": "string", "format": "date", "example": "2026-03-31", "description": "结束日期" }, "remark": { "type": "string", "example": "临时停用", "description": "备注" }, "startDate": { "type": "string", "format": "date", "example": "2026-03-01", "description": "开始日期" }, "status": { "type": "string", "example": "CLOSED", "description": "目标状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" } }, "title": "服务人员价格日历状态变更请求" }, "服务人员价格日历设置请求": { "type": "object", "required": [ "costPrice", "endDate", "startDate" ], "properties": { "costPrice": { "type": "number", "example": 500.0, "description": "日薪（元）" }, "endDate": { "type": "string", "format": "date", "example": "2026-03-31", "description": "结束日期" }, "excludeDates": { "type": "array", "description": "排除日期列表", "items": { "$ref": "#/definitions/LocalDate", "originalRef": "LocalDate" } }, "remark": { "type": "string", "example": "旺季价格", "description": "备注" }, "selectedWeekdays": { "type": "array", "example": [ 1, 2, 3, 4, 5 ], "description": "指定星期几（1=周一 7=周日）", "items": { "type": "integer", "format": "int32" } }, "startDate": { "type": "string", "format": "date", "example": "2026-03-01", "description": "开始日期" }, "status": { "type": "string", "example": "AVAILABLE", "description": "日历状态（字典 calendar_status：AVAILABLE=可售 SOLD_OUT=已售罄 CLOSED=已关闭）" }, "stock": { "type": "integer", "format": "int32", "example": 1, "description": "库存数量" }, "weekdayOnly": { "type": "boolean", "example": false, "description": "是否仅工作日" }, "weekendOnly": { "type": "boolean", "example": false, "description": "是否仅周末" } }, "title": "服务人员价格日历设置请求" }, "服务人员列表VO": { "type": "object", "properties": { "approvalNo": { "type": "string", "description": "审批单号" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "highlights": { "type": "string", "description": "人员亮点" }, "name": { "type": "string", "description": "姓名" }, "pendingStatus": { "type": "integer", "format": "int32", "description": "待审批目标状态" }, "phone": { "type": "string", "description": "手机号" }, "rating": { "type": "number", "description": "评分" }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "staffId": { "type": "string", "description": "人员ID" }, "staffType": { "type": "string", "description": "人员类型" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/服务人员标签VO", "originalRef": "服务人员标签VO" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" } }, "title": "服务人员列表VO" }, "服务人员创建请求": { "type": "object", "required": [ "name", "staffType" ], "properties": { "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "birthDate": { "type": "string", "format": "date", "example": "1990-01-15", "description": "出生日期" }, "certificateTags": { "type": "array", "description": "证书标签列表（旧字段，建议用certificates）", "items": { "type": "string" } }, "certificateUrls": { "type": "array", "description": "资质证书URL列表（旧字段，建议用certificates）", "items": { "type": "string" } }, "certificates": { "type": "array", "example": [ { "tag": "急救证书", "url": "https://xxx/cert.jpg" } ], "description": "证书列表（标签+附件一一对应）", "items": { "$ref": "#/definitions/Map«string,string»", "originalRef": "Map«string,string»" } }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "人员描述" }, "emergencyContact": { "type": "string", "description": "紧急联系人" }, "emergencyPhone": { "type": "string", "description": "紧急联系电话" }, "ethnicity": { "type": "string", "example": "汉族", "description": "民族" }, "gender": { "type": "integer", "format": "int32", "example": 1, "description": "性别：0=女 1=男" }, "guideCardNo": { "type": "string", "example": "D-5101-000001", "description": "导游证号" }, "guideLanguage": { "type": "string", "example": "中文", "description": "导游语种" }, "guideLevel": { "type": "string", "example": "中级", "description": "导游等级" }, "highlights": { "type": "string", "description": "人员亮点" }, "idCardUrls": { "type": "array", "description": "证件照URL列表", "items": { "type": "string" } }, "languages": { "type": "array", "description": "掌握语言（JSON数组）", "items": { "type": "string" } }, "licenseExpiry": { "type": "string", "format": "date", "description": "执照到期日" }, "licenseNo": { "type": "string", "description": "执照编号" }, "licenseType": { "type": "string", "description": "执照类型" }, "name": { "type": "string", "example": "张导", "description": "姓名" }, "nationality": { "type": "string", "example": "中国", "description": "国籍" }, "nativePlace": { "type": "string", "example": "四川成都", "description": "籍贯" }, "phone": { "type": "string", "example": 13800138000, "description": "手机号" }, "photoUrls": { "type": "array", "description": "个人照片URL列表", "items": { "type": "string" } }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "serviceAreas": { "type": "array", "description": "服务区域（JSON数组）", "items": { "type": "string" } }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "specialties": { "type": "array", "description": "擅长领域（JSON数组）", "items": { "type": "string" } }, "staffType": { "type": "string", "example": "GUIDE", "description": "人员类型" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "yearsOfExperience": { "type": "integer", "format": "int32", "example": 5, "description": "从业年限" } }, "title": "服务人员创建请求" }, "服务人员更新请求": { "type": "object", "properties": { "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "birthDate": { "type": "string", "format": "date", "example": "1990-01-15", "description": "出生日期" }, "certificateTags": { "type": "array", "description": "证书标签列表（旧字段，建议用certificates）", "items": { "type": "string" } }, "certificateUrls": { "type": "array", "description": "资质证书URL列表（旧字段，建议用certificates）", "items": { "type": "string" } }, "certificates": { "type": "array", "example": [ { "tag": "急救证书", "url": "https://xxx/cert.jpg" } ], "description": "证书列表（标签+附件一一对应）", "items": { "$ref": "#/definitions/Map«string,string»", "originalRef": "Map«string,string»" } }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "description": { "type": "string", "description": "人员描述" }, "emergencyContact": { "type": "string", "description": "紧急联系人" }, "emergencyPhone": { "type": "string", "description": "紧急联系电话" }, "ethnicity": { "type": "string", "example": "汉族", "description": "民族" }, "gender": { "type": "integer", "format": "int32", "example": 1, "description": "性别：0=女 1=男" }, "guideCardNo": { "type": "string", "description": "导游证号" }, "guideLanguage": { "type": "string", "description": "导游语种" }, "guideLevel": { "type": "string", "description": "导游等级" }, "highlights": { "type": "string", "description": "人员亮点" }, "idCardUrls": { "type": "array", "description": "证件照URL列表", "items": { "type": "string" } }, "languages": { "type": "array", "description": "掌握语言（JSON数组）", "items": { "type": "string" } }, "licenseExpiry": { "type": "string", "format": "date", "description": "执照到期日" }, "licenseNo": { "type": "string", "description": "执照编号" }, "licenseType": { "type": "string", "description": "执照类型" }, "name": { "type": "string", "example": "张导", "description": "姓名" }, "nationality": { "type": "string", "example": "中国", "description": "国籍" }, "nativePlace": { "type": "string", "example": "四川成都", "description": "籍贯" }, "phone": { "type": "string", "example": 13800138000, "description": "手机号" }, "photoUrls": { "type": "array", "description": "个人照片URL列表", "items": { "type": "string" } }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "serviceAreas": { "type": "array", "description": "服务区域（JSON数组）", "items": { "type": "string" } }, "sortOrder": { "type": "integer", "format": "int32", "example": 0, "description": "排序权重，值越大越靠前" }, "specialties": { "type": "array", "description": "擅长领域（JSON数组）", "items": { "type": "string" } }, "staffType": { "type": "string", "example": "GUIDE", "description": "人员类型" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "yearsOfExperience": { "type": "integer", "format": "int32", "description": "从业年限" } }, "title": "服务人员更新请求" }, "服务人员标签VO": { "type": "object", "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "tagColor": { "type": "string", "description": "标签颜色（十六进制）" }, "tagId": { "type": "string", "description": "标签ID" }, "tagName": { "type": "string", "description": "标签名称" }, "tagType": { "type": "integer", "format": "int32", "description": "标签类型：0=预设 1=自定义" }, "useCount": { "type": "integer", "format": "int32", "description": "使用次数" } }, "title": "服务人员标签VO" }, "服务人员标签创建请求": { "type": "object", "required": [ "tagName" ], "properties": { "tagColor": { "type": "string", "example": "#3366FF", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "金牌导游", "description": "标签名称" } }, "title": "服务人员标签创建请求" }, "服务人员标签更新请求": { "type": "object", "properties": { "tagColor": { "type": "string", "example": "#3366FF", "description": "标签颜色（十六进制）" }, "tagName": { "type": "string", "example": "金牌导游", "description": "标签名称" } }, "title": "服务人员标签更新请求" }, "服务人员详情VO": { "type": "object", "properties": { "bannerMaterialIds": { "type": "array", "description": "横幅素材ID列表", "items": { "type": "string" } }, "bannerUrls": { "type": "array", "description": "横幅图URL列表", "items": { "type": "string" } }, "birthDate": { "type": "string", "format": "date", "description": "出生日期" }, "certificateTags": { "type": "array", "description": "证书标签列表（旧字段，建议用certificates）", "items": { "type": "string" } }, "certificateUrls": { "type": "array", "description": "资质证书URL列表（旧字段，建议用certificates）", "items": { "type": "string" } }, "certificates": { "type": "array", "description": "证书列表（标签+附件一一对应）[{tag,url}]", "items": { "$ref": "#/definitions/Map«string,string»", "originalRef": "Map«string,string»" } }, "coverMaterialId": { "type": "string", "description": "封面素材ID" }, "coverUrl": { "type": "string", "description": "封面图URL" }, "createdAt": { "type": "string", "format": "date-time", "description": "创建时间" }, "createdBy": { "type": "string", "description": "创建者ID" }, "description": { "type": "string", "description": "人员描述" }, "emergencyContact": { "type": "string", "description": "紧急联系人" }, "emergencyPhone": { "type": "string", "description": "紧急联系电话" }, "ethnicity": { "type": "string", "description": "民族" }, "gender": { "type": "integer", "format": "int32", "description": "性别：0=女 1=男" }, "guideCardNo": { "type": "string", "description": "导游证号" }, "guideLanguage": { "type": "string", "description": "导游语种" }, "guideLevel": { "type": "string", "description": "导游等级" }, "highlights": { "type": "string", "description": "人员亮点" }, "idCardUrls": { "type": "array", "description": "证件照URL列表", "items": { "type": "string" } }, "languages": { "type": "array", "description": "掌握语言", "items": { "type": "string" } }, "licenseExpiry": { "type": "string", "format": "date", "description": "执照到期日" }, "licenseNo": { "type": "string", "description": "执照编号" }, "licenseType": { "type": "string", "description": "执照类型" }, "name": { "type": "string", "description": "姓名" }, "nationality": { "type": "string", "description": "国籍" }, "nativePlace": { "type": "string", "description": "籍贯" }, "phone": { "type": "string", "description": "手机号" }, "photoUrls": { "type": "array", "description": "个人照片URL列表", "items": { "type": "string" } }, "priceExcludes": { "type": "string", "description": "价格不包含内容" }, "priceIncludes": { "type": "string", "description": "价格包含内容" }, "rating": { "type": "number", "description": "评分" }, "reviewCount": { "type": "integer", "format": "int32", "description": "评价数" }, "serviceAreas": { "type": "array", "description": "服务区域", "items": { "type": "string" } }, "sortOrder": { "type": "integer", "format": "int32", "description": "排序权重" }, "specialties": { "type": "array", "description": "擅长领域", "items": { "type": "string" } }, "staffId": { "type": "string", "description": "人员ID" }, "staffType": { "type": "string", "description": "人员类型" }, "status": { "type": "integer", "format": "int32", "description": "状态：0=下架 1=上架" }, "tags": { "type": "array", "description": "标签列表", "items": { "$ref": "#/definitions/服务人员标签VO", "originalRef": "服务人员标签VO" } }, "updatedAt": { "type": "string", "format": "date-time", "description": "更新时间" }, "videoMaterialIds": { "type": "array", "description": "视频素材ID列表", "items": { "type": "string" } }, "videoUrls": { "type": "array", "description": "视频URL列表", "items": { "type": "string" } }, "viewCount": { "type": "integer", "format": "int32", "description": "浏览量" }, "yearsOfExperience": { "type": "integer", "format": "int32", "description": "从业年限" } }, "title": "服务人员详情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": { "code": { "type": "integer", "format": "int32", "example": 200, "description": "状态码" }, "data": { "description": "响应数据", "$ref": "#/definitions/服务人员详情VO", "originalRef": "服务人员详情VO" }, "message": { "type": "string", "example": "成功", "description": "响应消息" } }, "title": "统一响应结果«服务人员详情VO»" }, "设置人员标签请求": { "type": "object", "required": [ "tagIds" ], "properties": { "tagIds": { "type": "array", "description": "标签ID列表", "items": { "type": "integer", "format": "int64" } } }, "title": "设置人员标签请求" } } }