forge_admin/code-copilot/changes/application-business-process-orchestrator/execution-log.md

执行日志 — 应用级业务流程编排器

change: application-business-process-orchestrator started: 2026-08-03

2026-08-03 Task 0：HARD-GATE 与实施基线

• 变更范围：仅当前变更的 spec.md、tasks.md、test-spec.md、execution-log.md。
• 用户授权：当前会话明确要求开始开发，按 Spec 第 9 章六项推荐默认值完成 HARD-GATE。
• 规则基线：已读取根 AGENTS.md、code-copilot/AGENTS.md、三份 memory、自动化测试标准、流程业务 Skill 共享参考、Forge 编码规范与前端设计 Skill。
• Git 基线：当前分支为 main；工作区已有能力开放平台相关修改和 .DS_Store 变化，均不属于本变更，实施中禁止覆盖或提交。
• Flyway 基线：当前最新脚本为并行变更中的 V1.0.82__improve_capability_client_workbench.sql；本变更分配 V1.0.83/V1.0.84，不修改 V1.0.82。
• 协议基线：冻结 businessProcessJson 1.0、三类完整样例、可信身份矩阵、Process/Node/Approval 状态机与 CAS 条件。
• 安全结论：DAG、单活动审批、受限定时普通用户、同应用子流程深度 5、分阶段旧入口停写、禁止自由 Webhook；任一身份/权限/版本/关联不可信时失败关闭。
• 已启动服务：无。
• 数据库/运行态变更：无。
• 文档检查：四份变更文档通过 git diff --no-index --check，无空白错误。
• 协议检查：Ruby JSON.parse 成功解析 test-spec.md 中 3 个 JSON 协议样例；Ruby 输出一条系统目录权限 warning，不影响解析结论。
• 状态检查：Spec 为 apply、HARD-GATE 为 completed、Tasks 为 Apply/M1；未发现仍要求“仅允许 Proposal”或“待用户确认”的门禁文本。
• 已知非阻断：Spec Research 与任务前置中出现的 TODO 是对旧 BusinessTriggerExecutor 未实现 Webhook 的现状描述，不是本变更占位实现；新节点必须把该能力标为不可用。
• 提交证据：57fc3acb [application-business-process-orchestrator] 冻结编排协议与验证基线；提交统计上传因本机 DNS/网络失败，Git 提交本身成功，未执行 push。

2026-08-03 Task 1：流程数据库结构与资源

• 新增 V1.0.83__add_application_business_process.sql：创建流程定义、不可变版本、运行实例和节点运行四张表；定义/版本使用 BIGINT del_flag 主键墓碑，运行表不提供删除标记。
• 新增 V1.0.84__add_application_business_process_resources.sql：写入设计/运行/节点/触发字典、应用发布 PROCESSES 步骤、隐藏设计器路由和管理/运行/迁移权限；权限只继承既有应用查看、编辑和发布角色，不扩大无应用权限角色。
• 幂等与租户：建表使用 CREATE TABLE IF NOT EXISTS；字典、资源和角色资源均使用 NOT EXISTS；内置数据统一 tenant_id=1。
• 静态验证：git diff --check 通过；两个新迁移的 Flyway placeholder 扫描无输出；tenant_id DEFAULT 0/=0/,0 扫描无输出；迁移版本重复扫描无输出。
• 轻量结构检查：V1.0.83 单引号 202、左右括号 60/60；V1.0.84 单引号 496、左右括号 31/31。
• 合同核对：Flowable 使用 BusinessFlowService/FlowClient；消息与企业协同使用 BusinessActionStepExecutor + MessageService/CollaborationMessageChannel；统一能力平台仅确认 CapabilityRegistry，generator 尚无受控桥接，Task 9B 前按不可用处理。
• 安全发现：旧 SendMessageActionStepExecutor#resolveUserId 在无 Session 时回退 1L，违反本变更“无合法普通用户失败关闭”；列入 Task 9B 修复，业务流程运行时不得复用该回退。
• 跳过项：未连接 MySQL，未执行新库/存量库/重复 Flyway 和 forge_schema_history 检查；原因是本轮不自动修改真实数据库，留待 Task 19 目标环境验收。
• 已启动服务：无。

2026-08-03 Task 2：流程定义持久层

• 新增 AiBusinessProcess：覆盖流程定义全部字段，delFlag 显式使用 @TableLogic(value = "0", delval = "id")。
• 新增 BusinessProcessMapper/BusinessProcessMapper.xml：分页和按 ID/编码查询同时限定 tenant_id、有效应用、有效应用对象关联、启用业务对象和 del_flag=0，共享对象不能绕过应用关联。
• 并发与删除：草稿保存要求当前 draft_schema_hash 命中客户端基线后才更新；逻辑删除原子写入当前行 id 并记录更新人。
• 新增 BusinessProcessMapperContractTest 3 项：覆盖主键墓碑、租户/应用/对象失败关闭和草稿 hash CAS。
• 首次命令：默认 Java 8 执行 Maven 失败，错误为 无效的目标发行版: 17，未进入源码编译；确认本机已有 Homebrew JDK 17 后仅对验证命令临时切换。
• 成功命令：JAVA_HOME=<JDK17> PATH=<JDK17/bin:...> mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Dtest=BusinessProcessMapperContractTest test。
• 结果：主代码编译成功；测试 3/3 通过。现有 BusinessFlowService deprecation 与 BusinessObjectDesignerService unchecked 编译提示未新增失败。
• 已启动服务：无；数据库/Flowable 运行态变更：无。

2026-08-03 Task 3：流程版本持久层

• 新增 AiBusinessProcessVersion：完整承载应用版本、流程版本、规范化协议、依赖快照与发布审计，delFlag 使用主键墓碑逻辑删除。
• 新增 BusinessProcessVersionMapper/BusinessProcessVersionMapper.xml：提供固定版本、版本 ID、版本列表、应用选定流程集合和最大版本号查询；全部显式限定租户和未删除记录，正式版本读取额外限定 status=1。
• 不可变合同：只新增 insertImmutable，XML 不存在 <update> 或 UPDATE ai_business_process_version；空 processIds 集合使用 AND 1 = 0 失败关闭，避免误查全应用版本。
• 成功命令：JAVA_HOME=<JDK17> PATH=<JDK17/bin:...> mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Dtest=BusinessProcessMapperContractTest test。
• 结果：主代码编译成功；累计 Mapper 契约测试 4/4 通过。仅保留 Task 2 已记录的既有 deprecation/unchecked 编译提示。
• 已启动服务：无；数据库/Flowable 运行态变更：无。

2026-08-03 Task 4：流程运行与节点运行持久层

• 新增 AiBusinessProcessRun/AiBusinessProcessNodeRun：运行记录固定应用、流程版本、业务对象/记录、可信 actor 与组织；节点记录按 runId + nodeId + attemptNo 新增尝试，不声明普通删除字段。
• 新增 BusinessProcessRunMapper/BusinessProcessRunMapper.xml：提供运行 ID、幂等键、Flowable 实例等待关联和租户内恢复扫描；恢复范围区分 PENDING、超时 RUNNING/WAITING 和到期 FAILED。
• 流程强 CAS：更新同时匹配 tenantId + runId + expectedStatus + expectedCurrentNodeId + expectedProcessInstanceId；终态记录结束时间，失败重试仅允许 FAILED -> PENDING 且原子增加次数。
• 新增 BusinessProcessNodeRunMapper/BusinessProcessNodeRunMapper.xml：插入尝试强制 PENDING，认领只允许 PENDING，完成/等待/回调消费同时匹配旧状态和 correlation；失败尝试不提供复活 SQL。
• XML 检查：xmllint --noout BusinessProcessRunMapper.xml BusinessProcessNodeRunMapper.xml 通过；目标文件 git diff --check 通过。
• 成功命令：JAVA_HOME=<JDK17> PATH=<JDK17/bin:...> mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Dtest=BusinessProcessMapperContractTest test。
• 结果：主代码编译成功；累计 Mapper 契约测试 6/6 通过。仅保留已记录的既有 deprecation/unchecked 编译提示。
• 已启动服务：无；数据库/Flowable 运行态变更：无。

2026-08-03 Task 5：运行查询与安全摘要

• 新增 BusinessProcessRunQueryDTO：支持应用、流程、业务对象、记录、状态、触发来源和创建时间区间过滤。
• 新增 BusinessProcessRunVO/BusinessProcessRunDetailVO：流程、版本、actor、组织和节点运行 ID 均声明为字符串；详情时间线只暴露 correlation、安全输入/输出摘要、错误码和截断错误摘要。
• 运行分页 SQL：显式限定 r.tenant_id，使用 CAST(... AS CHAR) 返回所有长整型 ID，不读取 context_snapshot/source_event_id/idempotency_key。
• 节点查询：时间线使用不含幂等键的 Timeline_Columns；最后尝试保留内部幂等恢复字段；可重试与审批 correlation 查询同时限定租户和 run，查询顺序稳定。
• XML 检查：xmllint --noout BusinessProcessRunMapper.xml BusinessProcessNodeRunMapper.xml 通过；目标文件 git diff --check 通过。
• 成功命令：JAVA_HOME=<JDK17> PATH=<JDK17/bin:...> mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Dtest=BusinessProcessMapperContractTest test。
• 结果：主代码编译成功；累计 Mapper 契约测试 8/8 通过，新增验证安全列和字符串 ID。仅保留已记录的既有编译提示。
• 已启动服务：无；数据库/Flowable 运行态变更：无。

2026-08-03 Task 6：businessProcessJson 协议与发布校验

• 新增强类型协议：BusinessProcessSchema/BusinessProcessNode/BusinessProcessEdge 分离根协议、主对象、节点、连线、策略、依赖和迁移元数据，不复用 BPMN/flowJson。
• 新增 BusinessProcessSchemaValidator：严格拒绝重复键、未知根字段和数字 ID；按节点/边/端口及依赖排序生成 canonical JSON 和 SHA-256；保留条件分支与重试退避等有序语义。
• 图门禁：单开始、节点注册表、固定/条件/审批出口、悬空边、自环、重复出口、DAG、开始可达、结束可达、节点/边数量和子流程深度全部失败关闭。
• 节点与依赖门禁：校验事件、定时普通用户引用、审批固定版本与四结果出口、记录动作、消息、业务动作、能力桥接、同应用已发布子流程、直接/间接递归、对象与字段有效性。
• 安全门禁：大小写及嵌套路径扫描 URL/Webhook/Secret/Token/Password/PrivateKey/Authorization/Cookie/JavaClass/SQL/Script/SpEL；自由 URL/JDBC 地址和画布 actor userId 覆盖失败关闭，问题响应不回显配置值。
• 冻结样例修正：定时提醒样例原有未连线 end_failed，与不可达节点门禁冲突，已从 test-spec.md 和测试资源中移除；新增手动审批、事件审批、定时提醒三份 classpath 回归资源。
• 新增 BusinessProcessValidationVO/BusinessProcessValidationContext 与 BusinessProcessSchemaValidatorTest 10 项，覆盖稳定 hash、三份冻结样例、重复键/数字 ID、多开始、环、悬空边、未知节点、无结束路径、失效字段、敏感键、自由 URL、递归子流程和能力桥接未就绪。
• 中间失败 1：新增“未知节点/无结束节点”用例首次用字符串替换构造 fixture，未实际移除结束节点，导致 1 项断言失败；改为解析后按节点/边 ID 构造无结束图，重跑通过，生产代码无回退。
• 中间失败 2：仅关闭 Jackson scalar coercion 仍会把数字 objectId 转为字符串，数字 ID 拒绝用例失败；增加原始 JsonNode 递归 ID 类型检查，并保留校验阶段二次保护，重跑通过。
• 成功命令：JAVA_HOME=<JDK17> PATH=<JDK17/bin:...> mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Dtest=BusinessProcessSchemaValidatorTest,BusinessProcessMapperContractTest test。
• 结果：主代码编译成功；本轮 18/18 测试通过（Schema 10、Mapper 8）。仅保留已记录的既有 deprecation/unchecked 编译提示。
• 知识沉淀：新增 pitfalls.md #160，明确画布样例必须通过真实图校验，不能以 JSON 语法解析代替合法性验证。
• 已启动服务：无；数据库/Flowable 运行态变更：无。

2026-08-03 Task 7：流程定义控制面 Service 与 API

• 新增 BusinessProcessDTO/BusinessProcessSchemaDTO/BusinessProcessVO、BusinessProcessService 和 BusinessProcessController：提供应用内分页、详情、创建、同应用复制、基础信息更新、草稿 hash CAS、校验、启停和逻辑删除；Controller 使用独立 /ai/business/process 命名空间、加解密与细粒度权限。
• 草稿语义：新流程初始化为规范化“手动开始 → 成功结束”；所有 JSON/前端雪花 ID 保持字符串；流程编码创建后不可修改；结构不完整草稿可保存并保持 DRAFT，跨应用对象、编码不一致、Secret/自由 URL 等高风险错误禁止保存。
• 复制与删除：副本生成新编码并重建全部节点/边 ID，清空发布版本、运行状态和旧来源；存在任意 run 或有效发布版本时拒绝逻辑删除。
• 校验目录：使用当前应用对象/字段、不可变对象发布快照中的动作、表单/消息、同应用已发布子流程和真实 sys_resource 权限目录；Flowable 模型必须同时属于当前应用对象绑定且 status=1/deploymentId 有效，流程服务不可用时失败关闭。
• 权限补丁：新增 V1.0.85__add_business_process_start_permission.sql，不修改已提交 V1.0.84；注册 ai:businessProcess:start，仅从既有 ai:businessApplication:runtime 角色继承通用 API 门禁，正式运行仍需发布快照动作权限、可见条件、记录状态和数据权限二次校验。
• Mapper 扩展：基础信息/状态/设计状态更新、Schema CAS 同步主对象、run 引用计数、有效发布引用计数和当前已发布子流程查询全部写在 XML；流程列表不返回完整草稿正文。
• 定向测试命令：JAVA_HOME=<JDK17> PATH=<JDK17/bin:...> mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Dtest=BusinessProcessSchemaValidatorTest,BusinessProcessMapperContractTest,BusinessProcessServiceTest,BusinessProcessControllerTest,BusinessProcessValidationContextResolverTest test。
• 定向测试结果：31/31 通过（Schema 10、Mapper 9、Service 8、Controller 3、Context Resolver 1），Failures/Errors/Skipped 均为 0。
• 静态检查：xmllint --noout 校验三份变更 Mapper XML 通过；V1.0.85 Flyway placeholder 和 tenant_id=0 扫描无输出，tenant_id=1/NOT EXISTS/ai:businessProcess:start 命中预期；目标文件 git diff --check 通过。
• 聚合编译命令：JAVA_HOME=<JDK17> PATH=<JDK17/bin:...> mvn -pl forge-admin-server -am compile -DskipTests。
• 聚合编译结果：47/47 模块 BUILD SUCCESS，generator 与 admin 装配链路通过；仅有既有 deprecation、unchecked 和 Lombok @Builder warning，无新增阻断。
• 跳过项：未执行真实 MySQL/Flyway、权限继承数据查询、加密 HTTP API、Flowable 已发布/未发布模型联调和浏览器验证；原因是本轮遵循用户偏好不启动真实服务、不改数据库或 Flowable 运行态，留待 Task 19 环境门禁。
• 已启动服务：无；数据库/Flowable 运行态变更：无。

2026-08-03 Task 14：前端独立协议与画布基础

• TDD 红灯：首次执行 pnpm exec vitest run src/components/business-process-designer/__tests__/business-process-designer.spec.js，测试套件因 BusinessProcessCanvas.vue 等四个目标模块不存在而按预期失败，未进入用例执行。
• 协议与注册表：新增 business-process-schema.js/business-process-node-types.js，提供默认草稿、严格字符串 ID、BPMN 输入拒绝、节点/边/端口/依赖排序、稳定 hash 输入、八类业务节点和审批四结果出口。
• 设计器状态：新增 useBusinessProcessDesigner.js，复用 useFlowHistory，支持线性节点插入/复制/删除、边 CRUD、条件双分支、选择、撤销重做、dirty 基线和深克隆导出；业务 DAG 中不生成伪审批节点。
• 画布复用：新增 BusinessProcessCanvas.vue，用临时只读布局适配把业务类型映射给 layoutFlow，持久化协议不增加 nodeType/bpmnElementId；直接复用既有 FlowCanvas/EdgeLayer 插槽，无需修改共享画布。
• BPMN 隔离：convertJsonToBpmn 在转换前显式识别并拒绝 businessProcessJson，审批 flowJson 的原转换路径保持不变。
• 定向测试：业务画布测试 10/10 通过；组合执行业务画布、BPMN roundtrip、JSON→BPMN、FlowCanvas、layout-engine 共 5 个测试文件，结果 48/48 通过。
• 中间操作纠正：首次组合回归误在仓库根目录执行，pnpm 报 Command "vitest" not found，未执行任何测试或产生代码影响；切换到 forge-admin-ui 后按同一命令通过。
• 静态检查：pnpm exec eslint src/components/business-process-designer src/components/flow-designer/converter/json-to-bpmn.js 通过；目标文件 git diff --check 通过。
• 生产构建：Node v20.19.0 下执行 NODE_OPTIONS=--max-old-space-size=8192 pnpm build，Vite 转换 8825 个模块并 BUILD SUCCESS（built in 1m 50s）。保留仓库既有的组件命名冲突、动态/静态 import、CSS // 注释警告，未新增阻断。
• 跳过项：未启动 Vite/浏览器，原因是 Task 14 仅交付协议和画布基础，尚无应用路由与完整节点配置；浏览器交互留待 Task 15-16。未启动 Admin/Flow 服务，未执行 Flyway、数据库或 Flowable 运行态变更。
• 已启动服务：无。

2026-08-03 Task 15：节点配置、真实审批设计器与草稿交互

• TDD 红灯：新增 business-process-designer-workbench.spec.js 后首次运行因五个目标组件不存在而在模块解析阶段失败，符合先冻结工作台交互合同再实现的预期。
• 工作台：新增 BusinessProcessDesigner.vue，提供紧凑工具栏、节点面板、共享画布、问题列表、节点复制/删除、检查、自动/显式保存状态、服务端冲突提示与刷新入口；dirty 草稿注册 beforeunload 保护。
• 节点配置：新增 BusinessProcessNodeRenderer/BusinessProcessNodeConfigDrawer/StartNodeConfig/ActionAndApprovalNodeConfig，覆盖触发方式、事件、定时服务账号、结构化条件、记录动作、消息、业务动作、能力、审批、子流程和结束结果，不暴露高级文本协议或自由外部目标。
• 审批衔接：审批节点只选择已发布/已部署 Flowable 模型，并在全屏弹层异步复用真实 flow/design.vue；会签、驳回、退回、审批人和字段权限继续由 BPMN 所有，关闭/保存/部署后发出模型刷新事件。
• 协议联动：新增 synchronizeBusinessProcessDependencies 与开始类型切换合同；节点引用变更自动重建七类受治理依赖，手动/事件/定时切换同步 recordIdSource，动作新增默认绑定当前主对象。
• 定向测试：两份业务设计器测试共 17/17 通过（协议/历史 11、工作台交互 6）；工作台测试覆盖审批四出口、真实设计器入口、结构化触发切换、面板路由、依赖同步、自动保存、hash 冲突和离开保护。
• 组合回归：业务设计器、BPMN roundtrip、JSON→BPMN、FlowCanvas 和 layout-engine 共 6 个测试文件，结果 55/55 通过；未发布/未部署审批模型不会进入可选目录。
• 静态检查：pnpm exec eslint src/components/business-process-designer 通过；目标目录 git diff --check 通过。
• 生产构建：Node v20.19.0 下执行 NODE_OPTIONS=--max-old-space-size=8192 pnpm build，Vite 转换 8825 个模块并成功构建（built in 1m 46s）；真实 flow/design.vue 异步依赖、Naive UI 抽屉和弹窗均通过装配。
• 既有警告：仍为组件命名冲突、动态/静态 import 和 CSS // 注释等仓库存量构建警告，本任务未新增阻断。
• 跳过项：未启动 Vite/浏览器，原因是 Task 15 独立组件尚未接入可访问路由；浏览器与路由离开验收将在 Task 16 完成应用工作台/全屏设计页后执行。未启动 Admin/Flow 服务，未执行 Flyway、数据库或 Flowable 运行态变更。
• 已启动服务：无。

2026-08-03 Task 16：应用工作台业务流程核心面板

• TDD 红灯：新增 Task 16 工作台测试后首次运行因 ApplicationProcessPanel.vue、business-process.[processId].vue 和 api/business-process.js 不存在而在模块解析阶段失败，符合先冻结接口、列表和设计页交互合同再实现的预期。
• 控制面 API：新增 api/business-process.js，分页、详情、创建、复制、更新、设计草稿、Schema CAS、校验、启停和逻辑删除均显式使用加密请求；保存 payload 使用服务端返回的 64 位 draftSchemaHash，不把前端 dirty-check hash 当并发基线。
• 应用工作台：新增克制的流程列表，支持搜索、状态筛选、分页、新建、复制、设计、启停、逻辑删除和进入应用发布；新建流程只选择当前应用对象，流程编码由服务端生成。旧“业务流程/触发器/动作”三按钮组件不再作为应用工作台主入口。
• 路由与返回：automation 分区文案改为“业务流程 / 触发、审批与自动化”，新增 /app-center/business-process/:processId 全屏路由；筛选同步到 route query，returnTo 返回原应用和筛选状态，且只接受本地路径。
• 全屏设计页：加载真实 designer 草稿和对象字段、对象动作、Flowable 模型、表单、消息模板、同应用已发布子流程目录；所有 ID 归一为字符串。关闭内嵌 Flowable 设计器后刷新模型和表单目录；受治理能力与服务账号目录未交付时保持空目录并失败关闭。
• 草稿可靠性：保存期间继续编辑会排队再次 CAS 保存；脏草稿执行检查前先保存；HTTP 409 显示冲突并禁止覆盖；浏览器刷新和路由离开分别由 beforeunload 与 onBeforeRouteLeave 保护。
• 未交付边界：运行记录和迁移预览在面板中显示“待接入”禁用态，未创建 Task 13/17 尚不存在的 API。
• 定向与回归测试：Node v20.19.0 下执行 Task 16 API/工作台测试与业务流程设计器、BPMN roundtrip、JSON→BPMN、FlowCanvas、layout-engine 共 8 个测试文件，结果 62/62 通过。
• 静态检查：Task 16 API、页面、路由、测试及 src/components/business-process-designer 目标 ESLint 通过；目标文件空白检查通过。
• 浏览器验证：用 webapp-testing Playwright 脚本临时启动 Vite 127.0.0.1:3017，通过 34 次受控请求装配真实应用工作台和全屏设计路由；验证旧三入口消失、筛选保留、节点新增、CAS 保存使用 aaaaaaaa... 服务端 hash、服务端校验和未保存离开取消。workspace/designer 截图保存于 /tmp/forge-task16-workspace.png、/tmp/forge-task16-designer.png，console error 与 page error 均为 0；脚本结束后 Vite 已停止。
• 生产构建：Node v20.19.0 下执行 NODE_OPTIONS=--max-old-space-size=8192 pnpm build，Vite 转换 8845 个模块并成功构建（built in 1m 58s）；保留仓库既有组件命名冲突、动态/静态 import 和 CSS // 注释警告，无新增阻断。
• 跳过项：未启动 Admin/Flow，未执行真实加密 HTTP、权限资源查询、MySQL/Flyway、Flowable 模型保存/部署或运行态变更；这些仍由 Task 19 目标环境验收。
• 已启动服务：浏览器验证仅临时启动 Vite，已由脚本停止；未遗留 3017 监听进程。

2026-08-04 Task 12：应用发布流程版本和依赖快照

• TDD 红灯：先新增 BusinessProcessPublishServiceTest 和应用发布步骤断言；首次执行 mvn -Penable-tests ... -Dtest=BusinessProcessPublishServiceTest,BusinessApplicationPhaseFiveSecurityTest 在测试编译阶段因 BusinessProcessPublishService 尚不存在而失败，符合先冻结版本合同再实现的预期。
• 发布选择与候选冻结：BusinessApplicationPublishDTO/AssetSelectionVO 增加流程 ID；空选择默认包含应用内全部启用流程，includeAutomation=false 时明确为空。候选快照保存流程白名单信息、完整结构化协议和 draftSchemaHash，恢复不得读取后来修改的新草稿。
• 不可变版本：新增 BusinessProcessPublishService/BusinessProcessPublishResult/BusinessProcessSnapshot；发布前锁定流程定义，以 (tenant_id, process_id, application_version, del_flag) 幂等复用，hash 不同返回 409；新版本只执行 insertImmutable，无版本 UPDATE SQL。
• 依赖固定：流程版本依赖快照固定对象设计版本；Flowable 必须同时具备 status=1、正版本号、processDefinitionId 和 deploymentId，并保存模型 ID、版本与部署标识；表单、业务动作、消息模板、能力和子流程只保存稳定白名单引用。
• 应用发布与恢复：固定步骤变为 PRECHECK → SNAPSHOT → PROCESSES → OBJECTS → ENTRIES → PAGE_MENUS → EXTENSIONS → COMMIT；PROCESSES 被计入部分成功副作用，步骤成功后把结构化 publishedProcessVersions 写回运行单快照。runtimeActions 仅冻结空字段，Task 13 再编译手动动作。
• 回滚边界：来源快照中的历史 processVersionId 只恢复流程定义的 published_version/design_status 投影，并清理未选择投影；不读取或更新运行表，因此已开始实例继续固定自己的流程版本。
• 就绪检查：正式流程来源切换为 businessProcessJson；复用 Schema/图/依赖校验阻断对象版本、字段、审批部署版本、结束路径、子流程递归、单活动审批策略和手动权限问题。旧 binding 仅作为兼容快照保留，不再决定是否存在应用级流程。
• 定向验证命令：JAVA_HOME=<JDK17> mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Dtest=BusinessProcessPublishServiceTest,BusinessApplicationPhaseFiveSecurityTest,BusinessApplicationAssetSelectionServiceTest,BusinessApplicationReadinessServiceTest,BusinessProcessMapperContractTest,BusinessProcessSchemaValidatorTest,BusinessProcessValidationContextResolverTest,BusinessProcessServiceTest,BusinessApplicationPublishRunServiceTest -Dsurefire.failIfNoSpecifiedTests=false test。
• 边界复核红灯：补充“候选缺少流程 hash”和“Flowable 版本号为 0”回归后，相关两类测试共 7 项首次运行出现 3 个预期失败，确认协调发布仍会回退当前草稿且零版本会被校验/发布接受。
• 边界修正：协调发布存在 publishRunId 时强制要求每个所选流程都有候选 hash；Flowable 模型在校验目录和依赖固定阶段均要求版本号 > 0。相关两类测试重跑 7/7 通过。
• 定向验证结果：Task 12 九类测试最终 46/46 通过，Failures/Errors/Skipped 均为 0；覆盖幂等重试、hash 冲突、候选 hash 缺失失败关闭、Flowable 非正版本拒绝、对象/Flowable 依赖固定、历史投影恢复、默认流程选择、快照字段和就绪阻断。
• Mapper 静态检查：xmllint --noout BusinessProcessMapper.xml BusinessProcessVersionMapper.xml 通过；目标差异 git diff --check 通过。
• 聚合编译：边界修正后重跑 JAVA_HOME=<JDK17> mvn -pl forge-admin-server -am -DskipTests compile，47/47 模块 BUILD SUCCESS；仅保留仓库既有 deprecation、unchecked 和 Lombok @Builder warning。
• generator 全量基线（边界修正前）：执行 mvn -Penable-tests -pl forge-framework/forge-plugin-parent/forge-plugin-generator test，共 561 项，555 项通过，2 failures + 4 errors。失败为未被 Task 12 修改的 FormulaExecutionEngineLookupTest、FormulaValueMaskerTest、BusinessBindingApplicationTargetTest、BusinessExtensionVersionServiceTest（2 项）和 LowcodeRuntimeConfigBuilderTest；Task 12 定向类全部通过，本轮未越界修改这些存量失败。边界修正后未重复消耗时间执行同一已知失败全量，改以覆盖修改类的 46/46 定向测试和 47 模块聚合编译闭环。
• 跳过项：未启动 Admin/Flow，未执行 Flyway、真实数据库发布/回滚、加密 HTTP 或 Flowable 部署联调；本任务没有新增数据库脚本，真实新旧实例并存验收留待 Task 19。
• 已启动服务：无；数据库/Flowable 运行态变更：无。