Repository navigation
Open
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation
Description
版本概览
0.2.21 前后端同步发布(后端 codingapi.flow-engine / 前端 @coding-flow/*),本版三项能力:退回候选节点按执行历史下发、已完成流程支持二次发起(reissue)、流程事件改为提交后投递并按流程串行。
| 端 | 版本跨度 | 主要变化 |
|---|---|---|
| 后端 | v0.2.20 → v0.2.21 |
新增 1 个接口、1 张表、1 个事件、2 个响应字段;退回校验收紧;事件投递统一收敛到发布器 |
| 前端 | 0.2.20 → 0.2.21 |
退回弹框改用 backNodes;已办详情新增「重新发起」入口;presenter 新增 reissue() |
一、后端变更
1. 新接口:已完成流程二次发起 POST /api/cmd/record/reissue
- 新增
FlowReissueService:仅流程管理员可对**已正常完成(FINISH)**的流程记录执行二次发起。 - 以标准创建流程的方式复制源流程表单数据,生成一条全新流程,新流程停在开始节点、成为原发起人的待办,不自动提交;源流程记录、待办与历史记录不做任何改写。
- 请求体
FlowReissueRequest:sourceRecordId(源流程记录 id)、operatorId(须为流程管理员)、formData(可选,为空时按源流程复制)、advice(可选说明)。 - 新增关系记录
FlowReissueRecord(新表t_flow_record_reissue),保存源流程与新流程的映射;提供 JPA / Mock 两种仓储实现,并补充达梦序列。 - 新增事件
FlowRecordReissueEvent,供业务方同步已落库数据状态。
2. 退回候选节点按执行历史下发(#270)
FlowContent新增backNodes:只包含当前记录真实执行过的历史节点,按「最近优先」倒序去重(例如停留在 C 节点时为 B、A);nodes仍为流程定义全量节点,不受影响。- 无可退回候选时,动作集合不再下发
RETURN,修正「开始节点退回按钮可点、但提交必然失败」的错误交互。 - 收紧
RETURN校验:开始节点不支持退回;退回目标必须存在于当前记录的历史执行链(并行/条件分支里「结构上不是下游、但从未执行」的节点同样被拒绝)。 FlowStateException新增nodeNotSupportReturn、backNodeNotInHistory两个状态错误。
3. 事件投递:提交后投递 + 按流程串行(#274)
- 新增 SPI
IFlowEventPublisher与门面FlowEventPublisher;IFlowEvent增加eventKey()分区键(默认取processId)。 - 引擎内全部事件推送点由
EventPusher收敛到FlowEventPublisher;未注册实现时自动回退,原有行为不变。 - starter 新增
SpringFlowEventPublisher:事务afterCommit投递(回滚不投递)、按eventKey分区单线程串行、同步执行 handler 以获得确定顺序、单个 handler 异常不影响后续事件。 - 新增配置
codingapi.flow.event.ordered(默认开启;置为false时回退为直接推送到事件框架)。 FlowRecordReissueEvent同样接入发布器,分区键为新流程 id。
4. 依赖与测试
codingapi.framework升级至17.3.3(含异步事件顺序与可见性修复)。- 补充
SpringFlowEventPublisherIntegrationTest:真实 Spring 上下文 + 真实事务同步,覆盖「提交后投递、同流程严格顺序、回滚不投递、无事务立即投递、handler 运行在事件分区线程」。
二、前端变更(@coding-flow/* 0.2.21)
- 退回弹框改用
backNodes:PC / 移动端buildReturnNodeOptions不再从流程定义节点截取;backNodes为空时不展示退回入口;后端为旧版本(无该字段)时回退原有按定义顺序截取的逻辑。 - 已办详情「重新发起」:由详情
reissue标识驱动,点击调用/api/cmd/record/reissue;新增APPROVAL_ACTION_REISSUE_KEY插件点(可替换按钮实现)与APPROVAL_REISSUE提示文案。 - presenter:新增
reissue(),封装二次发起接口;PC / 移动端补充接口调用;补充单元测试。
三、数据格式影响点
| 位置 | 变化 | 兼容性 | 说明 |
|---|---|---|---|
FlowContent(/api/cmd/record/detail) |
新增 backNodes |
可选,新增字段 | 退回候选人的唯一来源;仅含当前记录已执行的历史节点,最近优先排序 |
FlowContent |
新增 reissue(boolean) |
可选,新增字段 | true 表示前端可展示「重新发起」入口 |
POST /api/cmd/record/reissue |
新增接口 | 新增 | 请求 FlowReissueRequest;仅流程管理员 + FINISH 记录 |
| 数据库 | 新增表 t_flow_record_reissue |
需执行 DDL | 升级前必须建表,达梦环境还需补充对应序列 |
| 事件类型 | 新增 FlowRecordReissueEvent;IFlowEvent 新增 eventKey() |
接口新增默认方法 | 自定义事件实现无需改动,默认按 processId 分区 |
| 事件时序 | 默认改为「提交后投递 + 同流程串行」 | 行为变化 | 订阅方若依赖「事务提交前同步消费」,需确认时序前提 |
结论:响应字段与接口均为增量,旧端忽略不影响既有功能;升级硬性要求是建表 t_flow_record_reissue(达梦补序列)。事件时序属行为变化,需业务订阅方确认。
四、升级建议
- 后端升级前先建表
t_flow_record_reissue(参考FlowReissueRecordEntity,达梦序列参考flow-engine-example/src/main/resources/sql/dm-sequences.sql)。 - 升级顺序:先后端(开始返回
backNodes/reissue),再前端;反序时前端退回弹框回退旧逻辑、「重新发起」入口不出现,不影响既有功能。 - 二次发起仅对
FINISH记录开放且操作者须为流程管理员;若需放开到普通发起人,需自行扩展校验。 - 事件订阅方:确认不再依赖「提交前收到事件」,也不依赖「全局严格顺序」(仅保证同一
processId内串行)。 - 权限:
/api/cmd/record/reissue需与既有命令接口一致地做鉴权,避免仅有前端隐藏入口。
五、关联 PR / Issue
后端
- 关于退回节点的操作控制 #270 关于退回节点的操作控制
- fix: 退回候选节点改为基于执行历史并收紧退回校验 (#270) #271 fix: 退回候选节点改为基于执行历史并收紧退回校验
- 需要支持一个新的能力,就是对流程已经审批完成的流程,可以支持快捷二次发起的能力 #272 已完成流程支持快捷二次发起
- feat: 已完成流程支持二次发起 (framework + infra + api) #275 feat: 已完成流程支持二次发起(framework + infra + api)
- 流程事件投递缺少顺序与事务可见性保障,异步订阅方可能在提交前消费 #274 流程事件投递缺少顺序与事务可见性保障
- feat: 流程事件统一走 FlowEventPublisher,保证提交后投递与按流程串行 #276 feat: 流程事件统一走 FlowEventPublisher,保证提交后投递与按流程串行
- 框架升级 17.3.3 + 事件投递集成测试
前端(flow-frontend)
- fix(approval): 退回候选节点改用后端执行历史列表 (#270) flow-frontend#78 退回候选节点改用后端执行历史列表(关于退回节点的操作控制 #270)
- Dev flow-frontend#79 已办详情支持已完成流程二次发起
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation
Activity