新增待办过期和历史归档任务

jsowell-system/src/main/java/com/jsowell/system/domain/dto/TodoTaskMaintenanceResult.java

@@ -0,0 +1,20 @@
+package com.jsowell.system.domain.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * 待办维护任务执行结果。
+ */
+@Data
+@AllArgsConstructor
+public class TodoTaskMaintenanceResult implements Serializable {
+	private static final long serialVersionUID = 1L;
+
+	private int expiredCount;
+	private int archivedCount;
+	private Date archiveBefore;
+}

jsowell-system/src/main/java/com/jsowell/system/mapper/SysTodoTaskMapper.java

@@ -6,6 +6,7 @@ import com.jsowell.system.domain.dto.TodoTaskQuery;
 import org.apache.ibatis.annotations.Param;
 
 import java.util.List;
+import java.util.Date;
 
 /**
  * 待办任务数据层。
@@ -73,4 +74,9 @@ public interface SysTodoTaskMapper {
 			@Param("updateBy") String updateBy);
 
 	int hideTodo(@Param("todoId") Long todoId, @Param("updateBy") String updateBy);
+
+	int expireDueTasks(@Param("now") Date now, @Param("updateBy") String updateBy);
+
+	int archiveTerminalTasks(@Param("archiveBefore") Date archiveBefore,
+			@Param("updateBy") String updateBy);
 }

jsowell-system/src/main/java/com/jsowell/system/service/TodoTaskMaintenanceService.java

@@ -0,0 +1,10 @@
+package com.jsowell.system.service;
+
+import com.jsowell.system.domain.dto.TodoTaskMaintenanceResult;
+
+/**
+ * 待办过期和历史归档维护服务。
+ */
+public interface TodoTaskMaintenanceService {
+	TodoTaskMaintenanceResult maintain();
+}

jsowell-system/src/main/java/com/jsowell/system/service/impl/TodoTaskMaintenanceServiceImpl.java

@@ -0,0 +1,38 @@
+package com.jsowell.system.service.impl;
+
+import com.jsowell.common.util.DateUtils;
+import com.jsowell.system.domain.dto.TodoTaskMaintenanceResult;
+import com.jsowell.system.mapper.SysTodoTaskMapper;
+import com.jsowell.system.service.TodoTaskMaintenanceService;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.Date;
+
+/**
+ * 待办过期和历史归档维护服务实现。
+ */
+@Service
+public class TodoTaskMaintenanceServiceImpl implements TodoTaskMaintenanceService {
+	private static final int DEFAULT_RETENTION_DAYS = 180;
+
+	@Value("${todo.retention-days:180}")
+	private Integer retentionDays;
+
+	@Autowired
+	private SysTodoTaskMapper todoTaskMapper;
+
+	@Override
+	@Transactional(rollbackFor = Exception.class)
+	public TodoTaskMaintenanceResult maintain() {
+		Date now = DateUtils.getNowDate();
+		int safeRetentionDays = retentionDays == null || retentionDays < DEFAULT_RETENTION_DAYS
+				? DEFAULT_RETENTION_DAYS : retentionDays;
+		int expiredCount = todoTaskMapper.expireDueTasks(now, "todo-maintenance");
+		Date archiveBefore = DateUtils.addDays(now, -safeRetentionDays);
+		int archivedCount = todoTaskMapper.archiveTerminalTasks(archiveBefore, "todo-maintenance");
+		return new TodoTaskMaintenanceResult(expiredCount, archivedCount, archiveBefore);
+	}
+}