任务清单：business-flow-lowcode-integration

status: proposed created: 2026-06-28 原则：复用现有低代码与 Flow 能力；不新建独立审批引擎；查询 SQL 写 Mapper XML；分页参数使用 pageNum/pageSize；Flyway 脚本防重复；内置数据 tenant_id=1；流程回调必须具备租户上下文和幂等。

阶段总览

阶段	目标	交付结果
Phase 0	基线冻结	明确当前能力、兼容范围和迁移边界
Phase 1	契约统一	`BusinessFlowContract` 协议和发布态快照
Phase 2	运行网关	统一发起、撤回、取消、重提和状态查询
Phase 3	事件桥接	Flow 全量事件消费、幂等、状态机和 trace
Phase 4	表单资产与待办表单	表单资产目录、`BUSINESS_OBJECT_FORM` / `BUSINESS_CODE_FORM` 和节点字段权限
Phase 5	设计器一体化	表单、单据、流程、节点权限、表单资产选择、自动化合并成流程应用搭建链路
Phase 6	模板与生成	BPMN 模板库、变量清单、节点权限默认值和脚手架
Phase 7	验收与治理	自动化验收、文档、迁移和运行监控

任务总览

Task	阶段	名称	状态	优先级
Task 0	Phase 0	业务流程现状基线和兼容范围确认	completed	P0
Task 1	Phase 1	定义 BusinessFlowContract 协议	in_progress	P0
Task 2	Phase 1	流程契约保存与发布态快照	in_progress	P0
Task 3	Phase 1	businessKey 和 recordKey 通用化	pending	P0
Task 4	Phase 2	BusinessFlowGateway 运行网关	pending	P0
Task 5	Phase 2	BusinessRecordRuntimeFacade 记录运行门面	pending	P0
Task 6	Phase 2	驳回修改重提运行接口	in_progress	P0
Task 7	Phase 3	BusinessFlowEventBridge 全量事件桥	pending	P0
Task 8	Phase 3	BusinessFlowStateMachine 状态机	pending	P0
Task 9	Phase 3	流程 trace 和幂等日志	pending	P1
Task 10	Phase 4	表单资产目录与 TaskFormInfo 统一表单引用	in_progress	P0
Task 11	Phase 4	待办审批页低代码/代码表单渲染	in_progress	P0
Task 12	Phase 4	节点字段权限后端校验与代码表单目录	in_progress	P0
Task 13	Phase 5	对象设计器流程应用向导与表单资产选择器	in_progress	P0
Task 14	Phase 5	发布检查合并流程契约规则	pending	P0
Task 15	Phase 5	触发器与流程事件副作用编排	pending	P1
Task 16	Phase 6	BPMN 模板库与变量清单	pending	P0
Task 17	Phase 6	代码优先复杂业务接入 SDK/Adapter	in_progress	P1
Task 18	Phase 6	AI/代码生成流程脚手架	pending	P1
Task 19	Phase 7	标准流程自动化验收模板	pending	P0
Task 20	Phase 7	历史数据迁移和兼容验证	pending	P0
Task 21	Phase 7	文档、示例和操作手册	pending	P1

Phase 0：业务流程现状基线

Task 0：业务流程现状基线和兼容范围确认

目标: 冻结本轮优化边界，避免重复建设已完成能力。

涉及文件:

code-copilot/changes/business-flow-lowcode-integration/spec.md
code-copilot/changes/lowcode-app-full-loop-optimization/spec.md
code-copilot/changes/form-first-business-object-designer/spec.md
code-copilot/changes/lowcode-runtime-datasource-isolation/spec.md

工作内容:

梳理现有 BusinessFlowService、BusinessDocumentRuntimeService、FlowTaskEventListener、FlowBusinessObjectRuntimeAdapterImpl 的职责。
明确手写业务模块和低代码业务对象分别采用的接入方式。
明确首期是否新增 ai_business_flow_contract_version，还是先复用 ai_business_binding.binding_config。
明确自定义主键改造范围：至少协议先支持 recordKey String，数据库可分阶段落地。

验收标准:

当前能力、缺口和兼容策略在 spec 中有明确结论。
不再出现“低代码审批引擎”作为独立平台能力。

本轮结果:

已完成现状评估和兼容边界梳理。
首期采用复用 ai_business_binding.binding_config 的渐进方案，不新增独立审批引擎。

Phase 1：流程契约统一

Task 1：定义 BusinessFlowContract 协议

目标: 用一份契约统一业务对象、单据、流程、节点表单、状态机、变量和事件副作用。

涉及文件:

新增或扩展 BusinessFlowBindingDTO
新增 BusinessFlowContractDTO
新增 BusinessFlowContractVO
新增 BusinessFlowContractNormalizer
新增 BusinessKeyCodec

工作内容:

设计 schemaVersion/objectCode/configKey/recordKey/businessBinding/document/mainFlow/variableMapping/nodeForms/events/options。
兼容旧字段 flowModelKey/titleTemplate/startMode/variableMapping/options。
增加业务表绑定：mode/tableName/primaryKeyField/tenantField/statusField/titleField/ownerField。
变量映射继续统一为 formField/flowVariable，兼容 field/variable。
增加 rejectStrategy/modifyTaskKey。

验收标准:

旧配置可无损归一化为新契约。
新契约可降级输出旧 BusinessFlowBindingVO 给现有前端。
低代码对象能自动生成业务表绑定；简单代码业务能手动选择白名单业务表和状态字段。

本轮结果:

BusinessFlowBindingDTO/VO 已增加 businessBinding。
BusinessFlowBindingDTO/VO 已增加 nodeForms，可承载节点表单引用和字段权限。
对象设计器流程面板已支持配置接入方式、业务表、主键字段、租户字段、状态字段、标题字段和负责人字段。

Task 2：流程契约保存与发布态快照

目标: 区分设计态草稿和运行态契约，避免运行中流程受设计变更影响。

涉及文件:

BusinessFlowService
BusinessObjectDesignerService
BusinessObjectPublishService
BusinessObjectDesignVersionService
Flyway 脚本（如新增契约版本表或扩展现有表）

工作内容:

设计态保存到对象设计快照。
发布态编译到 ai_business_binding.binding_config。
对 LOWCODE_OBJECT 模式自动解析运行态表名、主键字段、租户字段和状态字段。
对 BUSINESS_TABLE 模式保存开发者确认过的表字段白名单，不允许运行时任意拼表名字段名。
启动流程时把契约摘要写入 ai_business_flow_instance_link.variables_snapshot 或独立快照字段。
后续如新增 ai_business_flow_contract_version，记录对象版本、流程模型版本和表单权限版本。

验收标准:

编辑设计态不影响已启动流程办理页。
发布检查可以读取完整契约。

本轮结果:

流程绑定保存和查询已兼容 businessBinding。
低代码对象可根据运行态配置和单据配置补齐默认业务表绑定。
节点表单策略已随流程绑定写入 ai_business_binding.binding_config.nodeForms，首期不新增契约版本表。

Task 3：businessKey 和 recordKey 通用化

目标: 解决流程链路长期依赖 Long recordId 的问题。

涉及文件:

BusinessFlowStartDTO
AiBusinessFlowInstanceLink
BusinessFlowInstanceLinkMapper.xml
TaskFormInfo
FlowBusinessObjectRuntimeAdapter
FlowBusinessObjectRuntimeAdapterImpl
BusinessDocumentRuntimeService

工作内容:

DTO 增加 recordKey String，保留 recordId Long 兼容。
表增加 record_key，历史数据用 record_id 回填。
BusinessKeyCodec 统一构建/解析 ${objectCode}:${recordKey}。
所有新逻辑优先使用 recordKey。

验收标准:

Long 主键旧对象不受影响。
自定义单字段主键对象能完成发起、查询、回调和详情展示。

Phase 2：运行网关

Task 4：BusinessFlowGateway 运行网关

目标: 统一页面按钮、触发器、FlowEntry 三类流程发起入口。

涉及文件:

新增 BusinessFlowGateway
重构 BusinessFlowService
BusinessTriggerExecutor
FlowBusinessObjectRuntimeAdapterImpl
BusinessApprovalRuntimeService

工作内容:

提供 start/withdraw/cancel/resubmit/getRuntime/updateVariables。
发起时统一校验流程契约、单据状态、按钮权限和变量完整性。
发起成功后统一写实例关联和初始状态。
旧 /ai/business/approval/start 只保留兼容转发。

验收标准:

手动按钮和触发器发起走同一服务。
FlowEntry 创建业务记录后也走同一关联写入逻辑。

Task 5：BusinessRecordRuntimeFacade 记录运行门面

目标: 屏蔽动态 CRUD、多数据源、主键、审计和内部状态更新差异。

涉及文件:

新增 BusinessRecordRuntimeFacade
DynamicCrudService
LowcodeRuntimeDataSourceResolver
BusinessDocumentRuntimeService
BusinessFlowService

工作内容:

提供 loadRecord/updateInternalFields/buildRecordSnapshot/resolvePrimaryKey。
支持 LOWCODE_OBJECT 和简单 BUSINESS_TABLE 两种元数据来源。
状态回写按契约中的 statusField 更新，统一处理租户字段、审计字段和运行数据源。
内部更新状态不触发普通用户权限误判。
保持运行数据源上下文一致。

验收标准:

状态回写不再散落调用 dynamicCrudService.updateInternalFieldsById。
多数据源对象状态回写命中正确数据源。
简单业务表只配置主键字段和状态字段，也能完成发起、流程中、通过、驳回、撤回状态同步。

Task 6：驳回修改重提运行接口

目标: 把“驳回到发起人修改节点”固化为平台能力。

涉及文件:

BusinessFlowGateway
BusinessFlowStateMachine
FlowClient
AiCrudPage
待办详情页

工作内容:

契约增加 rejectStrategy=RETURN_TO_MODIFY_TASK 和 modifyTaskKey。
契约增加修改模式：INLINE_MODIFY（待办内嵌修改）和 BUSINESS_PAGE_MODIFY（跳转业务单据修改）。
TASK_COMPLETED + approvalResult=reject 进入可修改状态但不结束流程。
发起人在修改节点保存业务数据后，更新流程变量并完成原任务。
重提复用原流程实例。
低代码简单表单默认走 INLINE_MODIFY；代码优先复杂业务默认走 BUSINESS_PAGE_MODIFY，由业务页保存后调用 BusinessFlowGateway.resubmit(...)。

验收标准:

提交 -> 驳回 -> 修改 -> 重提 -> 通过全链路不新建第二个流程实例。
修改节点以外的流程中状态默认不可编辑主数据。
审批节点只处理审批意见/审批附件，不开放任意业务主字段修改。

本轮结果:

新增 POST /ai/business/flow/resubmit，供复杂代码业务页在保存主数据后完成当前修改节点。
重提接口会校验当前用户是已签收办理人，复用原流程实例，不新建第二个流程。
重提成功后业务流程状态回写为 IN_PROCESS，并可携带补充流程变量。
当前重提接口已具备平台协议能力；完整“驳回到指定修改节点”的模板和端到端样例仍需后续用真实流程模型验证。

Phase 3：事件桥、状态机和可观测性

Task 7：BusinessFlowEventBridge 全量事件桥

目标: 低代码流程不依赖 @FlowBind(modelKey=...) 手写 Bean。

涉及文件:

新增 BusinessFlowEventBridge
新增 Redis 事件监听或扩展现有 FlowEventSubscriber
BusinessFlowController#callback
BusinessFlowCallbackDTO

工作内容:

订阅 flow:event:all。
支持 Webhook 回调。
按 tenantId/businessKey/processInstanceId/processDefKey 查找实例关联和契约。
统一调用状态机。

验收标准:

新增低代码流程模型无需写 Java 回调类即可回写业务状态。
缺失 tenantId 时记录告警并拒绝或按明确策略兜底。

Task 8：BusinessFlowStateMachine 状态机

目标: 把 Flow 事件转为业务状态流转，支持中间节点状态。

涉及文件:

新增 BusinessFlowStateMachine
BusinessFlowService
BusinessDocumentConfigService
BusinessEventPublisher

工作内容:

处理 PROCESS_STARTED/TASK_CREATED/TASK_COMPLETED/PROCESS_COMPLETED/PROCESS_CANCELED。
支持终态驳回和驳回修改两类策略。
状态回写前校验当前状态，避免乱序覆盖。
状态变化后发布 FLOW_APPROVED/FLOW_REJECTED/FLOW_CANCELED 业务事件。

验收标准:

重复事件不会重复触发副作用。
乱序事件不会把 APPROVED 回退成 IN_PROCESS。

Task 9：流程 trace 和幂等日志

目标: 能按一条业务流程查清发起、回调、状态回写和触发器执行结果。

涉及文件:

新增或扩展 ai_business_flow_trace_log
BusinessFlowGateway
BusinessFlowEventBridge
BusinessTriggerExecutor
BusinessMessageChannelService

工作内容:

生成 correlationId。
记录发起来源、变量快照、Flow 返回、事件回调、状态前后值、触发器和消息结果。
记录 eventId 或组合幂等键。

验收标准:

运维能按 businessKey/processInstanceId/correlationId 查询完整链路。
回调失败可定位具体阶段并支持补偿重放。

Phase 4：表单资产与待办表单一体化

Task 10：表单资产目录与 TaskFormInfo 统一表单引用

目标: 流程节点配置不再让用户手工输入页面路径，而是选择平台可识别、可校验、可迁移的表单资产。

涉及文件:

TaskFormInfo
FlowTaskServiceImpl
新增 BusinessFormAsset
新增 BusinessFormAssetService
新增 BusinessCodeFormProvider
新增 BusinessCodeFormProviderRegistry
新增 BusinessTaskFormContextService
FlowBusinessObjectRuntimeAdapter
NodePropertiesPanel.vue
BusinessFlowBindingPanel.vue

工作内容:

定义统一 formRef：type/code/viewKey/version，兼容旧 formKey/formUrl。
支持四类资产：低代码业务表单、Flow 动态表单、代码表单、外部地址。
增加 formType=BUSINESS_OBJECT_FORM 和 formType=BUSINESS_CODE_FORM。
返回 formRef/objectCode/configKey/recordKey/viewKey/mode/editMode/fieldPermissions/runtimeRules。
代码表单通过 BusinessCodeFormProvider 或配置注册，不让用户输入组件路径。
提供表单资产查询和字段目录查询接口，供流程设计器节点面板使用。
支持通过 businessKey、流程变量、表单实例快照兜底解析业务记录。

验收标准:

流程节点配置默认通过下拉选择表单资产。
只有外部地址高级模式允许手工输入 URL。
待办页能打开低代码业务详情或代码注册表单。
会签子任务缺少本地 business_key 时能从流程变量或实例关联兜底。
旧 formKey/formUrl 配置仍能读取和办理。

本轮结果:

已新增 GET /ai/business/flow/form-assets/{objectCode}，从低代码对象 formDesignerSchema 汇聚默认表单、多表单资产和字段目录。
已新增 GET/PUT /ai/business/flow/task-form-context，待办页可按 businessKey/processInstanceId/taskDefKey 获取业务表单上下文并保存授权字段。
BusinessFlowVariableResolver 已解析 BPMN userTask，流程配置面板可按人工节点自动生成节点表单策略行。
节点表单配置已保存统一 formRef：低代码表单使用 BUSINESS_OBJECT_FORM + objectCode + formKey + viewKey，代码表单预留 BUSINESS_CODE_FORM + providerKey + formKey，外部表单使用 EXTERNAL + formUrl。
首期不让 forge-plugin-flow 反向依赖低代码模块；待办页先在读取 TaskFormInfo 后调用业务侧上下文 API 完成运行态桥接。

Task 11：待办审批页低代码/代码表单渲染

目标: 审批人办理时看到与业务详情一致的表单和流程上下文，复杂代码业务也能接入待办页。

涉及文件:

forge-admin-ui/src/views/flow/todo.vue
FlowTaskDetailShell.vue
新增或复用低代码表单渲染组件
新增代码表单运行容器或路由跳转处理
AiCrudFlowDetail.vue
FieldValueRenderer.vue

工作内容:

根据 BUSINESS_OBJECT_FORM 加载业务记录。
根据 BUSINESS_CODE_FORM 加载业务模块注册的表单上下文，支持内嵌组件或跳转业务详情页。
应用节点字段权限：只读、隐藏、可编辑、必填。
右侧展示流程历史、流程图和审批动作。
支持修改节点两种模式：待办内嵌“保存并重提”、跳转业务单据页修改后重提。
审批节点默认只写审批意见、签名和审批附件，不改业务主数据。

验收标准:

审批办理页不需要每条流程手写外置表单。
字典、图片、金额、关联字段等渲染与业务详情页一致。
采购合同等代码优先复杂业务可从待办进入业务页修改并重提。
审批、办理、驳回修改三类任务在 UI 上有清晰区分。

本轮结果:

forge-admin-ui/src/views/flow/todo.vue 已接入低代码业务表单上下文，使用 AiForm 渲染节点可见字段。
审批“同意”前会先校验并保存当前节点配置为可编辑的业务字段；快捷同意遇到需要填写业务字段的任务会提示进入详情办理。
待办页已支持 BUSINESS_CODE_FORM 上下文兜底展示；Provider 返回业务页地址时，可从待办打开业务表单处理。
代码表单和存在可写业务字段的任务已禁止快捷同意，避免绕过业务表单保存和节点字段权限。
代码表单内嵌运行容器仍按 Task 17 后续扩展；当前复杂代码业务优先走业务页跳转模式。

Task 12：节点字段权限后端校验与代码表单目录

目标: 字段权限不能只靠前端控制；代码表单也必须提供可配置的字段或区域目录。

涉及文件:

BusinessTaskFormContextService
BusinessRecordRuntimeFacade
DynamicCrudService
BusinessCodeFormProvider
BusinessFlowAdapter

工作内容:

只允许修改节点配置为可编辑的字段。
隐藏字段不返回给无权限办理人。
审批意见、签名等流程字段与业务字段隔离。
代码表单 Provider 通过 formAssets() 暴露字段或区域目录，复杂页面可把区域、附件区、操作按钮抽象为虚拟字段。
后端按 taskDefKey + formRef + fieldPolicies 校验提交字段。
发布检查校验节点权限引用的字段必须存在，历史字段标记为失效但不静默通过。

验收标准:

前端篡改不可编辑字段时后端拒绝。
待办办理人不能通过业务详情 API 看到无权字段。
代码表单即使是自定义 Vue 页面，也能在节点配置中选择“负责人节点显示上传清单、其他节点隐藏或只读”。

本轮结果:

节点字段权限已进入流程绑定协议，支持按字段保存 readable/writable/required。
后端保存时会归一化 fieldPermissions，默认不把未知字段当作可编辑字段。
BusinessFlowService#saveTaskFormContext 已按节点 taskDefKey + fieldPermissions 过滤保存字段，隐藏字段不返回给待办页，不可编辑字段即使前端篡改也不会写入。
待办业务表单上下文已强制携带 taskId 并通过 Flow 服务校验任务状态、办理人、候选人、流程实例、业务 Key 和节点 Key。
保存业务字段和重提必须由当前已签收办理人执行；候选任务需先签收，避免多人并发修改业务主数据。
新增 BusinessCodeFormProvider 和 BusinessCodeFormProviderRegistry，业务模块可用 Spring Bean 注册代码表单资产、上下文和保存逻辑。

Phase 5：设计器一体化

Task 13：对象设计器流程应用向导与表单资产选择器

目标: 把表单、单据、流程、节点权限和自动化组织成完整低代码搭建链路。

涉及文件:

object-designer.[objectCode].vue
BusinessDocumentPanel.vue
BusinessFlowBindingPanel.vue
FlowVariableMappingEditor.vue
新增节点表单权限配置面板
新增表单资产选择器

工作内容:

调整步骤：表单 -> 单据 -> 流程 -> 节点表单权限 -> 自动化 -> 权限 -> 发布检查。
流程配置面板展示状态字段、发起状态、已映射变量、缺失变量。
节点权限面板读取 BPMN userTask。
节点表单配置展示“表单类型 / 表单资产 / 表单视图”，不再默认展示路径输入框。
外部地址放到高级模式，并提示无法参与字段级权限校验。
选择代码表单后，自动加载 Provider 暴露的字段/区域目录给 FormPermissionConfig。

验收标准:

用户不需要在多个菜单间来回跳转才能完成流程类应用配置。
发布前能看到完整闭环状态。
业务用户能通过名称选择“采购合同审批表单”，不需要知道 Vue 路由或组件路径。

本轮结果:

BusinessFlowBindingPanel.vue 已增加业务记录绑定配置入口。
已取消“只靠用户手工输入隐藏路径/表名”的首期使用方式：低代码对象默认由后端回显运行态表和字段，代码优先复杂业务可切换到适配器模式。
BusinessFlowBindingPanel.vue 已增加“节点表单策略”：按 BPMN 人工节点选择低代码业务表单，配置可见、可编辑、必填字段；代码表单和外部表单保留开发者模式入口。
待办审批页渲染、运行态字段权限校验和代码表单 Provider 目录已按 Task 10/11/12 完成首期运行态桥接。
仿钉钉抄送节点已从手工输入用户 ID 改为“指定人员 / 指定角色 / 表达式”三种业务来源；普通 BPMN 服务任务勾选“作为抄送节点”后使用同一套配置能力。
抄送节点导出为 serviceTask + flowable:type="cc"，按来源写入 candidateUsers 或 candidateGroups，默认挂平台 flowCcNodeDelegate；流程走到该节点时可按固定人员、角色成员或表达式结果发送抄送，不再只能依赖流程结束后的后台变量抄送。
低代码应用完整步骤编排、发布检查联动和表单设计器侧体验改造按用户要求暂缓，本轮不继续扩展。

Task 14：发布检查合并流程契约规则

目标: 发布时一次性检查流程类应用是否可运行。

涉及文件:

BusinessObjectPublishService
BusinessPublishChecklist.vue
LowcodeSchemaValidator

工作内容:

检查业务表绑定、主键字段、状态字段、状态映射、流程模型、变量映射、修改节点、表单资产、节点字段权限、按钮权限、触发器动作。
校验 businessBinding.tableName/statusField/primaryKeyField/tenantField 来自低代码元数据或开发者白名单。
校验节点 formRef 引用的表单资产存在；代码表单资产必须提供字段或区域目录。
校验驳回修改模式必须明确为 INLINE_MODIFY 或 BUSINESS_PAGE_MODIFY。
对外部 URL 表单输出风险提示：只能做页面级跳转，不能参与平台字段级权限校验。
输出阻断项、警告项和跳转修复动作。

验收标准:

未配置主流程但启用单据模式时给出明确修复路径。
BPMN 引用未映射变量时发布检查能发现。

Task 15：触发器与流程事件副作用编排

目标: 流程通过、驳回、撤回后可以低代码配置副作用。

涉及文件:

BusinessTriggerService
BusinessTriggerExecutor
BusinessTriggerMapper.xml
触发器前端配置页

工作内容:

FLOW_APPROVED/FLOW_REJECTED/FLOW_CANCELED 作为标准事件源。
创建记录、更新字段、发送站内消息、Webhook TODO 统一支持 correlationId。
动作执行必须幂等。

验收标准:

审批通过后可创建关联记录。
审批驳回后可发送站内消息。
重复回调不重复创建记录。

Phase 6：模板与生成

Task 16：BPMN 模板库与变量清单

目标: 让流程设计器和 AI 生成器能快速生成规范流程。

涉及文件:

FlowTemplate
FlowTemplateFactory
FlowBpmnGenerateService
flow-designer/converter
模板 seed/Flyway

工作内容:

增加串行、会签、并行或签、驳回修改重提、审批后抄送、审批后处理模板。
每个模板输出 BPMN、变量清单、节点权限默认值、发布检查规则。
模板节点命名固定。

验收标准:

选择模板后能自动生成可发布 BPMN。
变量候选和低代码字段映射能自动推荐。

Task 17：代码优先复杂业务接入 SDK/Adapter

目标: 让非低代码创建、由用户自己写代码实现的复杂业务，也能灵活接入同一套流程网关、事件桥、trace 和待办展示能力。

涉及文件:

新增 BusinessFlowAdapter
新增 AbstractBusinessFlowAdapter
新增 BusinessFlowAdapterRegistry
新增 FlowStartRequest
新增 FlowStartResult
新增 FlowBusinessSnapshot
新增 BusinessTaskFormContext
新增 BusinessCodeFormProvider
新增 BusinessCodeFormProviderRegistry
BusinessFlowGateway
BusinessFlowEventBridge
示例业务模块文档

工作内容:

提供三种接入模式：Gateway API 模式、Adapter 模式、Annotation 兼容模式。
Adapter 提供 businessType/objectCode/modelKey/buildBusinessKey/loadBusiness/buildStartVariables/validateBeforeStart/markInProcess/onTaskCompleted/onApproved/onRejected/onCanceled。
Adapter 注册表按 businessType/modelKey/businessKey 路由流程事件。
BusinessFlowGateway 支持代码优先业务发起流程，不要求存在低代码对象或 ai_crud_config。
BusinessFlowEventBridge 识别代码优先业务后调用 Adapter，而不是走动态 CRUD 状态回写。
Adapter 可返回外部业务详情路由或 BUSINESS_CODE_FORM 上下文，供待办页打开复杂业务详情。
代码业务如果要参与节点字段权限，必须通过 BusinessCodeFormProvider.formAssets() 提供字段或区域目录；复杂区域可用虚拟字段表示。
提供示例：采购合同 Adapter + 采购合同审批表单 Provider + 负责人上传清单字段策略。
保留 @FlowBind/@FlowCallback 兼容，但新复杂业务优先使用 Adapter。

验收标准:

手写业务模块不迁移到低代码动态 CRUD，也能发起、审批、撤回、回写状态和查看流程进度。
业务状态机和领域副作用仍在业务 Service 内实现，平台不接管业务事务。
手写业务模块能复用同一事件桥、trace、消息和标准验收模板。
手写业务模块能通过注册表单资产接入待办页，不要求用户填写 Vue 路径。

本轮结果:

已落地 BusinessCodeFormProvider 和 BusinessCodeFormProviderRegistry 服务端扩展点。
GET /ai/business/flow/form-assets/{objectCode} 会合并已注册代码表单资产，后续业务模块实现 Provider 后即可出现在资产目录中。
BUSINESS_CODE_FORM 待办上下文已支持 Provider 委派；未注册 Provider 时返回明确 warning，不再默默降级为手工路径。
复杂代码业务“业务页保存 -> 调用 /ai/business/flow/resubmit 重提”的后端协议已具备；采购合同等具体示例 Provider 尚未新增。
同一套 Flow 事件不会被 Adapter 和 @FlowCallback 重复消费。
不要求低代码对象生成 Java Adapter。
已新增“采购单审批测试”代码优先样例，注册 SamplePurchaseOrderCodeFormProvider，可通过代码表单资产和外置表单路径验证手写业务接入流程。

Task 18：AI/代码生成流程脚手架

目标: 对需要代码化交付的流程模块，生成规范骨架。

涉及文件:

代码生成模板
forge-codegen-crud 相关模板
前端页面模板

工作内容:

生成 Adapter、BPMN 模板、Flyway、字典、权限、前端详情页、测试骨架。
生成内容遵循 XML SQL、pageNum/pageSize、字典和租户规则。

验收标准:

新手写流程模块不再从零拼接流程接入代码。
生成结果符合 Forge 编码规范。

Phase 7：验收与治理

Task 19：标准流程自动化验收模板

目标: 每个流程类应用可复用同一套验收场景。

涉及文件:

code-copilot/rules/automated-testing-standard.md
新增流程验收用例模板
后端测试
前端 E2E 或组件测试

验收场景:

提交 -> 审批通过 -> 状态 APPROVED -> 触发器副作用。
提交 -> 驳回 -> 修改重提 -> 再审批通过。
提交 -> 撤回 -> 状态 CANCELED。
会签所有人处理后才完成。
抄送人能查看详情。
多租户上下文正确。

验收标准:

新流程应用按模板可快速生成测试计划。
执行结果追加到当前变更 execution-log.md。

本轮结果:

已新增采购单审批测试样例，覆盖“提交 -> 部门负责人审批 -> 工程部经理审批 -> 会签 -> 审批通过”和“审批节点驳回 -> 申请人修改 -> 重提/终止”的核心验收路径。
已提供前端列表工作台和待办外置表单，用于后续真实服务环境下统一跑全链路验证。

Task 20：历史数据迁移和兼容验证

目标: 现有低代码对象和流程实例平滑迁移。

涉及文件:

Flyway 迁移脚本
迁移校验 SQL
兼容测试

工作内容:

旧 recordId 回填 recordKey。
旧 binding_config 归一化为新契约。
旧审批兼容接口仍可转发。
运行中流程按旧关联继续可查可办。

验收标准:

历史商机/离职等样例流程仍可查看进度。
新旧配置混合时发布检查给出明确提示。

Task 21：文档、示例和操作手册

目标: 让后续业务流程接入有可复用操作标准。

涉及文件:

forge-docs
code-copilot/knowledge
示例数据 seed

工作内容:

编写“流程类低代码应用搭建指南”。
编写“业务流程契约字段说明”。
编写“驳回修改重提模板使用指南”。
编写“流程事件排障指南”。

验收标准:

新增流程类低代码应用时，业务、开发、测试三方能按同一文档工作。
常见问题沉淀到 code-copilot/memory/pitfalls.md 或 code-copilot/knowledge。

tasks.md 30 KB Історія Запис

任务清单：business-flow-lowcode-integration

阶段总览

任务总览

Phase 0：业务流程现状基线

Task 0：业务流程现状基线和兼容范围确认

Phase 1：流程契约统一

Task 1：定义 BusinessFlowContract 协议

Task 2：流程契约保存与发布态快照

Task 3：businessKey 和 recordKey 通用化

Phase 2：运行网关

Task 4：BusinessFlowGateway 运行网关

Task 5：BusinessRecordRuntimeFacade 记录运行门面

Task 6：驳回修改重提运行接口

Phase 3：事件桥、状态机和可观测性

Task 7：BusinessFlowEventBridge 全量事件桥

Task 8：BusinessFlowStateMachine 状态机

Task 9：流程 trace 和幂等日志

Phase 4：表单资产与待办表单一体化

Task 10：表单资产目录与 TaskFormInfo 统一表单引用

Task 11：待办审批页低代码/代码表单渲染

Task 12：节点字段权限后端校验与代码表单目录

Phase 5：设计器一体化

Task 13：对象设计器流程应用向导与表单资产选择器

Task 14：发布检查合并流程契约规则

Task 15：触发器与流程事件副作用编排

Phase 6：模板与生成

Task 16：BPMN 模板库与变量清单

Task 17：代码优先复杂业务接入 SDK/Adapter

Task 18：AI/代码生成流程脚手架

Phase 7：验收与治理

Task 19：标准流程自动化验收模板

Task 20：历史数据迁移和兼容验证

Task 21：文档、示例和操作手册

tasks.md 30 KB

Історія Запис