docs(changelog-v2): 定时任务管理页补暂停/恢复/立即执行按钮 (#4615)

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` 字典翻中文展示（沿用现有「任务分组」列翻译逻辑）。
+
+## 五、后端
+
+无改动，端点既有、测试服已验证可达。