# refactor(material): 拆除素材审核遗留功能（reviewStatus 字段 + 字典 + DTO 全删）

> **仓库**: HL (后端 hl-resource-service + hl-user-service)
> **关联 PR/Issue**: PR #2795, Closes #2789
> **日期**: 2026-05-21
> **影响范围**: 管理后台「素材库」批量审核/批量驳回功能整体废弃
> **接收方**: mmg (前端)
> **前端**: **需要改动 — 拆按钮 + 删 API**

---

## 🚨 关键变化

「素材审核」功能业务上已不需要，本次全部拆除：

- 后端 `Material.reviewStatus` 字段删除
- DB `material.review_status` 列 DROP
- DB 字典 `material_review_status` DELETE
- `MaterialReviewRequest` DTO 删除

**正式环境之前批量审核接口 `PUT /admin/material/review` 触发的「参数类型错误: materialId='review'（需要 Long 类型）」报错根因就是这两条**：前端调了 `/admin/material/review` 但后端从未实现该接口，Spring 把 `review` 当成 `{materialId}` 路径变量去解析 Long，报错。

---

## 一、API 影响

### 不再存在的接口（后端从未实现）

```
PUT  /admin/material/review     ← 不再支持（前端有死调用）
PUT  /admin/material/reject     ← 不再支持（前端有死调用）
```

### 字段移除

| 接口 | 字段 | 改前 | 改后 |
|------|------|------|------|
| `GET /admin/material/list` | `reviewStatus` | 不返回（VO 本就没此字段） | 不返回（一致） |
| `GET /admin/material/{id}` | `reviewStatus` | 不返回（VO 本就没此字段） | 不返回（一致） |

> 实际 VO 层本来就没有 `reviewStatus` 字段，只是 Entity 层和 DB 列还在，本次一并清理。响应字段对前端无任何观测变化。

---

## 🚨 前端需要做的事

### 1. 删除批量审核/批量驳回 API

文件：`hl-ui/src/api/material.js` 第 335-353 行

```js
// 整段删掉
// ========== 素材审核 ==========

/**
 * 批量审核通过
 */
export function reviewMaterials(materialIds) {
  return http.put('/material/review', { materialIds })
}

/**
 * 批量驳回素材(删除)
 */
export function rejectMaterials(materialIds) {
  return http.put('/material/reject', { materialIds })
}
```

### 2. 拆 UI 按钮 + 弹窗

文件：`hl-ui/src/views/material/index.vue`

- 删除「批量审核」按钮、「批量驳回」按钮
- 删除「批量审核确认」弹窗及相关逻辑
- 列表/详情若有 `reviewStatus` 列或字段显示，一并删（实际 API 本就不返回）

### 3. 自查

请 mmg 全前端 grep 一遍：

```bash
grep -rE "reviewMaterials|rejectMaterials|material.*review|批量审核|审核通过|审核状态" hl-ui/src
```

如有残留请一并清理。

---

## 二、DB 改动（Flyway 已自动跑）

- `hl-resource-service` `V20260521_001__drop_material_review_status.sql` — `ALTER TABLE material DROP COLUMN review_status`（MySQL 8.0 兼容写法，列不存在时跳过）
- `hl-user-service` `V20260521_006__drop_material_review_status_dict.sql` — `DELETE` `sys_dict_type` + `sys_dict_data` 中 `material_review_status` 全部行

> dev 上的 user-service Flyway 文件名是 `V20260521_002`，dev-v3 上为避免 out-of-order 改名为 `V20260521_006`。两个分支文件名不同但 SQL 内容完全一致。

---

## 三、兼容性 / 风险

- ✅ VO 层本就无 `reviewStatus` 字段，前端列表/详情响应字段零变化
- ✅ Flyway 用 `information_schema` 防御，多环境部署安全（本地无此列也能跑过）
- ✅ DB 历史 `review_status` 值（如 PENDING/REJECTED）随列 DROP 丢失语义，业务已确认不需要
- ⚠️ 前端 `PUT /admin/material/review` `/admin/material/reject` 调用 100% 报错（路径变量 Long 解析失败），mmg 改前端前用户使用「批量审核」按钮会持续报错

---

## 四、测试服验证记录

部署到测试服 (`https://web.test.1814.love:9443`) 后已 round-trip 验证（2026-05-21 14:01）：

```
✓ GET /admin/material/list?page=1&pageSize=1
  → 响应 item keys 中无 reviewStatus

✓ GET /admin/dict/data/material_review_status
  → code=200, data=[] (字典已清空)
```

Flyway 自动执行：
- hl-resource-service 启动时跑 `V20260521_001__drop_material_review_status.sql` → `material.review_status` 列已 DROP
- hl-user-service 启动时跑 `V20260521_006__drop_material_review_status_dict.sql` → 字典 `material_review_status` 已 DELETE

---

## 五、联系人

后端：wx（呼籁旅行）
前端：mmg

如有疑问可在 [#2789](https://git.1814.love:8443/wx/HL/issues/2789) 评论区留言。