73 行
1.9 KiB
Markdown
73 行
1.9 KiB
Markdown
# 管理端 Topic status 字段从 Integer 改为 String 枚举
|
||
|
||
- **日期**: 2026-04-22
|
||
- **PR**: #1156
|
||
- **工单**: #1154
|
||
- **DDL**: 测试服已执行迁移脚本
|
||
- **影响**: 管理端专题模块
|
||
|
||
## 变更概要
|
||
|
||
Topic（专题）模块 `status` 字段由 `Integer`（0/1）改为 `String` 枚举（`ONLINE` / `OFFLINE`），对齐项目状态字段规范。
|
||
|
||
## 接口影响
|
||
|
||
### 1. 管理端专题列表查询 `GET /admin/topic/list`
|
||
|
||
**变更前**：
|
||
```
|
||
?status=1 // 上线
|
||
?status=0 // 下线
|
||
```
|
||
|
||
**变更后**：
|
||
```
|
||
?status=ONLINE // 上线
|
||
?status=OFFLINE // 下线
|
||
```
|
||
|
||
### 2. 管理端专题创建 / 更新 `POST /admin/topic/save` / `PUT /admin/topic/{id}`
|
||
|
||
请求 body 中 `status` 字段：
|
||
|
||
**变更前**：
|
||
```json
|
||
{ "status": 1 }
|
||
```
|
||
|
||
**变更后**：
|
||
```json
|
||
{ "status": "ONLINE" }
|
||
```
|
||
|
||
校验规则：`@Pattern("^(ONLINE|OFFLINE)$")`，不传入该枚举值会返回参数校验错误。
|
||
|
||
### 3. 所有返回 TopicVO 的接口（管理端 + C 端）
|
||
|
||
返回 body 中 `status` 字段：
|
||
|
||
**变更前**：
|
||
```json
|
||
{ "status": 1 }
|
||
```
|
||
|
||
**变更后**：
|
||
```json
|
||
{ "status": "ONLINE" }
|
||
```
|
||
|
||
## 前端需同步
|
||
|
||
1. **下拉字典切换**：管理端 topic 的 status 下拉/筛选从通用字典 `common_status`（0=禁用 / 1=启用）切换到专用字典 `topic_status`（ONLINE=上线 / OFFLINE=下线）
|
||
2. **所有传 status 的表单/筛选**：传值从 `1/0` 改为 `"ONLINE"/"OFFLINE"`
|
||
3. **所有读 status 的列表/详情**：显示逻辑从判 `status===1` 改为判 `status==='ONLINE'`
|
||
|
||
## 字段 `createdAt` 保持不变
|
||
|
||
为降低前端改动，TopicVO 的 `createdAt` 字段名保留不变（后端内部已从 `getCreatedAt` 改为 `getCreateTime` 读取，返回值仍是 ISO 时间字符串，业务语义和格式完全不变）。
|
||
|
||
## 非破坏性说明
|
||
|
||
- 已有逻辑只需按上述同步改 status 枚举值，无其他改动
|
||
- 后端已部署，测试服已迁移 DB，可直接联调
|