diff --git a/changelogs/2026-03/24_1438_resource_status.md b/changelogs/2026-03/24_1438_resource_status.md new file mode 100644 index 0000000..bd6aa11 --- /dev/null +++ b/changelogs/2026-03/24_1438_resource_status.md @@ -0,0 +1,41 @@ +# 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 文档描述,使其与实际逻辑一致。**数据库无变更,不影响已有数据。**