如何使用export实现支持状态回滚的可撤销业务模型模块导出？

本文共计797个文字，预计阅读时间需要4分钟。

要导出一个具备状态回退能力的可撤销业务模型模块，关键不在于导出语法本身，而在于模块内部是否封装了支持运行时状态回退的逻辑（如Flowable的`ChangeActivityStateBuilder`调用、任务校验、日志标记等）。将这些能力以函数或类形式直接暴露出来。

明确导出目标：回退能力 ≠ 导出动作

“状态回退”是业务流程引擎（如 Flowable）在运行时执行的操作，export 只负责把封装好的回退功能对外提供。不能指望只写 export const revert = ... 就自动获得流程控制权——它必须依赖底层流程服务实例（runtimeService, historyService 等）和权限/校验逻辑。

• 导出的是“可调用的回退方法”，不是“流程定义”或“BPMN 文件”
• 该方法需接收 taskId、reason 等参数，内部完成历史任务查询、节点迁移、日志记录等全流程
• 模块应与 Spring Boot Controller 分离：Controller 负责 HTTP 接入，模块负责核心回退能力复用

模块结构建议：按职责拆分并导出

一个健壮的可撤销业务模型模块，建议组织为以下导出项：

• export function revertToTask(taskId: string, targetKey: string, reason?: string)：主回退函数，执行 ChangeActivityState 迁移，含完整校验（任务归属、流程未结束、下游未办理）
• export function isRevertible(taskId: string): Promise<boolean>：前置检查函数，返回是否允许撤回（如 30 分钟窗口、assignee 匹配、endTime 存在）
• export class RevertResult：导出结果类，统一包装 success、message、originalTaskId、newTaskId 等字段
• export const REVERT_CONSTRAINTS：导出常量对象，如 { maxWindowMs: 1800000, allowedKeys: ['task_lisi', 'task_zhangsan'] }，便于外部配置约束

导出时注意模块边界与依赖注入

Flowable 的 Service（如 RuntimeService）不能直接 export，需通过工厂函数或参数传入，保证模块无框架强耦合：

• 不写 export const runtimeService = ...（违反依赖倒置）
• 改用 export function createReverter(runtime: RuntimeService, history: HistoryService)，返回具体重试能力的对象
• 实际使用时：const reverter = createReverter(runtimeService, historyService); reverter.revertToTask(...)
• 这样模块可被单元测试 Mock，也可适配不同环境（开发/测试/线上）的服务实例

配套导出类型定义（TypeScript 场景）

若项目使用 TypeScript，应在同一模块中导出清晰接口，提升消费端体验：

• export interface RevertOptions：包含 taskId、targetKey、reason、skipNotify?: boolean
• export type RevertStatus = 'success' | 'blocked' | 'not-found' | 'forbidden'
• 配合 JSDoc 注释说明每个参数的业务含义（例如 “targetKey 必须是 BPMN 中 task 定义的 stable id，非任务实例 ID”）