Skip to content

release: 0.2.21 版本说明(退回节点控制 + 二次发起 + 事件顺序保障) #279

Open

Description

@xlorne

版本概览

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(达梦补序列)。事件时序属行为变化,需业务订阅方确认。


四、升级建议

  1. 后端升级前先建表 t_flow_record_reissue(参考 FlowReissueRecordEntity,达梦序列参考 flow-engine-example/src/main/resources/sql/dm-sequences.sql)。
  2. 升级顺序:先后端(开始返回 backNodes / reissue),再前端;反序时前端退回弹框回退旧逻辑、「重新发起」入口不出现,不影响既有功能。
  3. 二次发起仅对 FINISH 记录开放且操作者须为流程管理员;若需放开到普通发起人,需自行扩展校验。
  4. 事件订阅方:确认不再依赖「提交前收到事件」,也不依赖「全局严格顺序」(仅保证同一 processId 内串行)。
  5. 权限:/api/cmd/record/reissue 需与既有命令接口一致地做鉴权,避免仅有前端隐藏入口。

五、关联 PR / Issue

后端

前端(flow-frontend)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions