refactor: 拆分接口文档分组配置及 controller 到各自模块

continew-plugin/continew-plugin-schedule/src/main/java/top/continew/admin/schedule/config/ScheduleConfiguration.java

@@ -0,0 +1,27 @@
+package top.continew.admin.schedule.config;
+
+import org.springdoc.core.models.GroupedOpenApi;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * 任务调度配置
+ *
+ * @author Charles7c
+ * @since 2025/6/14 21:22
+ */
+@Configuration
+public class ScheduleConfiguration {
+
+    /**
+     * API 文档分组配置
+     */
+    @Bean
+    public GroupedOpenApi scheduleApi() {
+        return GroupedOpenApi.builder()
+                             .group("schedule")
+                             .displayName("任务调度")
+                             .pathsToMatch("/schedule/**")
+                             .build();
+    }
+}

continew-plugin/continew-plugin-schedule/src/main/java/top/continew/admin/schedule/controller/JobController.java

@@ -0,0 +1,109 @@
+/*
+ * Copyright (c) 2022-present Charles7c Authors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package top.continew.admin.schedule.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.enums.ParameterIn;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+import top.continew.admin.schedule.model.query.JobQuery;
+import top.continew.admin.schedule.model.req.JobReq;
+import top.continew.admin.schedule.model.req.JobStatusReq;
+import top.continew.admin.schedule.model.req.JobTriggerReq;
+import top.continew.admin.schedule.model.resp.JobResp;
+import top.continew.admin.schedule.service.JobService;
+import top.continew.starter.extension.crud.model.resp.PageResp;
+import top.continew.starter.extension.crud.validation.CrudValidationGroup;
+import top.continew.starter.log.annotation.Log;
+
+import java.util.List;
+
+/**
+ * 任务 API
+ *
+ * @author KAI
+ * @author Charles7c
+ * @since 2024/6/25 22:24
+ */
+@Tag(name = " 任务 API")
+@Validated
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/schedule/job")
+public class JobController {
+
+    private final JobService baseService;
+
+    @Operation(summary = "分页查询任务列表", description = "分页查询任务列表")
+    @SaCheckPermission("schedule:job:list")
+    @GetMapping
+    public PageResp<JobResp> page(JobQuery query) {
+        return baseService.page(query);
+    }
+
+    @Operation(summary = "新增任务", description = "新增任务")
+    @SaCheckPermission("schedule:job:create")
+    @PostMapping
+    public void create(@Validated(CrudValidationGroup.Create.class) @RequestBody JobReq req) {
+        baseService.create(req);
+    }
+
+    @Operation(summary = "修改任务", description = "修改任务")
+    @Parameter(name = "id", description = "ID", example = "1", in = ParameterIn.PATH)
+    @SaCheckPermission("schedule:job:update")
+    @PutMapping("/{id}")
+    public void update(@Validated(CrudValidationGroup.Update.class) @RequestBody JobReq req, @PathVariable Long id) {
+        baseService.update(req, id);
+    }
+
+    @Operation(summary = "修改任务状态", description = "修改任务状态")
+    @SaCheckPermission("schedule:job:update")
+    @PatchMapping("/{id}/status")
+    public void updateStatus(@Validated @RequestBody JobStatusReq req, @PathVariable Long id) {
+        baseService.updateStatus(req, id);
+    }
+
+    @Operation(summary = "删除任务", description = "删除任务")
+    @Parameter(name = "id", description = "ID", example = "1", in = ParameterIn.PATH)
+    @SaCheckPermission("schedule:job:delete")
+    @DeleteMapping("/{id}")
+    public void delete(@PathVariable Long id) {
+        baseService.delete(id);
+    }
+
+    @Operation(summary = "执行任务", description = "执行任务")
+    @Parameter(name = "id", description = "ID", example = "1", in = ParameterIn.PATH)
+    @SaCheckPermission("schedule:job:trigger")
+    @PostMapping("/trigger/{id}")
+    public void trigger(@PathVariable Long id) {
+        JobTriggerReq req = new JobTriggerReq();
+        req.setJobId(id);
+        baseService.trigger(req);
+    }
+
+    @Log(ignore = true)
+    @Operation(summary = "查询任务分组列表", description = "查询任务分组列表")
+    @SaCheckPermission("schedule:job:list")
+    @GetMapping("/group")
+    public List<String> listGroup() {
+        return baseService.listGroup();
+    }
+}

continew-plugin/continew-plugin-schedule/src/main/java/top/continew/admin/schedule/controller/JobLogController.java

@@ -0,0 +1,90 @@
+/*
+ * Copyright (c) 2022-present Charles7c Authors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package top.continew.admin.schedule.controller;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.enums.ParameterIn;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+import top.continew.admin.schedule.model.JobInstanceLogPageResult;
+import top.continew.admin.schedule.model.query.JobInstanceLogQuery;
+import top.continew.admin.schedule.model.query.JobInstanceQuery;
+import top.continew.admin.schedule.model.query.JobLogQuery;
+import top.continew.admin.schedule.model.resp.JobInstanceResp;
+import top.continew.admin.schedule.model.resp.JobLogResp;
+import top.continew.admin.schedule.service.JobLogService;
+import top.continew.starter.extension.crud.model.resp.PageResp;
+
+import java.util.List;
+
+/**
+ * 任务日志 API
+ *
+ * @author KAI
+ * @author Charles7c
+ * @since 2024/6/27 22:24
+ */
+@Tag(name = " 任务日志 API")
+@Validated
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/schedule/log")
+public class JobLogController {
+
+    private final JobLogService baseService;
+
+    @Operation(summary = "分页查询任务日志列表", description = "分页查询任务日志列表")
+    @SaCheckPermission("schedule:log:list")
+    @GetMapping
+    public PageResp<JobLogResp> page(JobLogQuery query) {
+        return baseService.page(query);
+    }
+
+    @Operation(summary = "停止任务", description = "停止任务")
+    @Parameter(name = "id", description = "ID", example = "1", in = ParameterIn.PATH)
+    @SaCheckPermission("schedule:log:stop")
+    @PostMapping("/stop/{id}")
+    public void stop(@PathVariable Long id) {
+        baseService.stop(id);
+    }
+
+    @Operation(summary = "重试任务", description = "重试任务")
+    @Parameter(name = "id", description = "ID", example = "1", in = ParameterIn.PATH)
+    @SaCheckPermission("schedule:log:retry")
+    @PostMapping("/retry/{id}")
+    public void retry(@PathVariable Long id) {
+        baseService.retry(id);
+    }
+
+    @Operation(summary = "查询任务实例列表", description = "查询任务实例列表")
+    @SaCheckPermission("schedule:log:list")
+    @GetMapping("/instance")
+    public List<JobInstanceResp> listInstance(JobInstanceQuery query) {
+        return baseService.listInstance(query);
+    }
+
+    @Operation(summary = "分页查询任务实例日志列表", description = "分页查询任务实例日志列表")
+    @SaCheckPermission("schedule:log:list")
+    @GetMapping("/instance/log")
+    public JobInstanceLogPageResult pageInstanceLog(JobInstanceLogQuery query) {
+        return baseService.pageInstanceLog(query);
+    }
+}