From c5d914d073737a19d73f725e5952ca54c4693bf6 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 29 Jun 2026 12:25:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E5=AE=9A=E6=97=B6?= =?UTF-8?q?=E4=BB=BB=E5=8A=A1=E7=AE=A1=E7=90=86=E9=A1=B5=E8=A1=A5=E6=9A=82?= =?UTF-8?q?=E5=81=9C/=E6=81=A2=E5=A4=8D/=E7=AB=8B=E5=8D=B3=E6=89=A7?= =?UTF-8?q?=E8=A1=8C=E6=8C=89=E9=92=AE=20(#4615)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...理页补暂停恢复立即执行按钮_前端对接-管理后台.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 changelogs-v2/2026-06/50_4615_定时任务管理页补暂停恢复立即执行按钮_前端对接-管理后台.md diff --git a/changelogs-v2/2026-06/50_4615_定时任务管理页补暂停恢复立即执行按钮_前端对接-管理后台.md b/changelogs-v2/2026-06/50_4615_定时任务管理页补暂停恢复立即执行按钮_前端对接-管理后台.md new file mode 100644 index 0000000..0d8fc18 --- /dev/null +++ b/changelogs-v2/2026-06/50_4615_定时任务管理页补暂停恢复立即执行按钮_前端对接-管理后台.md @@ -0,0 +1,42 @@ +# 定时任务管理页：补「暂停 / 恢复 / 立即执行」按钮（后端已就绪） + +> 模块：用户中心 · 定时任务管理（管理后台 `/admin/job` 页） +> 类型：**前端对接（后端端点早已上线，无需后端改动）** +> 关联：#4615（消除散落 @Scheduled 统一迁移用户中心定时任务） +> 日期：2026-06-29 + +--- + +## 一、背景 + +定时任务统一收口到「用户中心定时任务」（sys_job/Quartz）后，运营需要能在后台**暂停**异常任务（如发骚扰短信的任务）。后端 `/admin/job` 的暂停/恢复/立即执行端点**早已上线并在测试服验证可达**，但管理后台定时任务列表页目前**只有查看、缺操作按钮**，需前端补上。 + +## 二、后端现有端点（均已上线，无需等后端） + +列表每行补以下操作按钮： + +| 操作 | 接口 | 说明 | +|------|------|------| +| 暂停 | `POST /admin/job/{jobId}/pause` | 任务转 `PAUSED`，从调度器移除，不再按 cron 执行 | +| 恢复 | `POST /admin/job/{jobId}/resume` | 任务转 `ACTIVE`，重新按 cron 调度 | +| 立即执行一次 | `POST /admin/job/{jobId}/trigger` | 不影响原 cron 计划，手动触发一次（ACTIVE/PAUSED 均可），结果进任务日志 | +| 执行日志 | `GET /admin/job/{jobId}/logs?page=&pageSize=` | 按执行时间倒序，含成功/失败、耗时、异常信息 | + +（另已存在 创建 `POST /admin/job`、更新 `PUT /admin/job/{jobId}`、删除 `DELETE /admin/job/{jobId}`，如页面需要可一并接。） + +返回均为标准 `Result`，`code=200` 即成功，`data` 为空。 + +## 三、权限约束（重要） + +- 暂停 / 恢复 / 立即执行 / 创建 / 更新 / 删除 **均要求超级管理员（SUPER_ADMIN）角色**；非超管调用后端返回 **`code=210301`「仅超级管理员可管理定时任务」**（HTTP 仍 200）。 +- 列表查询 `GET /admin/job`、日志查询 `GET /admin/job/{jobId}/logs` 不限超管。 +- 前端建议：操作按钮按当前登录角色是否超管来显示/置灰；非超管误触时按 `210301` 给出「需超级管理员」提示，不要当成系统错误。 + +## 四、字段提示 + +- 列表项 `status`：`ACTIVE`=启用 / `PAUSED`=已暂停（字典 `job_status`）；按钮态据此切换（ACTIVE 显示「暂停」，PAUSED 显示「恢复」）。 +- `jobGroup`：返回的是 code（如 `ORDER`/`TASK`/`SYSTEM`/`WECHAT`/`INSURANCE`/`HOUSE`），按 `job_group` 字典翻中文展示（沿用现有「任务分组」列翻译逻辑）。 + +## 五、后端 + +无改动，端点既有、测试服已验证可达。