6999 行
267 KiB
Markdown
6999 行
267 KiB
Markdown
# 资源服务 API 文档
|
||
|
||
**服务**: `hl-resource-service`
|
||
**接口总数**: 183
|
||
|
||
## 目录
|
||
|
||
- **住宿标签管理** (8 个接口)
|
||
- **住宿管理** (10 个接口)
|
||
- **增值服务管理** (9 个接口)
|
||
- **备品标签管理** (8 个接口)
|
||
- **备品管理** (9 个接口)
|
||
- **房型价格日历** (4 个接口)
|
||
- **房型管理** (7 个接口)
|
||
- **景区价格日历** (4 个接口)
|
||
- **景区季节内容** (3 个接口)
|
||
- **景区标签管理** (8 个接口)
|
||
- **景区管理** (9 个接口)
|
||
- **服务人员价格日历** (4 个接口)
|
||
- **服务人员标签管理** (8 个接口)
|
||
- **服务人员管理** (9 个接口)
|
||
- **服务价格日历** (4 个接口)
|
||
- **服务标签管理** (8 个接口)
|
||
- **游玩项目价格日历** (4 个接口)
|
||
- **游玩项目标签管理** (8 个接口)
|
||
- **游玩项目管理** (9 个接口)
|
||
- **费用项价格日历** (3 个接口)
|
||
- **费用项管理** (8 个接口)
|
||
- **车型价格日历** (4 个接口)
|
||
- **车型标签管理** (8 个接口)
|
||
- **车型管理** (10 个接口)
|
||
- **餐厅标签管理** (8 个接口)
|
||
- **餐厅管理** (9 个接口)
|
||
|
||
---
|
||
|
||
## 住宿标签管理
|
||
|
||
### `PUT` /admin/hotel/item/{hotelId}/tags
|
||
|
||
**设置住宿标签**
|
||
|
||
全量替换指定住宿的标签列表。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelId` | `integer` | | 住宿ID |
|
||
|
||
**请求体** `酒店标签更新请求_1`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagIds` | `string[]` | | 标签ID列表（全量替换） |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/items/batch/tags
|
||
|
||
**批量添加/移除标签**
|
||
|
||
对多个住宿批量添加/移除标签。增量操作，不影响未指定的标签。
|
||
|
||
**请求体** `酒店批量标签操作请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `addTagIds` | `string[]` | | 要添加的标签ID列表 |
|
||
| `hotelIds` | `string[]` | 是 | 酒店ID列表 |
|
||
| `removeTagIds` | `string[]` | | 要移除的标签ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/hotel/tag
|
||
|
||
**创建标签**
|
||
|
||
创建预设标签，标签名不可重复。
|
||
|
||
**请求体** `酒店标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«酒店标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `酒店标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/hotel/tag/adhoc
|
||
|
||
**查找或创建自定义标签**
|
||
|
||
按名称查找标签，不存在则自动创建。用于住宿编辑时快速输入新标签。
|
||
|
||
**请求体** `酒店标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«酒店标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `酒店标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/tag/{tagId}
|
||
|
||
**更新标签**
|
||
|
||
修改标签名称或颜色，所有关联住宿自动生效。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**请求体** `酒店标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
|
||
**响应** `统一响应结果«酒店标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `酒店标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/hotel/tag/{tagId}
|
||
|
||
**删除标签**
|
||
|
||
删除标签并解除所有住宿与该标签的关联。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/hotel/tags
|
||
|
||
**预设标签列表（分页）**
|
||
|
||
分页查询住宿标签库，支持按关键词搜索。
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 关键词 | |
|
||
| `page` | `integer(int32)` | | 页码 | |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | |
|
||
|
||
**响应** `统一响应结果«分页结果«酒店标签VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«酒店标签VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `酒店标签VO[]` | | 数据列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/hotel/tags/all
|
||
|
||
**所有标签列表**
|
||
|
||
不分页返回所有标签，用于住宿编辑时的标签选择。
|
||
|
||
**响应** `统一响应结果«List«酒店标签VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `酒店标签VO[]` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 住宿管理
|
||
|
||
### `POST` /admin/hotel/item
|
||
|
||
**创建住宿**
|
||
|
||
新建住宿资源（酒店/民宿/营地等），初始状态为草稿(status=0)。创建后需通过「提交启用/禁用审批」走企微OA审批流程才能上架。住宿下可继续创建房型（RoomType），房型有独立的价格日历。
|
||
|
||
**关联字典**：
|
||
- hotel_type：住宿类型（表单选择）
|
||
- hotel_star_level：酒店星级（表单选择）
|
||
- hotel_facility：酒店设施（表单多选）
|
||
|
||
**请求体** `酒店创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | 是 | 详细地址 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `checkInNotes` | `string` | | 入住须知 |
|
||
| `checkInTime` | `string` | | 入住时间 |
|
||
| `checkOutTime` | `string` | | 退房时间 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 酒店描述 |
|
||
| `diamondLevel` | `int` | | 钻级：0-5 |
|
||
| `district` | `string` | | 区县 |
|
||
| `facilities` | `string` | | 设施配置（JSON） |
|
||
| `highlights` | `string` | | 酒店亮点（JSON） |
|
||
| `hotelType` | `string` | 是 | 住宿类型 |
|
||
| `latitude` | `number` | 是 | 纬度 |
|
||
| `longitude` | `number` | 是 | 经度 |
|
||
| `luggageInfo` | `string` | | 行李服务说明 |
|
||
| `name` | `string` | 是 | 酒店名称 |
|
||
| `parkingInfo` | `string` | | 停车信息 |
|
||
| `province` | `string` | | 省份 |
|
||
| `shuttleInfo` | `string` | | 接驳服务说明 |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `starLevel` | `int` | | 星级：1-5 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«酒店详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `酒店详情VO` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `checkInNotes` | `string` | | 入住须知 |
|
||
| `checkInTime` | `string` | | 入住时间 |
|
||
| `checkOutTime` | `string` | | 退房时间 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 酒店描述 |
|
||
| `diamondLevel` | `int` | | 钻级：0-5 |
|
||
| `district` | `string` | | 区县 |
|
||
| `facilities` | `string` | | 设施配置（JSON） |
|
||
| `highlights` | `string` | | 酒店亮点（JSON） |
|
||
| `hotelId` | `string` | | 酒店ID |
|
||
| `hotelType` | `string` | | 住宿类型 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `luggageInfo` | `string` | | 行李服务说明 |
|
||
| `name` | `string` | | 酒店名称 |
|
||
| `parkingInfo` | `string` | | 停车信息 |
|
||
| `province` | `string` | | 省份 |
|
||
| `roomTypeCount` | `int` | | 房型数量 |
|
||
| `shuttleInfo` | `string` | | 接驳服务说明 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `starLevel` | `int` | | 星级：1-5 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `酒店标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/hotel/item/{hotelId}
|
||
|
||
**住宿详情**
|
||
|
||
获取住宿完整信息，包含素材URL、标签列表、房型列表等。素材ID会自动解析为OSS访问地址。
|
||
|
||
**关联字典**：
|
||
- hotel_type：住宿类型（详情显示）
|
||
- hotel_star_level：酒店星级（详情显示）
|
||
- hotel_facility：酒店设施（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelId` | `integer` | | 住宿ID |
|
||
|
||
**响应** `统一响应结果«酒店详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `酒店详情VO` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `checkInNotes` | `string` | | 入住须知 |
|
||
| `checkInTime` | `string` | | 入住时间 |
|
||
| `checkOutTime` | `string` | | 退房时间 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 酒店描述 |
|
||
| `diamondLevel` | `int` | | 钻级：0-5 |
|
||
| `district` | `string` | | 区县 |
|
||
| `facilities` | `string` | | 设施配置（JSON） |
|
||
| `highlights` | `string` | | 酒店亮点（JSON） |
|
||
| `hotelId` | `string` | | 酒店ID |
|
||
| `hotelType` | `string` | | 住宿类型 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `luggageInfo` | `string` | | 行李服务说明 |
|
||
| `name` | `string` | | 酒店名称 |
|
||
| `parkingInfo` | `string` | | 停车信息 |
|
||
| `province` | `string` | | 省份 |
|
||
| `roomTypeCount` | `int` | | 房型数量 |
|
||
| `shuttleInfo` | `string` | | 接驳服务说明 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `starLevel` | `int` | | 星级：1-5 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `酒店标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/item/{hotelId}
|
||
|
||
**更新住宿**
|
||
|
||
更新住宿基本信息。更新不会改变当前状态，已上架的住宿修改后仍保持上架状态。
|
||
|
||
**关联字典**：
|
||
- hotel_type：住宿类型（表单选择）
|
||
- hotel_star_level：酒店星级（表单选择）
|
||
- hotel_facility：酒店设施（表单多选）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelId` | `integer` | | 住宿ID |
|
||
|
||
**请求体** `酒店更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `checkInNotes` | `string` | | 入住须知 |
|
||
| `checkInTime` | `string` | | 入住时间 |
|
||
| `checkOutTime` | `string` | | 退房时间 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 酒店描述 |
|
||
| `diamondLevel` | `int` | | 钻级：0-5 |
|
||
| `district` | `string` | | 区县 |
|
||
| `facilities` | `string` | | 设施配置（JSON） |
|
||
| `highlights` | `string` | | 酒店亮点（JSON） |
|
||
| `hotelType` | `string` | | 住宿类型 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `luggageInfo` | `string` | | 行李服务说明 |
|
||
| `name` | `string` | | 酒店名称 |
|
||
| `parkingInfo` | `string` | | 停车信息 |
|
||
| `province` | `string` | | 省份 |
|
||
| `shuttleInfo` | `string` | | 接驳服务说明 |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `starLevel` | `int` | | 星级：1-5 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«酒店详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `酒店详情VO` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `checkInNotes` | `string` | | 入住须知 |
|
||
| `checkInTime` | `string` | | 入住时间 |
|
||
| `checkOutTime` | `string` | | 退房时间 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 酒店描述 |
|
||
| `diamondLevel` | `int` | | 钻级：0-5 |
|
||
| `district` | `string` | | 区县 |
|
||
| `facilities` | `string` | | 设施配置（JSON） |
|
||
| `highlights` | `string` | | 酒店亮点（JSON） |
|
||
| `hotelId` | `string` | | 酒店ID |
|
||
| `hotelType` | `string` | | 住宿类型 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `luggageInfo` | `string` | | 行李服务说明 |
|
||
| `name` | `string` | | 酒店名称 |
|
||
| `parkingInfo` | `string` | | 停车信息 |
|
||
| `province` | `string` | | 省份 |
|
||
| `roomTypeCount` | `int` | | 房型数量 |
|
||
| `shuttleInfo` | `string` | | 接驳服务说明 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `starLevel` | `int` | | 星级：1-5 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `酒店标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/hotel/item/{hotelId}
|
||
|
||
**删除住宿**
|
||
|
||
软删除住宿。仅SUPER_ADMIN或创建者可操作。删除住宿会同时删除其下所有房型和价格日历数据。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelId` | `integer` | | 住宿ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/item/{hotelId}/status
|
||
|
||
**启用/禁用切换**
|
||
|
||
直接修改住宿状态（跳过审批），仅限SUPER_ADMIN使用。状态值：0=草稿，1=上架，2=下架。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelId` | `integer` | | 住宿ID |
|
||
|
||
**请求体** `酒店状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelIds` | `string[]` | | 酒店ID列表（批量操作时使用） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/hotel/item/{hotelId}/submit-approval
|
||
|
||
**提交启用/禁用审批**
|
||
|
||
向企微OA提交住宿启用/禁用审批。targetStatus=1申请上架，targetStatus=2申请下架。审批通过后自动更新状态。返回企微审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelId` | `integer` | | 住宿ID |
|
||
|
||
**请求体** `酒店审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | 是 | 审批理由 |
|
||
| `targetStatus` | `int` | 是 | 目标状态：1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/hotel/items
|
||
|
||
**住宿列表**
|
||
|
||
分页查询住宿列表，支持按名称关键词、状态、住宿类型等条件筛选。返回列表摘要信息，按sortOrder倒序+创建时间倒序排列。
|
||
|
||
**关联字典**：
|
||
- hotel_type：住宿类型（筛选+列表显示）
|
||
- hotel_star_level：酒店星级（筛选+列表显示）
|
||
- hotel_facility：酒店设施（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `city` | `string` | | 城市筛选 | 丽江市 |
|
||
| `cityKeyword` | `string` | | 城市/区域关键词模糊搜索（匹配城市名、省份、地址） | 海拉尔 |
|
||
| `hotelType` | `string` | | 住宿类型筛选 | HOTEL |
|
||
| `keyword` | `string` | | 搜索关键词（名称/地址模糊匹配） | 丽江 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `sortBy` | `string` | | 排序字段 | createdAt |
|
||
| `sortDir` | `string` | | 排序方向：asc/desc | desc |
|
||
| `starLevel` | `integer(int32)` | | 星级筛选 | 5 |
|
||
| `status` | `integer(int32)` | | 状态筛选：0=草稿 1=上架 2=下架 | 1 |
|
||
| `tagId` | `integer(int64)` | | 标签ID（单个） | |
|
||
| `tagIds` | `string` | | 标签ID列表（逗号分隔） | 1,2,3 |
|
||
|
||
**响应** `统一响应结果«分页结果«酒店列表VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«酒店列表VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `酒店列表VO[]` | | 数据列表 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `city` | `string` | | 城市 |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `diamondLevel` | `int` | | 钻级：0-5 |
|
||
| `hotelId` | `string` | | 酒店ID |
|
||
| `hotelType` | `string` | | 住宿类型 |
|
||
| `name` | `string` | | 酒店名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `roomTypeCount` | `int` | | 房型数量 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `starLevel` | `int` | | 星级：1-5 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `酒店标签VO[]` | | 标签列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/hotel/items/all-simple
|
||
|
||
**所有启用的住宿（不分页，仅ID和名称）**
|
||
|
||
返回所有已上架(status=1)的住宿简要信息，用于下拉选择框。每项只含hotelId和name字段。适用于房型管理时选择所属住宿、产品编排时绑定住宿资源等场景。
|
||
|
||
**响应** `统一响应结果«List«Map«string,object»»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `Map«string,object»[]` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/hotel/items/batch
|
||
|
||
**批量删除**
|
||
|
||
批量软删除多个住宿及其关联的房型和价格日历。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**请求体** `酒店批量删除请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelIds` | `string[]` | 是 | 酒店ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/items/batch/status
|
||
|
||
**批量启用/禁用**
|
||
|
||
批量修改多个住宿的状态，跳过审批流程。hotelIds为住宿ID列表（字符串格式）。
|
||
|
||
**请求体** `酒店状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelIds` | `string[]` | | 酒店ID列表（批量操作时使用） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 增值服务管理
|
||
|
||
### `POST` /admin/service/item
|
||
|
||
**创建增值服务**
|
||
|
||
新建增值服务项目（如保险、签证代办、接送机等），初始状态为草稿(status=0)。支持免费(isPaid=false)和付费两种模式，付费服务有独立的价格日历。需走企微审批上架。
|
||
|
||
**关联字典**：
|
||
- service_category：服务分类（表单选择）
|
||
- billing_type_service：服务计费方式（表单选择）
|
||
- service_unit：服务计量单位（表单选择）
|
||
|
||
**请求体** `服务项创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `advanceBookingHours` | `int` | | 提前预订时间（小时） |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `basePrice` | `number` | | 基础价格（元） |
|
||
| `billingType` | `string` | | 计费方式 |
|
||
| `cancellationPolicy` | `string` | | 取消政策说明 |
|
||
| `capacityMax` | `int` | | 最多服务人数 |
|
||
| `capacityMin` | `int` | | 最少服务人数 |
|
||
| `categoryCode` | `string` | 是 | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 服务描述 |
|
||
| `durationHours` | `number` | | 服务时长（小时） |
|
||
| `equipmentList` | `string` | | 设备清单（JSON） |
|
||
| `freeCancelHours` | `int` | | 免费取消期限（小时） |
|
||
| `highlights` | `string` | | 服务亮点 |
|
||
| `includedItems` | `string` | | 包含项目说明 |
|
||
| `instantConfirm` | `int` | | 是否即时确认：0=否 1=是 |
|
||
| `isPaid` | `int` | 是 | 是否收费：0=免费 1=收费 |
|
||
| `languageSupport` | `string` | | 语言支持 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | 是 | 服务名称 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `province` | `string` | | 省份 |
|
||
| `serviceHours` | `string` | | 服务时段 |
|
||
| `serviceProcess` | `string` | | 服务流程说明 |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `staffCount` | `int` | | 服务人员数量 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleType` | `string` | | 配套车型 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«服务项详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务项详情VO` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `advanceBookingHours` | `int` | | 提前预订时间（小时） |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础价格（元） |
|
||
| `billingType` | `string` | | 计费方式 |
|
||
| `cancellationPolicy` | `string` | | 取消政策说明 |
|
||
| `capacityMax` | `int` | | 最多服务人数 |
|
||
| `capacityMin` | `int` | | 最少服务人数 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 服务描述 |
|
||
| `durationHours` | `number` | | 服务时长（小时） |
|
||
| `equipmentList` | `string` | | 设备清单（JSON） |
|
||
| `freeCancelHours` | `int` | | 免费取消期限（小时） |
|
||
| `highlights` | `string` | | 服务亮点 |
|
||
| `includedItems` | `string` | | 包含项目说明 |
|
||
| `instantConfirm` | `int` | | 是否即时确认：0=否 1=是 |
|
||
| `isPaid` | `int` | | 是否收费：0=免费 1=收费 |
|
||
| `languageSupport` | `string` | | 语言支持 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 服务名称 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `province` | `string` | | 省份 |
|
||
| `serviceHours` | `string` | | 服务时段 |
|
||
| `serviceId` | `string` | | 服务项ID |
|
||
| `serviceProcess` | `string` | | 服务流程说明 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `staffCount` | `int` | | 服务人员数量 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `服务标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleType` | `string` | | 配套车型 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/service/item/{serviceId}
|
||
|
||
**增值服务详情**
|
||
|
||
获取增值服务完整信息，包含素材URL、标签、计费方式等。
|
||
|
||
**关联字典**：
|
||
- service_category：服务分类（详情显示）
|
||
- billing_type_service：服务计费方式（详情显示）
|
||
- service_unit：服务计量单位（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**响应** `统一响应结果«服务项详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务项详情VO` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `advanceBookingHours` | `int` | | 提前预订时间（小时） |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础价格（元） |
|
||
| `billingType` | `string` | | 计费方式 |
|
||
| `cancellationPolicy` | `string` | | 取消政策说明 |
|
||
| `capacityMax` | `int` | | 最多服务人数 |
|
||
| `capacityMin` | `int` | | 最少服务人数 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 服务描述 |
|
||
| `durationHours` | `number` | | 服务时长（小时） |
|
||
| `equipmentList` | `string` | | 设备清单（JSON） |
|
||
| `freeCancelHours` | `int` | | 免费取消期限（小时） |
|
||
| `highlights` | `string` | | 服务亮点 |
|
||
| `includedItems` | `string` | | 包含项目说明 |
|
||
| `instantConfirm` | `int` | | 是否即时确认：0=否 1=是 |
|
||
| `isPaid` | `int` | | 是否收费：0=免费 1=收费 |
|
||
| `languageSupport` | `string` | | 语言支持 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 服务名称 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `province` | `string` | | 省份 |
|
||
| `serviceHours` | `string` | | 服务时段 |
|
||
| `serviceId` | `string` | | 服务项ID |
|
||
| `serviceProcess` | `string` | | 服务流程说明 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `staffCount` | `int` | | 服务人员数量 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `服务标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleType` | `string` | | 配套车型 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/service/item/{serviceId}
|
||
|
||
**更新增值服务**
|
||
|
||
更新增值服务基本信息，不改变当前状态。
|
||
|
||
**关联字典**：
|
||
- service_category：服务分类（表单选择）
|
||
- billing_type_service：服务计费方式（表单选择）
|
||
- service_unit：服务计量单位（表单选择）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**请求体** `服务项更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `advanceBookingHours` | `int` | | 提前预订时间（小时） |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `basePrice` | `number` | | 基础价格（元） |
|
||
| `billingType` | `string` | | 计费方式 |
|
||
| `cancellationPolicy` | `string` | | 取消政策说明 |
|
||
| `capacityMax` | `int` | | 最多服务人数 |
|
||
| `capacityMin` | `int` | | 最少服务人数 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 服务描述 |
|
||
| `durationHours` | `number` | | 服务时长（小时） |
|
||
| `equipmentList` | `string` | | 设备清单（JSON） |
|
||
| `freeCancelHours` | `int` | | 免费取消期限（小时） |
|
||
| `highlights` | `string` | | 服务亮点 |
|
||
| `includedItems` | `string` | | 包含项目说明 |
|
||
| `instantConfirm` | `int` | | 是否即时确认：0=否 1=是 |
|
||
| `isPaid` | `int` | | 是否收费：0=免费 1=收费 |
|
||
| `languageSupport` | `string` | | 语言支持 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 服务名称 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `province` | `string` | | 省份 |
|
||
| `serviceHours` | `string` | | 服务时段 |
|
||
| `serviceProcess` | `string` | | 服务流程说明 |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `staffCount` | `int` | | 服务人员数量 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleType` | `string` | | 配套车型 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«服务项详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务项详情VO` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `advanceBookingHours` | `int` | | 提前预订时间（小时） |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础价格（元） |
|
||
| `billingType` | `string` | | 计费方式 |
|
||
| `cancellationPolicy` | `string` | | 取消政策说明 |
|
||
| `capacityMax` | `int` | | 最多服务人数 |
|
||
| `capacityMin` | `int` | | 最少服务人数 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 服务描述 |
|
||
| `durationHours` | `number` | | 服务时长（小时） |
|
||
| `equipmentList` | `string` | | 设备清单（JSON） |
|
||
| `freeCancelHours` | `int` | | 免费取消期限（小时） |
|
||
| `highlights` | `string` | | 服务亮点 |
|
||
| `includedItems` | `string` | | 包含项目说明 |
|
||
| `instantConfirm` | `int` | | 是否即时确认：0=否 1=是 |
|
||
| `isPaid` | `int` | | 是否收费：0=免费 1=收费 |
|
||
| `languageSupport` | `string` | | 语言支持 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 服务名称 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `province` | `string` | | 省份 |
|
||
| `serviceHours` | `string` | | 服务时段 |
|
||
| `serviceId` | `string` | | 服务项ID |
|
||
| `serviceProcess` | `string` | | 服务流程说明 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `staffCount` | `int` | | 服务人员数量 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `服务标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleType` | `string` | | 配套车型 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/service/item/{serviceId}
|
||
|
||
**删除增值服务**
|
||
|
||
软删除增值服务。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/service/item/{serviceId}/status
|
||
|
||
**启用/禁用切换**
|
||
|
||
直接修改状态（跳过审批），仅限SUPER_ADMIN。状态值：0=草稿，1=上架，2=下架。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**请求体** `服务项状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceIds` | `string[]` | | 服务ID列表（批量操作时使用） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/service/item/{serviceId}/submit-approval
|
||
|
||
**提交启用/禁用审批**
|
||
|
||
向企微OA提交审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**请求体** `服务项审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | 是 | 审批理由 |
|
||
| `targetStatus` | `int` | 是 | 目标状态：1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/service/items
|
||
|
||
**增值服务列表**
|
||
|
||
分页查询增值服务列表，支持按名称、状态、分类等条件筛选。
|
||
|
||
**关联字典**：
|
||
- service_category：服务分类（筛选+列表显示）
|
||
- billing_type_service：服务计费方式（列表显示）
|
||
- service_unit：服务计量单位（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `billingType` | `string` | | 计费方式筛选 | PER_DAY |
|
||
| `categoryCode` | `string` | | 分类编码筛选 | GUIDE |
|
||
| `city` | `string` | | 城市筛选 | 丽江市 |
|
||
| `cityKeyword` | `string` | | 城市/区域关键词模糊搜索（匹配城市名、省份、地址） | 海拉尔 |
|
||
| `instantConfirm` | `integer(int32)` | | 是否即时确认筛选：0=否 1=是 | 1 |
|
||
| `isPaid` | `integer(int32)` | | 是否收费筛选：0=免费 1=收费 | 1 |
|
||
| `keyword` | `string` | | 搜索关键词（名称模糊匹配） | 导游 |
|
||
| `maxPrice` | `number` | | 最高价格筛选 | 1000.0 |
|
||
| `minPrice` | `number` | | 最低价格筛选 | 100.0 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `sortBy` | `string` | | 排序字段 | createdAt |
|
||
| `sortDir` | `string` | | 排序方向：asc/desc | desc |
|
||
| `status` | `integer(int32)` | | 状态筛选：0=草稿 1=上架 2=下架 | 1 |
|
||
| `tagId` | `integer(int64)` | | 标签ID（单个） | |
|
||
| `tagIds` | `string` | | 标签ID列表（逗号分隔） | 1,2,3 |
|
||
| `vehicleType` | `string` | | 配套车型筛选 | 商务车 |
|
||
|
||
**响应** `统一响应结果«分页结果«服务项列表VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«服务项列表VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `服务项列表VO[]` | | 数据列表 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `basePrice` | `number` | | 基础价格（元） |
|
||
| `billingType` | `string` | | 计费方式 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `durationHours` | `number` | | 服务时长（小时） |
|
||
| `highlights` | `string` | | 服务亮点 |
|
||
| `instantConfirm` | `int` | | 是否即时确认：0=否 1=是 |
|
||
| `isPaid` | `int` | | 是否收费：0=免费 1=收费 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 服务名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `serviceId` | `string` | | 服务项ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `服务标签VO[]` | | 标签列表 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `vehicleType` | `string` | | 配套车型 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/service/items/batch
|
||
|
||
**批量删除**
|
||
|
||
批量软删除多个增值服务。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**请求体** `服务项批量删除请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceIds` | `string[]` | 是 | 服务ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/service/items/batch/status
|
||
|
||
**批量启用/禁用**
|
||
|
||
批量修改多个增值服务的状态，跳过审批流程。
|
||
|
||
**请求体** `服务项状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceIds` | `string[]` | | 服务ID列表（批量操作时使用） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 备品标签管理
|
||
|
||
### `PUT` /admin/supplies/item/{suppliesId}/tags
|
||
|
||
**更新备品标签**
|
||
|
||
全量替换指定备品的标签列表。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `suppliesId` | `integer` | | 备品ID |
|
||
|
||
**请求体** `备品标签更新请求_1`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagIds` | `string[]` | | 标签ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/supplies/items/batch/tags
|
||
|
||
**批量打标签**
|
||
|
||
对多个备品批量添加/移除标签。增量操作。
|
||
|
||
**请求体** `备品批量标签操作请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `addTagIds` | `string[]` | | 要添加的标签ID列表 |
|
||
| `removeTagIds` | `string[]` | | 要移除的标签ID列表 |
|
||
| `suppliesIds` | `string[]` | 是 | 备品ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/supplies/tag
|
||
|
||
**创建管理标签**
|
||
|
||
创建预设标签，标签名不可重复。
|
||
|
||
**请求体** `备品标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«备品标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `备品标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/supplies/tag/adhoc
|
||
|
||
**解析自定义标签**
|
||
|
||
按名称查找或自动创建标签。
|
||
|
||
**请求体** `备品标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«备品标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `备品标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/supplies/tag/{tagId}
|
||
|
||
**编辑标签**
|
||
|
||
修改标签名称或颜色，所有关联备品自动生效。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**请求体** `备品标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
|
||
**响应** `统一响应结果«备品标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `备品标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/supplies/tag/{tagId}
|
||
|
||
**删除标签**
|
||
|
||
删除标签并解除所有备品与该标签的关联。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/supplies/tags
|
||
|
||
**获取管理标签列表（分页）**
|
||
|
||
分页查询备品标签库，支持按关键词搜索。
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 关键词 | |
|
||
| `page` | `integer(int32)` | | 页码 | |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | |
|
||
|
||
**响应** `统一响应结果«分页结果«备品标签视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«备品标签视图»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `备品标签视图[]` | | 数据列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/supplies/tags/all
|
||
|
||
**获取全部标签**
|
||
|
||
不分页返回所有标签，用于备品编辑时的标签选择下拉。
|
||
|
||
**响应** `统一响应结果«List«备品标签视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `备品标签视图[]` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 备品管理
|
||
|
||
### `POST` /admin/supplies/item
|
||
|
||
**创建备品**
|
||
|
||
新建备品资源（帐篷、睡袋、炊具等物资），初始状态为草稿(status=0)。需走企微审批上架。支持按件(PER_ITEM)和按人(PER_PERSON)计费。
|
||
|
||
**关联字典**：
|
||
- supplies_category：备品分类（表单选择）
|
||
- billing_type：计费方式（表单选择）
|
||
|
||
**请求体** `备品创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `basePrice` | `number` | 是 | 基础单价（元） |
|
||
| `billingType` | `string` | 是 | 计费方式：PER_ITEM=按件 PER_DAY=按天 |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `categoryCode` | `string` | 是 | 分类编码 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 备品描述 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `includes` | `string[]` | | 包含物品清单 |
|
||
| `model` | `string` | | 型号 |
|
||
| `name` | `string` | 是 | 备品名称 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `sizeOptions` | `string[]` | | 可选尺码列表 |
|
||
| `sortOrder` | `int` | | 排序权重（数字越大越靠前） |
|
||
| `specifications` | `string` | | 规格参数（JSON格式） |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `weight` | `number` | | 重量（kg） |
|
||
|
||
**响应** `统一响应结果«备品详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `备品详情视图` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `basePrice` | `number` | | 基础单价（元） |
|
||
| `billingType` | `string` | | 计费方式编码 |
|
||
| `billingTypeName` | `string` | | 计费方式名称 |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `categoryName` | `string` | | 分类名称 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `description` | `string` | | 备品描述 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `includes` | `string[]` | | 包含物品清单 |
|
||
| `model` | `string` | | 型号 |
|
||
| `name` | `string` | | 备品名称 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `sizeOptions` | `string[]` | | 可选尺码列表 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `specifications` | `string` | | 规格参数（JSON格式） |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `suppliesId` | `string` | | 备品ID |
|
||
| `tags` | `备品标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `weight` | `number` | | 重量（kg） |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/supplies/item/{suppliesId}
|
||
|
||
**备品详情**
|
||
|
||
获取备品完整信息，包含素材URL、标签等。
|
||
|
||
**关联字典**：
|
||
- supplies_category：备品分类（详情显示）
|
||
- billing_type：计费方式（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `suppliesId` | `integer` | | 备品ID |
|
||
|
||
**响应** `统一响应结果«备品详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `备品详情视图` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `basePrice` | `number` | | 基础单价（元） |
|
||
| `billingType` | `string` | | 计费方式编码 |
|
||
| `billingTypeName` | `string` | | 计费方式名称 |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `categoryName` | `string` | | 分类名称 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `description` | `string` | | 备品描述 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `includes` | `string[]` | | 包含物品清单 |
|
||
| `model` | `string` | | 型号 |
|
||
| `name` | `string` | | 备品名称 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `sizeOptions` | `string[]` | | 可选尺码列表 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `specifications` | `string` | | 规格参数（JSON格式） |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `suppliesId` | `string` | | 备品ID |
|
||
| `tags` | `备品标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `weight` | `number` | | 重量（kg） |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/supplies/item/{suppliesId}
|
||
|
||
**更新备品**
|
||
|
||
更新备品基本信息，不改变当前状态。
|
||
|
||
**关联字典**：
|
||
- supplies_category：备品分类（表单选择）
|
||
- billing_type：计费方式（表单选择）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `suppliesId` | `integer` | | 备品ID |
|
||
|
||
**请求体** `备品更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `basePrice` | `number` | | 基础单价（元） |
|
||
| `billingType` | `string` | | 计费方式：PER_ITEM=按件 PER_DAY=按天 |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 备品描述 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `includes` | `string[]` | | 包含物品清单 |
|
||
| `model` | `string` | | 型号 |
|
||
| `name` | `string` | | 备品名称 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `sizeOptions` | `string[]` | | 可选尺码列表 |
|
||
| `sortOrder` | `int` | | 排序权重（数字越大越靠前） |
|
||
| `specifications` | `string` | | 规格参数（JSON格式） |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `weight` | `number` | | 重量（kg） |
|
||
|
||
**响应** `统一响应结果«备品详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `备品详情视图` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `basePrice` | `number` | | 基础单价（元） |
|
||
| `billingType` | `string` | | 计费方式编码 |
|
||
| `billingTypeName` | `string` | | 计费方式名称 |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `categoryName` | `string` | | 分类名称 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `description` | `string` | | 备品描述 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `includes` | `string[]` | | 包含物品清单 |
|
||
| `model` | `string` | | 型号 |
|
||
| `name` | `string` | | 备品名称 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `sizeOptions` | `string[]` | | 可选尺码列表 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `specifications` | `string` | | 规格参数（JSON格式） |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `suppliesId` | `string` | | 备品ID |
|
||
| `tags` | `备品标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `weight` | `number` | | 重量（kg） |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/supplies/item/{suppliesId}
|
||
|
||
**删除备品**
|
||
|
||
软删除备品。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `suppliesId` | `integer` | | 备品ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/supplies/item/{suppliesId}/status
|
||
|
||
**上下架切换**
|
||
|
||
直接修改状态（跳过审批），仅限SUPER_ADMIN。状态值：0=草稿，1=上架，2=下架。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `suppliesId` | `integer` | | 备品ID |
|
||
|
||
**请求体** `备品状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
| `suppliesIds` | `string[]` | | 备品ID列表（批量操作） |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/supplies/item/{suppliesId}/submit-approval
|
||
|
||
**提交启用/禁用审批**
|
||
|
||
向企微OA提交审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `suppliesId` | `integer` | | 备品ID |
|
||
|
||
**请求体** `备品审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | 是 | 审批理由 |
|
||
| `targetStatus` | `int` | 是 | 目标状态：1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/supplies/items
|
||
|
||
**备品列表**
|
||
|
||
分页查询备品列表，支持按名称、状态、分类等条件筛选。
|
||
|
||
**关联字典**：
|
||
- supplies_category：备品分类（筛选+列表显示）
|
||
- billing_type：计费方式（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `billingType` | `string` | | 计费方式：PER_ITEM=按件 PER_DAY=按天 | PER_ITEM |
|
||
| `categoryCode` | `string` | | 分类编码 | OUTDOOR_GEAR |
|
||
| `keyword` | `string` | | 搜索关键词（名称/副标题模糊搜索） | 登山杖 |
|
||
| `maxPrice` | `number` | | 最高价格 | 500.0 |
|
||
| `minPrice` | `number` | | 最低价格 | 10.0 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `recommended` | `integer(int32)` | | 是否推荐：0=否 1=是 | 1 |
|
||
| `sortBy` | `string` | | 排序字段 | createdAt |
|
||
| `sortDir` | `string` | | 排序方向：asc=升序 desc=降序 | desc |
|
||
| `status` | `integer(int32)` | | 状态：0=草稿 1=上架 2=下架 | 1 |
|
||
| `tagId` | `integer(int64)` | | 标签ID | 100 |
|
||
| `tagIds` | `string` | | 标签ID列表（逗号分隔） | 100,101,102 |
|
||
|
||
**响应** `统一响应结果«分页结果«备品列表视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«备品列表视图»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `备品列表视图[]` | | 数据列表 |
|
||
| `approvalNo` | `string` | | 审批编号 |
|
||
| `basePrice` | `number` | | 基础单价（元） |
|
||
| `billingType` | `string` | | 计费方式编码 |
|
||
| `billingTypeName` | `string` | | 计费方式名称 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `categoryName` | `string` | | 分类名称 |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `name` | `string` | | 备品名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `suppliesId` | `string` | | 备品ID |
|
||
| `tags` | `备品标签视图[]` | | 标签列表 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/supplies/items/batch
|
||
|
||
**批量删除**
|
||
|
||
批量软删除多个备品。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**请求体** `备品批量删除请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `suppliesIds` | `string[]` | 是 | 备品ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/supplies/items/batch/status
|
||
|
||
**批量上下架**
|
||
|
||
批量修改多个备品的状态，跳过审批流程。
|
||
|
||
**请求体** `备品状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
| `suppliesIds` | `string[]` | | 备品ID列表（批量操作） |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 房型价格日历
|
||
|
||
### `GET` /admin/hotel/room-type/{roomTypeId}/prices
|
||
|
||
**查询价格日历**
|
||
|
||
按月查询房型的每日价格和可售状态。每个房型有独立的价格日历。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `month` | `integer(int32)` | | 月份 | |
|
||
| `year` | `integer(int32)` | | 年份 | |
|
||
|
||
**响应** `统一响应结果«酒店房型价格日历VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `酒店房型价格日历VO` | | 响应数据 |
|
||
| `hotelId` | `string` | | 酒店ID |
|
||
| `month` | `int` | | 月份 |
|
||
| `prices` | `酒店房型价格日历日VO[]` | | 价格日历明细列表 |
|
||
| `costPrice` | `number` | | 成本价（元） |
|
||
| `date` | `string` | | 日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `status` | `int` | | 状态：0=不可售 1=可售 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `stockUsed` | `int` | | 已用库存 |
|
||
| `roomTypeId` | `string` | | 房型ID |
|
||
| `roomTypeName` | `string` | | 房型名称 |
|
||
| `stockEnabled` | `boolean` | | 是否启用库存管理 |
|
||
| `year` | `int` | | 年份 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/room-type/{roomTypeId}/prices
|
||
|
||
**批量设置价格日历**
|
||
|
||
在指定日期范围内批量设置房型的成本价和可售状态。支持按星期过滤和排除特定日期。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**请求体** `酒店房型价格日历设置请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costPrice` | `number` | 是 | 成本价（元） |
|
||
| `endDate` | `string` | 是 | 结束日期（yyyy-MM-dd） |
|
||
| `excludeDates` | `string[]` | | 排除日期列表 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `selectedWeekdays` | `int[]` | | 指定星期几（1=周一 7=周日） |
|
||
| `startDate` | `string` | 是 | 开始日期（yyyy-MM-dd） |
|
||
| `status` | `int` | | 状态：0=不可售 1=可售 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `weekdayOnly` | `boolean` | | 是否仅工作日 |
|
||
| `weekendOnly` | `boolean` | | 是否仅周末 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/hotel/room-type/{roomTypeId}/prices
|
||
|
||
**删除价格日历**
|
||
|
||
删除指定日期范围内房型的所有价格记录。日期格式：yyyy-MM-dd。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `endDate` | `string` | | 结束日期 | |
|
||
| `startDate` | `string` | | 开始日期 | |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/room-type/{roomTypeId}/prices/batch-status
|
||
|
||
**批量修改日期可售状态**
|
||
|
||
批量修改指定日期范围内房型的可售状态，不影响价格。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**请求体** `酒店房型价格日历状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `endDate` | `string` | 是 | 结束日期（yyyy-MM-dd） |
|
||
| `remark` | `string` | | 备注 |
|
||
| `startDate` | `string` | 是 | 开始日期（yyyy-MM-dd） |
|
||
| `status` | `int` | 是 | 状态：0=不可售 1=可售 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 房型管理
|
||
|
||
### `GET` /admin/hotel/room-type/{roomTypeId}
|
||
|
||
**房型详情**
|
||
|
||
获取房型完整信息，包含价格、入住人数、素材等。
|
||
|
||
**关联字典**：
|
||
- room_category：房型分类（列表/详情显示）
|
||
- bed_type：床型（列表/详情显示）
|
||
- window_type：窗户类型（列表/详情显示）
|
||
- bathroom_type：卫浴类型（列表/详情显示）
|
||
- room_facility：房间设施（列表/详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**响应** `统一响应结果«房型详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `房型详情VO` | | 响应数据 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础成本价（元） |
|
||
| `bathroomType` | `string` | | 卫浴类型 |
|
||
| `bedCount` | `int` | | 床位数量 |
|
||
| `bedSize` | `string` | | 床尺寸 |
|
||
| `bedType` | `string` | | 床型 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `description` | `string` | | 房型描述 |
|
||
| `floorInfo` | `string` | | 楼层信息 |
|
||
| `hotelId` | `string` | | 所属酒店ID |
|
||
| `maxOccupancy` | `int` | | 最多入住人数 |
|
||
| `name` | `string` | | 房型名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `roomArea` | `number` | | 房间面积（平方米） |
|
||
| `roomCategory` | `string` | | 房型分类 |
|
||
| `roomFacilities` | `string` | | 房间设施（JSON） |
|
||
| `roomTypeId` | `string` | | 房型ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=禁用 1=启用 |
|
||
| `totalRooms` | `int` | | 总房间数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialId` | `string` | | 视频素材ID |
|
||
| `videoUrl` | `string` | | 视频URL |
|
||
| `windowType` | `string` | | 窗型 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/room-type/{roomTypeId}
|
||
|
||
**更新房型**
|
||
|
||
更新房型基本信息，不改变当前状态。
|
||
|
||
**关联字典**：
|
||
- room_category：房型分类（表单选择）
|
||
- bed_type：床型（表单选择）
|
||
- window_type：窗户类型（表单选择）
|
||
- bathroom_type：卫浴类型（表单选择）
|
||
- room_facility：房间设施（表单多选）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**请求体** `房型更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `basePrice` | `number` | | 基础成本价（元） |
|
||
| `bathroomType` | `string` | | 卫浴类型 |
|
||
| `bedCount` | `int` | | 床位数量 |
|
||
| `bedSize` | `string` | | 床尺寸 |
|
||
| `bedType` | `string` | | 床型 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 房型描述 |
|
||
| `floorInfo` | `string` | | 楼层信息 |
|
||
| `maxOccupancy` | `int` | | 最多入住人数 |
|
||
| `name` | `string` | | 房型名称 |
|
||
| `roomArea` | `number` | | 房间面积（平方米） |
|
||
| `roomCategory` | `string` | | 房型分类 |
|
||
| `roomFacilities` | `string` | | 房间设施（JSON） |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `totalRooms` | `int` | | 总房间数 |
|
||
| `videoMaterialId` | `string` | | 视频素材ID |
|
||
| `windowType` | `string` | | 窗型 |
|
||
|
||
**响应** `统一响应结果«房型详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `房型详情VO` | | 响应数据 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础成本价（元） |
|
||
| `bathroomType` | `string` | | 卫浴类型 |
|
||
| `bedCount` | `int` | | 床位数量 |
|
||
| `bedSize` | `string` | | 床尺寸 |
|
||
| `bedType` | `string` | | 床型 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `description` | `string` | | 房型描述 |
|
||
| `floorInfo` | `string` | | 楼层信息 |
|
||
| `hotelId` | `string` | | 所属酒店ID |
|
||
| `maxOccupancy` | `int` | | 最多入住人数 |
|
||
| `name` | `string` | | 房型名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `roomArea` | `number` | | 房间面积（平方米） |
|
||
| `roomCategory` | `string` | | 房型分类 |
|
||
| `roomFacilities` | `string` | | 房间设施（JSON） |
|
||
| `roomTypeId` | `string` | | 房型ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=禁用 1=启用 |
|
||
| `totalRooms` | `int` | | 总房间数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialId` | `string` | | 视频素材ID |
|
||
| `videoUrl` | `string` | | 视频URL |
|
||
| `windowType` | `string` | | 窗型 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/hotel/room-type/{roomTypeId}
|
||
|
||
**删除房型**
|
||
|
||
软删除房型及其价格日历数据。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/hotel/room-type/{roomTypeId}/status
|
||
|
||
**启用/禁用房型**
|
||
|
||
直接修改房型状态（跳过审批）。status=0禁用，status=1启用。禁用后该房型不会出现在C端展示中。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**请求体** `房型状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `status` | `int` | 是 | 状态：0=禁用 1=启用 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/hotel/room-type/{roomTypeId}/submit-approval
|
||
|
||
**提交房型启用/禁用审批**
|
||
|
||
向企微OA提交房型启用/禁用审批。审批流程与住宿共享同一模板。返回审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `roomTypeId` | `integer` | | 房型ID |
|
||
|
||
**请求体** `酒店审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | 是 | 审批理由 |
|
||
| `targetStatus` | `int` | 是 | 目标状态：1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/hotel/{hotelId}/room-type
|
||
|
||
**创建房型**
|
||
|
||
在指定住宿下创建房型（如标准间、大床房、套房等）。每个房型有独立的价格日历、最大入住人数(maxOccupancy)和基础价格(basePrice)。房型初始状态为草稿(status=0)，需独立审批后才能启用。创建后可通过「提交房型启用审批」接口提交企微OA审批。
|
||
|
||
**关联字典**：
|
||
- room_category：房型分类（表单选择）
|
||
- bed_type：床型（表单选择）
|
||
- window_type：窗户类型（表单选择）
|
||
- bathroom_type：卫浴类型（表单选择）
|
||
- room_facility：房间设施（表单多选）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelId` | `integer` | | 住宿ID |
|
||
|
||
**请求体** `房型创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `basePrice` | `number` | | 基础成本价（元） |
|
||
| `bathroomType` | `string` | | 卫浴类型 |
|
||
| `bedCount` | `int` | | 床位数量 |
|
||
| `bedSize` | `string` | | 床尺寸 |
|
||
| `bedType` | `string` | 是 | 床型 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 房型描述 |
|
||
| `floorInfo` | `string` | | 楼层信息 |
|
||
| `maxOccupancy` | `int` | | 最多入住人数 |
|
||
| `name` | `string` | 是 | 房型名称 |
|
||
| `roomArea` | `number` | | 房间面积（平方米） |
|
||
| `roomCategory` | `string` | 是 | 房型分类 |
|
||
| `roomFacilities` | `string` | | 房间设施（JSON） |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `totalRooms` | `int` | | 总房间数 |
|
||
| `videoMaterialId` | `string` | | 视频素材ID |
|
||
| `windowType` | `string` | | 窗型 |
|
||
|
||
**响应** `统一响应结果«房型详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `房型详情VO` | | 响应数据 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础成本价（元） |
|
||
| `bathroomType` | `string` | | 卫浴类型 |
|
||
| `bedCount` | `int` | | 床位数量 |
|
||
| `bedSize` | `string` | | 床尺寸 |
|
||
| `bedType` | `string` | | 床型 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `description` | `string` | | 房型描述 |
|
||
| `floorInfo` | `string` | | 楼层信息 |
|
||
| `hotelId` | `string` | | 所属酒店ID |
|
||
| `maxOccupancy` | `int` | | 最多入住人数 |
|
||
| `name` | `string` | | 房型名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `roomArea` | `number` | | 房间面积（平方米） |
|
||
| `roomCategory` | `string` | | 房型分类 |
|
||
| `roomFacilities` | `string` | | 房间设施（JSON） |
|
||
| `roomTypeId` | `string` | | 房型ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=禁用 1=启用 |
|
||
| `totalRooms` | `int` | | 总房间数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialId` | `string` | | 视频素材ID |
|
||
| `videoUrl` | `string` | | 视频URL |
|
||
| `windowType` | `string` | | 窗型 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/hotel/{hotelId}/room-types
|
||
|
||
**房型列表**
|
||
|
||
获取指定住宿下的所有房型列表（不分页），按sortOrder排序。
|
||
|
||
**关联字典**：
|
||
- room_category：房型分类（列表/详情显示）
|
||
- bed_type：床型（列表/详情显示）
|
||
- window_type：窗户类型（列表/详情显示）
|
||
- bathroom_type：卫浴类型（列表/详情显示）
|
||
- room_facility：房间设施（列表/详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `hotelId` | `integer` | | 住宿ID |
|
||
|
||
**响应** `统一响应结果«List«房型详情VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `房型详情VO[]` | | 响应数据 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础成本价（元） |
|
||
| `bathroomType` | `string` | | 卫浴类型 |
|
||
| `bedCount` | `int` | | 床位数量 |
|
||
| `bedSize` | `string` | | 床尺寸 |
|
||
| `bedType` | `string` | | 床型 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `description` | `string` | | 房型描述 |
|
||
| `floorInfo` | `string` | | 楼层信息 |
|
||
| `hotelId` | `string` | | 所属酒店ID |
|
||
| `maxOccupancy` | `int` | | 最多入住人数 |
|
||
| `name` | `string` | | 房型名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `roomArea` | `number` | | 房间面积（平方米） |
|
||
| `roomCategory` | `string` | | 房型分类 |
|
||
| `roomFacilities` | `string` | | 房间设施（JSON） |
|
||
| `roomTypeId` | `string` | | 房型ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=禁用 1=启用 |
|
||
| `totalRooms` | `int` | | 总房间数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialId` | `string` | | 视频素材ID |
|
||
| `videoUrl` | `string` | | 视频URL |
|
||
| `windowType` | `string` | | 窗型 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 景区价格日历
|
||
|
||
### `GET` /admin/scenic/spot/{scenicId}/prices
|
||
|
||
**查询价格日历**
|
||
|
||
按月查询景区的每日价格和可售状态。返回指定年月中所有已设置价格的日期，未设置的日期不返回。用于前端日历组件渲染。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `month` | `integer(int32)` | | 月份 | |
|
||
| `year` | `integer(int32)` | | 年份 | |
|
||
|
||
**响应** `统一响应结果«价格日历月视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `价格日历月视图` | | 响应数据 |
|
||
| `month` | `int` | | 月份 |
|
||
| `prices` | `价格日历日数据[]` | | 每日价格列表 |
|
||
| `costPrice` | `number` | | 成本价（元） |
|
||
| `date` | `string` | | 日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `status` | `int` | | 状态：0=不可用 1=可用 |
|
||
| `stock` | `int` | | 总库存 |
|
||
| `stockUsed` | `int` | | 已用库存 |
|
||
| `scenicId` | `string` | | 景区ID |
|
||
| `scenicName` | `string` | | 景区名称 |
|
||
| `stockEnabled` | `boolean` | | 是否启用库存管理 |
|
||
| `year` | `int` | | 年份 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/scenic/spot/{scenicId}/prices
|
||
|
||
**批量设置价格**
|
||
|
||
在指定日期范围内批量设置成本价、库存和可售状态。支持weekdayOnly/weekendOnly/selectedWeekdays过滤特定星期，支持excludeDates排除特定日期。已有价格的日期会被覆盖更新。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**请求体** `价格日历批量设置请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costPrice` | `number` | 是 | 成本价（元） |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `excludeDates` | `string[]` | | 排除的日期列表 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `selectedWeekdays` | `int[]` | | 选中的星期（1=周一...7=周日），为空时不做过滤 |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `status` | `int` | | 状态：0=不可用 1=可用 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `weekdayOnly` | `boolean` | | 仅工作日 |
|
||
| `weekendOnly` | `boolean` | | 仅周末 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/scenic/spot/{scenicId}/prices
|
||
|
||
**批量清除价格**
|
||
|
||
删除指定日期范围内的所有价格记录。删除后该日期范围将显示为未设置状态。日期格式：yyyy-MM-dd。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `endDate` | `string` | | 结束日期 | |
|
||
| `startDate` | `string` | | 开始日期 | |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/scenic/spot/{scenicId}/prices/status
|
||
|
||
**批量修改可售状态**
|
||
|
||
批量修改指定日期范围内的可售状态，不影响价格和库存。status=0不可售，status=1可售。用于临时关闭/开放某些日期的售卖。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**请求体** `价格日历状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `status` | `int` | 是 | 目标状态：0=不可用 1=可用 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 景区季节内容
|
||
|
||
### `PUT` /admin/scenic/spot/{scenicId}/season/{seasonType}
|
||
|
||
**保存/更新季节内容**
|
||
|
||
创建或更新指定景区的季节内容。seasonType为季节标识（如spring/summer/autumn/winter）。如果该季节已存在则更新，不存在则创建。支持设置季节别名（如「樱花季」）、月份范围、独立封面和轮播图。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
| `seasonType` | `string` | | 季节类型 |
|
||
|
||
**请求体** `景区季节保存请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 季节描述 |
|
||
| `highlights` | `string` | | 季节亮点 |
|
||
| `monthEnd` | `int` | 是 | 结束月份（1-12） |
|
||
| `monthStart` | `int` | 是 | 开始月份（1-12） |
|
||
| `playGuide` | `string` | | 游玩攻略（富文本JSON） |
|
||
| `seasonName` | `string` | | 季节别名 |
|
||
| `tips` | `string` | | 温馨提示 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«景区季节内容»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区季节内容` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `description` | `string` | | 季节描述 |
|
||
| `highlights` | `string` | | 季节亮点 |
|
||
| `monthEnd` | `int` | | 结束月份 |
|
||
| `monthStart` | `int` | | 开始月份 |
|
||
| `playGuide` | `string` | | 游玩攻略（富文本JSON） |
|
||
| `scenicId` | `string` | | 景区ID |
|
||
| `seasonId` | `string` | | 季节ID |
|
||
| `seasonName` | `string` | | 季节别名 |
|
||
| `seasonType` | `string` | | 季节类型：spring/summer/autumn/winter |
|
||
| `tips` | `string` | | 温馨提示 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/scenic/spot/{scenicId}/season/{seasonType}
|
||
|
||
**删除季节内容**
|
||
|
||
删除指定景区的某个季节内容，同时清理关联的素材引用。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
| `seasonType` | `string` | | 季节类型 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/scenic/spot/{scenicId}/seasons
|
||
|
||
**获取景区全部季节内容**
|
||
|
||
返回景区的所有季节内容列表（春/夏/秋/冬）。季节内容是景区独有功能，其他资源类型没有此概念。每个季节可设置独立的封面、轮播图、亮点描述和游玩攻略。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**响应** `统一响应结果«List«景区季节内容»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区季节内容[]` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `description` | `string` | | 季节描述 |
|
||
| `highlights` | `string` | | 季节亮点 |
|
||
| `monthEnd` | `int` | | 结束月份 |
|
||
| `monthStart` | `int` | | 开始月份 |
|
||
| `playGuide` | `string` | | 游玩攻略（富文本JSON） |
|
||
| `scenicId` | `string` | | 景区ID |
|
||
| `seasonId` | `string` | | 季节ID |
|
||
| `seasonName` | `string` | | 季节别名 |
|
||
| `seasonType` | `string` | | 季节类型：spring/summer/autumn/winter |
|
||
| `tips` | `string` | | 温馨提示 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 景区标签管理
|
||
|
||
### `PUT` /admin/scenic/spot/{scenicId}/tags
|
||
|
||
**更新景区标签**
|
||
|
||
全量替换指定景区的标签列表。传入tagIds为该景区最终要关联的标签ID列表，为空则清除所有标签。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**请求体** `景区标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagIds` | `string[]` | | 标签ID列表（全量替换） |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/scenic/spots/batch/tags
|
||
|
||
**批量打标签**
|
||
|
||
对多个景区批量添加或移除标签。addTagIds为要添加的标签，removeTagIds为要移除的标签，两者可同时使用。增量操作，不影响未指定的标签。
|
||
|
||
**请求体** `景区批量标签操作请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `addTagIds` | `string[]` | | 要添加的标签ID列表 |
|
||
| `removeTagIds` | `string[]` | | 要移除的标签ID列表 |
|
||
| `scenicIds` | `string[]` | 是 | 景区ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/scenic/tag
|
||
|
||
**创建管理标签**
|
||
|
||
创建预设标签，标签名不可重复。可指定颜色(tagColor)，默认为#409EFF。预设标签在标签管理页面展示和维护。
|
||
|
||
**请求体** `标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«景区标签»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区标签` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统预设 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/scenic/tag/adhoc
|
||
|
||
**解析自定义标签**
|
||
|
||
输入标签名称，如果已存在则直接返回，不存在则自动创建。用于景区编辑时快速输入新标签，避免先到标签管理页面创建。
|
||
|
||
**请求体** `标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«景区标签»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区标签` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统预设 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/scenic/tag/{tagId}
|
||
|
||
**编辑标签**
|
||
|
||
修改标签名称或颜色。修改后所有关联此标签的景区会自动生效。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**请求体** `标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
|
||
**响应** `统一响应结果«景区标签»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区标签` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统预设 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/scenic/tag/{tagId}
|
||
|
||
**删除标签**
|
||
|
||
删除标签并自动解除所有景区与该标签的关联关系。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/scenic/tags
|
||
|
||
**获取管理标签列表（分页）**
|
||
|
||
分页查询景区标签库中的所有标签，支持按关键词搜索。标签分为预设标签（管理员创建）和自定义标签（adhoc接口创建），此接口返回全部类型。
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 关键词 | |
|
||
| `page` | `integer(int32)` | | 页码 | |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | |
|
||
|
||
**响应** `统一响应结果«分页结果«景区标签»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«景区标签»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `景区标签[]` | | 数据列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统预设 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/scenic/tags/all
|
||
|
||
**获取全部标签**
|
||
|
||
不分页返回所有标签，用于景区编辑时的标签选择下拉列表。
|
||
|
||
**响应** `统一响应结果«List«景区标签»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区标签[]` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统预设 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 景区管理
|
||
|
||
### `POST` /admin/scenic/spot
|
||
|
||
**创建景区**
|
||
|
||
新建一个景区资源，初始状态为草稿(status=0)。创建后需通过「提交启用审批」接口走企微OA审批流程才能上架。支持富文本字段（featureIntro/detailContent等），素材ID从素材库获取。
|
||
|
||
**关联字典**：
|
||
- scenic_facility：景区设施（表单多选）
|
||
- scenic_honor：景区荣誉（表单多选）
|
||
|
||
**请求体** `景区创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 行程安排（富文本JSON） |
|
||
| `backupContactPerson` | `string` | | 备用联系人姓名 |
|
||
| `backupContactPhone` | `string` | | 备用联系人电话 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `city` | `string` | 是 | 城市（行政区划） |
|
||
| `cityName` | `string` | 是 | 所在城市（展示用） |
|
||
| `closedDay` | `string` | | 闭园日 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系人电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `cultureExperience` | `string` | | 文化体验（富文本JSON） |
|
||
| `description` | `string` | | 景区描述 |
|
||
| `detailContent` | `string` | | 详情内容（富文本JSON） |
|
||
| `district` | `string` | | 区/县 |
|
||
| `facilities` | `string[]` | | 设施编码列表 |
|
||
| `featureIntro` | `string` | | 特色介绍（富文本JSON） |
|
||
| `highlightSpots` | `string` | | 亮点景点（富文本JSON） |
|
||
| `highlights` | `string` | | 亮点简介 |
|
||
| `honors` | `string[]` | | 荣誉称号列表 |
|
||
| `interactiveExperience` | `string` | | 互动体验（富文本JSON） |
|
||
| `latitude` | `number` | 是 | 纬度 |
|
||
| `longitude` | `number` | 是 | 经度 |
|
||
| `name` | `string` | 是 | 景区名称 |
|
||
| `openTime` | `string` | | 开放时间 |
|
||
| `photographyGuide` | `string` | | 摄影指南（富文本JSON） |
|
||
| `province` | `string` | 是 | 省份 |
|
||
| `sceneryExperience` | `string` | | 风景体验（富文本JSON） |
|
||
| `sortOrder` | `int` | | 排序权重，越大越靠前 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `travelPrep` | `string` | | 出行准备（富文本JSON） |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«景区详情»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区详情` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 行程安排（富文本JSON） |
|
||
| `backupContactPerson` | `string` | | 备用联系人姓名 |
|
||
| `backupContactPhone` | `string` | | 备用联系人电话 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `city` | `string` | | 城市（行政区划） |
|
||
| `cityName` | `string` | | 所在城市（展示用） |
|
||
| `closedDay` | `string` | | 闭园日 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系人电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `cultureExperience` | `string` | | 文化体验（富文本JSON） |
|
||
| `description` | `string` | | 景区描述 |
|
||
| `detailContent` | `string` | | 详情内容（富文本JSON） |
|
||
| `district` | `string` | | 区/县 |
|
||
| `facilities` | `string[]` | | 设施编码列表 |
|
||
| `facilityNames` | `string[]` | | 设施名称列表 |
|
||
| `featureIntro` | `string` | | 特色介绍（富文本JSON） |
|
||
| `highlightSpots` | `string` | | 亮点景点（富文本JSON） |
|
||
| `highlights` | `string` | | 亮点简介 |
|
||
| `honors` | `string[]` | | 荣誉称号列表 |
|
||
| `interactiveExperience` | `string` | | 互动体验（富文本JSON） |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 景区名称 |
|
||
| `openTime` | `string` | | 开放时间 |
|
||
| `photographyGuide` | `string` | | 摄影指南（富文本JSON） |
|
||
| `province` | `string` | | 省份 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `reviewCount` | `int` | | 评论数 |
|
||
| `sceneryExperience` | `string` | | 风景体验（富文本JSON） |
|
||
| `scenicId` | `string` | | 景区ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `tags` | `景区标签[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统预设 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `travelPrep` | `string` | | 出行准备（富文本JSON） |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/scenic/spot/{scenicId}
|
||
|
||
**景区详情**
|
||
|
||
获取景区完整信息，包含富文本内容、素材URL、标签列表、季节内容等。素材ID会自动解析为OSS访问地址。
|
||
|
||
**关联字典**：
|
||
- scenic_facility：景区设施（详情显示）
|
||
- scenic_honor：景区荣誉（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**响应** `统一响应结果«景区详情»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区详情` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 行程安排（富文本JSON） |
|
||
| `backupContactPerson` | `string` | | 备用联系人姓名 |
|
||
| `backupContactPhone` | `string` | | 备用联系人电话 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `city` | `string` | | 城市（行政区划） |
|
||
| `cityName` | `string` | | 所在城市（展示用） |
|
||
| `closedDay` | `string` | | 闭园日 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系人电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `cultureExperience` | `string` | | 文化体验（富文本JSON） |
|
||
| `description` | `string` | | 景区描述 |
|
||
| `detailContent` | `string` | | 详情内容（富文本JSON） |
|
||
| `district` | `string` | | 区/县 |
|
||
| `facilities` | `string[]` | | 设施编码列表 |
|
||
| `facilityNames` | `string[]` | | 设施名称列表 |
|
||
| `featureIntro` | `string` | | 特色介绍（富文本JSON） |
|
||
| `highlightSpots` | `string` | | 亮点景点（富文本JSON） |
|
||
| `highlights` | `string` | | 亮点简介 |
|
||
| `honors` | `string[]` | | 荣誉称号列表 |
|
||
| `interactiveExperience` | `string` | | 互动体验（富文本JSON） |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 景区名称 |
|
||
| `openTime` | `string` | | 开放时间 |
|
||
| `photographyGuide` | `string` | | 摄影指南（富文本JSON） |
|
||
| `province` | `string` | | 省份 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `reviewCount` | `int` | | 评论数 |
|
||
| `sceneryExperience` | `string` | | 风景体验（富文本JSON） |
|
||
| `scenicId` | `string` | | 景区ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `tags` | `景区标签[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统预设 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `travelPrep` | `string` | | 出行准备（富文本JSON） |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/scenic/spot/{scenicId}
|
||
|
||
**更新景区**
|
||
|
||
更新景区基本信息和富文本内容。更新不会改变当前状态。如果景区已上架，修改后仍保持上架状态，无需重新审批。
|
||
|
||
**关联字典**：
|
||
- scenic_facility：景区设施（表单多选）
|
||
- scenic_honor：景区荣誉（表单多选）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**请求体** `景区更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 行程安排（富文本JSON） |
|
||
| `backupContactPerson` | `string` | | 备用联系人姓名 |
|
||
| `backupContactPhone` | `string` | | 备用联系人电话 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `city` | `string` | | 城市（行政区划） |
|
||
| `cityName` | `string` | | 所在城市（展示用） |
|
||
| `closedDay` | `string` | | 闭园日 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系人电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `cultureExperience` | `string` | | 文化体验（富文本JSON） |
|
||
| `description` | `string` | | 景区描述 |
|
||
| `detailContent` | `string` | | 详情内容（富文本JSON） |
|
||
| `district` | `string` | | 区/县 |
|
||
| `facilities` | `string[]` | | 设施编码列表 |
|
||
| `featureIntro` | `string` | | 特色介绍（富文本JSON） |
|
||
| `highlightSpots` | `string` | | 亮点景点（富文本JSON） |
|
||
| `highlights` | `string` | | 亮点简介 |
|
||
| `honors` | `string[]` | | 荣誉称号列表 |
|
||
| `interactiveExperience` | `string` | | 互动体验（富文本JSON） |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 景区名称 |
|
||
| `openTime` | `string` | | 开放时间 |
|
||
| `photographyGuide` | `string` | | 摄影指南（富文本JSON） |
|
||
| `province` | `string` | | 省份 |
|
||
| `sceneryExperience` | `string` | | 风景体验（富文本JSON） |
|
||
| `sortOrder` | `int` | | 排序权重，越大越靠前 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `travelPrep` | `string` | | 出行准备（富文本JSON） |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«景区详情»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `景区详情` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 行程安排（富文本JSON） |
|
||
| `backupContactPerson` | `string` | | 备用联系人姓名 |
|
||
| `backupContactPhone` | `string` | | 备用联系人电话 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `city` | `string` | | 城市（行政区划） |
|
||
| `cityName` | `string` | | 所在城市（展示用） |
|
||
| `closedDay` | `string` | | 闭园日 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系人电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `cultureExperience` | `string` | | 文化体验（富文本JSON） |
|
||
| `description` | `string` | | 景区描述 |
|
||
| `detailContent` | `string` | | 详情内容（富文本JSON） |
|
||
| `district` | `string` | | 区/县 |
|
||
| `facilities` | `string[]` | | 设施编码列表 |
|
||
| `facilityNames` | `string[]` | | 设施名称列表 |
|
||
| `featureIntro` | `string` | | 特色介绍（富文本JSON） |
|
||
| `highlightSpots` | `string` | | 亮点景点（富文本JSON） |
|
||
| `highlights` | `string` | | 亮点简介 |
|
||
| `honors` | `string[]` | | 荣誉称号列表 |
|
||
| `interactiveExperience` | `string` | | 互动体验（富文本JSON） |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 景区名称 |
|
||
| `openTime` | `string` | | 开放时间 |
|
||
| `photographyGuide` | `string` | | 摄影指南（富文本JSON） |
|
||
| `province` | `string` | | 省份 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `reviewCount` | `int` | | 评论数 |
|
||
| `sceneryExperience` | `string` | | 风景体验（富文本JSON） |
|
||
| `scenicId` | `string` | | 景区ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `tags` | `景区标签[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统预设 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `travelPrep` | `string` | | 出行准备（富文本JSON） |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/scenic/spot/{scenicId}
|
||
|
||
**删除景区**
|
||
|
||
软删除景区（设置deleted_at）。仅SUPER_ADMIN角色或创建者本人可删除。已上架的景区需先下架再删除。删除后会同时清理关联的素材引用。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/scenic/spot/{scenicId}/status
|
||
|
||
**上下架切换**
|
||
|
||
直接修改景区状态（跳过审批流程），仅限SUPER_ADMIN使用。普通管理员应使用「提交启用/禁用审批」接口。状态值：0=草稿，1=上架，2=下架。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**请求体** `景区状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicIds` | `string[]` | | 景区ID列表 |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/scenic/spot/{scenicId}/submit-approval
|
||
|
||
**提交启用/禁用审批**
|
||
|
||
向企微OA提交审批申请。targetStatus=1表示申请上架，targetStatus=2表示申请下架。提交后景区进入PENDING_APPROVAL状态，企微审批通过/拒绝后通过回调自动更新状态。返回企微审批单号spNo。同一景区不可重复提交未完成的审批。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicId` | `integer` | | 景区ID |
|
||
|
||
**请求体** `审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | 是 | 审批理由 |
|
||
| `targetStatus` | `int` | 是 | 目标状态：1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/scenic/spots
|
||
|
||
**景区列表**
|
||
|
||
分页查询景区列表，支持按名称关键词、状态(0草稿/1上架/2下架)、城市等条件筛选。返回列表摘要信息（不含富文本详情），按sortOrder倒序+创建时间倒序排列。
|
||
|
||
**关联字典**：
|
||
- scenic_facility：景区设施（列表显示）
|
||
- scenic_honor：景区荣誉（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `city` | `string` | | 城市筛选（行政区划） | 杭州市 |
|
||
| `cityKeyword` | `string` | | 城市/区域关键词模糊搜索（匹配城市名、省份、地址） | 海拉尔 |
|
||
| `cityName` | `string` | | 城市名称筛选（展示用） | 杭州 |
|
||
| `facility` | `string` | | 设施编码筛选 | parking |
|
||
| `keyword` | `string` | | 搜索关键词（名称/地址模糊匹配） | 西湖 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `province` | `string` | | 省份筛选 | 浙江省 |
|
||
| `sortBy` | `string` | | 排序字段：name/rating/viewCount/sortOrder/createdAt | sortOrder |
|
||
| `sortDir` | `string` | | 排序方向：asc/desc | desc |
|
||
| `status` | `integer(int32)` | | 状态筛选：0=草稿 1=上架 2=下架 | 1 |
|
||
| `tagId` | `integer(int64)` | | 标签ID筛选（单个） | |
|
||
| `tagIds` | `string` | | 标签ID筛选（多个，逗号分隔） | 1,2,3 |
|
||
|
||
**响应** `统一响应结果«分页结果«景区列表项»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«景区列表项»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `景区列表项[]` | | 数据列表 |
|
||
| `approvalNo` | `string` | | 审批编号（审批中时有值） |
|
||
| `cityName` | `string` | | 所在城市 |
|
||
| `contactPerson` | `string` | | 联系人姓名 |
|
||
| `contactPhone` | `string` | | 联系人电话 |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `highlights` | `string` | | 亮点简介 |
|
||
| `honors` | `string[]` | | 荣誉称号列表 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 景区名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `reviewCount` | `int` | | 评论数 |
|
||
| `scenicId` | `string` | | 景区ID |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `tags` | `景区标签[]` | | 标签列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/scenic/spots/batch
|
||
|
||
**批量删除**
|
||
|
||
批量软删除多个景区。权限校验同单个删除：仅SUPER_ADMIN或创建者可操作。部分失败不影响其他景区的删除。
|
||
|
||
**请求体** `景区批量删除请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicIds` | `string[]` | 是 | 景区ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/scenic/spots/batch/status
|
||
|
||
**批量上下架**
|
||
|
||
批量修改多个景区的状态。scenicIds为景区ID列表（字符串格式），status为目标状态。跳过审批流程，适用于批量管理场景。
|
||
|
||
**请求体** `景区状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `scenicIds` | `string[]` | | 景区ID列表 |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 服务人员价格日历
|
||
|
||
### `GET` /admin/staff/type/{staffType}/prices
|
||
|
||
**查询价格日历（按人员类型）**
|
||
|
||
按月查询指定人员类型的每日服务费用和可调度状态。注意：价格日历按人员类型维度管理，非按个人维度。同一类型的所有人员共享同一套价格。
|
||
|
||
**关联字典**：
|
||
- staff_type（人员类型）→ staffType路径参数
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffType` | `string` | | 人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `month` | `integer(int32)` | | 月份 | |
|
||
| `year` | `integer(int32)` | | 年份 | |
|
||
|
||
**响应** `统一响应结果«服务人员价格日历VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务人员价格日历VO` | | 响应数据 |
|
||
| `month` | `int` | | 月份 |
|
||
| `prices` | `服务人员价格日历日VO[]` | | 价格日历明细列表 |
|
||
| `costPrice` | `number` | | 日薪（元） |
|
||
| `date` | `string` | | 日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `status` | `int` | | 状态：0=不可用 1=可用 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `stockUsed` | `int` | | 已用库存 |
|
||
| `staffType` | `string` | | 人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER |
|
||
| `staffTypeName` | `string` | | 人员类型名称 |
|
||
| `stockEnabled` | `boolean` | | 是否启用库存管理 |
|
||
| `year` | `int` | | 年份 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/staff/type/{staffType}/prices
|
||
|
||
**批量设置价格（按人员类型）**
|
||
|
||
在指定日期范围内批量设置该类型人员的服务成本价和可调度状态。
|
||
|
||
**关联字典**：
|
||
- staff_type（人员类型）→ staffType路径参数
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffType` | `string` | | 人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER |
|
||
|
||
**请求体** `服务人员价格日历设置请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costPrice` | `number` | 是 | 日薪（元） |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `excludeDates` | `LocalDate[]` | | 排除日期列表 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `selectedWeekdays` | `int[]` | | 指定星期几（1=周一 7=周日） |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `status` | `int` | | 状态：0=不可用 1=可用 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `weekdayOnly` | `boolean` | | 是否仅工作日 |
|
||
| `weekendOnly` | `boolean` | | 是否仅周末 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/staff/type/{staffType}/prices
|
||
|
||
**清除价格日历（按人员类型）**
|
||
|
||
删除指定日期范围内该类型人员的价格记录。日期格式：yyyy-MM-dd。
|
||
|
||
**关联字典**：
|
||
- staff_type（人员类型）→ staffType路径参数
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffType` | `string` | | 人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `endDate` | `string(date)` | | 结束日期 | |
|
||
| `startDate` | `string(date)` | | 开始日期 | |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/staff/type/{staffType}/prices/batch-status
|
||
|
||
**批量修改调度状态（按人员类型）**
|
||
|
||
批量修改日期范围内的可调度状态，不影响价格。
|
||
|
||
**关联字典**：
|
||
- staff_type（人员类型）→ staffType路径参数
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffType` | `string` | | 人员类型: GUIDE/GUIDE_ASSISTANT/PHOTOGRAPHER/LEADER/OTHER |
|
||
|
||
**请求体** `服务人员价格日历状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `status` | `int` | 是 | 状态：0=不可用 1=可用 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 服务人员标签管理
|
||
|
||
### `PUT` /admin/staff/batch/tags
|
||
|
||
**批量添加/移除标签**
|
||
|
||
对多个人员批量添加/移除标签。增量操作。
|
||
|
||
**请求体** `人员批量标签操作请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `addTagIds` | `long[]` | | 要添加的标签ID列表 |
|
||
| `removeTagIds` | `long[]` | | 要移除的标签ID列表 |
|
||
| `staffIds` | `long[]` | 是 | 人员ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/staff/tag
|
||
|
||
**创建标签**
|
||
|
||
创建预设标签，标签名不可重复。
|
||
|
||
**请求体** `服务人员标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«服务人员标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务人员标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=预设 1=自定义 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/staff/tag/adhoc
|
||
|
||
**解析自定义标签**
|
||
|
||
按名称查找或自动创建标签。
|
||
|
||
**请求体** `服务人员标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«服务人员标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务人员标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=预设 1=自定义 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/staff/tag/{tagId}
|
||
|
||
**更新标签**
|
||
|
||
修改标签名称或颜色。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**请求体** `服务人员标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
|
||
**响应** `统一响应结果«服务人员标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务人员标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=预设 1=自定义 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/staff/tag/{tagId}
|
||
|
||
**删除标签**
|
||
|
||
删除标签并解除所有人员与该标签的关联。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/staff/tags
|
||
|
||
**预设标签列表（分页）**
|
||
|
||
分页查询服务人员标签库，支持按关键词搜索。
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 关键词 | |
|
||
| `page` | `integer(int32)` | | 页码 | |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | |
|
||
|
||
**响应** `统一响应结果«分页结果«服务人员标签VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«服务人员标签VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `服务人员标签VO[]` | | 数据列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=预设 1=自定义 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/staff/tags/all
|
||
|
||
**全部标签列表**
|
||
|
||
不分页返回所有标签，用于人员编辑时的标签选择。
|
||
|
||
**响应** `统一响应结果«List«服务人员标签VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务人员标签VO[]` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=预设 1=自定义 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/staff/{staffId}/tags
|
||
|
||
**设置人员标签**
|
||
|
||
全量替换指定人员的标签列表。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffId` | `integer` | | 人员ID |
|
||
|
||
**请求体** `设置人员标签请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagIds` | `long[]` | 是 | 标签ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 服务人员管理
|
||
|
||
### `POST` /admin/staff
|
||
|
||
**创建服务人员**
|
||
|
||
新建服务人员（导游/领队/摄影师/助理等）。人员类型(staffType)决定了其在价格日历中的归类。需走企微审批上架后才能被产品引用。
|
||
|
||
**关联字典**：
|
||
- staff_type：人员类型（表单选择）
|
||
- guide_level：导游等级（表单选择）
|
||
- driver_license_type：驾照类型（表单选择）
|
||
- language：语言能力（表单多选）
|
||
- guide_specialty：导游专长（表单多选）
|
||
- guide_service_area：服务区域（表单多选）
|
||
|
||
**请求体** `服务人员创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `birthDate` | `string` | | 出生日期 |
|
||
| `certificateUrls` | `string[]` | | 资质证书URL列表 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 人员描述 |
|
||
| `emergencyContact` | `string` | | 紧急联系人 |
|
||
| `emergencyPhone` | `string` | | 紧急联系电话 |
|
||
| `ethnicity` | `string` | | 民族 |
|
||
| `gender` | `int` | | 性别：0=女 1=男 |
|
||
| `guideCardNo` | `string` | | 导游证号 |
|
||
| `guideLanguage` | `string` | | 导游语种 |
|
||
| `guideLevel` | `string` | | 导游等级 |
|
||
| `highlights` | `string` | | 人员亮点 |
|
||
| `idCardUrls` | `string[]` | | 证件照URL列表 |
|
||
| `languages` | `string[]` | | 掌握语言（JSON数组） |
|
||
| `licenseExpiry` | `string` | | 执照到期日 |
|
||
| `licenseNo` | `string` | | 执照编号 |
|
||
| `licenseType` | `string` | | 执照类型 |
|
||
| `name` | `string` | 是 | 姓名 |
|
||
| `nationality` | `string` | | 国籍 |
|
||
| `nativePlace` | `string` | | 籍贯 |
|
||
| `phone` | `string` | | 手机号 |
|
||
| `photoUrls` | `string[]` | | 个人照片URL列表 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `serviceAreas` | `string[]` | | 服务区域（JSON数组） |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `specialties` | `string[]` | | 擅长领域（JSON数组） |
|
||
| `staffType` | `string` | 是 | 人员类型 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `yearsOfExperience` | `int` | | 从业年限 |
|
||
|
||
**响应** `统一响应结果«服务人员详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务人员详情VO` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `birthDate` | `string` | | 出生日期 |
|
||
| `certificateUrls` | `string[]` | | 资质证书URL列表 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 人员描述 |
|
||
| `emergencyContact` | `string` | | 紧急联系人 |
|
||
| `emergencyPhone` | `string` | | 紧急联系电话 |
|
||
| `ethnicity` | `string` | | 民族 |
|
||
| `gender` | `int` | | 性别：0=女 1=男 |
|
||
| `guideCardNo` | `string` | | 导游证号 |
|
||
| `guideLanguage` | `string` | | 导游语种 |
|
||
| `guideLevel` | `string` | | 导游等级 |
|
||
| `highlights` | `string` | | 人员亮点 |
|
||
| `idCardUrls` | `string[]` | | 证件照URL列表 |
|
||
| `languages` | `string[]` | | 掌握语言 |
|
||
| `licenseExpiry` | `string` | | 执照到期日 |
|
||
| `licenseNo` | `string` | | 执照编号 |
|
||
| `licenseType` | `string` | | 执照类型 |
|
||
| `name` | `string` | | 姓名 |
|
||
| `nationality` | `string` | | 国籍 |
|
||
| `nativePlace` | `string` | | 籍贯 |
|
||
| `phone` | `string` | | 手机号 |
|
||
| `photoUrls` | `string[]` | | 个人照片URL列表 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `reviewCount` | `int` | | 评价数 |
|
||
| `serviceAreas` | `string[]` | | 服务区域 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `specialties` | `string[]` | | 擅长领域 |
|
||
| `staffId` | `string` | | 人员ID |
|
||
| `staffType` | `string` | | 人员类型 |
|
||
| `status` | `int` | | 状态：0=禁用 1=启用 |
|
||
| `tags` | `服务人员标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=预设 1=自定义 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `yearsOfExperience` | `int` | | 从业年限 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/staff/batch
|
||
|
||
**批量删除**
|
||
|
||
批量软删除多个服务人员。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**请求体** `人员批量删除请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffIds` | `long[]` | 是 | 人员ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/staff/batch/status
|
||
|
||
**批量更新状态**
|
||
|
||
批量修改多个服务人员的状态，跳过审批流程。
|
||
|
||
**请求体** `人员状态请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffIds` | `long[]` | | 人员ID列表（批量操作时使用） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/staff/list
|
||
|
||
**服务人员列表**
|
||
|
||
分页查询服务人员列表，支持按姓名、状态、人员类型等条件筛选。
|
||
|
||
**关联字典**：
|
||
- staff_type：人员类型（筛选+列表显示）
|
||
- guide_level：导游等级（列表显示）
|
||
- driver_license_type：驾照类型（列表显示）
|
||
- language：语言能力（列表显示）
|
||
- guide_specialty：导游专长（列表显示）
|
||
- guide_service_area：服务区域（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 搜索关键词（姓名/描述模糊匹配） | 张导 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `sortBy` | `string` | | 排序字段 | createdAt |
|
||
| `sortDir` | `string` | | 排序方向：asc/desc | desc |
|
||
| `staffType` | `string` | | 人员类型筛选 | GUIDE |
|
||
| `status` | `integer(int32)` | | 状态筛选：0=禁用 1=启用 | 1 |
|
||
| `tagId` | `integer(int64)` | | 标签ID（单个） | |
|
||
| `tagIds` | `string` | | 标签ID列表（逗号分隔） | 1,2,3 |
|
||
|
||
**响应** `统一响应结果«分页结果«服务人员列表VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«服务人员列表VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `服务人员列表VO[]` | | 数据列表 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `highlights` | `string` | | 人员亮点 |
|
||
| `name` | `string` | | 姓名 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `phone` | `string` | | 手机号 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `staffId` | `string` | | 人员ID |
|
||
| `staffType` | `string` | | 人员类型 |
|
||
| `status` | `int` | | 状态：0=禁用 1=启用 |
|
||
| `tags` | `服务人员标签VO[]` | | 标签列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/staff/{staffId}
|
||
|
||
**服务人员详情**
|
||
|
||
获取服务人员完整信息，包含素材URL、标签、技能描述等。
|
||
|
||
**关联字典**：
|
||
- staff_type：人员类型（详情显示）
|
||
- guide_level：导游等级（详情显示）
|
||
- driver_license_type：驾照类型（详情显示）
|
||
- language：语言能力（详情显示）
|
||
- guide_specialty：导游专长（详情显示）
|
||
- guide_service_area：服务区域（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffId` | `integer` | | 人员ID |
|
||
|
||
**响应** `统一响应结果«服务人员详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务人员详情VO` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `birthDate` | `string` | | 出生日期 |
|
||
| `certificateUrls` | `string[]` | | 资质证书URL列表 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 人员描述 |
|
||
| `emergencyContact` | `string` | | 紧急联系人 |
|
||
| `emergencyPhone` | `string` | | 紧急联系电话 |
|
||
| `ethnicity` | `string` | | 民族 |
|
||
| `gender` | `int` | | 性别：0=女 1=男 |
|
||
| `guideCardNo` | `string` | | 导游证号 |
|
||
| `guideLanguage` | `string` | | 导游语种 |
|
||
| `guideLevel` | `string` | | 导游等级 |
|
||
| `highlights` | `string` | | 人员亮点 |
|
||
| `idCardUrls` | `string[]` | | 证件照URL列表 |
|
||
| `languages` | `string[]` | | 掌握语言 |
|
||
| `licenseExpiry` | `string` | | 执照到期日 |
|
||
| `licenseNo` | `string` | | 执照编号 |
|
||
| `licenseType` | `string` | | 执照类型 |
|
||
| `name` | `string` | | 姓名 |
|
||
| `nationality` | `string` | | 国籍 |
|
||
| `nativePlace` | `string` | | 籍贯 |
|
||
| `phone` | `string` | | 手机号 |
|
||
| `photoUrls` | `string[]` | | 个人照片URL列表 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `reviewCount` | `int` | | 评价数 |
|
||
| `serviceAreas` | `string[]` | | 服务区域 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `specialties` | `string[]` | | 擅长领域 |
|
||
| `staffId` | `string` | | 人员ID |
|
||
| `staffType` | `string` | | 人员类型 |
|
||
| `status` | `int` | | 状态：0=禁用 1=启用 |
|
||
| `tags` | `服务人员标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=预设 1=自定义 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `yearsOfExperience` | `int` | | 从业年限 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/staff/{staffId}
|
||
|
||
**更新服务人员**
|
||
|
||
更新服务人员基本信息，不改变当前状态。
|
||
|
||
**关联字典**：
|
||
- staff_type：人员类型（表单选择）
|
||
- guide_level：导游等级（表单选择）
|
||
- driver_license_type：驾照类型（表单选择）
|
||
- language：语言能力（表单多选）
|
||
- guide_specialty：导游专长（表单多选）
|
||
- guide_service_area：服务区域（表单多选）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffId` | `integer` | | 人员ID |
|
||
|
||
**请求体** `服务人员更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `birthDate` | `string` | | 出生日期 |
|
||
| `certificateUrls` | `string[]` | | 资质证书URL列表 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 人员描述 |
|
||
| `emergencyContact` | `string` | | 紧急联系人 |
|
||
| `emergencyPhone` | `string` | | 紧急联系电话 |
|
||
| `ethnicity` | `string` | | 民族 |
|
||
| `gender` | `int` | | 性别：0=女 1=男 |
|
||
| `guideCardNo` | `string` | | 导游证号 |
|
||
| `guideLanguage` | `string` | | 导游语种 |
|
||
| `guideLevel` | `string` | | 导游等级 |
|
||
| `highlights` | `string` | | 人员亮点 |
|
||
| `idCardUrls` | `string[]` | | 证件照URL列表 |
|
||
| `languages` | `string[]` | | 掌握语言（JSON数组） |
|
||
| `licenseExpiry` | `string` | | 执照到期日 |
|
||
| `licenseNo` | `string` | | 执照编号 |
|
||
| `licenseType` | `string` | | 执照类型 |
|
||
| `name` | `string` | | 姓名 |
|
||
| `nationality` | `string` | | 国籍 |
|
||
| `nativePlace` | `string` | | 籍贯 |
|
||
| `phone` | `string` | | 手机号 |
|
||
| `photoUrls` | `string[]` | | 个人照片URL列表 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `serviceAreas` | `string[]` | | 服务区域（JSON数组） |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `specialties` | `string[]` | | 擅长领域（JSON数组） |
|
||
| `staffType` | `string` | | 人员类型 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `yearsOfExperience` | `int` | | 从业年限 |
|
||
|
||
**响应** `统一响应结果«服务人员详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务人员详情VO` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `birthDate` | `string` | | 出生日期 |
|
||
| `certificateUrls` | `string[]` | | 资质证书URL列表 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 人员描述 |
|
||
| `emergencyContact` | `string` | | 紧急联系人 |
|
||
| `emergencyPhone` | `string` | | 紧急联系电话 |
|
||
| `ethnicity` | `string` | | 民族 |
|
||
| `gender` | `int` | | 性别：0=女 1=男 |
|
||
| `guideCardNo` | `string` | | 导游证号 |
|
||
| `guideLanguage` | `string` | | 导游语种 |
|
||
| `guideLevel` | `string` | | 导游等级 |
|
||
| `highlights` | `string` | | 人员亮点 |
|
||
| `idCardUrls` | `string[]` | | 证件照URL列表 |
|
||
| `languages` | `string[]` | | 掌握语言 |
|
||
| `licenseExpiry` | `string` | | 执照到期日 |
|
||
| `licenseNo` | `string` | | 执照编号 |
|
||
| `licenseType` | `string` | | 执照类型 |
|
||
| `name` | `string` | | 姓名 |
|
||
| `nationality` | `string` | | 国籍 |
|
||
| `nativePlace` | `string` | | 籍贯 |
|
||
| `phone` | `string` | | 手机号 |
|
||
| `photoUrls` | `string[]` | | 个人照片URL列表 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `reviewCount` | `int` | | 评价数 |
|
||
| `serviceAreas` | `string[]` | | 服务区域 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `specialties` | `string[]` | | 擅长领域 |
|
||
| `staffId` | `string` | | 人员ID |
|
||
| `staffType` | `string` | | 人员类型 |
|
||
| `status` | `int` | | 状态：0=禁用 1=启用 |
|
||
| `tags` | `服务人员标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=预设 1=自定义 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `yearsOfExperience` | `int` | | 从业年限 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/staff/{staffId}
|
||
|
||
**删除服务人员**
|
||
|
||
软删除服务人员。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffId` | `integer` | | 人员ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/staff/{staffId}/status
|
||
|
||
**更新状态**
|
||
|
||
直接修改人员状态（跳过审批），仅限SUPER_ADMIN。状态值：0=草稿，1=启用，2=禁用。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffId` | `integer` | | 人员ID |
|
||
|
||
**请求体** `人员状态请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffIds` | `long[]` | | 人员ID列表（批量操作时使用） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/staff/{staffId}/submit-approval
|
||
|
||
**提交审批**
|
||
|
||
向企微OA提交人员启用/禁用审批。targetStatus=1申请启用，targetStatus=2申请禁用。返回审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `staffId` | `integer` | | 人员ID |
|
||
|
||
**请求体** `人员审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | | 审批原因 |
|
||
| `targetStatus` | `int` | 是 | 目标状态 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 服务价格日历
|
||
|
||
### `GET` /admin/service/item/{serviceId}/prices
|
||
|
||
**查询价格日历**
|
||
|
||
按月查询增值服务的每日价格和可售状态。仅付费服务(isPaid=true)需要设置价格日历。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `month` | `integer(int32)` | | 月份 | |
|
||
| `year` | `integer(int32)` | | 年份 | |
|
||
|
||
**响应** `统一响应结果«服务项价格日历VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务项价格日历VO` | | 响应数据 |
|
||
| `month` | `int` | | 月份 |
|
||
| `prices` | `服务项价格日历日VO[]` | | 价格日历明细列表 |
|
||
| `costPrice` | `number` | | 成本价（元） |
|
||
| `date` | `string` | | 日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `status` | `int` | | 状态：0=不可售 1=可售 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `stockUsed` | `int` | | 已用库存 |
|
||
| `serviceId` | `string` | | 服务项ID |
|
||
| `serviceName` | `string` | | 服务项名称 |
|
||
| `stockEnabled` | `boolean` | | 是否启用库存管理 |
|
||
| `year` | `int` | | 年份 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/service/item/{serviceId}/prices
|
||
|
||
**批量设置价格**
|
||
|
||
在指定日期范围内批量设置服务的成本价和可售状态。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**请求体** `服务项价格日历设置请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costPrice` | `number` | 是 | 成本价（元） |
|
||
| `endDate` | `string` | 是 | 结束日期（yyyy-MM-dd） |
|
||
| `excludeDates` | `string[]` | | 排除日期列表 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `selectedWeekdays` | `int[]` | | 指定星期几（1=周一 7=周日） |
|
||
| `startDate` | `string` | 是 | 开始日期（yyyy-MM-dd） |
|
||
| `status` | `int` | | 状态：0=不可售 1=可售 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `weekdayOnly` | `boolean` | | 是否仅工作日 |
|
||
| `weekendOnly` | `boolean` | | 是否仅周末 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/service/item/{serviceId}/prices
|
||
|
||
**批量清除价格**
|
||
|
||
删除指定日期范围内的价格记录。日期格式：yyyy-MM-dd。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `endDate` | `string` | | 结束日期 | |
|
||
| `startDate` | `string` | | 开始日期 | |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/service/item/{serviceId}/prices/batch-status
|
||
|
||
**批量修改可售状态**
|
||
|
||
批量修改日期范围内的可售状态，不影响价格。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**请求体** `服务项价格日历状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `endDate` | `string` | 是 | 结束日期（yyyy-MM-dd） |
|
||
| `remark` | `string` | | 备注 |
|
||
| `startDate` | `string` | 是 | 开始日期（yyyy-MM-dd） |
|
||
| `status` | `int` | 是 | 状态：0=不可售 1=可售 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 服务标签管理
|
||
|
||
### `PUT` /admin/service/item/{serviceId}/tags
|
||
|
||
**更新服务标签**
|
||
|
||
全量替换指定服务的标签列表。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `serviceId` | `integer` | | 服务ID |
|
||
|
||
**请求体** `服务项标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagIds` | `string[]` | | 标签ID列表（全量替换） |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/service/items/batch/tags
|
||
|
||
**批量打标签**
|
||
|
||
对多个服务批量添加/移除标签。增量操作。
|
||
|
||
**请求体** `服务项批量标签操作请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `addTagIds` | `string[]` | | 要添加的标签ID列表 |
|
||
| `removeTagIds` | `string[]` | | 要移除的标签ID列表 |
|
||
| `serviceIds` | `string[]` | 是 | 服务ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/service/tag
|
||
|
||
**创建管理标签**
|
||
|
||
创建预设标签，标签名不可重复。
|
||
|
||
**请求体** `服务标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«服务标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/service/tag/adhoc
|
||
|
||
**解析自定义标签**
|
||
|
||
按名称查找或自动创建标签。
|
||
|
||
**请求体** `服务标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«服务标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/service/tag/{tagId}
|
||
|
||
**编辑标签**
|
||
|
||
修改标签名称或颜色，所有关联服务自动生效。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**请求体** `服务标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
|
||
**响应** `统一响应结果«服务标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/service/tag/{tagId}
|
||
|
||
**删除标签**
|
||
|
||
删除标签并解除所有服务与该标签的关联。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/service/tags
|
||
|
||
**获取管理标签列表（分页）**
|
||
|
||
分页查询增值服务标签库，支持按关键词搜索。
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 关键词 | |
|
||
| `page` | `integer(int32)` | | 页码 | |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | |
|
||
|
||
**响应** `统一响应结果«分页结果«服务标签VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«服务标签VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `服务标签VO[]` | | 数据列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/service/tags/all
|
||
|
||
**获取全部标签**
|
||
|
||
不分页返回所有标签，用于服务编辑时的标签选择。
|
||
|
||
**响应** `统一响应结果«List«服务标签VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `服务标签VO[]` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 游玩项目价格日历
|
||
|
||
### `GET` /admin/activity/item/{activityId}/prices
|
||
|
||
**查询价格日历**
|
||
|
||
按月查询游玩项目的每日价格和可接待状态。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `month` | `integer(int32)` | | 月份 | |
|
||
| `year` | `integer(int32)` | | 年份 | |
|
||
|
||
**响应** `统一响应结果«活动价格日历视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `活动价格日历视图` | | 响应数据 |
|
||
| `activityId` | `string` | | 活动项目ID |
|
||
| `activityName` | `string` | | 活动项目名称 |
|
||
| `month` | `int` | | 月份 |
|
||
| `prices` | `活动价格日历日视图[]` | | 价格日历每日数据列表 |
|
||
| `costPrice` | `number` | | 成本价（元） |
|
||
| `date` | `string` | | 日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `status` | `int` | | 状态：0=不可用 1=可用 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `stockUsed` | `int` | | 已用库存 |
|
||
| `stockEnabled` | `boolean` | | 是否启用库存管理 |
|
||
| `year` | `int` | | 年份 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/activity/item/{activityId}/prices
|
||
|
||
**批量设置价格**
|
||
|
||
在指定日期范围内批量设置成本价和可接待状态。支持按星期过滤和排除特定日期。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**请求体** `活动价格日历设置请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costPrice` | `number` | 是 | 成本价（元） |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `excludeDates` | `string[]` | | 排除日期列表 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `selectedWeekdays` | `int[]` | | 指定星期几（1=周一 7=周日） |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `status` | `int` | | 状态：0=不可用 1=可用 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `weekdayOnly` | `boolean` | | 是否仅工作日 |
|
||
| `weekendOnly` | `boolean` | | 是否仅周末 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/activity/item/{activityId}/prices
|
||
|
||
**批量清除价格**
|
||
|
||
删除指定日期范围内的所有价格记录。日期格式：yyyy-MM-dd。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `endDate` | `string` | | 结束日期 | |
|
||
| `startDate` | `string` | | 开始日期 | |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/activity/item/{activityId}/prices/batch-status
|
||
|
||
**批量修改可接待状态**
|
||
|
||
批量修改指定日期范围内的可接待状态，不影响价格。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**请求体** `活动价格日历状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `status` | `int` | 是 | 状态：0=不可用 1=可用 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 游玩项目标签管理
|
||
|
||
### `PUT` /admin/activity/item/{activityId}/tags
|
||
|
||
**更新项目标签**
|
||
|
||
全量替换指定项目的标签列表。传入tagIds为最终关联的标签ID列表，为空则清除所有标签。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**请求体** `活动项目标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagIds` | `string[]` | | 标签ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/activity/items/batch/tags
|
||
|
||
**批量打标签**
|
||
|
||
对多个项目批量添加/移除标签。增量操作，不影响未指定的标签。
|
||
|
||
**请求体** `活动项目批量标签操作请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityIds` | `string[]` | 是 | 活动项目ID列表 |
|
||
| `addTagIds` | `string[]` | | 要添加的标签ID列表 |
|
||
| `removeTagIds` | `string[]` | | 要移除的标签ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/activity/tag
|
||
|
||
**创建管理标签**
|
||
|
||
创建预设标签，标签名不可重复。可指定颜色(tagColor)，默认#409EFF。
|
||
|
||
**请求体** `活动标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«活动标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `活动标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/activity/tag/adhoc
|
||
|
||
**解析自定义标签**
|
||
|
||
按名称查找或自动创建标签。用于项目编辑时快速输入新标签。
|
||
|
||
**请求体** `活动标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«活动标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `活动标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/activity/tag/{tagId}
|
||
|
||
**编辑标签**
|
||
|
||
修改标签名称或颜色，所有关联项目自动生效。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**请求体** `活动标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
|
||
**响应** `统一响应结果«活动标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `活动标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/activity/tag/{tagId}
|
||
|
||
**删除标签**
|
||
|
||
删除标签并自动解除所有项目与该标签的关联。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/activity/tags
|
||
|
||
**获取管理标签列表（分页）**
|
||
|
||
分页查询游玩项目标签库，支持按关键词搜索。包含预设标签和自定义标签。
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 关键词 | |
|
||
| `page` | `integer(int32)` | | 页码 | |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | |
|
||
|
||
**响应** `统一响应结果«分页结果«活动标签视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«活动标签视图»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `活动标签视图[]` | | 数据列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/activity/tags/all
|
||
|
||
**获取全部标签**
|
||
|
||
不分页返回所有标签，用于项目编辑时的标签选择下拉。
|
||
|
||
**响应** `统一响应结果«List«活动标签视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `活动标签视图[]` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 游玩项目管理
|
||
|
||
### `POST` /admin/activity/item
|
||
|
||
**创建游玩项目**
|
||
|
||
新建游玩项目资源（如漂流、骑行、篝火晚会等），初始状态为草稿(status=0)。需通过「提交启用/禁用审批」走企微审批后上架。支持按项收费(PER_ITEM)和按人收费(PER_PERSON)两种计费方式。
|
||
|
||
**关联字典**：
|
||
- activity_category：活动分类（表单选择）
|
||
- activity_billing_type：计费方式（表单选择）
|
||
|
||
**请求体** `活动项目创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `ageMax` | `int` | | 最大年龄限制 |
|
||
| `ageMin` | `int` | | 最小年龄限制 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bestSeason` | `string` | | 最佳季节 |
|
||
| `billingType` | `string` | 是 | 计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时 |
|
||
| `categoryCode` | `string` | 是 | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `dailyCapacity` | `int` | | 每日接待上限 |
|
||
| `description` | `string` | | 项目描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `durationMinutes` | `int` | | 体验时长（分钟） |
|
||
| `environmentType` | `string` | | 环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外 |
|
||
| `groupSizeMax` | `int` | | 单次最多人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `healthNotes` | `string` | | 健康须知 |
|
||
| `highlights` | `string` | | 项目亮点 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | 是 | 项目名称 |
|
||
| `physicalLevel` | `string` | | 体力要求：LOW=低 MEDIUM=中 HIGH=高 |
|
||
| `providedEquipment` | `string` | | 提供装备说明 |
|
||
| `province` | `string` | | 省份 |
|
||
| `requiredEquipment` | `string` | | 需自备装备说明 |
|
||
| `safetyNotes` | `string` | | 安全须知 |
|
||
| `sortOrder` | `int` | | 排序权重（数字越大越靠前） |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `weatherDependent` | `int` | | 是否受天气影响：0=否 1=是 |
|
||
| `whatExcluded` | `string` | | 费用不包含说明 |
|
||
| `whatIncluded` | `string` | | 费用包含说明 |
|
||
|
||
**响应** `统一响应结果«活动项目详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `活动项目详情视图` | | 响应数据 |
|
||
| `activityId` | `string` | | 活动项目ID |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `ageMax` | `int` | | 最大年龄限制 |
|
||
| `ageMin` | `int` | | 最小年龄限制 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `bestSeason` | `string` | | 最佳季节 |
|
||
| `billingType` | `string` | | 计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `dailyCapacity` | `int` | | 每日接待上限 |
|
||
| `description` | `string` | | 项目描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `durationMinutes` | `int` | | 体验时长（分钟） |
|
||
| `environmentType` | `string` | | 环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外 |
|
||
| `groupSizeMax` | `int` | | 单次最多人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `healthNotes` | `string` | | 健康须知 |
|
||
| `highlights` | `string` | | 项目亮点 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 项目名称 |
|
||
| `physicalLevel` | `string` | | 体力要求：LOW=低 MEDIUM=中 HIGH=高 |
|
||
| `providedEquipment` | `string` | | 提供装备说明 |
|
||
| `province` | `string` | | 省份 |
|
||
| `requiredEquipment` | `string` | | 需自备装备说明 |
|
||
| `safetyNotes` | `string` | | 安全须知 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `活动标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `weatherDependent` | `int` | | 是否受天气影响：0=否 1=是 |
|
||
| `whatExcluded` | `string` | | 费用不包含说明 |
|
||
| `whatIncluded` | `string` | | 费用包含说明 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/activity/item/{activityId}
|
||
|
||
**游玩项目详情**
|
||
|
||
获取游玩项目完整信息，包含富文本内容、素材URL、标签、价格日历等。
|
||
|
||
**关联字典**：
|
||
- activity_category：活动分类（详情显示）
|
||
- activity_billing_type：计费方式（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**响应** `统一响应结果«活动项目详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `活动项目详情视图` | | 响应数据 |
|
||
| `activityId` | `string` | | 活动项目ID |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `ageMax` | `int` | | 最大年龄限制 |
|
||
| `ageMin` | `int` | | 最小年龄限制 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `bestSeason` | `string` | | 最佳季节 |
|
||
| `billingType` | `string` | | 计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `dailyCapacity` | `int` | | 每日接待上限 |
|
||
| `description` | `string` | | 项目描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `durationMinutes` | `int` | | 体验时长（分钟） |
|
||
| `environmentType` | `string` | | 环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外 |
|
||
| `groupSizeMax` | `int` | | 单次最多人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `healthNotes` | `string` | | 健康须知 |
|
||
| `highlights` | `string` | | 项目亮点 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 项目名称 |
|
||
| `physicalLevel` | `string` | | 体力要求：LOW=低 MEDIUM=中 HIGH=高 |
|
||
| `providedEquipment` | `string` | | 提供装备说明 |
|
||
| `province` | `string` | | 省份 |
|
||
| `requiredEquipment` | `string` | | 需自备装备说明 |
|
||
| `safetyNotes` | `string` | | 安全须知 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `活动标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `weatherDependent` | `int` | | 是否受天气影响：0=否 1=是 |
|
||
| `whatExcluded` | `string` | | 费用不包含说明 |
|
||
| `whatIncluded` | `string` | | 费用包含说明 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/activity/item/{activityId}
|
||
|
||
**更新游玩项目**
|
||
|
||
更新游玩项目基本信息，不改变当前状态。已上架的项目修改后仍保持上架。
|
||
|
||
**关联字典**：
|
||
- activity_category：活动分类（表单选择）
|
||
- activity_billing_type：计费方式（表单选择）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**请求体** `活动项目更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `ageMax` | `int` | | 最大年龄限制 |
|
||
| `ageMin` | `int` | | 最小年龄限制 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bestSeason` | `string` | | 最佳季节 |
|
||
| `billingType` | `string` | | 计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `dailyCapacity` | `int` | | 每日接待上限 |
|
||
| `description` | `string` | | 项目描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `durationMinutes` | `int` | | 体验时长（分钟） |
|
||
| `environmentType` | `string` | | 环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外 |
|
||
| `groupSizeMax` | `int` | | 单次最多人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `healthNotes` | `string` | | 健康须知 |
|
||
| `highlights` | `string` | | 项目亮点 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 项目名称 |
|
||
| `physicalLevel` | `string` | | 体力要求：LOW=低 MEDIUM=中 HIGH=高 |
|
||
| `providedEquipment` | `string` | | 提供装备说明 |
|
||
| `province` | `string` | | 省份 |
|
||
| `requiredEquipment` | `string` | | 需自备装备说明 |
|
||
| `safetyNotes` | `string` | | 安全须知 |
|
||
| `sortOrder` | `int` | | 排序权重（数字越大越靠前） |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `weatherDependent` | `int` | | 是否受天气影响：0=否 1=是 |
|
||
| `whatExcluded` | `string` | | 费用不包含说明 |
|
||
| `whatIncluded` | `string` | | 费用包含说明 |
|
||
|
||
**响应** `统一响应结果«活动项目详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `活动项目详情视图` | | 响应数据 |
|
||
| `activityId` | `string` | | 活动项目ID |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `ageMax` | `int` | | 最大年龄限制 |
|
||
| `ageMin` | `int` | | 最小年龄限制 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `bestSeason` | `string` | | 最佳季节 |
|
||
| `billingType` | `string` | | 计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `contactPhone` | `string` | | 联系电话 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `dailyCapacity` | `int` | | 每日接待上限 |
|
||
| `description` | `string` | | 项目描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `durationMinutes` | `int` | | 体验时长（分钟） |
|
||
| `environmentType` | `string` | | 环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外 |
|
||
| `groupSizeMax` | `int` | | 单次最多人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `healthNotes` | `string` | | 健康须知 |
|
||
| `highlights` | `string` | | 项目亮点 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 项目名称 |
|
||
| `physicalLevel` | `string` | | 体力要求：LOW=低 MEDIUM=中 HIGH=高 |
|
||
| `providedEquipment` | `string` | | 提供装备说明 |
|
||
| `province` | `string` | | 省份 |
|
||
| `requiredEquipment` | `string` | | 需自备装备说明 |
|
||
| `safetyNotes` | `string` | | 安全须知 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `活动标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用注意事项 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `weatherDependent` | `int` | | 是否受天气影响：0=否 1=是 |
|
||
| `whatExcluded` | `string` | | 费用不包含说明 |
|
||
| `whatIncluded` | `string` | | 费用包含说明 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/activity/item/{activityId}
|
||
|
||
**删除游玩项目**
|
||
|
||
软删除游玩项目。仅SUPER_ADMIN或创建者可操作。删除后关联的素材引用会被清理。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/activity/item/{activityId}/status
|
||
|
||
**启用/禁用切换**
|
||
|
||
直接修改状态（跳过审批），仅限SUPER_ADMIN。状态值：0=草稿，1=上架，2=下架。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**请求体** `活动项目状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityIds` | `string[]` | | 活动项目ID列表（批量操作） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/activity/item/{activityId}/submit-approval
|
||
|
||
**提交启用/禁用审批**
|
||
|
||
向企微OA提交审批。targetStatus=1申请上架，targetStatus=2申请下架。审批通过后自动更新状态，返回审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityId` | `integer` | | 游玩项目ID |
|
||
|
||
**请求体** `活动项目审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | 是 | 审批理由 |
|
||
| `targetStatus` | `int` | 是 | 目标状态：1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/activity/items
|
||
|
||
**游玩项目列表**
|
||
|
||
分页查询游玩项目列表，支持按名称、状态、分类等条件筛选。返回摘要信息，按sortOrder倒序+创建时间倒序排列。
|
||
|
||
**关联字典**：
|
||
- activity_category：活动分类（筛选+列表显示）
|
||
- activity_billing_type：计费方式（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `billingType` | `string` | | 计费方式：PER_PERSON=按人 PER_GROUP=按团 PER_HOUR=按时 | PER_PERSON |
|
||
| `categoryCode` | `string` | | 分类编码 | OUTDOOR |
|
||
| `city` | `string` | | 城市 | 拉萨市 |
|
||
| `cityKeyword` | `string` | | 城市/区域关键词模糊搜索（匹配城市名、省份、地址） | 海拉尔 |
|
||
| `environmentType` | `string` | | 环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外 | OUTDOOR |
|
||
| `keyword` | `string` | | 搜索关键词（名称/副标题模糊搜索） | 骑马 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `physicalLevel` | `string` | | 体力要求：LOW=低 MEDIUM=中 HIGH=高 | MEDIUM |
|
||
| `sortBy` | `string` | | 排序字段 | createdAt |
|
||
| `sortDir` | `string` | | 排序方向：asc=升序 desc=降序 | desc |
|
||
| `status` | `integer(int32)` | | 状态：0=草稿 1=上架 2=下架 | 1 |
|
||
| `tagId` | `integer(int64)` | | 标签ID | 100 |
|
||
| `tagIds` | `string` | | 标签ID列表（逗号分隔） | 100,101,102 |
|
||
| `weatherDependent` | `integer(int32)` | | 是否受天气影响：0=否 1=是 | 1 |
|
||
|
||
**响应** `统一响应结果«分页结果«活动项目列表视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«活动项目列表视图»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `活动项目列表视图[]` | | 数据列表 |
|
||
| `activityId` | `string` | | 活动项目ID |
|
||
| `approvalNo` | `string` | | 审批编号 |
|
||
| `billingType` | `string` | | 计费方式编码 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `durationMinutes` | `int` | | 体验时长（分钟） |
|
||
| `environmentType` | `string` | | 环境类型：INDOOR=室内 OUTDOOR=室外 BOTH=室内外 |
|
||
| `highlights` | `string` | | 项目亮点 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `name` | `string` | | 项目名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `physicalLevel` | `string` | | 体力要求：LOW=低 MEDIUM=中 HIGH=高 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `活动标签视图[]` | | 标签列表 |
|
||
| `unit` | `string` | | 计量单位 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `weatherDependent` | `int` | | 是否受天气影响：0=否 1=是 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/activity/items/batch
|
||
|
||
**批量删除**
|
||
|
||
批量软删除多个游玩项目。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**请求体** `活动项目批量删除请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityIds` | `string[]` | 是 | 活动项目ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/activity/items/batch/status
|
||
|
||
**批量启用/禁用**
|
||
|
||
批量修改多个游玩项目的状态，跳过审批流程。
|
||
|
||
**请求体** `活动项目状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `activityIds` | `string[]` | | 活动项目ID列表（批量操作） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 费用项价格日历
|
||
|
||
### `GET` /admin/cost/item/{costId}/prices
|
||
|
||
**查询价格日历**
|
||
|
||
按月查询费用项的每日价格。费用项价格日历用于产品报价计算时按日期获取成本价。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costId` | `integer` | | 费用项ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `month` | `integer(int32)` | | 月份 | |
|
||
| `year` | `integer(int32)` | | 年份 | |
|
||
|
||
**响应** `统一响应结果«费用项价格日历VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `费用项价格日历VO` | | 响应数据 |
|
||
| `days` | `费用项价格日历日VO[]` | | 价格日历明细列表 |
|
||
| `date` | `string` | | 日期（yyyy-MM-dd） |
|
||
| `remark` | `string` | | 备注 |
|
||
| `status` | `int` | | 状态：0=不可用 1=可用 |
|
||
| `unitPrice` | `number` | | 单价（元） |
|
||
| `yearMonth` | `string` | | 年月（yyyy-MM） |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/cost/item/{costId}/prices
|
||
|
||
**批量设置价格**
|
||
|
||
在指定日期范围内批量设置费用项的成本价。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costId` | `integer` | | 费用项ID |
|
||
|
||
**请求体** `费用项价格日历设置请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `dayFilter` | `string` | | 日期过滤：weekday=仅工作日 weekend=仅周末 |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `excludeDates` | `LocalDate[]` | | 排除日期列表 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `selectedWeekdays` | `int[]` | | 指定星期几（1=周一 7=周日） |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `unitPrice` | `number` | 是 | 单价（元） |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/cost/item/{costId}/prices
|
||
|
||
**清除价格日历**
|
||
|
||
删除指定日期范围内费用项的价格记录。日期格式：yyyy-MM-dd。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costId` | `integer` | | 费用项ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `endDate` | `string(date)` | | 结束日期 | |
|
||
| `startDate` | `string(date)` | | 开始日期 | |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 费用项管理
|
||
|
||
### `POST` /admin/cost/item
|
||
|
||
**创建费用项**
|
||
|
||
新建费用项（如门票成本、餐费、保险费等），用于产品报价计算。费用项有独立的价格日历，价格变更会记录变更日志。创建后需走企微审批上架。
|
||
|
||
**关联字典**：
|
||
- cost_category：费用分类（表单选择）
|
||
- cost_apply_role：适用角色（表单选择）
|
||
- cost_unit：计量单位（表单选择）
|
||
|
||
**请求体** `费用项创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `applyRole` | `string` | 是 | 适用角色 |
|
||
| `calcHint` | `string` | | 计算提示 |
|
||
| `categoryCode` | `string` | 是 | 费用分类编码 |
|
||
| `defaultFormula` | `string` | | 默认计算公式 |
|
||
| `description` | `string` | | 费用描述 |
|
||
| `name` | `string` | 是 | 费用名称 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `unitPrice` | `number` | 是 | 单价（元） |
|
||
|
||
**响应** `统一响应结果«费用项详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `费用项详情VO` | | 响应数据 |
|
||
| `applyRole` | `string` | | 适用角色 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `calcHint` | `string` | | 计算提示 |
|
||
| `categoryCode` | `string` | | 费用分类编码 |
|
||
| `costId` | `string` | | 费用项ID |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `defaultFormula` | `string` | | 默认计算公式 |
|
||
| `description` | `string` | | 费用描述 |
|
||
| `name` | `string` | | 费用名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `refCount` | `int` | | 引用次数 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `unitPrice` | `number` | | 单价（元） |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/cost/item/{costId}
|
||
|
||
**费用项详情**
|
||
|
||
获取费用项完整信息，包含当前价格、引用计数等。
|
||
|
||
**关联字典**：
|
||
- cost_category：费用分类（详情显示）
|
||
- cost_apply_role：适用角色（详情显示）
|
||
- cost_unit：计量单位（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costId` | `integer` | | 费用项ID |
|
||
|
||
**响应** `统一响应结果«费用项详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `费用项详情VO` | | 响应数据 |
|
||
| `applyRole` | `string` | | 适用角色 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `calcHint` | `string` | | 计算提示 |
|
||
| `categoryCode` | `string` | | 费用分类编码 |
|
||
| `costId` | `string` | | 费用项ID |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `defaultFormula` | `string` | | 默认计算公式 |
|
||
| `description` | `string` | | 费用描述 |
|
||
| `name` | `string` | | 费用名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `refCount` | `int` | | 引用次数 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `unitPrice` | `number` | | 单价（元） |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/cost/item/{costId}
|
||
|
||
**更新费用项**
|
||
|
||
更新费用项信息。如果修改了价格，会自动记录价格变更日志。
|
||
|
||
**关联字典**：
|
||
- cost_category：费用分类（表单选择）
|
||
- cost_apply_role：适用角色（表单选择）
|
||
- cost_unit：计量单位（表单选择）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costId` | `integer` | | 费用项ID |
|
||
|
||
**请求体** `费用项更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `applyRole` | `string` | | 适用角色 |
|
||
| `calcHint` | `string` | | 计算提示 |
|
||
| `categoryCode` | `string` | | 费用分类编码 |
|
||
| `changeReason` | `string` | | 价格变更原因（修改单价时必填） |
|
||
| `defaultFormula` | `string` | | 默认计算公式 |
|
||
| `description` | `string` | | 费用描述 |
|
||
| `name` | `string` | | 费用名称 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `unitPrice` | `number` | | 单价（元） |
|
||
|
||
**响应** `统一响应结果«费用项详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `费用项详情VO` | | 响应数据 |
|
||
| `applyRole` | `string` | | 适用角色 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `calcHint` | `string` | | 计算提示 |
|
||
| `categoryCode` | `string` | | 费用分类编码 |
|
||
| `costId` | `string` | | 费用项ID |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `defaultFormula` | `string` | | 默认计算公式 |
|
||
| `description` | `string` | | 费用描述 |
|
||
| `name` | `string` | | 费用名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `refCount` | `int` | | 引用次数 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `unitPrice` | `number` | | 单价（元） |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/cost/item/{costId}
|
||
|
||
**删除费用项**
|
||
|
||
软删除费用项。仅SUPER_ADMIN或创建者可操作。被产品引用(refCount>0)的费用项不建议删除。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costId` | `integer` | | 费用项ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/cost/item/{costId}/price-logs
|
||
|
||
**费用项价格变更记录**
|
||
|
||
查询费用项的历史价格变更记录，按时间倒序排列。用于追溯价格调整历史。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costId` | `integer` | | 费用项ID |
|
||
|
||
**响应** `统一响应结果«List«费用项价格变更日志VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `费用项价格变更日志VO[]` | | 响应数据 |
|
||
| `changeReason` | `string` | | 变更原因 |
|
||
| `changedAt` | `string` | | 变更时间 |
|
||
| `changedBy` | `string` | | 变更人ID |
|
||
| `costId` | `string` | | 费用项ID |
|
||
| `id` | `long` | | 日志ID |
|
||
| `newPrice` | `number` | | 变更后价格（元） |
|
||
| `oldPrice` | `number` | | 变更前价格（元） |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/cost/item/{costId}/submit-approval
|
||
|
||
**提交审批**
|
||
|
||
向企微OA提交费用项启用/禁用审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costId` | `integer` | | 费用项ID |
|
||
|
||
**请求体** `费用项审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | | 审批原因 |
|
||
| `targetStatus` | `int` | 是 | 目标状态 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/cost/items
|
||
|
||
**费用项列表**
|
||
|
||
分页查询费用项列表，支持按名称、状态等条件筛选。
|
||
|
||
**关联字典**：
|
||
- cost_category：费用分类（筛选+列表显示）
|
||
- cost_apply_role：适用角色（筛选+列表显示）
|
||
- cost_unit：计量单位（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `applyRole` | `string` | | 适用角色筛选 | ADULT |
|
||
| `categoryCode` | `string` | | 费用分类编码筛选 | GUIDE |
|
||
| `keyword` | `string` | | 搜索关键词（名称模糊匹配） | 导游 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `sortBy` | `string` | | 排序字段 | createdAt |
|
||
| `sortDir` | `string` | | 排序方向：asc/desc | desc |
|
||
| `status` | `integer(int32)` | | 状态筛选：0=草稿 1=上架 2=下架 | 1 |
|
||
|
||
**响应** `统一响应结果«分页结果«费用项列表VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«费用项列表VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `费用项列表VO[]` | | 数据列表 |
|
||
| `applyRole` | `string` | | 适用角色 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `categoryCode` | `string` | | 费用分类编码 |
|
||
| `costId` | `string` | | 费用项ID |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `name` | `string` | | 费用名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `refCount` | `int` | | 引用次数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `unitPrice` | `number` | | 单价（元） |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/cost/items/enabled
|
||
|
||
**启用的费用项列表**
|
||
|
||
查询所有已启用(status=1)的费用项，不分页。用于产品编排时选择费用项的下拉列表。
|
||
|
||
**关联字典**：
|
||
- cost_category：费用分类（列表显示）
|
||
- cost_apply_role：适用角色（列表显示）
|
||
- cost_unit：计量单位（列表显示）
|
||
|
||
**响应** `统一响应结果«List«费用项详情VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `费用项详情VO[]` | | 响应数据 |
|
||
| `applyRole` | `string` | | 适用角色 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `calcHint` | `string` | | 计算提示 |
|
||
| `categoryCode` | `string` | | 费用分类编码 |
|
||
| `costId` | `string` | | 费用项ID |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `defaultFormula` | `string` | | 默认计算公式 |
|
||
| `description` | `string` | | 费用描述 |
|
||
| `name` | `string` | | 费用名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `refCount` | `int` | | 引用次数 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `unit` | `string` | | 计价单位 |
|
||
| `unitPrice` | `number` | | 单价（元） |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 车型价格日历
|
||
|
||
### `GET` /admin/vehicle/model/{vehicleId}/prices
|
||
|
||
**查询价格日历**
|
||
|
||
按月查询车型的每日租赁价格和可调度状态。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `month` | `integer(int32)` | | 月份 | |
|
||
| `year` | `integer(int32)` | | 年份 | |
|
||
|
||
**响应** `统一响应结果«车型价格日历VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车型价格日历VO` | | 响应数据 |
|
||
| `month` | `int` | | 月份 |
|
||
| `prices` | `车型价格日历日VO[]` | | 价格日历明细列表 |
|
||
| `costPrice` | `number` | | 日租价（元） |
|
||
| `date` | `string` | | 日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `status` | `int` | | 状态：0=不可租 1=可租 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `stockUsed` | `int` | | 已用库存 |
|
||
| `stockEnabled` | `boolean` | | 是否启用库存管理 |
|
||
| `vehicleId` | `string` | | 车型ID |
|
||
| `vehicleName` | `string` | | 车型名称 |
|
||
| `year` | `int` | | 年份 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/vehicle/model/{vehicleId}/prices
|
||
|
||
**批量设置价格**
|
||
|
||
在指定日期范围内批量设置车型的租赁成本价和可调度状态。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**请求体** `车型价格日历设置请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `costPrice` | `number` | 是 | 日租价（元） |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `excludeDates` | `LocalDate[]` | | 排除日期列表 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `selectedWeekdays` | `int[]` | | 指定星期几（1=周一 7=周日） |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `status` | `int` | | 状态：0=不可租 1=可租 |
|
||
| `stock` | `int` | | 库存数量 |
|
||
| `weekdayOnly` | `boolean` | | 是否仅工作日 |
|
||
| `weekendOnly` | `boolean` | | 是否仅周末 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/vehicle/model/{vehicleId}/prices
|
||
|
||
**清除价格日历**
|
||
|
||
删除指定日期范围内车型的价格记录。日期格式：yyyy-MM-dd。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `endDate` | `string(date)` | | 结束日期 | |
|
||
| `startDate` | `string(date)` | | 开始日期 | |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/vehicle/model/{vehicleId}/prices/batch-status
|
||
|
||
**批量修改调度状态**
|
||
|
||
批量修改日期范围内车型的可调度状态，不影响价格。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**请求体** `车型价格日历状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `endDate` | `string` | 是 | 结束日期 |
|
||
| `remark` | `string` | | 备注 |
|
||
| `startDate` | `string` | 是 | 开始日期 |
|
||
| `status` | `int` | 是 | 状态：0=不可租 1=可租 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 车型标签管理
|
||
|
||
### `PUT` /admin/vehicle/model/{vehicleId}/tags
|
||
|
||
**设置车型标签**
|
||
|
||
全量替换指定车型的标签列表。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**请求体** `设置车型标签请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagIds` | `long[]` | 是 | 标签ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/vehicle/models/batch/tags
|
||
|
||
**批量添加/移除标签**
|
||
|
||
对多个车型批量添加/移除标签。增量操作。
|
||
|
||
**请求体** `车型批量标签操作请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `addTagIds` | `long[]` | | 要添加的标签ID列表 |
|
||
| `removeTagIds` | `long[]` | | 要移除的标签ID列表 |
|
||
| `vehicleIds` | `long[]` | 是 | 车型ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/vehicle/tag
|
||
|
||
**创建标签**
|
||
|
||
创建预设标签，标签名不可重复。
|
||
|
||
**请求体** `车辆标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«车辆标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车辆标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/vehicle/tag/adhoc
|
||
|
||
**解析自定义标签**
|
||
|
||
按名称查找或自动创建标签。
|
||
|
||
**请求体** `车辆标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«车辆标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车辆标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/vehicle/tag/{tagId}
|
||
|
||
**更新标签**
|
||
|
||
修改标签名称或颜色。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**请求体** `车辆标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
|
||
**响应** `统一响应结果«车辆标签VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车辆标签VO` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/vehicle/tag/{tagId}
|
||
|
||
**删除标签**
|
||
|
||
删除标签并解除所有车型与该标签的关联。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/vehicle/tags
|
||
|
||
**预设标签列表（分页）**
|
||
|
||
分页查询车型标签库，支持按关键词搜索。
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 关键词 | |
|
||
| `page` | `integer(int32)` | | 页码 | |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | |
|
||
|
||
**响应** `统一响应结果«分页结果«车辆标签VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«车辆标签VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `车辆标签VO[]` | | 数据列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/vehicle/tags/all
|
||
|
||
**全部标签列表**
|
||
|
||
不分页返回所有标签，用于车型编辑时的标签选择。
|
||
|
||
**响应** `统一响应结果«List«车辆标签VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车辆标签VO[]` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 车型管理
|
||
|
||
### `POST` /admin/vehicle/model
|
||
|
||
**创建车型**
|
||
|
||
新建车型资源（如7座商务车、14座中巴等），初始状态为草稿(status=0)。车型有独立的价格日历用于报价计算。需走企微审批上架。
|
||
|
||
**关联字典**：
|
||
- vehicle_type：车辆类型（表单选择）
|
||
|
||
**请求体** `车型创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `basePrice` | `number` | | 基础日租价（元） |
|
||
| `brand` | `string` | 是 | 品牌 |
|
||
| `comfortFeatures` | `string` | | 舒适配置（JSON） |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 车型描述 |
|
||
| `driveType` | `string` | | 驱动方式 |
|
||
| `engineType` | `string` | | 动力类型 |
|
||
| `highlights` | `string` | | 车型亮点 |
|
||
| `luggageCapacity` | `string` | | 行李容量描述 |
|
||
| `modelSeries` | `string` | | 车系 |
|
||
| `modelYear` | `int` | | 年款 |
|
||
| `name` | `string` | 是 | 车型名称 |
|
||
| `passengerCount` | `int` | 是 | 可乘坐人数 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `seatCount` | `int` | 是 | 座位数 |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `transmission` | `string` | | 变速箱类型 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleType` | `string` | 是 | 车型分类 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«车型详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车型详情VO` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础日租价（元） |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `comfortFeatures` | `string` | | 舒适配置（JSON） |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 车型描述 |
|
||
| `driveType` | `string` | | 驱动方式 |
|
||
| `engineType` | `string` | | 动力类型 |
|
||
| `highlights` | `string` | | 车型亮点 |
|
||
| `luggageCapacity` | `string` | | 行李容量描述 |
|
||
| `modelSeries` | `string` | | 车系 |
|
||
| `modelYear` | `int` | | 年款 |
|
||
| `name` | `string` | | 车型名称 |
|
||
| `passengerCount` | `int` | | 可乘坐人数 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `seatCount` | `int` | | 座位数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `车辆标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `transmission` | `string` | | 变速箱类型 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleId` | `string` | | 车型ID |
|
||
| `vehicleType` | `string` | | 车型分类 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/vehicle/model/{vehicleId}
|
||
|
||
**车型详情**
|
||
|
||
获取车型完整信息，包含座位数、品牌、素材URL、标签等。
|
||
|
||
**关联字典**：
|
||
- vehicle_type：车辆类型（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**响应** `统一响应结果«车型详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车型详情VO` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础日租价（元） |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `comfortFeatures` | `string` | | 舒适配置（JSON） |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 车型描述 |
|
||
| `driveType` | `string` | | 驱动方式 |
|
||
| `engineType` | `string` | | 动力类型 |
|
||
| `highlights` | `string` | | 车型亮点 |
|
||
| `luggageCapacity` | `string` | | 行李容量描述 |
|
||
| `modelSeries` | `string` | | 车系 |
|
||
| `modelYear` | `int` | | 年款 |
|
||
| `name` | `string` | | 车型名称 |
|
||
| `passengerCount` | `int` | | 可乘坐人数 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `seatCount` | `int` | | 座位数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `车辆标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `transmission` | `string` | | 变速箱类型 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleId` | `string` | | 车型ID |
|
||
| `vehicleType` | `string` | | 车型分类 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/vehicle/model/{vehicleId}
|
||
|
||
**更新车型**
|
||
|
||
更新车型基本信息，不改变当前状态。
|
||
|
||
**关联字典**：
|
||
- vehicle_type：车辆类型（表单选择）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**请求体** `车型更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `basePrice` | `number` | | 基础日租价（元） |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `comfortFeatures` | `string` | | 舒适配置（JSON） |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `description` | `string` | | 车型描述 |
|
||
| `driveType` | `string` | | 驱动方式 |
|
||
| `engineType` | `string` | | 动力类型 |
|
||
| `highlights` | `string` | | 车型亮点 |
|
||
| `luggageCapacity` | `string` | | 行李容量描述 |
|
||
| `modelSeries` | `string` | | 车系 |
|
||
| `modelYear` | `int` | | 年款 |
|
||
| `name` | `string` | | 车型名称 |
|
||
| `passengerCount` | `int` | | 可乘坐人数 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `seatCount` | `int` | | 座位数 |
|
||
| `sortOrder` | `int` | | 排序权重，值越大越靠前 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `transmission` | `string` | | 变速箱类型 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleType` | `string` | | 车型分类 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«车型详情VO»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车型详情VO` | | 响应数据 |
|
||
| `bannerMaterialIds` | `string[]` | | 横幅素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 横幅图URL列表 |
|
||
| `basePrice` | `number` | | 基础日租价（元） |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `comfortFeatures` | `string` | | 舒适配置（JSON） |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建者ID |
|
||
| `description` | `string` | | 车型描述 |
|
||
| `driveType` | `string` | | 驱动方式 |
|
||
| `engineType` | `string` | | 动力类型 |
|
||
| `highlights` | `string` | | 车型亮点 |
|
||
| `luggageCapacity` | `string` | | 行李容量描述 |
|
||
| `modelSeries` | `string` | | 车系 |
|
||
| `modelYear` | `int` | | 年款 |
|
||
| `name` | `string` | | 车型名称 |
|
||
| `passengerCount` | `int` | | 可乘坐人数 |
|
||
| `priceExcludes` | `string` | | 价格不包含内容 |
|
||
| `priceIncludes` | `string` | | 价格包含内容 |
|
||
| `seatCount` | `int` | | 座位数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `车辆标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `transmission` | `string` | | 变速箱类型 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `usageNotes` | `string` | | 使用须知 |
|
||
| `vehicleId` | `string` | | 车型ID |
|
||
| `vehicleType` | `string` | | 车型分类 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/vehicle/model/{vehicleId}
|
||
|
||
**删除车型**
|
||
|
||
软删除车型。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/vehicle/model/{vehicleId}/status
|
||
|
||
**更新状态**
|
||
|
||
直接修改车型状态（跳过审批），仅限SUPER_ADMIN。状态值：0=草稿，1=上架，2=下架。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**请求体** `车型状态请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
| `vehicleIds` | `long[]` | | 车型ID列表（批量操作时使用） |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/vehicle/model/{vehicleId}/submit-approval
|
||
|
||
**提交审批**
|
||
|
||
向企微OA提交车型启用/禁用审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleId` | `integer` | | 车型ID |
|
||
|
||
**请求体** `车型审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | | 审批原因 |
|
||
| `targetStatus` | `int` | 是 | 目标状态 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/vehicle/models
|
||
|
||
**车型列表**
|
||
|
||
分页查询车型列表，支持按名称、状态、车辆类型等条件筛选。
|
||
|
||
**关联字典**：
|
||
- vehicle_type：车辆类型（筛选+列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `brand` | `string` | | 品牌筛选 | 别克 |
|
||
| `keyword` | `string` | | 搜索关键词（名称/品牌模糊匹配） | 别克 |
|
||
| `maxPrice` | `number` | | 最高价格筛选 | 2000.0 |
|
||
| `maxSeatCount` | `integer(int32)` | | 最多座位数筛选 | 15 |
|
||
| `minPrice` | `number` | | 最低价格筛选 | 500.0 |
|
||
| `minSeatCount` | `integer(int32)` | | 最少座位数筛选 | 5 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `sortBy` | `string` | | 排序字段 | createdAt |
|
||
| `sortDir` | `string` | | 排序方向：asc/desc | desc |
|
||
| `status` | `integer(int32)` | | 状态筛选：0=草稿 1=上架 2=下架 | 1 |
|
||
| `tagId` | `integer(int64)` | | 标签ID（单个） | |
|
||
| `tagIds` | `string` | | 标签ID列表（逗号分隔） | 1,2,3 |
|
||
| `vehicleType` | `string` | | 车型分类筛选 | MPV |
|
||
|
||
**响应** `统一响应结果«分页结果«车型列表VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«车型列表VO»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `车型列表VO[]` | | 数据列表 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `basePrice` | `number` | | 基础日租价（元） |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `highlights` | `string` | | 车型亮点 |
|
||
| `modelSeries` | `string` | | 车系 |
|
||
| `name` | `string` | | 车型名称 |
|
||
| `passengerCount` | `int` | | 可乘坐人数 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `seatCount` | `int` | | 座位数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `车辆标签VO[]` | | 标签列表 |
|
||
| `vehicleId` | `string` | | 车型ID |
|
||
| `vehicleType` | `string` | | 车型分类 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/vehicle/models/all
|
||
|
||
**车型全量列表（不分页，用于下拉选择）**
|
||
|
||
返回所有车型列表，可选按状态筛选。适用于产品编排时选择车型的下拉选择框。不分页返回全部数据。
|
||
|
||
**关联字典**：
|
||
- vehicle_type：车辆类型（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `status` | `integer(int32)` | | 状态筛选：1=上架 | |
|
||
|
||
**响应** `统一响应结果«List«车型列表VO»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `车型列表VO[]` | | 响应数据 |
|
||
| `approvalNo` | `string` | | 审批单号 |
|
||
| `basePrice` | `number` | | 基础日租价（元） |
|
||
| `brand` | `string` | | 品牌 |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `highlights` | `string` | | 车型亮点 |
|
||
| `modelSeries` | `string` | | 车系 |
|
||
| `name` | `string` | | 车型名称 |
|
||
| `passengerCount` | `int` | | 可乘坐人数 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `seatCount` | `int` | | 座位数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `车辆标签VO[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：0=自定义 1=系统 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `vehicleId` | `string` | | 车型ID |
|
||
| `vehicleType` | `string` | | 车型分类 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/vehicle/models/batch
|
||
|
||
**批量删除**
|
||
|
||
批量软删除多个车型。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**请求体** `车型批量删除请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `vehicleIds` | `long[]` | 是 | 车型ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/vehicle/models/batch/status
|
||
|
||
**批量更新状态**
|
||
|
||
批量修改多个车型的状态，跳过审批流程。
|
||
|
||
**请求体** `车型状态请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
| `vehicleIds` | `long[]` | | 车型ID列表（批量操作时使用） |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
## 餐厅标签管理
|
||
|
||
### `PUT` /admin/restaurant/item/{restaurantId}/tags
|
||
|
||
**更新餐厅标签**
|
||
|
||
全量替换指定餐厅的标签列表。传入tagIds为最终关联的标签ID列表，为空则清除所有标签。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantId` | `integer` | | 餐厅ID |
|
||
|
||
**请求体** `餐厅标签更新请求_1`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagIds` | `string[]` | | 标签ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/restaurant/items/batch/tags
|
||
|
||
**批量打标签**
|
||
|
||
对多个餐厅批量添加/移除标签。增量操作，不影响未指定的标签。
|
||
|
||
**请求体** `餐厅批量标签操作请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `addTagIds` | `string[]` | | 要添加的标签ID列表 |
|
||
| `removeTagIds` | `string[]` | | 要移除的标签ID列表 |
|
||
| `restaurantIds` | `string[]` | 是 | 餐厅ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/restaurant/tag
|
||
|
||
**创建管理标签**
|
||
|
||
创建预设标签，标签名不可重复。可指定颜色(tagColor)，默认#409EFF。
|
||
|
||
**请求体** `餐厅标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«餐厅标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `餐厅标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `POST` /admin/restaurant/tag/adhoc
|
||
|
||
**解析自定义标签**
|
||
|
||
按名称查找或自动创建标签。用于餐厅编辑时快速输入新标签。
|
||
|
||
**请求体** `餐厅标签创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | 是 | 标签名称 |
|
||
|
||
**响应** `统一响应结果«餐厅标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `餐厅标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/restaurant/tag/{tagId}
|
||
|
||
**编辑标签**
|
||
|
||
修改标签名称或颜色，所有关联餐厅自动生效。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**请求体** `餐厅标签更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagColor` | `string` | | 标签颜色（十六进制） |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
|
||
**响应** `统一响应结果«餐厅标签视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `餐厅标签视图` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/restaurant/tag/{tagId}
|
||
|
||
**删除标签**
|
||
|
||
删除标签并解除所有餐厅与该标签的关联。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `tagId` | `integer` | | 标签ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `GET` /admin/restaurant/tags
|
||
|
||
**获取管理标签列表（分页）**
|
||
|
||
分页查询餐厅标签库，支持按关键词搜索。包含预设标签和自定义标签。
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `keyword` | `string` | | 关键词 | |
|
||
| `page` | `integer(int32)` | | 页码 | |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | |
|
||
|
||
**响应** `统一响应结果«分页结果«餐厅标签视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«餐厅标签视图»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `餐厅标签视图[]` | | 数据列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/restaurant/tags/all
|
||
|
||
**获取全部标签**
|
||
|
||
不分页返回所有标签，用于餐厅编辑时的标签选择下拉。
|
||
|
||
**响应** `统一响应结果«List«餐厅标签视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `餐厅标签视图[]` | | 响应数据 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
## 餐厅管理
|
||
|
||
### `POST` /admin/restaurant/item
|
||
|
||
**创建餐厅**
|
||
|
||
新建餐厅资源，初始状态为草稿(status=0)。餐厅没有价格日历，费用通过产品报价中的费用项管理。需走企微审批流程上架。
|
||
|
||
**关联字典**：
|
||
- restaurant_category：餐厅分类（表单选择）
|
||
- cuisine_type：菜系类型（表单多选）
|
||
- environment_type：环境类型（表单多选）
|
||
- restaurant_facility：餐厅设施（表单多选）
|
||
|
||
**纯文本字段**：
|
||
- cityName：城市名称（手动输入，如「拉萨」「海拉尔」）
|
||
|
||
**请求体** `餐厅创建请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 座位布局说明 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `businessHours` | `string` | | 营业时间 |
|
||
| `capacity` | `int` | | 容纳人数 |
|
||
| `categoryCode` | `string` | 是 | 分类编码 |
|
||
| `city` | `string` | 是 | 城市 |
|
||
| `cityName` | `string` | 是 | 城市名称（纯文本输入） |
|
||
| `closedDay` | `string` | | 休息日 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `cuisineType` | `string` | | 菜系类型 |
|
||
| `description` | `string` | | 餐厅描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `environmentType` | `string` | | 环境类型 |
|
||
| `facilities` | `string[]` | | 设施列表 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `featuredMenu` | `string` | | 招牌菜单（JSON格式） |
|
||
| `groupSizeMax` | `int` | | 最多接待人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `hasPrivateRoom` | `int` | | 是否有包间：0=无 1=有 |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `latitude` | `number` | 是 | 纬度 |
|
||
| `longitude` | `number` | 是 | 经度 |
|
||
| `minAdvanceHours` | `int` | | 最少提前预约小时数 |
|
||
| `name` | `string` | 是 | 餐厅名称 |
|
||
| `phone` | `string` | | 联系电话 |
|
||
| `pricePerPerson` | `number` | | 人均消费（元） |
|
||
| `province` | `string` | 是 | 省份 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `reservationRequired` | `int` | | 是否需要预约：0=否 1=是 |
|
||
| `sortOrder` | `int` | | 排序权重（数字越大越靠前） |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«餐厅详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `餐厅详情视图` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 座位布局说明 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `businessHours` | `string` | | 营业时间 |
|
||
| `capacity` | `int` | | 容纳人数 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `categoryName` | `string` | | 分类名称 |
|
||
| `city` | `string` | | 城市 |
|
||
| `cityName` | `string` | | 城市名称（纯文本） |
|
||
| `closedDay` | `string` | | 休息日 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `cuisineType` | `string` | | 菜系类型编码 |
|
||
| `cuisineTypeName` | `string` | | 菜系类型名称 |
|
||
| `description` | `string` | | 餐厅描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `environmentType` | `string` | | 环境类型 |
|
||
| `facilities` | `string[]` | | 设施编码列表 |
|
||
| `facilityNames` | `string[]` | | 设施名称列表 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `featuredMenu` | `string` | | 招牌菜单（JSON格式） |
|
||
| `groupSizeMax` | `int` | | 最多接待人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `hasPrivateRoom` | `int` | | 是否有包间：0=无 1=有 |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `minAdvanceHours` | `int` | | 最少提前预约小时数 |
|
||
| `name` | `string` | | 餐厅名称 |
|
||
| `phone` | `string` | | 联系电话 |
|
||
| `pricePerPerson` | `number` | | 人均消费（元） |
|
||
| `province` | `string` | | 省份 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `reservationRequired` | `int` | | 是否需要预约：0=否 1=是 |
|
||
| `restaurantId` | `string` | | 餐厅ID |
|
||
| `reviewCount` | `int` | | 评论数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `餐厅标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/restaurant/item/{restaurantId}
|
||
|
||
**餐厅详情**
|
||
|
||
获取餐厅完整信息，包含素材URL、标签、富文本介绍等。
|
||
|
||
**关联字典**：
|
||
- restaurant_category：餐厅分类（详情显示）
|
||
- cuisine_type：菜系类型（详情显示）
|
||
- environment_type：环境类型（详情显示）
|
||
- restaurant_facility：餐厅设施（详情显示）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantId` | `integer` | | 餐厅ID |
|
||
|
||
**响应** `统一响应结果«餐厅详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `餐厅详情视图` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 座位布局说明 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `businessHours` | `string` | | 营业时间 |
|
||
| `capacity` | `int` | | 容纳人数 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `categoryName` | `string` | | 分类名称 |
|
||
| `city` | `string` | | 城市 |
|
||
| `cityName` | `string` | | 城市名称（纯文本） |
|
||
| `closedDay` | `string` | | 休息日 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `cuisineType` | `string` | | 菜系类型编码 |
|
||
| `cuisineTypeName` | `string` | | 菜系类型名称 |
|
||
| `description` | `string` | | 餐厅描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `environmentType` | `string` | | 环境类型 |
|
||
| `facilities` | `string[]` | | 设施编码列表 |
|
||
| `facilityNames` | `string[]` | | 设施名称列表 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `featuredMenu` | `string` | | 招牌菜单（JSON格式） |
|
||
| `groupSizeMax` | `int` | | 最多接待人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `hasPrivateRoom` | `int` | | 是否有包间：0=无 1=有 |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `minAdvanceHours` | `int` | | 最少提前预约小时数 |
|
||
| `name` | `string` | | 餐厅名称 |
|
||
| `phone` | `string` | | 联系电话 |
|
||
| `pricePerPerson` | `number` | | 人均消费（元） |
|
||
| `province` | `string` | | 省份 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `reservationRequired` | `int` | | 是否需要预约：0=否 1=是 |
|
||
| `restaurantId` | `string` | | 餐厅ID |
|
||
| `reviewCount` | `int` | | 评论数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `餐厅标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `PUT` /admin/restaurant/item/{restaurantId}
|
||
|
||
**更新餐厅**
|
||
|
||
更新餐厅基本信息，不改变当前状态。
|
||
|
||
**关联字典**：
|
||
- restaurant_category：餐厅分类（表单选择）
|
||
- cuisine_type：菜系类型（表单多选）
|
||
- environment_type：环境类型（表单多选）
|
||
- restaurant_facility：餐厅设施（表单多选）
|
||
|
||
**纯文本字段**：
|
||
- cityName：城市名称（手动输入）
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantId` | `integer` | | 餐厅ID |
|
||
|
||
**请求体** `餐厅更新请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 座位布局说明 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `businessHours` | `string` | | 营业时间 |
|
||
| `capacity` | `int` | | 容纳人数 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `city` | `string` | | 城市 |
|
||
| `cityName` | `string` | | 城市名称（纯文本输入） |
|
||
| `closedDay` | `string` | | 休息日 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `cuisineType` | `string` | | 菜系类型 |
|
||
| `description` | `string` | | 餐厅描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `environmentType` | `string` | | 环境类型 |
|
||
| `facilities` | `string[]` | | 设施列表 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `featuredMenu` | `string` | | 招牌菜单（JSON格式） |
|
||
| `groupSizeMax` | `int` | | 最多接待人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `hasPrivateRoom` | `int` | | 是否有包间：0=无 1=有 |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `minAdvanceHours` | `int` | | 最少提前预约小时数 |
|
||
| `name` | `string` | | 餐厅名称 |
|
||
| `phone` | `string` | | 联系电话 |
|
||
| `pricePerPerson` | `number` | | 人均消费（元） |
|
||
| `province` | `string` | | 省份 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `reservationRequired` | `int` | | 是否需要预约：0=否 1=是 |
|
||
| `sortOrder` | `int` | | 排序权重（数字越大越靠前） |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
|
||
**响应** `统一响应结果«餐厅详情视图»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `餐厅详情视图` | | 响应数据 |
|
||
| `address` | `string` | | 详细地址 |
|
||
| `arrangement` | `string` | | 座位布局说明 |
|
||
| `bannerMaterialIds` | `string[]` | | 轮播图素材ID列表 |
|
||
| `bannerUrls` | `string[]` | | 轮播图URL列表 |
|
||
| `businessHours` | `string` | | 营业时间 |
|
||
| `capacity` | `int` | | 容纳人数 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `categoryName` | `string` | | 分类名称 |
|
||
| `city` | `string` | | 城市 |
|
||
| `cityName` | `string` | | 城市名称（纯文本） |
|
||
| `closedDay` | `string` | | 休息日 |
|
||
| `coverMaterialId` | `string` | | 封面素材ID |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `createdBy` | `string` | | 创建人ID |
|
||
| `createdByName` | `string` | | 创建人姓名 |
|
||
| `cuisineType` | `string` | | 菜系类型编码 |
|
||
| `cuisineTypeName` | `string` | | 菜系类型名称 |
|
||
| `description` | `string` | | 餐厅描述 |
|
||
| `district` | `string` | | 区县 |
|
||
| `environmentType` | `string` | | 环境类型 |
|
||
| `facilities` | `string[]` | | 设施编码列表 |
|
||
| `facilityNames` | `string[]` | | 设施名称列表 |
|
||
| `featureIntro` | `string` | | 图文详情（JSON格式） |
|
||
| `featuredMenu` | `string` | | 招牌菜单（JSON格式） |
|
||
| `groupSizeMax` | `int` | | 最多接待人数 |
|
||
| `groupSizeMin` | `int` | | 最少成行人数 |
|
||
| `hasPrivateRoom` | `int` | | 是否有包间：0=无 1=有 |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `latitude` | `number` | | 纬度 |
|
||
| `longitude` | `number` | | 经度 |
|
||
| `minAdvanceHours` | `int` | | 最少提前预约小时数 |
|
||
| `name` | `string` | | 餐厅名称 |
|
||
| `phone` | `string` | | 联系电话 |
|
||
| `pricePerPerson` | `number` | | 人均消费（元） |
|
||
| `province` | `string` | | 省份 |
|
||
| `rating` | `number` | | 评分 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `reservationRequired` | `int` | | 是否需要预约：0=否 1=是 |
|
||
| `restaurantId` | `string` | | 餐厅ID |
|
||
| `reviewCount` | `int` | | 评论数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `餐厅标签视图[]` | | 标签列表 |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `tagColor` | `string` | | 标签颜色 |
|
||
| `tagId` | `string` | | 标签ID |
|
||
| `tagName` | `string` | | 标签名称 |
|
||
| `tagType` | `int` | | 标签类型：1=系统标签 2=自定义标签 |
|
||
| `useCount` | `int` | | 使用次数 |
|
||
| `updatedAt` | `string` | | 更新时间 |
|
||
| `videoMaterialIds` | `string[]` | | 视频素材ID列表 |
|
||
| `videoUrls` | `string[]` | | 视频URL列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/restaurant/item/{restaurantId}
|
||
|
||
**删除餐厅**
|
||
|
||
软删除餐厅。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantId` | `integer` | | 餐厅ID |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/restaurant/item/{restaurantId}/status
|
||
|
||
**上下架切换**
|
||
|
||
直接修改状态（跳过审批），仅限SUPER_ADMIN。状态值：0=草稿，1=上架，2=下架。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantId` | `integer` | | 餐厅ID |
|
||
|
||
**请求体** `餐厅状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantIds` | `string[]` | | 餐厅ID列表（批量操作） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `POST` /admin/restaurant/item/{restaurantId}/submit-approval
|
||
|
||
**提交启用/禁用审批**
|
||
|
||
向企微OA提交审批。targetStatus=1申请上架，targetStatus=2申请下架。返回审批单号spNo。
|
||
|
||
**路径参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantId` | `integer` | | 餐厅ID |
|
||
|
||
**请求体** `餐厅审批提交请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `reason` | `string` | 是 | 审批理由 |
|
||
| `targetStatus` | `int` | 是 | 目标状态：1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Map«string,string»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `object` | | 响应数据 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `GET` /admin/restaurant/items
|
||
|
||
**餐厅列表**
|
||
|
||
分页查询餐厅列表，支持按名称、状态、分类、城市等条件筛选。
|
||
|
||
**关联字典**：
|
||
- restaurant_category：餐厅分类（筛选+列表显示）
|
||
- cuisine_type：菜系类型（列表显示）
|
||
- environment_type：环境类型（列表显示）
|
||
- restaurant_facility：餐厅设施（列表显示）
|
||
|
||
**查询参数**
|
||
|
||
| 参数 | 类型 | 必填 | 说明 | 示例 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `categoryCode` | `string` | | 分类编码 | TIBETAN |
|
||
| `city` | `string` | | 城市 | 拉萨市 |
|
||
| `cityName` | `string` | | 城市名称筛选（纯文本） | 拉萨 |
|
||
| `cuisineType` | `string` | | 菜系类型 | TIBETAN |
|
||
| `keyword` | `string` | | 搜索关键词（名称/副标题模糊搜索） | 藏餐 |
|
||
| `page` | `integer(int32)` | | 页码 | 1 |
|
||
| `pageSize` | `integer(int32)` | | 每页条数 | 20 |
|
||
| `province` | `string` | | 省份 | 西藏自治区 |
|
||
| `recommended` | `integer(int32)` | | 是否推荐：0=否 1=是 | 1 |
|
||
| `sortBy` | `string` | | 排序字段 | createdAt |
|
||
| `sortDir` | `string` | | 排序方向：asc=升序 desc=降序 | desc |
|
||
| `status` | `integer(int32)` | | 状态：0=草稿 1=上架 2=下架 | 1 |
|
||
| `tagId` | `integer(int64)` | | 标签ID | 100 |
|
||
| `tagIds` | `string` | | 标签ID列表（逗号分隔） | 100,101,102 |
|
||
|
||
**响应** `统一响应结果«分页结果«餐厅列表视图»»`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `code` | `int` | | 状态码 |
|
||
| `data` | `分页结果«餐厅列表视图»` | | 响应数据 |
|
||
| `page` | `int` | | 当前页码 |
|
||
| `pageSize` | `int` | | 每页条数 |
|
||
| `records` | `餐厅列表视图[]` | | 数据列表 |
|
||
| `approvalNo` | `string` | | 审批编号 |
|
||
| `categoryCode` | `string` | | 分类编码 |
|
||
| `categoryName` | `string` | | 分类名称 |
|
||
| `cityName` | `string` | | 城市名称（纯文本） |
|
||
| `coverUrl` | `string` | | 封面图URL |
|
||
| `createdAt` | `string` | | 创建时间 |
|
||
| `cuisineType` | `string` | | 菜系类型编码 |
|
||
| `cuisineTypeName` | `string` | | 菜系类型名称 |
|
||
| `highlights` | `string` | | 亮点摘要 |
|
||
| `name` | `string` | | 餐厅名称 |
|
||
| `pendingStatus` | `int` | | 待审批目标状态 |
|
||
| `pricePerPerson` | `number` | | 人均消费（元） |
|
||
| `rating` | `number` | | 评分 |
|
||
| `recommended` | `int` | | 是否推荐：0=否 1=是 |
|
||
| `restaurantId` | `string` | | 餐厅ID |
|
||
| `reviewCount` | `int` | | 评论数 |
|
||
| `sortOrder` | `int` | | 排序权重 |
|
||
| `status` | `int` | | 状态：0=草稿 1=上架 2=下架 |
|
||
| `subtitle` | `string` | | 副标题 |
|
||
| `tags` | `餐厅标签视图[]` | | 标签列表 |
|
||
| `viewCount` | `int` | | 浏览量 |
|
||
| `total` | `int` | | 总记录数 |
|
||
| `message` | `string` | | 响应消息 |
|
||
|
||
---
|
||
|
||
### `DELETE` /admin/restaurant/items/batch
|
||
|
||
**批量删除**
|
||
|
||
批量软删除多个餐厅。仅SUPER_ADMIN或创建者可操作。
|
||
|
||
**请求体** `餐厅批量删除请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantIds` | `string[]` | 是 | 餐厅ID列表 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|
||
|
||
### `PUT` /admin/restaurant/items/batch/status
|
||
|
||
**批量上下架**
|
||
|
||
批量修改多个餐厅的状态，跳过审批流程。
|
||
|
||
**请求体** `餐厅状态变更请求`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- |
|
||
| `restaurantIds` | `string[]` | | 餐厅ID列表（批量操作） |
|
||
| `status` | `int` | 是 | 目标状态：0=草稿 1=上架 2=下架 |
|
||
|
||
**响应** `统一响应结果«Void»`
|
||
|
||
---
|