# 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 文档描述，使其与实际逻辑一致。**数据库无变更，不影响已有数据。**