档案软件任务模糊？实操基于工作流引擎的任务清晰化重构

发布时间: 2026年09月15日 12:10:04 来源: 安答联动浏览量: 0

一、现状分析与标准状态定义

档案管理软件中任务功能不清晰的核心原因在于缺乏标准化的状态流转机制。用户无法明确当前任务处于哪个环节，以及下一步可以执行什么操作。解决此问题的首要步骤是剥离业务逻辑，定义一套通用的任务生命周期模型。

我们将任务生命周期拆解为五个核心状态，并为每个状态定义严格的允许操作：

DRAFT（草稿）：任务创建初始状态。允许操作：保存、提交。
PENDING_REVIEW（待审核）：任务提交后等待管理员处理。允许操作：审核通过、驳回。
ARCHIVING（归档中）：审核通过，系统正在进行数字化处理或物理入库。允许操作：完成归档、异常挂起。
COMPLETED（已完成）：任务全流程结束，档案入库。允许操作：查看、借阅。
REJECTED（已驳回）：审核未通过。允许操作：修改后重新提交、废弃。

通过上述定义，我们将模糊的“处理任务”动作具象化为状态机中的节点流转，确保每一步操作都有据可依。

二、数据库层改造：引入状态机字段

为了支撑状态机逻辑，需要对现有的任务表进行结构升级。必须新增状态字段、当前处理人字段以及操作日志字段，以实现全链路可追溯。以下是完整的 MySQL 建表及改造 SQL 语句，可直接在数据库中执行。

创建任务主表，包含核心状态字段：


CREATE TABLE `sys_archive_task` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '任务ID',
`task_name` varchar(255) NOT NULL COMMENT '任务名称',
`task_code` varchar(64) NOT NULL COMMENT '任务编号',
`current_status` varchar(32) NOT NULL DEFAULT 'DRAFT' COMMENT '当前状态：DRAFT, PENDING_REVIEW, ARCHIVING, COMPLETED, REJECTED',
`current_handler` bigint(20) DEFAULT NULL COMMENT '当前处理人ID',
`create_by` bigint(20) NOT NULL COMMENT '创建人ID',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_task_code` (`task_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='档案任务表';

创建状态流转日志表，记录每一次任务变更的细节，这是解决“任务不清晰”的关键数据支撑：


CREATE TABLE `sys_task_status_log` (
`id` bigint(20) NOT NULL AUTO_INCREMENT,
`task_id` bigint(20) NOT NULL COMMENT '任务ID',
`pre_status` varchar(32) DEFAULT NULL COMMENT '变更前状态',
`post_status` varchar(32) NOT NULL COMMENT '变更后状态',
`operation` varchar(64) NOT NULL COMMENT '操作动作：SUBMIT, APPROVE, REJECT等',
`operator` bigint(20) NOT NULL COMMENT '操作人ID',
`remark` varchar(500) DEFAULT NULL COMMENT '备注/驳回原因',
`operate_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '操作时间',
PRIMARY KEY (`id`),
KEY `idx_task_id` (`task_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='任务状态流转日志';

如果是在现有系统上改造，请执行以下 ALTER 语句添加缺失字段：


ALTER TABLE `sys_archive_task`
ADD COLUMN `current_status` varchar(32) NOT NULL DEFAULT 'DRAFT' COMMENT '当前状态',
ADD COLUMN `current_handler` bigint(20) DEFAULT NULL COMMENT '当前处理人ID';

三、后端核心逻辑：构建有限状态机服务

后端需要实现一个严格的状态机服务，强制校验状态流转的合法性。以下是基于 Java Spring Boot 框架的核心实现代码。该代码不依赖任何第三方工作流引擎，通过原生代码实现轻量级管控，确保零门槛落地。

定义状态枚举和操作枚举：

档案软件任务模糊？实操基于工作流引擎的任务清晰化重构


public enum TaskStatus {
DRAFT, PENDING_REVIEW, ARCHIVING, COMPLETED, REJECTED
}
public enum TaskAction {
SUBMIT, APPROVE, REJECT, FINISH_ARCHIVE, RE_SUBMIT
}

实现核心的状态机服务类。此类包含了状态流转校验逻辑和数据库更新操作：


import org.springframework.transaction.annotation.Transactional;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import java.util.Date;
@Service
public class ArchiveTaskStateMachine {
private final JdbcTemplate jdbcTemplate;
// 构造函数注入 JdbcTemplate
public ArchiveTaskStateMachine(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
/
执行状态流转
@param taskId 任务ID
@param action 执行动作
@param operatorId 操作人ID
@param remark 备注（如驳回原因）
/
@Transactional(rollbackFor = Exception.class)
public void transition(Long taskId, TaskAction action, Long operatorId, String remark) {
// 1. 查询当前任务状态
String sql = "SELECT current_status, current_handler FROM sys_archive_task WHERE id = ?";
TaskStatus currentStatus = jdbcTemplate.queryForObject(sql,
(rs, rowNum) -> TaskStatus.valueOf(rs.getString("current_status")), taskId);
// 2. 校验状态流转合法性
TaskStatus nextStatus = validateTransition(currentStatus, action);
// 3. 更新任务主表状态
String updateSql = "UPDATE sys_archive_task SET current_status = ?, current_handler = ?, update_time = ? WHERE id = ?";
Long nextHandler = determineNextHandler(nextStatus, taskId); // 根据业务逻辑确定下一处理人
jdbcTemplate.update(updateSql, nextStatus.name(), nextHandler, new Date(), taskId);
// 4. 记录流转日志
String logSql = "INSERT INTO sys_task_status_log (task_id, pre_status, post_status, operation, operator, remark, operate_time) VALUES (?, ?, ?, ?, ?, ?, ?)";
jdbcTemplate.update(logSql, taskId, currentStatus.name(), nextStatus.name(), action.name(), operatorId, remark, new Date());
}
/
核心状态流转规则校验
/
private TaskStatus validateTransition(TaskStatus current, TaskAction action) {
switch (current) {
case DRAFT:
if (action == TaskAction.SUBMIT) return TaskStatus.PENDING_REVIEW;
break;
case PENDING_REVIEW:
if (action == TaskAction.APPROVE) return TaskStatus.ARCHIVING;
if (action == TaskAction.REJECT) return TaskStatus.REJECTED;
break;
case REJECTED:
if (action == TaskAction.RE_SUBMIT) return TaskStatus.PENDING_REVIEW;
break;
case ARCHIVING:
if (action == TaskAction.FINISH_ARCHIVE) return TaskStatus.COMPLETED;
break;
case COMPLETED:
throw new IllegalStateException("任务已完成，禁止任何操作");
}
throw new IllegalStateException("非法的状态流转: 当前状态 " + current + ", 尝试操作 " + action);
}
/
模拟确定下一处理人（实际业务中需根据部门或角色查询）
/
private Long determineNextHandler(TaskStatus status, Long taskId) {
// 这里只是示例，实际应查询部门主管或归档员ID
if (status == TaskStatus.PENDING_REVIEW) return 1001L; // 假设管理员ID是1001
if (status == TaskStatus.ARCHIVING) return 1002L; // 假设归档员ID是1002
return null;
}
}

代码关键点说明：

强类型校验： validateTransition 方法使用 Switch 结构硬编码了流转规则，任何不合法的操作（如在草稿状态直接点击归档）都会直接抛出异常，从源头杜绝数据混乱。
事务一致性： @Transactional 注解确保了状态更新和日志记录要么同时成功，要么同时回滚，保证数据一致性。
自动记录日志： 每次状态变更自动写入 sys_task_status_log 表，无需业务代码手动维护，解决了“不知道谁改了任务”的问题。