forge_admin/code-copilot/changes/archive/2026-06-27-flow-condition-form-rules/spec.md

流程分支条件表单规则配置优化

status: done created: 2026-06-20 complexity: 🟡中等

1. 背景与目标

流程模型设计器的条件分支目前只能手写 SpEL 表达式，使用门槛高且容易写错字段名。优化后，当流程配置了动态表单时，条件分支可通过表单字段、运算符和值组合生成条件表达式；仍保留高级表达式模式，兼容已有 BPMN XML 和后端 Flowable 条件表达式执行。

2. 代码现状（Research Findings）

2.1 相关入口与链路

• forge-admin-ui/src/views/flow/design.vue 已维护 formSchema 和 formFieldCatalog，并通过 refreshFormFieldCatalog() 从已选表单或内嵌表单解析字段目录。
• forge-admin-ui/src/components/flow-designer/DingFlowDesigner.vue 负责流程画布和节点配置抽屉，目前只传 node/outgoingEdges/nodes 给 NodeConfigDrawer。
• forge-admin-ui/src/components/flow-designer/panel/NodeConfigDrawer.vue 通过 CONFIG_RENDERER_MAP 调度 ConditionConfig.vue。
• forge-admin-ui/src/components/flow-designer/panel/ConditionConfig.vue 目前只展示每条出边的 condition 输入框和默认分支单选。

2.2 现有实现

• 分支条件最终存储在 edge 的 condition 字符串中。
• forge-admin-ui/src/components/flow-designer/converter/json-to-bpmn.js 将非默认分支的 edge.condition 写入 <bpmn:conditionExpression>。
• forge-admin-ui/src/components/flow-designer/canvas/BranchHeader.vue 直接展示 edge.condition 或默认文案。

2.3 发现与风险

• BPMN 导出链路只消费 edge.condition，因此规则配置器必须生成标准表达式字符串，不能依赖额外结构。
• 动态表单字段可能不存在或尚未配置，需要给出空状态并允许继续手写表达式。
• 已有手写表达式必须可继续编辑，不能被规则模式误覆盖。

3. 功能点

• 流程设计页将动态表单字段目录传入 DingFlowDesigner。
• 节点配置抽屉将字段目录传入条件分支配置组件。
• 条件分支配置支持“表单字段条件”和“高级表达式”两种模式。
• 表单字段条件支持多条规则、任一/全部匹配、常用运算符和值输入，并生成 SpEL 表达式。
• 统一动态表单字段目录为空时，前端从已加载表单 Schema 递归解析字段作为兜底。
• 点击条件分支标签时只配置对应分支，点击网关节点时展示全部分支。
• 条件规则支持删除至空状态，并同步清空该分支表达式。
• 条件配置面板约束规则行、表达式预览和高级表达式输入，避免抽屉内容横向溢出。
• 默认分支仍允许在设计器中配置和保留条件表达式，但导出 BPMN 时不写入 default 边条件，避免 Flowable 部署失败。
• 条件规则行按字段、关系、取值三列对齐，默认分支在画布上保持默认分支标签。
• 条件网关支持在配置面板继续添加多条分支，并保持一个默认分支。
• 添加分支操作改到画布分支连线区域，右侧条件面板只负责条件配置。
• 画布分支标签使用“条件已设 / N 条条件”摘要，不直接铺开 SpEL 表达式。
• 表单字段生成的常见表达式重新打开时可回显为字段条件模式。
• 流程设计支持提交人撤回权限配置，并在运行时限制非提交人或禁用配置下撤回。
• 流程设计支持重复审批自动同意策略：仅首个节点需审批、仅连续审批自动同意、每个节点都需审批。
• 审批意见配置文案调整为“审批意见”，节点运行时保持同意/驳回等操作必填校验。
• 审批节点表单字段权限改为按流程全局动态表单字段勾选，不再手工输入字段名。
• 待办动态表单按节点字段权限隐藏不可见字段、禁用只读字段，并对节点必填字段补校验。

4. 业务规则

• 默认分支可保留设计器草稿条件，但 Flowable 不允许 default sequenceFlow 携带 conditionExpression，导出 BPMN 时必须跳过默认边条件。
• 条件网关可存在多条非默认条件分支，但同一网关必须保持且仅保持一个默认分支。
• 非默认分支规则模式生成 ${...} 格式 SpEL 表达式。
• 多条规则按“符合全部”生成 &&，按“符合任一”生成 ||。
• 字符串值自动加单引号，数字和布尔值按原值生成。
• 高级表达式模式保持用户原始输入。
• 画布分支标签只展示条件状态摘要；原始表达式可通过配置抽屉继续查看和编辑，避免画布上内容过载。
• 流程级审批策略写入 BPMN process 扩展属性：flowable:allowSubmitterWithdraw、flowable:autoApprovalMode。
• autoApprovalMode=firstOnly 时，同一审批人在流程中已经完成过任一审批，后续再次成为当前任务审批人时自动同意。
• autoApprovalMode=consecutive 时，仅上一已完成审批任务和当前任务审批人相同才自动同意。
• autoApprovalMode=none 时，所有节点都需要人工审批。
• 表单字段权限写入用户任务 flowable:formFieldPermissions，运行时通过 TaskFormInfo.formFieldPermissions 下发到待办页。

5. 数据变更

操作	表名	字段/索引	说明
无	-	-	审批策略和字段权限存入 BPMN XML 扩展属性，不新增表结构

6. 接口变更

操作	接口	方法	变更内容
兼容增强	/flow/task/form/{taskId}	GET	TaskFormInfo 增加 formFieldPermissions 字段，用于待办动态表单权限渲染
兼容增强	/flow/task/withdraw	POST	后端按流程级 allowSubmitterWithdraw 和提交人身份进行撤回校验

7. 影响范围

• 流程模型设计页
• 钉钉样式流程设计器条件分支配置抽屉
• 审批节点配置抽屉的表单权限页
• 待办审批动态表单渲染
• Flowable 任务撤回与审批通过后的重复审批自动同意
• 条件分支相关前端单元测试

8. 风险与关注点

• 涉及流程状态流转和提交人撤回权限，已通过后端 flow 插件编译验证，未做数据库级流程实例实跑。
• 表达式生成必须兼容现有 Flowable 条件表达式。
• 条件面板视觉需保持后台工具风格，避免过度装饰。

8.5 测试策略

• 测试范围：前端组件单元测试、针对性 lint/type/build 可行性验证。
• 覆盖率目标：覆盖字段条件渲染、规则生成表达式、无字段时回退高级模式。
• 独立 Test Spec：否，使用当前变更 execution-log 记录。

9. 待澄清

• 无。

10. 技术决策

• 不改变 BPMN 数据结构，规则配置器作为表达式生成辅助层，保存时仍写入 edge.condition。

11. 执行日志

Task	状态	实际改动文件	备注
Task 1	已完成	design.vue, DingFlowDesigner.vue, NodeConfigDrawer.vue	接入动态表单字段目录
Task 2	已完成	ConditionConfig.vue	实现规则模式和高级表达式模式
Task 3	已完成	ConditionConfig.spec.js, form-field-catalog.spec.js, test-spec.md, execution-log.md	补测试并完成验证
Task 4	已完成	DingFlowDesigner.vue, NodeConfigDrawer.vue, ConditionConfig.vue, ConditionConfig.spec.js, DingFlowDesigner.spec.js	修复分支聚焦、规则删除和表达式溢出
Task 5	已完成	ConditionConfig.vue, BranchHeader.vue, EdgePath.vue, json-to-bpmn.js, branch-parser.js	默认分支可配条件并优化规则行对齐
Task 6	已完成	useFlowDesigner.js, ConditionConfig.vue, NodeConfigDrawer.vue, DingFlowDesigner.vue	支持配置面板继续添加条件分支，并保持唯一默认分支
Task 7	已完成	BranchAddButton.vue, BranchHeader.vue, EdgePath.vue, DingFlowDesigner.vue, ConditionConfig.vue	添加分支入口移到画布，边标签摘要化，表单表达式回显规则模式
Task 8	已完成	design.vue, DingFlowDesigner.vue, FormPermissionConfig.vue, FlowFormCreateRenderer.vue, todo.vue, FlowTaskServiceImpl.java, TaskFormInfo.java	补齐审批策略、表单字段权限和运行时执行

12. 审查结论

自检通过：前端组件测试、目标 ESLint、生产构建和 Playwright 交互验证均通过；构建存在项目既有非阻断告警。

13. 确认记录（HARD-GATE）

• 确认时间：2026-06-20
• 确认人：用户直接提出优化需求，按当前会话执行。

归档记录（HARD-GATE）

• 状态：done
• 归档时间：2026-06-27
• 归档人：yaomd（批量归档）
• 归档路径：code-copilot/changes/archive/2026-06-27-flow-condition-form-rules/
• 判定依据：任务清单全部完成，execution-log 验证通过（编译/构建/lint 闭环）。