hl-api-changelog/changelogs-v2/2026-06/50_4615_定时任务管理页补暂停恢复立即执行按钮_前端对接-管理后台.md

定时任务管理页：补「暂停 / 恢复 / 立即执行」按钮（后端已就绪）

模块：用户中心 · 定时任务管理（管理后台 /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 字典翻中文展示（沿用现有「任务分组」列翻译逻辑）。

五、后端

无改动，端点既有、测试服已验证可达。