43 行
2.5 KiB
Markdown
43 行
2.5 KiB
Markdown
# 定时任务管理页：补「暂停 / 恢复 / 立即执行」按钮（后端已就绪）
|
||
|
||
> 模块：用户中心 · 定时任务管理（管理后台 `/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` 字典翻中文展示（沿用现有「任务分组」列翻译逻辑）。
|
||
|
||
## 五、后端
|
||
|
||
无改动，端点既有、测试服已验证可达。
|