采购仓储低代码配置验收说明

本文只描述如何用平台通用能力配置采购仓储流程，不要求在平台代码中写死采购、仓库、供应商、物料等对象名。

1. 采购入库

对象：采购单作为主对象，采购明细作为明细关系对象。
关系：采购单 id 关联采购明细的主单字段，明细关系开启行级合并保存。
选择器：采购明细启用子表选择器，候选对象为物料或报价明细，显示编号、名称、规格、单位，字段映射到明细的物料、单位、单价等字段。
动作：配置通用动作 COMMAND，使用“循环明细步骤”模板，collectionPath 指向采购明细集合。
数量动作：循环内执行 DOMAIN_ACTION/QUANTITY，operationType=INBOUND，按明细行映射账户、数量项、维度和数量。
流程回调：采购单审批通过回调执行上述通用动作；驳回不入账。
详情区块：采购单详情配置数量流水区块，按 sourceObjectCode + sourceRecordId 查询本单产生的入库流水。

2. 出库扣减

对象：出库申请作为主对象，出库明细作为明细关系对象。
关系：出库申请 id 关联出库明细主单字段，明细关系开启行级合并保存。
选择器：出库明细启用子表选择器，候选对象可配置为库存余额视图对象或物料对象，并通过过滤参数按当前仓库、项目、库存状态过滤候选记录。
动作：提交或审批通过阶段使用 FOREACH 遍历出库明细。
数量动作：提交阶段可配置 LOCK 锁定数量；审批通过后配置 COMMIT 或扣减动作，映射锁定号、来源记录和来源明细。
流程回调：流程通过执行扣减，流程撤回或驳回执行释放锁定。
详情区块：出库详情配置数量锁定区块和数量流水区块，分别按来源单据查询锁定记录和扣减流水。

3. 调拨转移

对象：调拨单作为主对象，调拨明细作为明细关系对象。
关系：调拨单 id 关联调拨明细主单字段。
选择器：调拨明细选择器按调出账户或调出维度过滤可选数量项。
动作：审批通过后执行 FOREACH，循环变量使用 ${item.xxx} 映射每一行明细。
数量动作：循环内执行 DOMAIN_ACTION/QUANTITY，operationType=TRANSFER，同时映射调出账户、调入账户、数量项、目标数量项、维度和目标维度。
详情区块：调拨详情配置数量流水区块，展示每条转移流水及目标账户信息。

4. 供应商报价维护

对象：供应商、报价单、报价明细按普通业务对象配置。
关系：报价单包含报价明细，报价明细引用物料对象。
选择器：报价明细字段使用记录选择器，keywordFields 配置编号和名称，searchParams 可按供应商、项目或物料分类做动态过滤。
字段映射：选择物料后把物料编号、名称、规格、单位等字段映射到报价明细。
详情区块：供应商详情通过关系页签展示报价单，通过数量区块或关联页签展示被引用的物料记录。

5. 仓库详情

对象：仓库或库存账户作为主对象。
数量余额区块：配置 quantity-balance，查询参数映射 accountCode=${row.accountCode} 或 dimensionKey=${row.dimensionKey}。
数量流水区块：配置 quantity-ledger，查询参数映射同上，展示入库、扣减、转移等历史流水。
数量锁定区块：配置 quantity-lock，按账户和状态过滤未完成锁定。
关联页签：采购记录、出库记录、调拨记录使用关系配置或接口展开面板展示，不需要定制仓库页面代码。

6. 验收结论

采购入库、出库扣减、调拨转移可以通过 FOREACH + DOMAIN_ACTION/QUANTITY 表达。
物料、报价、库存余额候选记录可以通过通用记录选择器、多字段关键词和动态过滤参数表达。
仓库、单据详情可以通过关系页签、数量余额、数量流水和数量锁定区块表达。
平台新增能力保持通用命名和通用协议，采购仓储只作为配置验收场景。