hl-api-changelog/changelogs/2026-03/2026-03-24_1434_50e2536_refactor.md
2026-03-24 14:52:18 +08:00

266 行
12 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 接口变更记录 — 2026-03-24 14:34
> **提交** `50e2536` · **作者** wx · **时间** 2026-03-24 14:34:21 +0800
>
> refactor: 资源管理去除草稿状态,只保留上架/下架二态
## 变更总览
### ⚠️ 一句话:所有资源模块的 status 字段,去掉「草稿」,只剩「上架/下架」
| 原来 | 现在 |
|------|------|
| 0 = 草稿 | 0 = **下架** |
| 1 = 上架 | 1 = 上架(不变) |
| 2 = 下架 | **删除,不再使用** |
### 前端要改的地方
1. **状态筛选下拉框**:去掉「草稿」选项,只留「下架(0)」和「上架(1)」
2. **状态标签显示**`status=0` 原来显示「草稿」→ 现在显示「**下架**」
3. **删掉 status=2 的逻辑**:如果代码里有处理 `status=2` 的地方,直接删
4. **上下架按钮传值**:只传 `0`(下架)或 `1`(上架),不再传 `2`
### 涉及的资源模块全部9个,改法一样
景区、游玩项目、酒店(含房型)、车辆、额外服务、人员、餐厅、额外费用、备品
### 补充说明
数据库里实际从来没有 status=2 的数据,之前代码也只用 0 和 1。这次只是把 API 文档统一了。**不需要做数据迁移。**
---
## 📦 其他数据对象变更(自动生成的 diff 详情)
> 以下变更未直接关联到本次接口变更,但可能影响现有接口的请求/响应
### 资源服务
#### ✏️ ActivityListVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ ActivityQueryRequest
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ ActivityStatusRequest
- ✏️ `status`: 说明 "目标状态0=草稿 1=上架 2=下架" → "目标状态0=下架 1=上架"
#### ✏️ ActivityVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ ApprovalSubmitRequest
- ✏️ `targetStatus`: 说明 "目标状态1=上架 2=下架" → "目标状态0=下架 1=上架"
#### ✏️ CostItemListVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ CostItemQueryRequest
- ✏️ `status`: 说明 "状态筛选0=草稿 1=上架 2=下架" → "状态筛选0=下架 1=上架"
#### ✏️ CostItemVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ HotelListVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ HotelQueryRequest
- ✏️ `status`: 说明 "状态筛选0=草稿 1=上架 2=下架" → "状态筛选0=下架 1=上架"
#### ✏️ HotelStatusRequest
- ✏️ `status`: 说明 "目标状态0=草稿 1=上架 2=下架" → "目标状态0=下架 1=上架"
#### ✏️ HotelVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ RestaurantListVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ RestaurantQueryRequest
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ RestaurantStatusRequest
- ✏️ `status`: 说明 "目标状态0=草稿 1=上架 2=下架" → "目标状态0=下架 1=上架"
#### ✏️ RestaurantUpdateRequest
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ RestaurantVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ RoomTypeStatusRequest
- ✏️ `status`: 说明 "状态0=禁用 1=启用" → "状态0=下架 1=上架"
#### ✏️ RoomTypeVO
- ✏️ `status`: 说明 "状态0=禁用 1=启用" → "状态0=下架 1=上架"
#### ✏️ ScenicSpotListVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ ScenicSpotQueryRequest
- ✏️ `status`: 说明 "状态筛选0=草稿 1=上架 2=下架" → "状态筛选0=下架 1=上架"
#### ✏️ ScenicSpotUpdateRequest
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ ScenicSpotVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ ScenicStatusRequest
- ✏️ `status`: 说明 "目标状态0=草稿 1=上架 2=下架" → "目标状态0=下架 1=上架"
#### ✏️ ServiceItemListVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ ServiceItemVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ ServiceQueryRequest
- ✏️ `status`: 说明 "状态筛选0=草稿 1=上架 2=下架" → "状态筛选0=下架 1=上架"
#### ✏️ ServiceStatusRequest
- ✏️ `status`: 说明 "目标状态0=草稿 1=上架 2=下架" → "目标状态0=下架 1=上架"
#### ✏️ StaffListVO
- ✏️ `status`: 说明 "状态0=禁用 1=启用" → "状态0=下架 1=上架"
#### ✏️ StaffQueryRequest
- ✏️ `status`: 说明 "状态筛选0=禁用 1=启用" → "状态筛选0=下架 1=上架"
#### ✏️ StaffStatusRequest
- ✏️ `status`: 说明 "目标状态0=草稿 1=上架 2=下架" → "目标状态0=下架 1=上架"
#### ✏️ StaffVO
- ✏️ `status`: 说明 "状态0=禁用 1=启用" → "状态0=下架 1=上架"
#### ✏️ SuppliesListVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ SuppliesQueryRequest
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ SuppliesStatusRequest
- ✏️ `status`: 说明 "目标状态0=草稿 1=上架 2=下架" → "目标状态0=下架 1=上架"
#### ✏️ SuppliesUpdateRequest
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ SuppliesVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ VehicleModelListVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ VehicleModelVO
- ✏️ `status`: 说明 "状态0=草稿 1=上架 2=下架" → "状态0=下架 1=上架"
#### ✏️ VehicleQueryRequest
- ✏️ `status`: 说明 "状态筛选0=草稿 1=上架 2=下架" → "状态筛选0=下架 1=上架"
#### ✏️ VehicleStatusRequest
- ✏️ `status`: 说明 "目标状态0=草稿 1=上架 2=下架" → "目标状态0=下架 1=上架"
<details>
<summary>📁 全部变更文件 (点击展开)</summary>
```
M hl-resource-service/src/main/java/com/hulalv/resource/activity/controller/ActivityController.java
M hl-resource-service/src/main/java/com/hulalv/resource/activity/dto/ActivityQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/activity/dto/ActivityStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/activity/dto/ApprovalSubmitRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/activity/vo/ActivityListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/activity/vo/ActivityVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/cost/dto/CostItemQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/cost/vo/CostItemListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/cost/vo/CostItemVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/controller/HotelController.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/controller/RoomTypeController.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/dto/ApprovalSubmitRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/dto/HotelQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/dto/HotelStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/dto/RoomTypeStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/vo/HotelListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/vo/HotelVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/hotel/vo/RoomTypeVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/restaurant/controller/RestaurantController.java
M hl-resource-service/src/main/java/com/hulalv/resource/restaurant/dto/ApprovalSubmitRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/restaurant/dto/RestaurantQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/restaurant/dto/RestaurantStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/restaurant/dto/RestaurantUpdateRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/restaurant/vo/RestaurantListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/restaurant/vo/RestaurantVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/controller/ScenicSpotController.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/ApprovalSubmitRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/ScenicSpotCreateRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/ScenicSpotQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/ScenicSpotUpdateRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/ScenicStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/service/ScenicSpotService.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/vo/ScenicSpotListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/scenic/vo/ScenicSpotVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/service/controller/ServiceItemController.java
M hl-resource-service/src/main/java/com/hulalv/resource/service/dto/ApprovalSubmitRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/service/dto/ServiceQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/service/dto/ServiceStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/service/vo/ServiceItemListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/service/vo/ServiceItemVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/staff/controller/StaffController.java
M hl-resource-service/src/main/java/com/hulalv/resource/staff/dto/StaffQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/staff/dto/StaffStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/staff/vo/StaffListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/staff/vo/StaffVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/supplies/controller/SuppliesController.java
M hl-resource-service/src/main/java/com/hulalv/resource/supplies/dto/ApprovalSubmitRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/supplies/dto/SuppliesQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/supplies/dto/SuppliesStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/supplies/dto/SuppliesUpdateRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/supplies/vo/SuppliesListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/supplies/vo/SuppliesVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/vehicle/controller/VehicleModelController.java
M hl-resource-service/src/main/java/com/hulalv/resource/vehicle/dto/VehicleQueryRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/vehicle/dto/VehicleStatusRequest.java
M hl-resource-service/src/main/java/com/hulalv/resource/vehicle/vo/VehicleModelListVO.java
M hl-resource-service/src/main/java/com/hulalv/resource/vehicle/vo/VehicleModelVO.java
```
</details>