forge_admin/code-copilot/changes/archive/lowcode-business-transaction-closure/execution-log.md

执行日志 — 低代码业务交易闭环能力补齐

status: apply_completed created: 2026-07-03

2026-07-03 SDD 初始化

• 用户确认按 SDD 开始推进。
• 创建变更目录：code-copilot/changes/lowcode-business-transaction-closure/。
• 范围收敛：平台级业务交易闭环能力，不硬编码采购仓储。
• P0 能力：FOREACH 动作步骤、选择器多字段搜索/动态过滤、数量台账只读查询。

验证记录

2026-07-03 P0 平台能力实现与验证

变更范围

• 后端动作引擎：新增 FOREACH 动作步骤、循环作用域变量、嵌套子步骤执行入口。
• 后端选择器：多字段关键词归一为私有 OR-like 条件，字段仍走动态 CRUD 白名单；过滤内部字段和空值。
• 前端选择器：运行态解析 searchParams 中的 ${formData.xxx}、${record.xxx}、${row.xxx}、${query.xxx}，子表选择器可读取父表单数据。
• 数量台账：新增余额/流水/锁定只读查询 DTO/VO/Mapper XML/Service/Controller/API 和 ai:businessQuantity:view 权限脚本。

执行命令与结果

1. 后端插件编译：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -am compile -DskipTests

结果：首次失败于 ForeachActionStepExecutor lambda 捕获循环变量 i；修复为 itemIndex 后复跑通过，最终 BUILD SUCCESS。

1. FOREACH 定向单测：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessActionForeachStepExecutorTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：首次因 Mockito inline MockMaker 无法 attach 当前 Homebrew JDK 失败；测试改为无 Mockito 本地 fake 后复跑通过，Tests run: 5, Failures: 0, Errors: 0, Skipped: 0。

1. 选择器归一逻辑单测：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessRecordSelectorSearchParamsTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 4, Failures: 0, Errors: 0, Skipped: 0。

1. 数量台账查询服务单测：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessQuantityQueryServiceTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 3, Failures: 0, Errors: 0, Skipped: 0。

1. 本轮组合单测：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessActionForeachStepExecutorTest,BusinessRecordSelectorSearchParamsTest,BusinessQuantityQueryServiceTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 12, Failures: 0, Errors: 0, Skipped: 0。

1. 前端构建：

source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build

结果：通过，✓ built in 2m 34s。

1. 静态检查：

git diff --check
rg -n '\$\{[^}]+\}' forge-server/db/migration

结果：git diff --check 无输出；Flyway ${...} 扫描无输出。

警告项

• 后端编译存在既有 BusinessFlowService deprecated API 和 BusinessObjectDesignerService unchecked 警告，不阻断。
• 前端构建存在既有 UserSelectModal 命名冲突提示、CSS // 注释 minify 警告、动态/静态导入同模块 chunk 提示，不阻断。
• 单测输出 commons-logging.jar 与 spring-jcl 发现提示，不阻断。

跳过项

• 未启动本地 MySQL/Redis/后端服务做真实接口联调；本轮先完成平台 P0 编译、单测和前端构建闭环。
• 未做采购仓储端到端配置验收文档和详情数量区块 UI，保留为 Task 10-13 的 P1 后续项。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。

2026-07-04 表单校验、关系选择器配置和运行态选择器兜底验证

变更范围

• 表单设计：修复常用校验 preset/pattern/message 在 formDesignerSchema 归一化时被丢弃的问题，并在属性面板选择常用校验时同步写回字段资产。
• 关系与级联：将子表选择器从手写文本配置改成候选对象、展示字段、搜索字段、字段映射和筛选条件的结构化选择式配置；旧 displayFields/keywordFields/fieldMappings/searchParams 协议兼容读取和保存。
• 运行配置：LowcodeRuntimeConfigBuilder 在字段或页面配置带有 recordSelector/selector 元数据时，优先发布为 recordSelector 组件，并把选择器配置下发到运行时 props，避免仓库/供应商等字段退化成 ID 输入框。
• 单测：扩展 LowcodeRuntimeConfigBuilderTest 覆盖 bigint 字段携带 recordSelector 元数据时发布为选择器组件。

执行命令与结果

1. 静态检查：

git diff --check -- forge-admin-ui/src/views/app-center/components/designer/BusinessRelationDesigner.vue forge-admin-ui/src/views/app-center/components/designer/forge-form-designer/ForgePropertyPanel.vue forge-admin-ui/src/views/app-center/components/designer/form-first/formDesignerSchema.js forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/service/lowcode/LowcodeRuntimeConfigBuilder.java forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/test/java/com/mdframe/forge/plugin/generator/service/lowcode/LowcodeRuntimeConfigBuilderTest.java

结果：通过，无输出。

1. 后端定向单测：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=LowcodeRuntimeConfigBuilderTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 4, Failures: 0, Errors: 0, Skipped: 0，BUILD SUCCESS。

1. 前端构建：

source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build

结果：通过，✓ built in 2m 35s。

警告项

• 后端编译仍有既有 deprecated API 和 unchecked 提示，不阻断。
• 前端构建仍有既有 UserSelectModal 命名冲突提示、CSS // 注释 minify 警告、动态/静态导入同模块 chunk 提示，不阻断。

跳过项

• 未启动本地后端、数据库和浏览器做真实采购单新增联调；本轮覆盖了运行配置生成单测、前端生产构建和静态检查。当前数据库如仍保留旧发布配置，需要重启服务执行 Flyway 后重新发布/刷新运行配置再复测。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。

2026-07-04 发布入口位置修复验证

变更范围

• 恢复对象设计器右上角“发布”按钮在发布检查面板中的显示。
• 移除发布检查卡片里的重复“发布对象”按钮，只保留“同步数据表结构”确认和“打开应用”。
• 右上角发布会读取发布检查面板当前 syncTable 勾选值。

执行命令与结果

source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build

结果：通过，✓ built in 2m 26s。

警告项

• 前端构建仍存在既有 UserSelectModal 命名冲突提示、CSS // 注释 minify 警告、动态/静态导入同模块 chunk 提示，不阻断。

服务清理

• 本轮未启动长期运行的前端开发服务，无需清理 PID。

2026-07-03 设计器配置保真与菜单停用回归修复验证

变更范围

• 后端设计器保存：重建字段前后保留已有 dictType、basicProps.generation、basicProps.recordSelector、引用字段、公式配置和业务组件类型；同时把旧 edit_schema/search_schema/columns_schema 桥接回 page_schema.fieldSettings，避免保存设计器后状态下拉、仓库/供应商选择器、自动编号消失。
• 存量配置修复：新增 V1.0.98__preserve_procurement_warehouse_designer_field_runtime_metadata.sql，修复采购仓储样例的仓库/供应商选择器、状态/仓库类型字典、列表渲染和编号字段生成配置。
• 前端设计器：合并对象设计器顶部发布和发布面板内发布入口，修复 Delete/Backspace 在字段绑定配置输入区误触设计器删除，字段绑定选择器禁止清空。
• 菜单状态：业务域/入口停用时同步 sys_resource.visible/menu_status，启用时恢复目录和启用应用菜单。
• 表格对齐：列表设计器新增表格块全局对齐配置，运行态列配置和预览渲染均使用全局默认值。

执行命令与结果

1. 前端构建：

source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build

结果：通过，✓ built in 1m 46s。

1. 定向组合单测：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessObjectDesignerPageSchemaTest,BusinessActionExecutionServiceTest,LowcodeRuntimeConfigBuilderTest,BusinessRecordSelectorSearchParamsTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 18, Failures: 0, Errors: 0, Skipped: 0。

1. admin 聚合编译：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-admin-server -am compile -DskipTests

结果：通过，BUILD SUCCESS，总耗时 13.779 s。

1. 静态检查：

git diff --check
rg -n '\$\{[^}]+\}' forge-server/db/migration

结果：git diff --check 无输出；Flyway ${...} 扫描无输出。

警告项

• 前端构建仍存在既有 UserSelectModal 命名冲突提示、CSS // 注释 minify 警告、动态/静态导入同模块 chunk 提示，不阻断。
• 后端编译仍存在既有 deprecated API 和 unchecked 警告，不阻断。
• 单测输出 commons-logging.jar 与 spring-jcl 发现提示，不阻断。

跳过项

• 未直接连接本地/远程业务库执行 V1.0.98；脚本会在 forge-admin-server 下次启动时由 Flyway 执行。当前服务如已启动，需要重启 admin 服务后再复测采购仓储新增/发布页面。
• 未做真实浏览器端采购仓储增删改流程联调；本轮用前端生产构建、admin 聚合编译、定向单测和 Flyway 占位符静态扫描覆盖。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。

2026-07-03 采购仓储发布协议二次收口验证

变更范围

• 设计器内部组件白名单和字段默认值映射补齐 input-number/inputnumber，避免保存/迁移旧表单组件时没有命中数字字段默认值。
• BusinessObjectDesignerPageSchemaTest 新增 input-number 默认映射断言，和发布校验、动作执行对象编码、运行配置动作元数据用例一起复跑。

执行命令与结果

1. 静态检查：

git diff --check
rg -n '\$\{[^}]+\}' forge-server/db/migration

结果：git diff --check 无输出；Flyway ${...} 扫描无输出。

1. 定向单测：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessObjectDesignerPageSchemaTest,BusinessActionExecutionServiceTest,LowcodeRuntimeConfigBuilderTest,BusinessRecordSelectorSearchParamsTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 15, Failures: 0, Errors: 0, Skipped: 0。

1. 后端插件编译：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -am compile -DskipTests

结果：通过，BUILD SUCCESS，总耗时 13.846 s。

警告项

• 后端编译仍有既有 deprecated API 和 unchecked 警告，不阻断。
• 单测仍输出 commons-logging.jar 与 spring-jcl 发现提示，不阻断。

跳过项

• 本轮没有改动前端源码，未重复执行前端构建。
• 未直接连接业务库执行 V1.0.97；需要重启 forge-admin-server 或手动执行迁移后，线上/本地数据库里的采购仓储样例配置才会被修复。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。

2026-07-03 采购仓储发布和动作协议补修验证

变更范围

• 页面协议校验：toolbar.fieldRefs 作为工具栏动作配置不再按数据字段校验，避免供应商/采购单发布被子表字段脏引用阻断。
• 控件兼容：后端低代码校验器接受 input-number/inputNumber/inputnumber，运行态继续归一为 number。
• 页面旧协议：LowcodePageZone 支持历史 key/type JSON 别名，避免旧 seed 的 zones 反序列化成空区域。
• 动作协议：BusinessActionExecuteDTO 兼容 businessObjectCode/targetObjectCode/targetEntityCode/refObjectCode/targetCode 等别名，并从 context.row._runtimeObjectCode 兜底；发布出的 COMMAND 动作保留 actionCode/suiteCode/objectCode/businessObjectCode。
• 迁移脚本：新增 V1.0.97__harden_procurement_warehouse_page_action_selector_protocol.sql，清理采购仓储样例已持久化的工具栏脏字段引用，并补齐运行态按钮和关键选择器对象编码别名。

执行命令与结果

1. 定向单测：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessObjectDesignerPageSchemaTest,BusinessActionExecutionServiceTest,LowcodeRuntimeConfigBuilderTest,BusinessRecordSelectorSearchParamsTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 14, Failures: 0, Errors: 0, Skipped: 0。

1. 后端插件编译：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -am compile -DskipTests

结果：通过，BUILD SUCCESS，总耗时 11.503 s。

1. 静态检查：

git diff --check
rg -n '\$\{[^}]+\}' forge-server/db/migration

结果：git diff --check 无输出；Flyway ${...} 扫描无输出。

警告项

• 后端编译仍有既有 deprecated API 和 unchecked 警告，不阻断。
• 单测仍输出 commons-logging.jar 与 spring-jcl 发现提示，不阻断。

跳过项

• 本轮未重复执行前端构建；没有改动前端源码，风险面集中在后端发布/动作协议和 Flyway JSON 修复。
• 未连接本地/远程业务库执行 V1.0.97；脚本会在 forge-admin-server 下次启动时由 Flyway 执行。已完成占位符静态扫描。
• 未启动后端服务做采购仓储真实页面联调；本轮覆盖发布校验器、动作执行解析和运行配置构建的定向单测。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。

2026-07-03 详情数量区块运行配置单测补强

变更范围

• 新增 LowcodeRuntimeConfigBuilderTest，使用真实 LowcodeRuntimeConfigBuilder、LowcodeSchemaValidator、LowcodePolicyService 构造最小低代码模型。
• 覆盖 detail zone props 中的 quantityPanels 发布为运行态 options.detailPanels。

执行命令与结果

1. 新增单测：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=LowcodeRuntimeConfigBuilderTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 1, Failures: 0, Errors: 0, Skipped: 0。

1. 扩展组合单测：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessActionForeachStepExecutorTest,BusinessRecordSelectorSearchParamsTest,BusinessQuantityQueryServiceTest,LowcodeRuntimeConfigBuilderTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 13, Failures: 0, Errors: 0, Skipped: 0。

警告项

• 单测仍输出 commons-logging.jar 与 spring-jcl 发现提示，不阻断。
• 新增单测首次编译测试源码时出现既有 deprecated/unchecked 测试源码提示，不阻断。

跳过项

• 本轮为单测补强，未重复执行前端构建和后端插件编译；上一轮同代码面已通过，且本轮 Maven test 已完成 testCompile。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。

2026-07-03 详情数量区块发布运行态贯通补齐

变更范围

• 后端运行配置：LowcodeRuntimeConfigBuilder 从详情 zone props 读取 quantityPanels，发布为通用 options.detailPanels。
• 前端真实运行页：views/ai/crud-page.vue 将 options.detailPanels 传入 AiCrudPage。
• 前端预览/页面块：LowcodePreviewPane.vue 和 GridBlockRenderer.vue 将运行态 detailPanels 透传给 AiCrudPage。
• 前端详情渲染：AiCrudPage 详情模式在主表单和子表之后渲染 AiCrudRowExpand，复用通用数量面板 renderer。

执行命令与结果

1. 静态检查：

git diff --check
rg -n '\$\{[^}]+\}' forge-server/db/migration

结果：git diff --check 无输出；Flyway ${...} 扫描无输出。

1. 后端插件编译：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -am compile -DskipTests

结果：通过，BUILD SUCCESS，总耗时 38.350 s。

1. 前端构建：

source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build

结果：通过，✓ built in 2m 54s。

1. 定向组合单测：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessActionForeachStepExecutorTest,BusinessRecordSelectorSearchParamsTest,BusinessQuantityQueryServiceTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 12, Failures: 0, Errors: 0, Skipped: 0。

警告项

• 前端构建仍存在既有 UserSelectModal 命名冲突提示、CSS // 注释 minify 警告、动态/静态导入同模块 chunk 提示，不阻断。
• 后端编译仍存在既有 deprecated API 和 unchecked 警告，不阻断。
• 单测输出 commons-logging.jar 与 spring-jcl 发现提示，不阻断。

跳过项

• 未启动本地 MySQL/Redis/后端服务做真实采购仓储端到端联调；本轮补齐的是设计器配置到发布运行态的协议贯通，已通过前端构建、后端编译和定向单测覆盖。
• 未做 Playwright 截图验证；本轮 UI 复用既有 AiCrudRowExpand/数量面板组件，主要风险在 prop 贯通和模板语法，已由生产构建覆盖。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。

2026-07-03 P1 前端配置入口与详情区块验证

变更范围

• 前端动作设计器：新增“循环明细步骤”模板，生成 FOREACH + DOMAIN_ACTION/QUANTITY 可编辑步骤 JSON。
• 前端选择器配置：字段属性面板新增 searchParams 过滤参数入口；关系设计器新增子表选择器按钮、候选对象、显示字段、搜索字段、字段映射和过滤参数配置。
• 前端详情/展开：expandConfig.panels[] 支持 quantity-balance、quantity-ledger、quantity-lock；详情设计器新增数量区块配置；行展开堆叠模式补错误重试。
• 后端运行配置：关系配置中的 recordSelector 透传到模型引用 props 和运行态 childrenConfig。
• 文档：新增 procurement-warehouse-acceptance.md，说明采购仓储通过平台配置验收。

执行命令与结果

1. 前端构建：

source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build

结果：通过，✓ built in 2m 17s。

1. 后端插件编译：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -am compile -DskipTests

结果：通过，BUILD SUCCESS。

1. 定向组合单测：

JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessActionForeachStepExecutorTest,BusinessRecordSelectorSearchParamsTest,BusinessQuantityQueryServiceTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 12, Failures: 0, Errors: 0, Skipped: 0。

1. 静态检查：

git diff --check
rg -n '\$\{[^}]+\}' forge-server/db/migration

结果：git diff --check 无输出；Flyway ${...} 扫描无输出。

警告项

• 前端构建仍存在既有 UserSelectModal 命名冲突提示、CSS // 注释 minify 警告、动态/静态导入同模块 chunk 提示，不阻断。
• 后端编译仍存在既有 deprecated API 和 unchecked 警告，不阻断。
• 单测输出 commons-logging.jar 与 spring-jcl 发现提示，不阻断。

跳过项

• 未启动本地 MySQL/Redis/后端服务做真实采购仓储端到端联调；本轮以平台通用能力编译、单测、前端构建和配置验收文档为准。
• 未做 Playwright 截图验证；本轮 UI 是既有后台设计器配置项扩展，已通过生产构建覆盖模板和脚本语法。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。

2026-07-03 采购仓储运行闭环问题修复验证

变更范围

• 后端设计器保存：保存前规范化 pageSchema.zones，丢弃空区域，兼容 list/data-table/form/edit-form/detail-view/table-toolbar 等历史别名，避免 不支持的页面区域: null。
• 后端字段协议：BusinessFieldSchemaService 从 basicProps/advancedProps 读取 dictType，并兼容选择器对象编码别名，避免已有字典字段保存时报“字典字段必须配置字典类型”。
• 选择器协议：前端选择器配置和弹窗提交 objectCode/businessObjectCode/targetObjectCode/targetEntityCode/refObjectCode/targetCode 等别名，后端 DTO 和解析逻辑同步兜底，避免“选择器缺少业务对象编码”。
• 迁移脚本：新增 V1.0.96__harden_procurement_warehouse_designer_runtime_config.sql，按字段名修复采购仓储样例的状态字典、供应商报价子表状态下拉、选择器编码别名和 pw_supplier_material.material_id 可空。

执行命令与结果

1. 静态检查：

git diff --check
rg -n '\$\{[^}]+\}' forge-server/db/migration

结果：git diff --check 无输出；Flyway ${...} 扫描无输出。

1. 后端插件编译：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -am compile -DskipTests

结果：通过，BUILD SUCCESS，总耗时 12.325 s。

1. 定向单测：

env JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:/usr/local/apache-maven-3.9.3/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin /usr/local/apache-maven-3.9.3/bin/mvn -pl forge-framework/forge-plugin-parent/forge-plugin-generator -Pdev,enable-tests -Dtest=BusinessFieldSchemaServiceTest,BusinessRecordSelectorSearchParamsTest,BusinessObjectDesignerPageSchemaTest -Dsurefire.failIfNoSpecifiedTests=false test

结果：通过，Tests run: 10, Failures: 0, Errors: 0, Skipped: 0。

清理新增单测未使用 helper 后，补充复跑 BusinessObjectDesignerPageSchemaTest，通过，Tests run: 1, Failures: 0, Errors: 0, Skipped: 0。

1. 前端构建：

source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build

结果：通过，✓ built in 1m 28s。

警告项

• 后端编译仍存在既有 deprecated API 和 unchecked 警告，不阻断。
• 单测仍存在既有 deprecated/unchecked 测试源码提示，不阻断。
• 前端构建仍存在既有 UserSelectModal 命名冲突提示、CSS // 注释 minify 警告、动态/静态导入同模块 chunk 提示，不阻断。

跳过项

• 未直接连接本地/远程业务库执行 V1.0.96；脚本会在 forge-admin-server 下次启动时由 Flyway 执行。如当前服务已经启动，需要重启后再复测采购仓储页面。
• 未做真实浏览器端采购仓储增删改流程联调；本轮覆盖后端编译、定向单测、前端生产构建和 Flyway 占位符静态扫描。

服务清理

• 本轮未启动长期运行的后端、前端开发服务或数据库服务，无需清理 PID。