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

任务拆分 — 低代码业务交易闭环能力补齐

status: apply_completed created: 2026-07-03 原则：平台能力通用；采购仓储只做验收样例；查询 SQL 写 Mapper XML；动作步骤白名单；内置数据 tenant_id=1。

阶段总览

阶段	目标	任务
Phase 1	动作循环	Task 1-3
Phase 2	选择器增强	Task 4-6
Phase 3	数量查询	Task 7-9
Phase 4	详情区块最小入口	Task 10-11
Phase 5	验证与文档	Task 12-13

任务清单

Task	名称	状态	优先级
Task 1	动作执行上下文支持循环变量	completed	P0
Task 2	新增 FOREACH 动作步骤执行器	completed	P0
Task 3	动作设计器提供循环步骤模板	completed	P1
Task 4	选择器后端支持多字段关键词查询	completed	P0
Task 5	选择器运行态支持动态过滤参数	completed	P0
Task 6	选择器配置入口优化	completed	P1
Task 7	数量台账查询 DTO/VO/Mapper	completed	P0
Task 8	数量台账查询 Service/Controller	completed	P0
Task 9	数量台账查询权限和前端 API	completed	P0
Task 10	详情区块运行协议接入数量查询	completed	P1
Task 11	详情设计器最小配置入口	completed	P1
Task 12	定向单测和构建验证	completed	P0
Task 13	采购仓储低代码配置验收文档	completed	P1

Task 1: 动作执行上下文支持循环变量

目标：让动作步骤映射能读取 ${item.xxx} 和 ${index}。

涉及文件：

• BusinessActionExecutionContext.java
• BusinessActionStepConfigHelper.java
• BusinessActionExecutionServiceTest.java

验收标准：

• 父级 record/form/context 解析不受影响。
• 循环上下文可以覆盖 item 和 index，并在子步骤执行结束后恢复。
• 未进入循环时读取 item.xxx 返回 null，不抛 NPE。

Task 2: 新增 FOREACH 动作步骤执行器

目标：动作步骤支持遍历集合并执行子步骤。

涉及文件：

• ForeachActionStepExecutor.java
• BusinessActionExecutionService.java
• BusinessActionStepDTO.java
• BusinessActionForeachStepExecutorTest.java

验收标准：

• collectionPath 支持 record.details、formData.children.items、context.rows。
• steps 只允许已有白名单步骤，禁止递归超过 2 层。
• 子步骤失败时默认回滚父事务。
• 每一行步骤结果包含 itemIndex 和子步骤结果。

Task 3: 动作设计器提供循环步骤模板

目标：降低业务配置动作循环的 JSON 成本。

涉及文件：

• BusinessActionDesigner.vue

验收标准：

• 通用动作步骤区新增“循环明细步骤”模板按钮。
• 模板生成 FOREACH + DOMAIN_ACTION/QUANTITY 的可编辑 JSON。
• 既有数量台账步骤模板不回退。

Task 4: 选择器后端支持多字段关键词查询

目标：实现物料编号/名称这类多字段 OR 搜索。

涉及文件：

• BusinessRecordSelectorService.java
• DynamicCrudService.java 或选择器专用 Mapper XML
• BusinessRecordSelectorSearchParamsTest.java

验收标准：

• 单字段关键词兼容旧行为。
• 多字段关键词按 OR 查询。
• 关键词字段必须在请求字段白名单内。
• 排序字段仍只能来自允许字段。

Task 5: 选择器运行态支持动态过滤参数

目标：选择器可按当前仓库、项目、供应商等上下文过滤候选记录。

涉及文件：

• AiFormItem.vue
• ChildTableEditor.vue
• record-selector-utils.js
• BusinessRecordSelectorService.java

验收标准：

• searchParams 支持 ${formData.xxx}、${record.xxx}、${row.xxx}、${query.xxx}。
• 空值参数不提交。
• 子表选择器能读取父表单数据。

Task 6: 选择器配置入口优化

目标：让字段属性面板能维护动态过滤参数。

涉及文件：

• BusinessFieldPropertyPanel.vue
• BusinessRelationDesigner.vue

验收标准：

• 字段选择器配置区新增过滤参数文本入口。
• 子表关系配置可维护选择器按钮、候选对象、映射和过滤参数。

Task 7: 数量台账查询 DTO/VO/Mapper

目标：建立只读查询协议。

涉及文件：

• BusinessQuantityQueryDTO.java
• BusinessQuantityBalanceVO.java
• BusinessQuantityLedgerVO.java
• BusinessQuantityLockVO.java
• BusinessQuantityBalanceMapper.java/xml
• BusinessQuantityLedgerMapper.java/xml
• BusinessQuantityLockMapper.java/xml

验收标准：

• 查询条件支持账户、数量项、维度、来源对象、来源记录和来源明细。
• 分页查询使用 pageNum/pageSize。
• XML 查询明确字段，不使用 SELECT *。

Task 8: 数量台账查询 Service/Controller

目标：提供低代码运行态可调用的只读接口。

涉及文件：

• BusinessQuantityQueryService.java
• BusinessQuantityQueryController.java

验收标准：

• Controller 返回 RespInfo.success(data)。
• 只读查询不修改余额、流水和锁定表。
• 查询接口具备权限校验。

Task 9: 数量台账查询权限和前端 API

目标：运行态可安全读取数量视图。

涉及文件：

• business-app.js
• Flyway 权限脚本或复用 V1.0.88 后续版本脚本

验收标准：

• 新增权限资源具备 NOT EXISTS 防重复。
• 前端 API 封装使用 POST 查询，避免复杂条件拼 URL。

Task 10: 详情区块运行协议接入数量查询

目标：低代码详情/展开面板可展示数量余额和流水。

涉及文件：

• ExpandPanelRenderer.vue
• expand-utils.js
• 新增或扩展数量面板 renderer

验收标准：

• 面板类型支持 quantity-balance 和 quantity-ledger。
• 支持从当前记录映射查询参数。
• 加载失败显示错误并可重试。

补充记录：

• 详情设计器保存的 quantityPanels 已由后端运行配置发布为 options.detailPanels。
• 真实运行页、运行态预览和低代码页面块均已把 detailPanels 传递给 AiCrudPage。
• 新增 LowcodeRuntimeConfigBuilderTest 覆盖详情数量区块发布到运行态 options，避免后续回归。

Task 11: 详情设计器最小配置入口

目标：详情设置能声明数量区块，而不是手写 JSON。

涉及文件：

• BusinessDetailDesigner.vue
• ForgePropertyPanel.vue 如运行配置入口已有更合适位置则复用。

验收标准：

• 能选择数量区块类型、标题、查询参数映射和展示字段。
• 不影响已有关系页签和操作/审批日志配置。

Task 12: 定向单测和构建验证

目标：按测试规范做增量验证。

验收标准：

• 读取 code-copilot/rules/automated-testing-standard.md。
• Maven 定向单测实际执行，日志包含 Tests run。
• 后端插件编译通过。
• 前端构建通过或明确跳过原因。
• execution-log.md 追加命令、结果、警告和跳过项。

Task 13: 采购仓储低代码配置验收文档

目标：沉淀采购仓储如何通过平台配置实现，不写业务代码。

涉及文件：

• code-copilot/changes/lowcode-business-transaction-closure/procurement-warehouse-acceptance.md

验收标准：

• 覆盖采购入库、出库扣减、调拨转移、供应商报价维护、仓库详情。
• 每个场景说明对象、关系、动作、流程回调、数量动作和详情区块配置。