hl-api-changelog/changelogs/2026-03/24_1438_resource_status.md

42 行
1.6 KiB
Markdown

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

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

# API 变更通知
**更新时间**: 2026-03-24 14:38
## ⚠️ 变更 - 资源管理状态简化
### 涉及模块全部9个资源模块
景区、游玩项目、酒店(含房型)、车辆、额外服务、人员、餐厅、额外费用、备品
### 变更内容
**状态值从三态改为二态:**
| 原状态 | 新状态 |
|--------|--------|
| 0=草稿 | 0=下架 |
| 1=上架 | 1=上架(不变) |
| 2=下架 | **已移除** |
**简单说:去掉草稿概念,只剩上架/下架两个状态。**
### 前端需要调整
1. **状态筛选下拉框**:去掉「草稿」选项,改为「下架(0)」和「上架(1)」
2. **列表/详情状态标签**`status=0` 显示「下架」(原来显示「草稿」),`status=1` 显示「上架」
3. **不再需要 status=2**:如果之前有 `status=2` 的处理逻辑,可以删除
4. **上下架操作按钮**:目标状态只传 `0`(下架)或 `1`(上架),不再传 `2`
5. **审批接口 targetStatus**:同上,只有 `0``1`
### 受影响的接口(所有资源模块通用)
- `GET /admin/{module}/list` — status 参数:`0=下架, 1=上架`
- `PUT /admin/{module}/{id}/status` — status 字段:`0=下架, 1=上架`
- `PUT /admin/{module}/batch/status` — status 字段同上
- `POST /admin/{module}/{id}/submit-approval` — targetStatus`0=下架, 1=上架`
- 创建/更新接口的 status 字段同上
### 说明
代码实际一直只用 0 和 1 两个值STATUS_OFF=0, STATUS_ON=1,status=2 从未真正使用过。本次只是统一了 API 文档描述,使其与实际逻辑一致。**数据库无变更,不影响已有数据。**